> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/ai/come-funziona/gli-strumenti-del-funzionario/la-chat.md).

# La chat

La chat è lo strumento principale per interagire con l'assistente. Il funzionario descrive in linguaggio naturale, per iscritto o a voce, quello che vuole fare e l'assistente risponde, chiede chiarimenti se necessario o avvia direttamente l'azione richiesta.

<figure><img src="https://793214105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0AdQysODIf5E7oHfQAtY%2Fuploads%2FTJcqk8e6eFShEx6Ph4pl%2Fimage.png?alt=media&amp;token=494b77c2-8ea1-4e46-9d18-b940a17491d4" alt=""><figcaption></figcaption></figure>

L'interazione è una conversazione: il funzionario può approfondire, correggere il tiro o tornare su un punto precedente e l'assistente mantiene il contesto dell'intera sessione. Se la risposta prende una direzione diversa da quella attesa, è possibile interromperla o rigenerarla, anche modificando la domanda di partenza.

Se sono disponibili più modelli, il selettore accanto al campo di testo permette di sceglierne uno prima di inviare la domanda. Il modello scelto resta lo stesso per tutta la risposta, anche quando la sessione viene rinnovata in automatico.

I documenti si caricano tramite il pulsante dedicato o trascinandoli direttamente in chat. L'assistente li legge e li usa come base per la risposta, senza che il funzionario debba copiarne o riassumerne il contenuto.

L'assistente può anche generare documenti, come PDF, documenti di testo e fogli di calcolo, scaricabili dalla chat. Nei messaggi successivi della stessa conversazione li può rileggere: ne riporta il testo in chat o risponde a domande sul contenuto, in modo fedele al file scaricato.

<figure><img src="https://793214105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0AdQysODIf5E7oHfQAtY%2Fuploads%2FFTfuFeMTp48rwEgfAFWW%2Fimage.png?alt=media&amp;token=52459916-9532-48d5-9b9e-e485aea79eb8" alt=""><figcaption></figcaption></figure>

La lettura di un documento avviene in background, quindi il caricamento è immediato. Finché il documento viene letto, accanto al nome del file compare "Lettura del documento…" e, se è molto lungo, anche l'avviso che può richiedere alcuni minuti. Se nel frattempo il funzionario scrive un messaggio, questo resta in attesa e parte da solo appena il documento è pronto: compare "Il messaggio partirà appena il documento è pronto" e il pulsante "Annulla invio" permette di ritirarlo. Se la lettura non riesce, o supera il tempo massimo di 10 minuti, il file diventa rosso con il motivo e il pulsante "Riprova", e il testo scritto torna nel campo del messaggio.

Per togliere un allegato prima di inviare il messaggio basta premere la "x" sulla sua chip: il documento viene tolto dalla conversazione e l'assistente non lo vede più, nemmeno nei messaggi successivi.

Mentre elabora la risposta, l'assistente mostra in tempo reale cosa sta facendo: se sta ragionando sulla richiesta, cercando tra le istruzioni operative o recuperando un documento dalla base di conoscenza. A risposta completata, è possibile vedere quale istruzione è stata richiamata.

Quando la risposta cita norme o altre fonti, i riferimenti compaiono in fondo alla risposta come elenco "Riferimenti", con il titolo di ciascuna fonte e un link cliccabile. Il pulsante "Copia" copia l'intera risposta, riferimenti compresi.

<figure><img src="https://793214105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0AdQysODIf5E7oHfQAtY%2Fuploads%2Ffp0bDeQCigQuZtdoIHx2%2Fimage.png?alt=media&amp;token=c54cb522-f645-426b-b9be-815e1d41ec0e" alt=""><figcaption></figcaption></figure>

Sotto il campo di testo sono sempre visibili alcuni suggerimenti di attività. Si tratta di azioni frequenti o pertinenti al contesto dell'assistente attivo, proposte sotto forma di etichette selezionabili che, se cliccate, permettono di avviare rapidamente un'attività.

<figure><img src="https://793214105-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0AdQysODIf5E7oHfQAtY%2Fuploads%2FU1IuxLGHvWUdM3s34cQX%2Fimage.png?alt=media&amp;token=a7989406-192f-4d3a-9794-8bcec8d9bb35" alt=""><figcaption></figcaption></figure>

Ogni conversazione viene salvata automaticamente ed è sempre consultabile. Alla prima domanda, ogni nuova conversazione riceve un titolo breve, di massimo sei parole, che ne riassume l'argomento e la rende riconoscibile nell'elenco. Il funzionario può riprendere una sessione precedente, cercare tra le conversazioni passate o continuare un'attività avviata in un momento diverso.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.opencityitalia.it/ai/come-funziona/gli-strumenti-del-funzionario/la-chat.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
