02 Tracing

Le contenu du workshop est maintenu dans le dépôt public langfuse/langfuse-workshop. Utilisez ce dépôt pour exécuter l’application, accéder aux branches de checkpoint et effectuer la configuration locale.

Afficher ce fichier Markdown

Guide du participant : 02 Tracing

Notes pour le formateur

• Présentez la progression en trois couches visibles : generations OpenAI, racine unique de l’agent, puis observations des outils.
• Gardez des modifications petites et locales. L’objectif est de montrer que Langfuse enveloppe les limites existantes de l’application sans imposer une réécriture de l’architecture.
• La propagation utilisateur/session est facultative pendant la démonstration, mais les checkpoints suivants l’incluent afin que les chapitres ultérieurs disposent de l’attribution.

Rythme de la démonstration

1. Ajoutez LangfuseSpanProcessor et observeOpenAI, exécutez un tour et montrez les traces de generation séparés.
2. Enveloppez runSupportConversationInner avec observe(...), exécutez à nouveau et montrez les generations imbriquées.
3. Enveloppez les deux fonctions d’outils locales, relancez et montrez l’arbre complet.

Points d’attention

• Un conteneur parent parfois vide autour de dad-it-support-chat-turn juste après l’Étape 2. Actualisez une fois avant de conclure à un bug ; s’il persiste à chaque tour, recherchez des wrappers de tracing supplémentaires au-delà de l’unique observe(...) de la leçon.
• Les participants qui enveloppent le client OpenAI dans une factory séparée. Le workshop garde volontairement le wrapper inline.
• Les participants qui collent le bloc de l’Étape 3 au-dessus du executeTool existant au lieu de le remplacer. Le serveur s’arrête avec Multiple exports with the same name "executeTool" ; l’ancienne copie se trouve plus bas dans tools.ts.
• L’absence de flush à l’arrêt dans index.ts ; sans lui, les traces peuvent arriver en retard.