La trace montre tout ce que votre bot a fait pour répondre à un message, étape par étape : ce que le visiteur a envoyé, les étapes exécutées par le parcours, les valeurs de vos variables et la réponse envoyée. Utilisez-la pour déboguer un parcours pendant que vous le construisez, ou pour comprendre pourquoi votre bot a répondu ainsi dans une vraie conversation.
Ouvrir une trace
Dans le Flow Builder, cliquez sur Test, ouvrez l'Inspector puis cliquez sur Access logs
Dans Conversations, cliquez sur Trace sur un message pour comprendre pourquoi le bot a répondu ainsi
La trace s'ouvre sur le message sélectionné. Utilisez les flèches de chaque côté pour passer au message précédent ou suivant de la conversation.
Lire une trace
La trace comporte deux onglets :
Steps : la liste des étapes exécutées par le bot, dans l'ordre, et le détail de l'étape sélectionnée
Variables : les Input Variables, disponibles avant l'exécution, et les Output Variables, mises à jour ou créées par l'exécution
La liste des étapes
Chaque étape de la liste affiche son type, son nom et la même icône que dans le Bot Builder.
Durées : chaque étape indique le temps qu'elle a pris. La durée totale de l'exécution s'affiche en haut. Les étapes les plus lentes sont mises en évidence.
Filter steps : saisissez un mot pour n'afficher que les étapes correspondantes
Errors : cliquez sur Errors pour n'afficher que les étapes en échec
Clavier : utilisez les flèches haut et bas pour passer d'une étape à l'autre
Le détail d'une étape
Quand vous sélectionnez une étape, son détail s'ouvre à droite, dans une vue mise en forme selon le type d'étape. Chaque section peut être repliée, et la barre d'outils en haut propose ces actions :
Search in this step (Ctrl+F) : cherchez un mot ou une phrase dans l'étape. Les textes longs, comme un prompt ou une réponse d'API, ont aussi leur propre recherche.
Open this step in the Bot Builder : ouvre l'étape dans un nouvel onglet
Expand all sections / Collapse all sections
View raw JSON : affiche toutes les données de l'étape, telles que la plateforme les a enregistrées. Cliquez de nouveau sur le bouton pour revenir à la vue mise en forme.
Chaque section, et la plupart des champs, ont un bouton de copie.
Ce que montre chaque étape
User input
Le message envoyé par le visiteur, et son contexte au moment de l'envoi :
Message : ce que le visiteur a écrit
Channel : le type de canal, sa langue et un lien vers ses réglages
On the site : la page en cours, l'URL de départ, le nombre de pages vues et le temps passé sur le site
Device : le navigateur, le système d'exploitation, la langue du navigateur et l'heure locale
Survolez l'icône (i) à côté d'un champ pour savoir ce qu'il signifie. Les champs vides sont masqués.
Intent detection
Le message analysé, l'intention détectée, les intentions évaluées et les entités détectées.
Generate with AI
Output : la réponse générée par le modèle. Une réponse JSON s'affiche champ par champ.
User prompt et System prompt : les prompts envoyés au modèle
Tools : les outils disponibles pour l'étape, avec le nombre d'outils appelés (par exemple 2/4). Pour chaque outil appelé, vous voyez son Input et son Output. L'input liste les valeurs que le modèle a remplies à partir de la conversation et les variables de plateforme résolues par la plateforme. Cliquez sur le nom de l'outil pour ouvrir sa configuration. Les outils qui n'ont pas été appelés sont marqués Not called.
Context sent to the model : l'historique de conversation reçu par le modèle
Output schema : la structure attendue d'une réponse JSON, quand l'étape en utilise une
Configuration : la version du prompt et les réglages de l'étape
Louis AI
Answer : la réponse de Louis, et les documents que Louis a cités pour répondre (Cited by Louis). Cliquez sur le titre d'un document pour l'ouvrir dans la base de connaissances.
Reasoning : comment Louis a construit sa réponse
Question : la question du visiteur, et la question telle que Louis l'a reformulée pour chercher dans la base de connaissances
Knowledge given to Louis to answer : les extraits de documents reçus par Louis, regroupés par document
Guidelines : les guidelines actives pour cette réponse
Risk level : Low, Medium ou High. Survolez le badge pour voir ce que signifie chaque niveau.
Condition
Result : le chemin pris par le bot, et pourquoi
Conditions checked : chaque chemin, avec ses conditions écrites en langage clair et la valeur réelle de chaque variable pendant la conversation (actual value). Chaque chemin est marqué True ou Not true, et le chemin pris par le bot est marqué Taken. Le bot prend le premier chemin vrai. Si aucun ne l'est, il utilise l'option par défaut.
API call
Request sent : la méthode, l'URL, les en-têtes et le corps. Les en-têtes d'authentification sont masqués : cliquez sur l'icône en forme d'œil pour les afficher. Cliquez sur Copy as cURL pour rejouer la requête depuis un terminal.
Response received : le statut, la durée et le corps de la réponse
Saved to variables : les variables extraites de la réponse. Une variable marquée nothing found signifie que la réponse ne contenait pas le champ attendu.
Quand l'appel échoue, l'étape l'indique en haut et rappelle que rien n'a été enregistré dans les variables.
Data manipulation
Variables in : les variables lues par l'étape, avec leur valeur au début de l'étape
Variables out : les variables écrites par l'étape. Quand une valeur a changé, l'ancienne valeur s'affiche à côté de la nouvelle. Une variable déclarée mais non renseignée est signalée, car les étapes qui la liront ensuite n'obtiendront rien.
Autres étapes
Go to use case : le use case vers lequel la conversation a été redirigée
User input (question posée par le bot) : ce que le visiteur a répondu, et les variables écrites à partir de sa réponse
Answer : la réponse envoyée au visiteur
Erreurs
Quand une étape échoue, la trace ajoute une étape Error. Elle affiche What went wrong : la raison, quand la plateforme en a enregistré une, et The visitor received : le message envoyé au visiteur. Un bandeau indique l'étape qui a échoué. Cliquez sur View the failing step pour y aller.
Variables
Partout où la trace affiche une variable, elle indique sa valeur, son type et l'origine de cette valeur :
Filled by the model from the conversation : remplie par le modèle à partir de la conversation
Resolved by the platform, the model did not choose it : résolue par la plateforme, sans choix du modèle
Extracted from the API response : extraite de la réponse de l'API
Written from the visitor's answer : écrite à partir de la réponse du visiteur
Created by this step ou Written by this step : créée ou écrite par l'étape
L'onglet Variables affiche les Input Variables, disponibles avant l'exécution, et les Output Variables, mises à jour ou créées par l'exécution.
Les Input Variables regroupent vos variables système et vos variables de canal utilisateur, comme un identifiant client envoyé par votre site. Une variable de canal utilisateur envoyée sur un message précédent reste affichée, car la trace liste les valeurs enregistrées pour le client.
Copier la trace complète
Cliquez sur Copy full trace, en bas de la trace, pour copier la trace complète. Chaque section et chaque étape sont commentées : vous pouvez la coller dans un assistant IA pour lui demander d'expliquer une réponse ou de trouver un bug, ou la joindre à une demande de support.
⚠️ La trace copiée contient les données brutes La trace copiée inclut toutes les valeurs enregistrées pendant l'exécution, y compris les en-têtes d'authentification et les données personnelles. Ne la collez que dans des outils de confiance.