Cette release permet à vos AI tools d'envoyer les variables de votre bot à vos API, pour que les valeurs qui comptent arrivent jusqu'à vos systèmes exactement telles qu'elles sont. Elle refond aussi la trace, pour que vous compreniez pourquoi votre bot a répondu ainsi sans avoir à lire du JSON brut.
Utiliser les variables de votre bot dans les AI tools
Vos AI tools peuvent désormais envoyer les variables de votre bot à vos API. Dans l'étape API connection d'un AI tool, ouvrez le sélecteur de variables dans l'URL, un header ou le body. À côté des données saisies collectées par l'IA, un nouveau groupe Platform variables liste vos variables custom, user channel et system. Quand l'outil s'exécute, chacune est remplacée par sa valeur dans la conversation en cours.
Des valeurs que l'IA ne peut pas modifier : l'IA ne choisit pas ces valeurs, donc un identifiant client envoyé par votre site, la langue de la conversation ou une catégorie de client définie plus tôt dans le flow arrive à votre API exactement telle quelle
Partout dans la requête : utilisez-les dans l'URL, les headers, le body, et dans la configuration de vos jetons d'authentification
Faciles à repérer : chaque variable apparaît sous forme de badge coloré, avec une couleur par catégorie
Testables : l'étape Test response demande une valeur de test pour chaque variable de plateforme utilisée par l'outil
La trace montre ce que chaque appel d'outil a reçu : les valeurs remplies par l'IA à partir de la conversation, et celles résolues par la plateforme.
Une vue formatée pour chaque étape de la trace
Chaque étape affiche désormais ce qui compte, en langage clair. Quand vous ouvrez une étape, la trace affiche une vue formatée conçue pour ce type d'étape. Le JSON brut reste disponible via le bouton View raw JSON en haut à droite.
User input : le message tapé par le visiteur, le canal, la page sur laquelle il se trouvait, son temps passé sur le site et son appareil
Generate with AI : le résultat, le prompt utilisateur, les outils appelés par le modèle avec leur entrée et leur réponse, le system prompt, le contexte envoyé au modèle et la configuration
Louis AI : la réponse, les documents cités par Louis, son raisonnement, la question telle que Louis l'a reformulée, la connaissance qui lui a été fournie et les guidelines suivies
Condition : le chemin emprunté par le bot et pourquoi, chaque condition étant écrite en langage clair à côté de la valeur réelle de la variable
API call : la requête envoyée, la réponse reçue et les variables enregistrées à partir de celle-ci, avec un bouton Copy as cURL
Data manipulation : les variables entrantes et sortantes, avec un avertissement quand une variable déclarée n'a pas été définie
Trouver le problème plus vite
La trace vous mène directement à ce qui a mal tourné. Les étapes en échec sont signalées dans la liste, et une vue d'erreur explique ce qui s'est passé et ce que le visiteur a reçu.
Filtre Errors : n'afficher en un clic que les étapes qui ont échoué
L'étape fautive : quand le bot échoue, une bannière nomme l'étape à l'origine du problème et vous y amène
Durées des étapes : voyez combien de temps a pris chaque étape et la durée totale de l'exécution, avec les étapes les plus lentes mises en évidence
Recherche : trouvez un mot dans l'étape en cours, ou dans n'importe quel texte long comme un prompt ou une réponse d'API
Icônes des étapes : chaque étape utilise la même icône que dans le Bot Builder, pour la reconnaître d'un coup d'œil
Suivre vos variables
Voyez d'où vient chaque valeur et ce que chaque étape a changé. Les variables d'une étape affichent leur valeur, leur type et leur origine : remplie par le modèle, extraite d'une réponse d'API, écrite à partir de la réponse du visiteur ou définie par la plateforme. Quand une étape modifie une variable, la valeur précédente s'affiche à côté de la nouvelle.
Liens vers la configuration : ouvrez l'AI tool, le document de la knowledge base ou l'étape dans le Bot Builder dans un nouvel onglet, directement depuis la trace
Partager une trace avec un assistant IA
Copiez la trace entière en un clic. Le bouton Copy full trace copie la trace complète, organisée et commentée section par section, pour que vous puissiez la coller dans un assistant IA et lui demander d'expliquer une réponse ou de trouver un bug. Chaque section et chaque champ dispose aussi de son propre bouton de copie.
Aucune action requise
Les deux fonctionnalités sont disponibles dès maintenant pour tous les bots. Ouvrez Integrate > AI Tools pour ajouter des variables de plateforme à vos outils. Ouvrez la trace comme avant : dans le Bot Builder, cliquez sur Test, ouvrez l'Inspector et cliquez sur Access logs, ou cliquez sur Trace sur n'importe quelle conversation dans Conversations.
Pour plus de détails, consultez la documentation des AI Tools et la documentation Trace in Flow Builder.