03 Gestión de prompts

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: 03 Gestión de prompts

Notas para el instructor

• La idea central es el ciclo entre trace y prompt: cada generation debe enlazar con la versión del prompt que la produjo.
• Empieza por la interfaz porque reproduce cómo editarán los prompts las personas no técnicas.
• Conserva el SYSTEM_PROMPT local como fallback de resiliencia, no como fuente de verdad una vez publicado el prompt.

Ritmo de la demostración

1. Crea dad-it-support-agent como prompt de texto y asígnale el label production.
2. Recupéralo con LangfuseClient.
3. Sustituye el mensaje de sistema fijo por el texto recuperado y conserva SYSTEM_PROMPT como fallback.
4. Pasa langfusePrompt a observeOpenAI.
5. Abre una generation y muestra la insignia Prompt.

Presta atención

• Diferencias en el nombre o el label del prompt entre .env y Langfuse.
• Participantes que olviden que el SDK recupera por defecto el label production.
• La insignia Prompt demuestra el enlace, no el uso. Una conversación que todavía envíe el SYSTEM_PROMPT local supera todas las verificaciones, aunque los cambios de la interfaz no tengan efecto; si una edición parece no funcionar, revisa la entrada de la generation.