La console Chat
La sezione Chat è l'interfaccia conversazionale per dialogare con gli agenti del tenant: supporta risposte in tempo reale, allegati, citazione delle fonti, approvazione esplicita degli strumenti MCP ed escalation verso un operatore.
Prerequisiti
- Permesso di lettura conversazioni sul tenant.
- Almeno un agente in stato Attivo (oppure un agente temporaneo generato da un'analisi documentale, vedere Analisi documentale).
Avviare una conversazione
- Aprire la sezione Chat dalla sidebar.
- Cliccare Nuova conversazione.
- Selezionare un agente dal menu Seleziona agente: nell'elenco compaiono sia gli agenti permanenti del tenant sia gli eventuali agenti temporanei generati dalle analisi documentali.
- Scrivere il messaggio e inviarlo.
Se il system prompt dell'agente contiene variabili template, prima di poter scrivere il primo messaggio è necessario compilarle (vedere Variabili template nelle conversazioni).
Risposte in tempo reale
La risposta dell'agente arriva in streaming: i token compaiono progressivamente man mano che vengono generati, senza dover attendere il completamento della risposta. Durante l'elaborazione possono comparire indicatori di stato, ad esempio:
- "Ricerca nella knowledge base…" — l'agente sta interrogando una Knowledge Base collegata;
- "Ragionamento in corso…" — un modello con reasoning esteso sta elaborando la risposta, con qualche decina di secondi di latenza aggiuntiva.
Allegare file
È possibile allegare immagini, PDF e file di testo trascinandoli nella finestra di conversazione oppure tramite l'icona dedicata accanto alla casella di testo; un'anteprima dell'allegato compare prima dell'invio.
Le fonti citate
Quando la risposta si basa sui contenuti di una Knowledge Base, sotto il messaggio compare il conteggio delle fonti utilizzate:
- il clic espande l'elenco dei documenti citati con la relativa percentuale di rilevanza;
- il campo di ricerca filtra l'elenco per titolo;
- le fonti con visibilità nelle citazioni disattivata (vedere Visibilità dei documenti nelle citazioni) non compaiono in elenco anche se hanno contribuito al contesto della risposta.
Approvare l'uso di strumenti
Se l'agente ha server MCP collegati e la chiamata a uno strumento richiede approvazione umana, prima dell'esecuzione compare una card con l'elenco degli strumenti richiesti e i pulsanti Approva ed esegui / Rifiuta.
Per il dettaglio della configurazione dei server MCP vedere Server MCP.
Feedback sui messaggi
Sotto ogni risposta è possibile indicare un feedback con pollice su (utile) o pollice giù (non utile). I messaggi con feedback negativo, insieme a quelli a bassa confidenza, confluiscono nella sezione Risposte incerte dell'agente (vedere Versioni e ripristino).
Protezione dei dati personali
Quando la policy PII Shield del tenant è attiva, i messaggi in cui è stata applicata la pseudonimizzazione dei dati personali mostrano il badge "PII protetto". Il dettaglio della policy e delle entità riconosciute è descritto in PII Shield: protezione dei dati personali.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Il messaggio non può essere inviato | Una variabile template obbligatoria non è stata compilata | Compilare tutti i campi richiesti sotto la barra di input |
| La risposta non mostra mai fonti | RAG disattivato sull'agente, o nessuna KB collegata | Verificare la configurazione in Collegare le Knowledge Base (RAG) |
| L'agente non propone mai l'approvazione di uno strumento | Nessun server MCP collegato all'agente, oppure approvazione umana disattivata sullo strumento | Verificare la configurazione in Server MCP |