Visualiser le raisonnement
En bref
Observez etape par etape comment votre agent raisonne, quels outils il mobilise et comment il construit sa reponse finale.
Avant de commencer
- Votre agent a ete execute au moins une fois. Voir Tester et evaluer.
- Recommande : avoir une session en cours ou recemment terminee pour explorer le visualiseur avec des donnees reelles.
Etapes
1. Acceder au visualiseur
Depuis le Hub de monitoring, cliquez sur la carte d'une session pour ouvrir le visualiseur avec cette session pre-chargee.
Vous pouvez aussi acceder directement au visualiseur via l'URL /agent-visualizer. Pour charger une session specifique, ajoutez le parametre ?sessionId=xxx a l'URL.
2. Comprendre le canvas
Le visualiseur affiche un canvas sur fond sombre representant le parcours de raisonnement de l'agent.
A gauche : le noeud principal de l'agent affiche le nom de l'agent, l'identifiant de session, le statut d'execution, le compteur d'iterations, les outils connectes et le modele utilise.
A droite : les etapes de raisonnement sont disposees verticalement dans l'ordre d'execution :
| Etape | Role |
|---|---|
| parse | Analyse la question de l'utilisateur |
| plan | Determine la strategie de resolution |
| execute | Lance les outils necessaires |
| evaluate | Verifie les resultats obtenus |
| synthesize | Formule la reponse finale |
| trace | Enregistre la trace complete de l'execution |
Chaque etape affiche un indicateur de statut :
- Vert : etape terminee avec succes
- Bleu (halo) : etape en cours de traitement
- Gris : etape en attente
Sous les etapes : les noeuds d'execution individuels detaillent chaque appel d'outil avec son nom, son statut et sa duree.
3. Selectionner une session
Le panneau Historique des sessions (en bas du canvas) liste les sessions recentes avec leur horodatage, leur statut et le nom de l'agent.
Cliquez sur une session pour charger son parcours de raisonnement dans le canvas.
4. Suivre une execution en temps reel
Lorsqu'une session est en cours, le canvas se met a jour au fur et a mesure que l'agent progresse dans ses etapes.
Utilisez le bouton Suivi automatique pour centrer automatiquement le canvas sur le noeud actif. Ce mode est utile pour ne pas perdre de vue l'etape en cours pendant une execution longue.
5. Consulter les statistiques
Le panneau de statistiques (en bas a gauche) affiche :
- Barre de progression : avancement global de l'execution
- Statistiques de taches : nombre de taches planifiees, en cours et terminees
- Consommation de tokens : nombre de tokens utilises pour la session
Le panneau de legende (en haut a gauche) rappelle la signification des couleurs et des statuts affiches sur le canvas.
Resultat attendu
Vous comprenez le parcours de raisonnement de votre agent etape par etape. Vous pouvez identifier a quel moment un outil a ete appele, combien de temps chaque etape a pris, et ou se situent les eventuels points de blocage.
Limites et erreurs frequentes
- Le canvas utilise un theme sombre. Si la lisibilite est insuffisante, ajustez la luminosite de votre ecran.
- Pour les sessions comportant un grand nombre de taches, utilisez la minimap et les controles de zoom pour naviguer efficacement.
- Si aucune session ne s'affiche, verifiez que votre agent a bien ete execute au moins une fois depuis Tester et evaluer.
Prochaines etapes
- Configurer les outils : ajustez les outils de votre agent en fonction des observations du visualiseur.
- Tester et evaluer : relancez des tests apres vos ajustements.
Besoin d'aide ?
Ecrivez-nous : Support et contact.