02 Tracing

O material do workshop é mantido no repositório público langfuse/langfuse-workshop. Use o repositório para executar a aplicação, acessar os branches de checkpoint e fazer a configuração local.

Ver este arquivo Markdown

Guia do participante: 02 Tracing

Notas para o instrutor

• Ensine a progressão em três camadas visíveis: generations da OpenAI, uma raiz do agente e, por fim, observações das ferramentas.
• Mantenha as mudanças pequenas e locais. O objetivo é mostrar que o Langfuse envolve os limites existentes da aplicação sem exigir uma reescrita da arquitetura.
• A propagação de usuário e sessão é opcional durante a apresentação ao vivo, mas os checkpoints seguintes a incluem para que os próximos capítulos tenham atribuição disponível.

Ritmo da demonstração

1. Adicione LangfuseSpanProcessor e observeOpenAI, execute um turno e mostre traces separados de generation.
2. Envolva runSupportConversationInner com observe(...), execute novamente e mostre as generations aninhadas.
3. Envolva as duas funções auxiliares das ferramentas locais, execute outra vez e mostre a árvore completa.

Fique atento

• Um contêiner pai ocasionalmente vazio ao redor de dad-it-support-chat-turn logo após a Etapa 2. Atualize a página uma vez antes de tratar isso como bug; se persistir em todos os turnos, procure wrappers extras de tracing além do único observe(...) da lição.
• Participantes envolvendo o cliente OpenAI em uma factory separada. O workshop mantém o wrapper inline intencionalmente.
• Participantes colando o bloco da Etapa 3 acima do executeTool existente, em vez de substituí-lo. O servidor encerra com Multiple exports with the same name "executeTool"; a cópia antiga fica mais abaixo em tools.ts.
• Ausência de flush no encerramento em index.ts; sem ele, os traces podem chegar atrasados.