08 Chat et Langfuse

Document d’accompagnement du formateur pour la leçon participant 08 Chat et Langfuse.

Durée

Environ 15 minutes. La clé du LLM d’exécution et les clés Langfuse figurent déjà dans .env.workshop depuis le module 00 ; il suffit donc principalement de redémarrer le back-end, puis de parcourir les traces.

Trame d’animation

• Le panneau de chat présenté au module 02 devient fonctionnel et chaque échange est tracé.
• Montrez une trace au projecteur : instruction, réponse, jetons et coût.

Problèmes courants

• OPENAI_API_KEY manque ; POST /api/chat renvoie une erreur 503 avec une indication de configuration (le reste de l’application n’est pas affecté). Une clé sans crédit provoque une erreur lors de l’appel au modèle.
• Région incorrecte dans LANGFUSE_BASE_URL (https://us.cloud.langfuse.com au lieu de https://cloud.langfuse.com, ou inversement) : les traces n’apparaissent donc pas.
• Le back-end n’a pas été redémarré après le remplissage de .env.workshop.
• La répétition en environnement vierge de juillet 2026 a couvert ce module ; les modes d’échec validés, les durées et les étapes nécessitant une intervention humaine y ont été confirmés.

Procédures de réinitialisation

• Fournissez une clé de LLM de prêt assortie d’un plafond de dépenses.
• Renseignez de nouveau OPENAI_API_KEY / LLM_MODEL / LLM_BASE_URL et les trois valeurs LANGFUSE_* dans .env.workshop, puis exécutez docker compose --env-file .env.workshop -f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build backend afin que la télémétrie ClickStack reste activée.