Vue de l’activité de l’agent - Weights & Biases Documentation

La vue Agents vous donne un enregistrement, tour par tour, de chaque conversation menée par votre agent, ainsi que de l’utilisation des jetons, des invocations d’outils et des spans d’exécution. Les applications d’agents sont difficiles à déboguer, car le comportement intéressant se produit entre la requête de l’utilisateur et la réponse finale. La vue Agents dans W&B Weave rend cette couche intermédiaire visible. Chaque conversation menée par votre agent est capturée ici, avec l’historique complet des messages, les détails d’exécution au niveau des spans et les coûts en jetons associés. Vous pouvez voir d’un coup d’œil si un agent a mené sa tâche à bien, combien d’appels d’outil il a effectués, et où le temps ou le budget ont été dépensés. Pour les équipes qui créent des agents et les font évoluer de manière itérative, c’est le point de départ pour comprendre le comportement en production.

Premiers pas

Pour ouvrir la vue Agents de votre projet :

Accédez à https://wandb.ai et sélectionnez votre projet.
Dans le menu latéral, sélectionnez Agents pour afficher toutes les conversations d’agents enregistrées dans votre projet.

La vue Agents est organisée en une rangée d’onglets en haut : Dashboard, Agents, Conversations, Spans et Signals. L’onglet Dashboard offre un aperçu de l’activité des agents à l’échelle du projet, tandis que les autres onglets vous permettent d’examiner en détail les agents, conversations, spans et signaux individuels.

Onglet Dashboard

L’onglet Dashboard offre un aperçu, à l’échelle du projet, de toute l’activité des agents. Il est conçu pour être lu d’un coup d’œil. Les équipes l’utilisent donc comme point de départ pour un contrôle de santé quotidien avant d’examiner en détail un agent ou une conversation en particulier.

En haut, des cartes de synthèse indiquent les totaux pour la fenêtre temporelle sélectionnée : Spans, Conversations, Tokens, Cost, Error rate et Agents. Sous les cartes, des graphiques en série temporelle montrent au fil du temps le volume des spans, des conversations, des jetons et du coût, ainsi que le nombre d’erreurs et l’activité des signaux. La rangée du bas présente la répartition des principaux outils, agents, modèles et fournisseurs par utilisation. À gauche, une liste des conversations ou des spans récents s’affiche, avec la possibilité de basculer entre Conversations et Spans ; le sélecteur de fenêtre temporelle contrôle la période reflétée dans chaque panneau.

Onglet Agents

L’onglet Agents vous offre une vue d’ensemble de tous les agents qui ont enregistré des traces dans ce projet. Utilisez-le pour repérer les agents actifs et comparer la latence et les taux d’erreur d’un agent à l’autre. Il vous aide également à identifier ceux qui nécessitent une attention particulière avant d’examiner les conversations individuelles.

Il est utile dans des scénarios tels que :

Surveiller une flotte d’agents. La grille de cartes vous permet de comparer la latence et le taux d’erreur de tous les agents en un coup d’œil, sans ouvrir chaque conversation. Un pic de latence ou un taux d’erreur qui passe au rouge sur une carte signale une régression qui mérite d’être examinée.
Identifier des agents inactifs. Le tri par Dernière activité met en évidence les agents qui n’ont pas enregistré d’activité récemment. Cela est utile pour confirmer qu’un déploiement est bien en ligne ou pour repérer des agents qui ont pu cesser de journaliser des traces de façon inattendue.
Comparer les versions. Le nombre de versions sur chaque carte indique combien de versions distinctes de cet agent ont été déployées. Un nombre élevé de versions, associé à une hausse du taux d’erreur, peut indiquer une régression introduite dans un déploiement récent.
Examiner un agent. Cliquez sur n’importe quelle carte pour ouvrir le panneau de détail de cet agent, depuis lequel vous pouvez accéder à ses conversations ou à ses spans :

Une carte d’agent sélectionnée dans l’onglet Agents, avec le panneau de détail ouvert à droite affichant les métadonnées de l’agent et les options de navigation.

Cartes des agents

Chaque agent est représenté par une carte indiquant :

Champ	Description
Nom de l’agent	Le nom enregistré avec les traces de l’agent.
Dernière activité	Le temps écoulé depuis la dernière activité enregistrée par l’agent.
Version	Le nombre de valeurs `agent_version` distinctes enregistrées dans les spans de l’agent.
Histogramme d’activité	Un graphique en barres du volume récent de conversations, qui donne un aperçu rapide des tendances d’utilisation.
Conversations	Nombre total de conversations enregistrées.
Spans	Nombre total de spans enregistrés dans l’ensemble des conversations.
Coût	Coût total engagé dans l’ensemble des conversations de l’agent. Affiche un tiret (`-`) lorsque les données de coût ne sont pas disponibles.
Latence (moy.)	Durée de bout en bout moyenne par invocation.
Taux d’erreur	Pourcentage d’invocations ayant renvoyé une erreur. S’affiche en rouge lorsqu’il est supérieur à 0 %.

Trouver et trier les agents

Utilisez le champ Recherche et filtrage des agents pour trouver des agents par nom. Utilisez la liste déroulante de tri (par défaut : Dernière activité) pour réorganiser la grille. Les options de tri disponibles sont :

Dernière activité : les agents actifs le plus récemment s’affichent en premier.
Le plus d’invocations : le volume de conversations le plus élevé s’affiche en premier.
Le plus de jetons d’entrée : la consommation de jetons la plus élevée s’affiche en premier.
Le plus d’erreurs : le nombre d’erreurs le plus élevé s’affiche en premier.

Le tri par Le plus d’erreurs est utile pour un contrôle de santé quotidien rapide : les agents avec un taux d’erreur non nul apparaissent immédiatement, et le taux d’erreur en rouge sur la carte permet de repérer d’un coup d’œil ceux qui nécessitent un examen plus approfondi.

Onglet Conversations

L’onglet Conversations de la page Agents vous permet de parcourir, filtrer et inspecter les exécutions individuelles d’agent. Utilisez-le pour analyser les échecs, évaluer les coûts en jetons et comprendre la séquence des appels LLM et des exécutions d’outils qui constituent une exécution. Pour obtenir une vue d’ensemble de ce qu’un agent a dit et fait au fil d’une conversation, commencez par l’onglet Conversations.

Tableau des conversations

Le tableau des conversations affiche une ligne par conversation. Les colonnes suivantes s’affichent par défaut :

Colonne	Description
Conversation	L’identifiant de la conversation et un aperçu du premier message.
Dernier message	Un aperçu du message le plus récent, avec un indicateur de rôle.
Spans	Nombre total de spans enregistrés, affiché à côté d’une bande colorée (décrite ci-dessous). Un nombre de spans plus élevé indique davantage de branchements ou d’utilisation d’outils.
Tags	Les tags de signal et les scores appliqués à la conversation.
Agent	Le nom du ou des agents impliqués.
Invocations	Le nombre de fois où l’agent a été invoqué pendant la conversation.
Jetons d’entrée	Jetons d’entrée consommés.
Jetons de sortie	Jetons de sortie générés.
Coût	Coût total de la conversation.
Début	Le moment où la conversation a commencé.
Dernière activité	Le temps écoulé depuis l’enregistrement du dernier message.

La colonne Spans affiche également une bande colorée qui donne un aperçu de la séquence d’événements de la conversation, en utilisant les mêmes couleurs d’événement que la chronologie des événements. Cela vous permet de voir d’un coup d’œil, sans l’ouvrir, si une conversation faisait un usage intensif des outils, du LLM, ou impliquait une délégation à un sous-agent. Pour afficher ou masquer des colonnes supplémentaires, cliquez sur colonne dans la barre d’outils.

Filtres et fenêtre temporelle

Utilisez la barre de Filtre pour affiner les résultats par agent, modèle, statut d’erreur ou autres attributs. Les attributs personnalisés que vous ajoutez aux spans d’agent avec le SDK peuvent également être filtrés ici. Vous pouvez filtrer la liste des conversations sur une valeur précise pour un attribut donné. Pour afficher un attribut personnalisé dans sa propre colonne, cliquez sur colonne dans la barre d’outils. Pour savoir comment définir ces attributs, voir Définir des attributs et des events sur les spans d’agent. Utilisez le sélecteur de fenêtre temporelle (1m, 1h, 6h, 24h, 7d, ou 30d) pour limiter la liste aux conversations actives au cours de cette période. L’histogramme du volume de conversations au-dessus de la liste se met à jour en fonction de la fenêtre sélectionnée. Survolez l’en-tête de n’importe quelle colonne dans la liste des conversations pour filtrer cette colonne selon une valeur ou une plage spécifique.

Détail d’une conversation d’agent

Cliquez sur une ligne de conversation pour ouvrir un panneau de détail avec deux sous-panneaux : Tours de conversation et Événements. L’en-tête du panneau affiche le nom de l’agent et l’ID de la conversation, ainsi que les actions Summarize (pour générer une synthèse de la conversation) et Add to dataset.

Une conversation sélectionnée dans l’onglet Conversations, avec le panneau de détail ouvert affichant le fil des messages tour par tour, les appels d’outil, le raisonnement et la chronologie des événements à droite.

Tours de conversation

Dans le détail de la conversation, le panneau des tours de conversation affiche chaque tour dans l’ordre chronologique, numéroté à partir de 1. Chaque tour de conversation affiche le nombre de réponses intermédiaires et d’appels d’outil, ainsi que la durée totale écoulée. Développez un tour de conversation pour voir le fil de messages complet.

Messages

Au sein d’un tour de conversation, les messages sont regroupés par rôle. Les messages utilisateur affichent le texte du message ainsi que tous les médias ou références de contenu joints. Les messages de l’assistant affichent les éléments suivants :

Le nom de l’agent et le modèle utilisé (par exemple, gpt-5.5-2026-04-23).
L’horodatage et la durée.
Le nombre de jetons en entrée et en sortie, ainsi que le coût (par exemple, 18823 in · 96 out · $0.0717).
Une section Raisonnement dépliable lorsque le modèle a utilisé un raisonnement approfondi.
Le texte de la réponse, qui se replie automatiquement pour les réponses longues.

Les appels d’outil affichent le nom de l’outil, l’horodatage et la durée. Si des données d’arguments ou de résultat sont disponibles, l’appel d’outil est dépliable et affiche Args et Result dans un tableau de paires clé-valeur. Si l’appel a échoué, un badge ERROR apparaît.

États d’erreur

Lorsqu’un appel d’outil renvoie un statut d’erreur, un badge rouge ERROR apparaît à côté, en ligne. Dans la chronologie des événements, cet événement s’affiche également en rouge, quel que soit son type.

Events

Le panneau Événements à droite affiche une bande colorée qui représente la séquence des événements au sein du tour de conversation sélectionné. Dans la chronologie Événements, la couleur de chaque segment indique le type d’événement.

Couleur	Type d’événement
Violet	Message utilisateur
Vert	Message de l’assistant
Bleu	Appel d’outil
Terre de Sienne	Invocation d’un sous-agent
Magenta	Transfert entre agents
Gris	Compactage du contexte
Rouge	Tout événement ayant renvoyé une erreur

Utilisez la chronologie du panneau Événements pour vous faire rapidement une idée de la structure d’un tour de conversation. Par exemple, vous pouvez voir s’il reposait surtout sur le LLM, surtout sur les outils, ou s’il impliquait une délégation à un sous-agent avant de lire le fil complet des messages.

Scores

Si des signaux sont actifs pour le projet, une section Scores fournit des métriques sur la conversation. Elle affiche le nom du scorer du signal, une note numérique globale de 0 à 1, un pourcentage de confiance, ainsi que les différents points de la grille d’évaluation qui ont contribué au score. Chaque point de la grille affiche également son propre niveau de confiance. Utilisez ces informations pour comprendre non seulement si un tour de conversation a obtenu un bon score, mais aussi quels critères précis de la grille ont été validés ou non.

Synthèse des métadonnées

La section Synthèse des métadonnées affiche des statistiques agrégées sur la conversation sélectionnée.

Champ	Description
Jetons	Nombre total de jetons d’entrée et de sortie.
Coût	Coût total de la conversation.
Appels d’outils	Nombre d’appels d’outils sur l’ensemble des tours de conversation.
Messages	Nombre total de messages.
Durée de la conversation	Durée écoulée entre le premier et le dernier message.
Page des tours de conversation	Tours de conversation actuellement affichés et nombre total de tours de conversation.

Répartition des jetons

La section Répartition des jetons affiche les détails du cache et du raisonnement pour la conversation sélectionnée.

Champ	Description
Lecture du cache	Jetons issus du cache de prompt.
Écriture dans le cache	Jetons écrits dans le cache de prompt.
Taux de succès du cache	Pourcentage des jetons d’entrée issus du cache. Un taux plus élevé réduit le coût et la latence.
Raisonnement	Jetons consacrés à un raisonnement approfondi.
Ratio de raisonnement	Pourcentage des jetons de sortie consacrés à un raisonnement approfondi.

Participants

La section Participants répertorie les agents et les modèles impliqués dans la conversation. Dans les conversations multi-agent, des tours de conversation différents peuvent afficher différents noms de modèle ici.

Ajouter des messages d’agent à un dataset

Pour ajouter des messages d’agent à un Dataset :

Dans l’en-tête du panneau de détails de la conversation, cliquez sur Add to dataset pour ouvrir le volet latéral Add example to dataset.
Dans Choisir un dataset, utilisez le menu déroulant pour choisir le dataset auquel vous souhaitez ajouter des traces.
Dans Select context, sélectionnez les messages à ajouter au dataset. Cliquez sur Next.
Vérifiez votre sélection, puis cliquez sur Add to dataset.

Onglet Spans

L’onglet Spans affiche chaque span individuel enregistré dans l’ensemble de l’activité des agents du projet. L’onglet Conversations regroupe l’activité en lignes au niveau du dialogue. L’onglet Spans montre les opérations brutes sous-jacentes : chaque appel au LLM, chaque exécution d’outil et chaque invocation d’agent sur une ligne distincte. Utilisez-le pour identifier précisément quel appel a été lent, quel modèle a consommé un nombre inattendu de jetons ou quelle invocation d’outil a échoué.

Tableau des spans

Le tableau des spans partage la plupart de ses colonnes avec le tableau Conversations (agent, modèle, outil, nombre de jetons, statut). Certaines colonnes propres à cette vue sont :

Colonne	Description
Span	Le nom et l’ID du span, avec son ID de trace en dessous.
Kind	Le type de span OpenTelemetry pour cette opération (par exemple `INTERNAL`, `SERVER` ou `CLIENT`).
Operation	Le type d’opération (par exemple `chat`, `execute_tool` ou `invoke_agent`).
Ratings & Tags	Les scores de signal et les tags appliqués au span.
Finish	La raison de fin renvoyée par le modèle (par exemple `stop` ou `max_tokens`). Cette colonne n’est renseignée que pour les spans `chat` lorsque le modèle indique une raison de fin.
Error type	Le type d’erreur renvoyé par le span, lorsqu’une erreur s’est produite.

Des colonnes supplémentaires pour le détail des jetons de cache, les jetons de raisonnement, les paramètres LLM et les métadonnées de run W&B sont disponibles via le bouton colonne. L’onglet Spans est particulièrement utile lorsque vous avez besoin d’une précision au niveau des opérations que l’onglet Conversations ne fournit pas :

Identifier les appels coûteux. Triez par jetons In ou Out pour trouver quels appels LLM individuels génèrent les coûts, au lieu d’afficher uniquement des totaux au niveau de la conversation.
Déboguer un type d’opération spécifique. Filtrez par Operation pour isoler tous les spans execute_tool et vérifier les taux d’erreur, ou tous les spans chat pour un modèle spécifique.
Examiner la troncature. Filtrez Finish sur max_tokens pour trouver les spans où le modèle a atteint sa limite de jetons au lieu de se terminer normalement.
Établir une corrélation avec un run W&B. Des colonnes masquées par défaut exposent les ID de run W&B et les étapes du run, ce qui vous permet de relier un span spécifique à un run d’entraînement ou d’évaluation dans W&B.

Groupes de traces

Cliquez sur n’importe quelle ligne pour sélectionner la trace correspondante et mettre en surbrillance tous les autres spans qui partagent le même ID de trace. Cela vous montre l’ensemble des opérations exécutées dans le cadre d’une invocation d’un agent. Le regroupement s’effectue ici par trace, et non par conversation. Cela signifie qu’une même conversation peut contenir plusieurs traces si elle implique une délégation à un sous-agent.

Détail de l’appel d’agent

Cliquez sur une ligne du tableau Spans pour ouvrir un panneau de détail contenant les données de l’appel d’agent complet. En haut du panneau de détail, un graphique à barres montre la position sur l’axe du temps et la durée relative de chaque span dans la trace sélectionnée, sous forme de cascade. L’appel parent s’étend sur toute la largeur, et chaque span enfant apparaît en dessous sous la forme d’une barre colorée mise à l’échelle selon sa durée réelle, positionnée à son heure de début en millisecondes à partir du début de la trace. Utilisez la chronologie pour :

Repérer l’opération la plus longue en un coup d’œil. Les barres larges indiquent les spans qui ont le plus contribué à la latence totale.
Voir le parallélisme. Les barres qui se chevauchent indiquent des spans exécutés en parallèle plutôt que séquentiellement.
Inspecter n’importe quel span directement. Cliquez sur une barre de la chronologie pour charger les détails de ce span dans la vue, y compris ses messages d’entrée et de sortie, le nombre de jetons et d’autres métadonnées.

L’onglet Spans avec une trace sélectionnée, mettant en évidence un groupe de spans liés dans le tableau et affichant le graphique en cascade dans le panneau de détail à droite.

Vous pouvez également afficher les spans enfants sous la forme d’une arborescence de trace hiérarchique en sélectionnant l’icône Show trace tree dans l’en-tête du panneau de détail.

Onglet Signals

L’onglet Signals affiche les tags et les scores des conversations de votre agent. Les signaux font ressortir les problèmes de qualité et de sécurité afin de signaler les incidents, de repérer des tendances et de mettre en évidence les traces qui nécessitent votre attention. Utilisez les signaux pour évaluer automatiquement la qualité des réponses de votre agent, détecter quand un utilisateur est frustré ou signaler du contenu NSFW. Pour la configuration et l’utilisation détaillée, voir Surveillez vos agents avec des signaux.

​Premiers pas

​Onglet Dashboard

​Onglet Agents

​Cartes des agents

​Trouver et trier les agents

​Onglet Conversations

​Tableau des conversations

​Filtres et fenêtre temporelle

​Détail d’une conversation d’agent

​Tours de conversation