08 Chat y Langfuse

Material del facilitador correspondiente a la lección 08 Chat y Langfuse del participante.

Tiempos

Unos 15 minutos. La clave de LLM en tiempo de ejecución y las claves de Langfuse ya están en .env.workshop desde el módulo 00, por lo que este módulo consiste principalmente en reiniciar el back-end y recorrer los traces.

Guion de presentación

• El panel de chat del módulo 02 pasa a ser real, y cada turno queda registrado.
• Muestra un trace en el proyector: prompt, respuesta, tokens y coste.

Fallos habituales

• Falta OPENAI_API_KEY; POST /api/chat devuelve 503 con una indicación de configuración (el resto de la aplicación no se ve afectado). Una clave sin saldo provoca un error en la llamada al modelo.
• Región incorrecta en LANGFUSE_BASE_URL (https://us.cloud.langfuse.com frente a https://cloud.langfuse.com), por lo que los traces no aparecen.
• No se reinició el back-end después de rellenar .env.workshop.
• El ensayo en entorno limpio de julio de 2026 cubrió este módulo; los modos de fallo, los tiempos y los pasos con intervención humana quedaron validados.

Pasos de restablecimiento

• Entrega una clave de LLM de reserva con límite de gasto.
• Vuelve a rellenar OPENAI_API_KEY / LLM_MODEL / LLM_BASE_URL y los tres valores LANGFUSE_* en .env.workshop y ejecuta docker compose --env-file .env.workshop -f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build backend para mantener habilitada la telemetría de ClickStack.