Para participantes

Empieza con las lecciones para participantes en docs/learner/. Cada lección indica qué checkpoint usar, qué cambiar en el código o configurar en Langfuse y cómo verificar el resultado.

Sigue este recorrido si quieres:

• Registrar tu primer trace desde una aplicación LLM real y entender lo que estás viendo.
• Llevar un prompt a Langfuse para versionar los cambios y vincularlos con los traces.
• Monitorizar el comportamiento en producción sin leer cada trace a mano.
• Crear un dataset, ejecutar experimentos y evaluar cambios con evidencia.
• Examinar una implementación de referencia completa en TypeScript cuyos patrones puedas reutilizar.

No hace falta un instructor. Las lecciones son lo bastante completas para realizar el workshop de forma autoguiada.

Cómo recorrer el workshop

main contiene la implementación de referencia completa. Para el trabajo práctico, haz checkout del checkpoint indicado en la lección que vas a comenzar, realiza los cambios que faltan y verifica el resultado antes de continuar.

checkpoint/00-setup y checkpoint/01-base-app contienen intencionadamente la misma aplicación base, todavía sin tracing. Setup usa ese estado para validar claves, dependencias y puertos; Base App lo usa para orientarte. El tracing comienza en 02-tracing.

El servidor del workshop y los scripts auxiliares de npm consideran el archivo .env del repositorio como fuente de verdad para Node. Las variables exportadas en el shell por otros proyectos no sustituyen .env; cambia en ese archivo las claves del workshop, el host de Langfuse, los labels de prompts y los nombres de datasets.

El workshop es lo bastante breve para completarlo en una sesión, y cada módulo también puede utilizarse por separado si solo te interesa una parte del ciclo.

Próximos pasos

• Recorre los módulos en orden empezando por docs/learner/00-setup.md.
• Ve directamente al capítulo que corresponda a lo que quieres aprender.
• Instala la skill de Langfuse (/langfuse) para aplicar los patrones de este workshop a tu propio código.
• Para obtener una visión más amplia de cada capítulo, consulta la Langfuse Academy.