08 Chat dan Langfuse

Pendamping fasilitator untuk pelajaran pembelajar 08 Chat dan Langfuse.

Waktu

Sekitar 15 menit. Key LLM runtime dan key Langfuse sudah ada di .env.workshop sejak modul 00, jadi ini sebagian besar hanya restart backend plus tur trace.

Alur pembicaraan

• Panel chat dari modul 02 menjadi nyata, dan setiap turn ditrace.
• Tunjukkan sebuah trace di proyektor: prompt, completion, token, biaya.

Kegagalan umum

• OPENAI_API_KEY tidak ada; POST /api/chat mengembalikan 503 dengan petunjuk setup (sisa aplikasi tidak terpengaruh). Key tanpa dana akan error pada panggilan model.
• Region LANGFUSE_BASE_URL salah (https://us.cloud.langfuse.com vs https://cloud.langfuse.com), sehingga trace tidak muncul.
• Back end tidak direstart setelah mengisi .env.workshop.
• Dry run clean-room 2026-07 mencakup modul ini; mode kegagalan, waktu, dan langkah bergerbang manusia yang tervalidasi dikonfirmasi pada dry run clean-room 2026-07.

Langkah reset

• Bagikan key LLM pinjaman berbatas dari pool.
• Isi kembali OPENAI_API_KEY / LLM_MODEL / LLM_BASE_URL dan tiga nilai LANGFUSE_* di .env.workshop, lalu docker compose --env-file .env.workshop -f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build backend agar telemetri ClickStack tetap aktif.