Naviguer dans la Vue de trace de Weave

Utilisez la Vue de trace de Weave pour comprendre les chemins d’exécution complexes de vos applications LLM et agentiques.

La Vue de trace de Weave est conçue pour vous aider à comprendre les chemins d’exécution complexes de vos applications LLM et agentiques. Que vous déboguiez une application agentique avec des dizaines d’appels imbriqués ou que vous suiviez le flux d’une prédiction de modèle unique, la Vue de trace fournit une visualisation claire de ce qui s’est passé. Elle propose également d’autres façons d’afficher et de comprendre le flux de votre application.

Ce guide explique comment parcourir la pile de traces, filtrer et rechercher les fonctions appelées par votre code, passer d’une représentation visuelle à une autre, et plus encore.

​

Premiers pas

Pour accéder à la vue de trace :

1. Accédez à https://wandb.ai et sélectionnez votre projet.
2. Dans le menu latéral, sélectionnez Traces pour afficher toutes les traces enregistrées pour votre projet.
3. Sélectionnez une trace pour ouvrir la vue des détails de la trace. La vue des détails de la trace affiche des panneaux supplémentaires avec une décomposition hiérarchique de l’exécution de la trace.

​

Aperçu de la page Traces

La page Traces se compose de trois panneaux principaux :

• Panneau de gauche : Une liste triable et paginée de toutes les traces du projet.
  • Ce tableau des traces inclut des données supplémentaires, comme les tokens, le coût et la latence.
• Panneau central : Vue de trace interactive pour une trace sélectionnée. L’arborescence de trace affiche une hiérarchie de toutes les méthodes suivies dans la trace.
  • L’arborescence de trace affiche les ops, c’est-à-dire les fonctions décorées avec @weave.op(), qui ont été appelées au cours de la trace.
• Panneau de droite : Détails de l’op sélectionnée au sein de la trace sélectionnée.

​

Filtrer dans une trace

• Filtre regex par nom(s) : utilisez le champ de texte au-dessus de l’arborescence de trace pour filtrer les ops par nom ou par type, par exemple tool, openai.response.create.
• Métriques : choisissez d’afficher ou non les métriques suivantes lorsqu’elles sont disponibles : coût, tokens et latence.

​

Naviguer dans une trace

L’arborescence de trace affiche une hiérarchie de toutes les méthodes suivies dans la trace. Pour vous déplacer vers le haut ou le bas dans l’arborescence, utilisez Cmd (macOS) ou Alt (Windows/Linux) + flèche vers le haut (↑) / flèche vers le bas (↓).

Plusieurs curseurs se trouvent sous l’arborescence de trace et permettent de naviguer rapidement entre ses différents états. Vous pouvez utiliser les curseurs pour parcourir stratégiquement votre trace.

Développez le panneau pour voir tous les curseurs disponibles :

• Timeline : ordre chronologique des événements dans la trace.
• Peers : Ops partageant le même type. Par exemple, si vous examinez les détails d’une fonction appelée predict, vous pouvez utiliser ce curseur pour passer immédiatement à l’exécution suivante de predict dans la trace.
• Siblings : Ops ayant le même parent. Utilisez ce curseur pour parcourir les ops imbriquées sous l’appel de fonction parent.
• Stack : parcourez la pile d’appels vers le haut ou vers le bas.
• Path : (Disponible uniquement dans la vue de composition du code) parcourez tous les appels ayant le même chemin de code que l’appel sélectionné.

​

Vues alternatives de l’arborescence de trace

En haut du panneau, vous pouvez passer d’une représentation visuelle de l’arborescence de trace à une autre selon vos besoins. Passez d’une vue à l’autre en fonction de vos besoins de débogage. Utilisez la vue de composition du code pour comprendre la logique des appels, la vue flame graph pour comprendre les performances dans le temps, et la vue graphique pour comprendre la structure.

​

Traces (par défaut)

La vue par défaut de l’arborescence de trace affiche la hiérarchie de la pile d’appels, le coût par op (si disponible), le temps d’exécution et les indicateurs de statut.

​

Vue de composition du code

Dans la vue de composition du code, les encadrés représentent les ops et leurs appels imbriqués. Cela permet de visualiser le flux des appels de fonction. Dans cette vue, vous pouvez sélectionner un encadré pour examiner cet op plus en détail et filtrer le chemin d’appel.

​

Flame graph

La vue flame graph offre une visualisation chronologique de la profondeur et de la durée d’exécution. Elle est utile pour comprendre les diagnostics de performances dans le temps. Vous pouvez sélectionner des frames pour isoler des sous-traces.

​

Vue graphique

La vue graphique présente les relations hiérarchiques entre les ops. C’est utile pour comprendre les relations parent-enfant.

​

Afficher les détails d’un op de trace

Après avoir sélectionné un op dans l’arborescence de trace, les détails de cet op s’affichent dans le panneau suivant. Ces détails sont regroupés dans les onglets suivants :

• Appel : Les entrées et les sorties de l’exécution de l’op.
• Code : Le code utilisé lors de l’appel.
• Feedback : Tout feedback disponible pour l’op. Vous pouvez donner du feedback directement dans Weave ou via l’API.
• Scores : Tous les scores disponibles pour l’op. Les appels sont évalués en exécutant des évaluations.
• Résumé : Informations générales sur l’op.
• Utiliser: Des extraits de code que vous pouvez utiliser pour récupérer l’appel par programmation et ajouter des réactions, des notes ou du feedback.