Provare un agente
Prima di rendere un agente disponibile ai canali di produzione, è possibile verificarne il comportamento in una conversazione di prova dalla console Chat, leggendo il dettaglio tecnico di ogni risposta.
Prerequisiti
- Un agente in stato Bozza o Attivo.
Avviare una conversazione di prova
Dal dettaglio dell'agente, o dalla sezione Chat, è possibile avviare una nuova conversazione selezionando l'agente da testare. Se il system prompt contiene variabili template, la console richiede di compilarle prima di iniziare (vedere Variabili template nelle conversazioni).
Leggere il pannello Dati Tecnici
Il pulsante Dati Tecnici apre un pannello laterale con il dettaglio di ogni turno di conversazione:
- modello utilizzato, token di input/output, latenza;
- punteggio di confidenza della risposta;
- intento classificato e sentiment rilevato;
- eventuale motivo e trigger di un'escalation (handoff);
- operazioni RAG eseguite (riscrittura della query, recupero, reranking).
Verificare le fonti recuperate
Quando l'agente utilizza una Knowledge Base per rispondere, il pannello e l'elenco fonti sotto la risposta mostrano i documenti effettivamente recuperati con il relativo punteggio di rilevanza: è il modo più diretto per verificare se il RAG sta recuperando i contenuti attesi prima di attivare l'agente in produzione (vedere La console Chat).
Dal test manuale ai test sistematici
Il test manuale è utile per una verifica rapida su singoli casi, ma non sostituisce una valutazione sistematica su un insieme di domande rappresentative. Per test ripetibili e misurabili nel tempo vedere Valutazioni e A/B Testing.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| La conversazione di prova non recupera le fonti attese | KB non collegata all'agente, o RAG disattivato | Verificare la configurazione in Collegare le Knowledge Base (RAG) |
| Il pannello Dati Tecnici non mostra un'operazione RAG | RAG disattivato sull'agente | Attivare il toggle Abilita RAG |
| La confidenza è sempre bassa nei test | Prompt poco specifico o KB con copertura insufficiente sull'argomento testato | Rivedere il system prompt e integrare la KB con i contenuti mancanti |