Surveillance des sessions et des traces de l'agent

Vue d'ensemble

Sessions & Inbox offre un espace d'observabilité centralisé pour consulter l'historique des conversations, les interactions utilisateurs, la consommation de crédits et les traces d'exécution d'un agent spécifique.

Il relie les échanges généraux de chat aux étapes techniques sous-jacentes, vous permettant d'auditer les interactions, d'analyser les étapes de raisonnement et de résoudre les requêtes en échec sur l'ensemble des canaux de déploiement.

Prérequis

• Vous devez être le propriétaire de l'agent ou disposer des droits d'administrateur avec accès en modification sur l'agent.

• L'agent doit être configuré et avoir enregistré des interactions sur au moins un canal.

Guide étape par étape

1. Accéder à Sessions & inbox

1. Dans la barre latérale gauche de votre espace de travail, cliquez sur Agents et sélectionnez l'agent souhaité.

2. Dans le volet de configuration de l'agent, faites défiler jusqu'à la section Observabilité et cliquez sur Sessions & Inbox.
   

   

3. La vue principale de Sessions & Inbox affiche la liste des conversations de votre agent avec des colonnes pour le statut, le canal, l'utilisateur, le titre de la conversation, l'horodatage et les crédits IA consommés.
   

   

2. Rechercher et filtrer les sessions

1. Dans la barre de recherche en haut à gauche, saisissez un nom d'utilisateur, une adresse e-mail ou un mot-clé du titre pour filtrer instantanément les sessions.

2. Cliquez sur le menu déroulant des canaux (défini sur All channels par défaut) pour filtrer les échanges selon leur point d'accès, comme Agent as App, API, Widget, Mobile, Desktop ou Trigger.
   

   

3. Cliquez sur le menu déroulant des dates (défini sur All par défaut) pour restreindre l'affichage à Today, This Week, This Month, ou choisissez Custom Period pour sélectionner une plage de dates personnalisée.
   

   

3. Filtrer par erreurs d'exécution

1. Repérez le bouton à bascule Errors Only dans la barre d'outils supérieure, situé à côté du bouton d'actualisation.

2. Activez le bouton pour n'afficher que les conversations ayant rencontré une défaillance d'exécution. Le badge numérique indique le nombre total de sessions concernées.

4. Inspecter la conversation et les traces de session

1. Cliquez sur une ligne du tableau pour ouvrir le panneau latéral détaillé à droite de l'écran.

2. Dans l'onglet Conversation, consultez la transcription complète en lecture seule entre l'utilisateur et l'agent, comprenant les résumés de réflexion, les crédits consommés et le modèle LLM actif.
   

   

3. Basculez sur l'onglet Logs & Errors pour inspecter la trace d'exécution chronologique, incluant le démarrage de la session, les messages de l'utilisateur, les étapes de réflexion internes et les réponses de l'agent.
   

   

4. En cas de dysfonctionnement, examinez la carte d'erreur mise en évidence et le badge d'erreur (tel que OUT_OF_CREDITS) pour diagnostiquer la cause exacte du problème.
   

   

5. Exporter l'historique des sessions en CSV

1. Définissez vos critères de recherche, vos filtres de canaux ou vos plages de dates.

2. Cliquez sur l'icône Export (bac de téléchargement) située en haut à droite du tableau, à côté du bouton d'actualisation.

3. Les enregistrements de session filtrés sont immédiatement téléchargés sur votre appareil sous la forme d'un fichier CSV.

Cas d'usage pratiques

• Résoudre un bug signalé par un utilisateur : Retrouvez une conversation signalée en recherchant le nom de l'utilisateur, ouvrez le volet de session et analysez la séquence exacte de prompts et de réponses.

• Auditer l'adoption multicanale : Filtrez les sessions par canal (par exemple Widget vs API) pour évaluer les points d'entrée les plus utilisés et comparer la consommation de jetons.

• Diagnostiquer l'épuisement des crédits : Activez le filtre Errors Only, repérez les interactions interrompues par OUT_OF_CREDITS, et inspectez la dépense en crédits par échange pour ajuster le modèle ou raccourcir le prompt.

Conseils et bonnes pratiques

• Utilisez le bouton d'actualisation situé à côté de l'icône d'export pour récupérer les nouvelles conversations sans recharger la page du navigateur.

• Analysez les étapes de réflexion dans l'onglet Logs & Errors pour vérifier que l'agent respecte bien les instructions complexes et les règles de raisonnement.

• Combinez les filtres de canal et de date avant d'exporter afin de générer des rapports ciblés pour vos audits internes ou revues d'équipe.

Dépannage

• Aucune session n'apparaît dans la liste :

• Cause : Les filtres de recherche ou de période excluent les conversations actuelles, ou l'agent n'a pas encore reçu de messages.

• Solution : Réinitialisez les filtres sur « All », effacez la barre de recherche et cliquez sur le bouton d'actualisation.

• La section Observabilité est invisible :

• Cause : Votre compte utilisateur ne dispose pas des droits de modification de l'agent ou du rôle administrateur.

• Solution : Demandez au propriétaire de l'agent ou à l'administrateur de l'espace de travail de vous accorder l'accès en modification.

• Le bouton d'export ne télécharge aucune donnée :

• Cause : Les filtres actifs renvoient 0 session correspondante.

• Solution : Assurez-vous qu'au moins une ligne est visible dans le tableau avant de cliquer sur l'icône d'export.

Ressources supplémentaires

• Analytique de l'agent

• Lock agent

• Créer une automatisation avec des agents