02 Tracing

El material del workshop se mantiene en el repositorio público langfuse/langfuse-workshop. Usa el repositorio para ejecutar la aplicación, acceder a las ramas de checkpoint y realizar la configuración local.

Ver este archivo Markdown

Guía del participante: 02 Tracing

Notas para el instructor

• Enseña la progresión en tres capas visibles: generations de OpenAI, una raíz del agente y, por último, observaciones de las herramientas.
• Mantén los cambios pequeños y locales. El objetivo es mostrar que Langfuse envuelve los límites existentes de la aplicación sin obligar a reescribir la arquitectura.
• La propagación de usuario y sesión es opcional en directo, pero los checkpoints posteriores la incluyen para que los siguientes capítulos dispongan de atribución.

Ritmo de la demostración

1. Añade LangfuseSpanProcessor y observeOpenAI, ejecuta un turno y muestra traces separados de generation.
2. Envuelve runSupportConversationInner con observe(...), ejecuta de nuevo y muestra las generations anidadas.
3. Envuelve las dos funciones auxiliares de herramientas locales, vuelve a ejecutar y muestra el árbol completo.

Presta atención

• Algún contenedor padre vacío alrededor de dad-it-support-chat-turn justo después del Paso 2. Actualiza una vez antes de considerarlo un error; si persiste en cada turno, busca wrappers de tracing adicionales aparte del único observe(...) de la lección.
• Participantes que envuelvan el cliente OpenAI en una factory separada. El workshop mantiene el wrapper inline intencionadamente.
• Participantes que peguen el bloque del Paso 3 encima del executeTool existente, en vez de sustituirlo. El servidor termina con Multiple exports with the same name "executeTool"; la copia anterior queda más abajo en tools.ts.
• Falta del flush de cierre en index.ts; sin él, los traces pueden llegar tarde.