Anteprima e test di un agente (Conversazione con il cliente) (anteprima)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Un agente che appare corretto nella scheda Build può comunque fallire in conversazione. Le istruzioni sono una guida, non garanzie: il modello le interpreta, e il divario tra ciò che hai scritto e ciò che fa l'agente appare solo quando parli effettivamente con lui. Usa la scheda Anteprima per testare il tuo agente sia tramite chat web che voce prima di pubblicarlo.

Canali di prova

La scheda Anteprima offre due modi per testare il tuo agente:

  • chat Web: Un pannello di chat testuale. Qui dovresti dedicare la maggior parte del tempo ai test. È più veloce della voce, la trascrizione completa è visibile e ottieni una traccia di ragionamento insieme alla chat.
  • Chiamata vocale: Una conversazione vocale in diretta con il tuo agente. La voce ha modalità di errore che il testo non mette mai in evidenza, quindi testa separatamente anche se la chat passa pulita.

Seleziona chat Web o Chiamata Vocale in alto nella scheda Anteprima per passare tra i canali di test. Un panel di trascrizione in diretta appare accanto alla conversazione.

Prima di iniziare

  • Salva le modifiche. Il pannello Anteprima esegue il tuo agente salvato, non le modifiche non salvate nella scheda Build .
  • Sappi come si presenta "corretto". Scrivi il risultato atteso prima di inviare il primo messaggio.
  • Apri la mappa Attività. Si trova accanto alla chat e mostra il routing, le chiamate degli strumenti e l'esecuzione dei topic. È il modo in cui distingui un errore di ragionamento da uno idraulico.
  • Inizia una nuova sessione di test tra gli scenari. Il contesto si trasferisce e contaminerà il tuo prossimo risultato.

I cinque strati da testare

Lavora verso l'esterno dallo strato più semplice. Un guasto in uno strato iniziale avrà un effetto a cascata, quindi risolvi i problemi in ordine.

Livello Cosa stai testando Come capire se funziona
Saluto e ambito L'agente si presenta e capisce il proprio compito Il messaggio di apertura corrisponde alla tua descrizione; accetta richieste in ambito
Routing L'orchestratore sceglie il sottoagente giusto La mappa dell'attività mostra lo specialista previsto richiamato
Strumenti e argomenti Le azioni effettivamente vengono eseguite e restituiscono dati I valori reali tornano, non i segnaposto o il silenzio
Conoscenza Le risposte sono basate sulle tue fonti Le citazioni appaiono e corrispondono alle fonti configurate
Guardrail Rifiuti, escalation e regole aziendali in sospeso L'agente rifiuta, fa l'escalation o segnala esattamente come richiesto

Test nella chat web

Esegui prima il percorso principale

Interpreta un utente realistico con un obiettivo preciso, non un tester che tocca le funzionalità. Ad esempio, per un agente di viaggio, questo significa prenotare un vero viaggio dall'inizio alla fine invece di chiedere "puoi prenotare i voli?"

  1. Apri l'obiettivo naturalmente, come farebbe un vero utilizzatore.
  2. Rispondi alle domande dell'agente come utente collaborativo.
  3. Segui il flusso fino a una vera conclusione: una prenotazione, un riassunto, una risoluzione.
  4. Chiedi un riepilogo alla fine, poi verifica ogni fatto nel riepilogo rispetto alla trascrizione.

Poi rompilo apposta

Il caso standard dimostra che l'agente può funzionare. Questi scenari dimostrano che si guasta in modalità fail-safe.

Test Cosa inviare Cosa dovrebbe succedere
Dettaglio mancante Salta un campo obbligatorio di cui l'agente ha bisogno Chiede esattamente quel campo, una volta
Cambio di idea Annullare una decisione durante il flusso Si aggiorna senza perdere il contesto precedente
Fuori ambito Chiedi qualcosa fuori dal suo ambito Esso declina e reindirizza, senza improvvisare
Riassegnazione Attiva una regola di passaggio documentata Esegue il trasferimento invece di tentare di eseguire l'operazione
Regola aziendale Violare un limite dichiarato, come il budget Segnala esplicitamente il conflitto
Memoria della sessione Chiedigli di ripetere un dettaglio di prima Ricorda con precisione, senza dover chiedere di nuovo

Leggi la mappa delle attività, non solo la risposta

La conversazione ti dice cosa ha detto l'agente. La mappa Attività ti dice cosa è stato fatto. Quando una risposta sembra sbagliata, la mappa ti dice dove correggerla:

  • Uno specialista sbagliato invocato → le tue istruzioni di instradamento o le descrizioni del sottoagente sono ambigue.
  • Specialista giusto, un output sbagliato → le istruzioni del sottoagente stesso devono essere migliorate.
  • Lo strumento è stato eseguito ma non ha restituito nulla → lo strumento o l'argomento sono rotti, non il prompt.
  • Nessuna chiamata allo strumento → l'agente ha risposto dal modello invece che dai tuoi dati. Considera ogni valore in quella risposta come non verificato.

Test in modalità vocale

Voice non è una chat web con audio allegato. Presenta modalità di guasto che nel testo non emergono mai, quindi testalo separatamente anche quando la chat non segnala problemi.

  1. Concedi l'accesso al microfono, poi avvia la conversazione vocale e conferma che lo stato raggiunge lo stato connesso e in ascolto.
  2. Pronuncia una richiesta completa in modo naturale invece di leggere uno script parola per parola.
  3. Guarda la trascrizione in diretta. Se il riconoscimento vocale ti fraintende, la risposta dell'agente risponde a una domanda diversa da quella che hai posto.
  4. Interrompi l'agente a metà frase per verificare che il barge-in interrompa la riproduzione e si metta in ascolto.
  5. Resta in silenzio per diversi secondi per confermare che il sistema riproponga il messaggio in modo cortese invece di chiudere la chiamata.
  6. Chiedi un codice di conferma e controlla che venga scandito carattere per carattere, non letto come una parola.

Cosa ascoltare

  • Lunghezza: Qualsiasi cosa oltre circa tre frasi è troppo lunga per essere seguita a orecchio.
  • Liste e URL: Questi devono essere riassunti, mai letti ad alta voce per elemento.
  • Date e numeri: "Martedì, 24 marzo" funziona; "2026-03-24" no.
  • Conferma dei dati critici: Nomi, date e codici devono essere ripetuti per conferma prima che l'agente agisca su di essi.

Se il Speech si comporta come il tuo canale Chat, le istruzioni specifiche del canale non stanno facendo il loro dovere. Le istruzioni Speech e Chat sono configurate separatamente su ciascun agente, nelle schede Speech e Chat della sezione Istruzioni. Vedi panoramica delle impostazioni vocali e della chat.

Tip

Esegui i tuoi scenari critici più di una volta e fai almeno una sessione lunga. I guasti intermittenti sono comunque fallimenti, e sono quelli che arrivano in produzione.

Quando qualcosa fallisce

  1. Riproducilo. Inizia una nuova sessione e ripeti lo stesso percorso, notando se fallisce ogni volta o a intermittenza.
  2. Localizzalo usando la mappa Attività: routing, strumento, conoscenza o istruzione.
  3. Risolvi una cosa alla volta. Cambiare più istruzioni contemporaneamente rende impossibile capire cosa abbia funzionato.
  4. Salva, inizia una nuova sessione e rifai esattamente lo stesso scenario.
  5. Rifai gli altri scenari riusciti. I cambiamenti nelle istruzioni hanno effetti collaterali.

Lista di controllo per articoli pronti per la spedizione

  • Il flusso principale si completa dall'inizio alla fine senza assistenza.
  • Ogni fatto nel riassunto finale è riconducibile a qualcosa che uno strumento o una fonte di conoscenza ha effettivamente restituito.
  • Non appare nessun testo provvisorio da nessuna parte in una risposta visibile dall'utente.
  • L'agente segnala onestamente il fallimento quando uno strumento non restituisce nulla.
  • Le regole di escalation e rifiuto si attivano in modo affidabile.
  • Le risposte vocali sono brevi e i codici vengono scanditi lettera per lettera.
  • Scenari critici sono stati eseguiti più di una volta, inclusa una lunga sessione.
  • Ultimo aggiornamento: