Riquadro di traccia in Agentforce Builder

Disponibile nelle versioni: Lightning Experience

Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition. Le licenze aggiuntive richieste variano a seconda del tipo di agente.

Dopo aver inviato un messaggio di prova, il Riepilogo interazione mostra ogni evento del processo decisionale dell'agente come sequenza temporale visiva. A seconda del caso di test, gli eventi includono:

Evento	Descrizione
Input: [messaggio]	Il messaggio che ha iniziato questo turno
Motivo: [nome agente]	Il ragionamento dell'agente passa che descrive cosa ha deciso di fare dopo e perché
Azione: [etichetta funzione]	Un'azione dell'agente attivata dall'agente (flusso, Apex e così via)
Passaggio a subagente: [agente di destinazione]	L'agente ha passato la conversazione a un sottoagente all'interno dello stesso agente
Passaggio all'agente: [nome sviluppatore]	L'agente ha passato la conversazione a un agente correlato separato
Valutazione dell'output: [category]	Valutazione della risposta dell'agente prima che venga restituita all'utente
Valutazione strumento MCP: [nome agente]	Uno strumento MCP chiama l'agente valutato

Selezionare un evento nel Riepilogo interazione per aprirne la visualizzazione dettagliata nella scheda Traccia. La scheda Traccia mostra una suddivisione di ogni millisecondo di quell'evento, con barre di temporizzazione per ogni operazione secondaria. Esaminare in dettaglio un singolo intervallo per vedere i dati di output completi ed esattamente ciò che l'agente ha ricevuto e restituito in quel momento.

La sottoscheda Variabili mostra lo stato di ogni variabile in ogni punto della sessione. Ogni evento mostra il valore prima dell'esecuzione e il valore dopo il completamento dell'evento. Ad esempio, un valore booleano che passa da False a True dopo un controllo della condizione. Utilizzare la sottoscheda Variabili per:

• Verificare che i dati corretti abbiano raggiunto un'azione agente o un modello di prompt
• Verificare che la variabile corretta sia stata aggiornata dopo il completamento dell'azione
• Identificare in quale punto della sessione una variabile ha ricevuto un valore imprevisto

Impostare i valori iniziali o ignorarli nelle variabili di contesto prima di iniziare il test, quindi utilizzare le variabili durante la sessione per tenere traccia dell'evoluzione di tali valori.

All'interno di qualsiasi fase di ragionamento, la scheda Traccia mostra il prompt esatto inviato al componente LLM. Utilizzare queste informazioni per capire:

• Contesto in cui si trovava l'agente quando ha selezionato un sottoagente o ha deciso di attivare un'azione agente
• Se il prompt conteneva i valori delle variabili e le istruzioni previste
• Perché il ragionamento dell'agente ha portato a un esito imprevisto

Durante la revisione di una traccia, porre domande all'Assistente Agentforce integrato su ciò che si sta visualizzando. Ad esempio, "Spiega il prompt generato in questa fase di ragionamento" o "Come posso correggere l'agente per gestire questo caso?"

Esaminare attentamente le correzioni suggerite prima di applicarle. I suggerimenti a volte fanno riferimento ad azioni o flussi degli agenti che non esistono nell'organizzazione, quindi verificare prima di apportare modifiche.

Di seguito sono riportati alcuni dei problemi di debug più comuni e i passaggi per risolverli.

Evento	Soluzione
Un'azione agente non è stata attivata	Aprire la fase Ragionamento immediatamente prima dell'azione prevista. Esaminare il prompt generato per vedere se l'agente disponeva del contesto necessario per chiamare l'azione. Verificare quindi se una FunctionStep (Action) viene visualizzata dopo la fase di ragionamento. In caso contrario, l'agente ha deciso di non attivare l'azione in base al contesto disponibile.
Si è verificata una transizione imprevista tra subagenti	Trovare la TransitionStep nel riepilogo delle interazioni. Espandere la fase Ragionamento prima di essa per vedere quale contesto ha portato l'agente alla transizione. Verificare se la configurazione del router agente corrisponde all'intento espresso nel messaggio di test.
L'output non corrisponde alle aspettative	Controllare OutputEvaluationStep alla fine della sequenza. Quindi tornare indietro nelle fasi di ragionamento e nella sottoscheda Variabili per identificare dove la decisione dell'agente si discosta da quanto previsto.