08 Chat と Langfuse
モジュール 08 のインストラクターノート — タイミング、トークトラック、よくある失敗、リセット手順。
macOS terminal: Run workshop commands in Terminal using zsh or bash.
学習者向けレッスン 08 Chat と Langfuse に対応するファシリテーター用の手引きです。
タイミング
約15分。ランタイム LLM のキーと Langfuse のキーはモジュール 00 の時点で .env.workshop に
入っているため、ここはほぼバックエンドの再起動とトレースの見学だけです。
トークトラック
- モジュール 02 のチャットパネルが本物になり、すべてのやり取りがトレースされる。
- プロジェクターでトレースを見せる: プロンプト、補完、トークン、コスト。
よくある失敗
OPENAI_API_KEYが未設定。POST /api/chatがセットアップのヒントとともに 503 を返す （アプリの他の部分には影響しない）。残高のないキーはモデル呼び出しでエラーになる。LANGFUSE_BASE_URLのリージョンが誤っている（https://us.cloud.langfuse.comとhttps://cloud.langfuse.com）ため、トレースが表示されない。.env.workshopを埋めた後にバックエンドを再起動していない。- 2026-07 のクリーンルームでのドライランはこのモジュールを対象に含んでいた。検証済みの失敗モード、タイミング、人による確認が必要な手順は 2026-07 のクリーンルームでのドライランで確認済み。
リセット手順
- プールから上限を設定した貸出用 LLM キーを渡す。
.env.workshopのOPENAI_API_KEY/LLM_MODEL/LLM_BASE_URLと3つのLANGFUSE_*の値を 埋め直し、その後docker compose --env-file .env.workshop -f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build backendを実行して ClickStack のテレメトリーを有効に保つ。