Panneau de trace dans Agentforce Builder

Disponible avec : Lightning Experience

Disponible avec : Enterprise Edition, Performance Edition, Unlimited Edition et Developer Edition. Les licences complémentaires requises varient selon le type d'agent.

Après avoir envoyé un message test, le Résumé des interactions affiche chaque événement du processus de prise de décision de l'agent sous forme de chronologie visuelle. Selon le cas de test, les événements comprennent :

Événement	Description
Entrée : [Message]	Le message qui a commencé ce tour
Motif : [nom de l'agent]	La passe de raisonnement de l'agent indiquant ce qu'il a décidé de faire ensuite et pourquoi
Action : [étiquette de fonction]	Une action de l'agent que l'agent a déclenchée (flux, Apex, etc.)
Transition vers un sous-agent : [agent cible]	L'agent a transféré la conversation à un sous-agent du même agent
Transition vers Agent : [nom du développeur]	L'agent a transféré la conversation à un agent associé séparé
Évaluation des extrants : [catégorie]	Évaluation de la réponse de l'agent avant son renvoi à l'utilisateur
Évaluation de l'outil MCP : [nom de l'agent]	Un outil MCP appelle l'agent évalué

Sélectionnez un événement dans le Résumé des interactions pour ouvrir sa vue de détail sous l'onglet Trace. L'onglet Trace affiche une répartition de chaque milliseconde de cet événement, avec des barres de temps pour chaque sous-opération. Explorez une plage individuelle pour afficher ses données de sortie complètes et exactement ce que l'agent a reçu et renvoyé à ce stade.

Le sous-onglet Variables affiche l'état de chaque variable à chaque point de décision de la session. Chaque événement affiche la valeur avant son exécution et la valeur une fois l'événement terminé. Par exemple, un booléen qui bascule de False à True après un contrôle de condition réussit. Utilisez le sous-onglet Variables pour :

• Vérifier que les données correctes ont atteint une action de l'agent ou un modèle d'invite
• Confirmez que la variable correcte a été mise à jour une fois l'action terminée
• Identifier où dans la session une variable a reçu une valeur inattendue

Définissez des valeurs initiales ou de remplacement dans Variables de contexte avant de lancer votre test, puis utilisez des variables pendant la session pour suivre l'évolution de ces valeurs.

Dans n'importe quelle étape de Raisonnement, l'onglet Trace affiche l'invite exacte envoyée au grand livre. Utilisez ces informations pour comprendre :

• Quel contexte avait l'agent lorsqu'il a sélectionné un sous-agent ou décidé de déclencher une action de l'agent
• Si l'invite contenait les valeurs de variable et les instructions attendues
• Pourquoi le raisonnement de l'agent a conduit à un résultat inattendu

En examinant une trace, posez des questions à l'assistant Agentforce intégré sur ce que vous voyez. Par exemple, « Expliquez l'invite générée à cette étape de raisonnement » ou « Comment puis-je corriger l'agent pour traiter cette requête ? »

Examinez attentivement les correctifs suggérés avant de les appliquer. Les suggestions référencent parfois des actions ou des flux d'agents qui n'existent pas dans votre organisation. Par conséquent, vérifiez avant d'apporter des modifications.

Voici quelques-uns des problèmes de débogage les plus courants et des étapes pour les résoudre.

Événement	Résolution
Une action de l'agent n'a pas été déclenchée	Ouvrez l'étape Raisonnement immédiatement avant l'action attendue. Examinez l'invite générée pour déterminer si l'agent avait le contexte nécessaire pour appeler l'action. Vérifiez ensuite si une FunctionStep (Action) est affichée après l'étape Raisonnement. Sinon, l'agent a décidé de ne pas déclencher l'action en fonction de son contexte disponible.
Une transition inattendue de sous-agent s'est produite	Recherchez TransitionStep dans le Résumé des interactions. Agrandissez l'étape Raisonnement qui précède pour déterminer le contexte qui a conduit l'agent à la transition. Vérifiez si la configuration du Routeur de l'agent correspond à l'intention exprimée par votre message test.
La sortie n'a pas répondu aux attentes	Vérifiez OutputEvaluationStep à la fin de la séquence. Suivez ensuite les étapes de Raisonnement et le sous-onglet Variables pour identifier les différences entre la décision de l'agent et celle attendue.