Para participantes
Comece pelas lições em docs/learner/. Cada lição indica qual checkpoint usar, o que mudar no código ou configurar no Langfuse e como verificar o resultado.
Comece pelas lições para participantes em docs/learner/. Cada lição indica qual checkpoint usar, o que mudar no código ou configurar no Langfuse e como verificar o resultado.
Use este percurso se você quiser:
- Registrar seu primeiro trace de uma aplicação LLM real e entender o que está vendo.
- Mover um prompt para o Langfuse, versionando as mudanças e vinculando-as aos traces.
- Monitorar o comportamento em produção sem ler cada trace manualmente.
- Criar um dataset, executar experimentos e avaliar mudanças com evidências.
- Examinar uma implementação de referência completa em TypeScript e reaproveitar seus padrões.
Não é necessário ter instrutor. As lições são completas o bastante para realizar o workshop de forma autoguiada.
Como percorrer o workshop
main contém a implementação de referência completa. Para a parte prática, faça checkout do checkpoint indicado na lição que você está iniciando, implemente as mudanças que faltam e verifique o resultado antes de avançar.
checkpoint/00-setup e checkpoint/01-base-app contêm intencionalmente a mesma aplicação base, ainda sem tracing. O Setup usa esse estado para validar chaves, dependências e portas; Base App o usa para orientação. O tracing começa em 02-tracing.
O servidor do workshop e os scripts auxiliares do npm tratam o arquivo .env do repositório como fonte da verdade para o Node. Variáveis exportadas no shell por outros projetos não sobrescrevem .env; altere nesse arquivo as chaves do workshop, o host do Langfuse, os labels dos prompts e os nomes dos datasets.
O workshop é curto o bastante para ser concluído em uma sessão, e cada módulo também pode ser usado separadamente se você quiser estudar apenas uma parte do ciclo.
Próximos passos
- Percorra os módulos em ordem, começando por
docs/learner/00-setup.md. - Vá diretamente ao capítulo que corresponde ao que você quer aprender.
- Instale a skill do Langfuse (
/langfuse) para aplicar os padrões deste workshop à sua própria base de código. - Para uma visão mais ampla de cada capítulo, consulte a Langfuse Academy.