03 Gerenciamento de prompts

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: 03 Gerenciamento de prompts

Notas para o instrutor

• O ponto central é o ciclo entre trace e prompt: cada generation deve apontar para a versão do prompt que a produziu.
• Prefira começar pela interface, pois ela reproduz como pessoas não técnicas editarão prompts depois.
• Mantenha o SYSTEM_PROMPT local como fallback de resiliência, não como fonte da verdade depois que o prompt for publicado.

Ritmo da demonstração

1. Crie dad-it-support-agent como prompt de texto e aplique o label production.
2. Busque-o com LangfuseClient.
3. Troque a mensagem de sistema fixa pelo texto buscado, mantendo SYSTEM_PROMPT como fallback.
4. Passe langfusePrompt para observeOpenAI.
5. Abra uma generation e mostre o badge Prompt.

Fique atento

• Nome ou label do prompt divergente entre .env e Langfuse.
• Participantes que esquecem que, por padrão, o SDK busca o label production.
• O badge Prompt comprova o vínculo, não o uso. Uma conversa que ainda envia o SYSTEM_PROMPT local passa por todas as verificações, mas as edições na interface não produzem efeito — se uma mudança parecer não funcionar, examine a entrada da generation.