08 Chat และ Langfuse

คู่มือประกอบของผู้ดำเนินเวิร์กช็อปสำหรับบทเรียนผู้เรียน 08 Chat และ Langfuse

เวลา

ประมาณ 15 นาที คีย์ LLM สำหรับรันไทม์และคีย์ของ Langfuse อยู่ใน .env.workshop มาตั้งแต่โมดูล 00 แล้ว ดังนั้นส่วนใหญ่จึงเป็นการรีสตาร์ต backend บวกกับการพาทัวร์ trace

แนวการบรรยาย

• แผง chat จากโมดูล 02 กลายเป็นของจริง และทุกรอบการสนทนาถูก trace ไว้
• แสดง trace หนึ่งรายการบนโปรเจกเตอร์: prompt, completion, token, ต้นทุน

ปัญหาที่พบบ่อย

• ไม่มี OPENAI_API_KEY ทำให้ POST /api/chat คืน 503 พร้อมคำแนะนำการตั้งค่า (ส่วนที่เหลือ ของแอปไม่ได้รับผลกระทบ) คีย์ที่ไม่มีเงินจะ error ตอนเรียกโมเดล
• region ของ LANGFUSE_BASE_URL ผิด (https://us.cloud.langfuse.com เทียบกับ https://cloud.langfuse.com) จึงไม่มี trace ปรากฏ
• ไม่ได้รีสตาร์ต back end หลังจากกรอก .env.workshop
• การซ้อมแบบ clean-room เดือน 2026-07 ครอบคลุมโมดูลนี้แล้ว โดยรูปแบบความล้มเหลว, เวลา และขั้นตอนที่ต้องให้มนุษย์อนุมัติ ได้รับการยืนยันในการซ้อมแบบ clean-room เดือน 2026-07

ขั้นตอนรีเซ็ต

• แจกคีย์ LLM สำหรับยืมใช้ที่จำกัดวงเงินจาก pool
• กรอก OPENAI_API_KEY / LLM_MODEL / LLM_BASE_URL และค่า LANGFUSE_* ทั้งสามตัว ใน .env.workshop ใหม่ แล้วรัน docker compose --env-file .env.workshop -f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build backend เพื่อให้ telemetry ของ ClickStack ยังเปิดใช้อยู่