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 里的 chat 面板变成真的了，而且每一轮对话都会被追踪。
- 在投影仪上展示一条追踪：提示词、补全内容、token 数、成本。
常见故障
- 缺少
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和三个LANGFUSE_*值，然后运行docker compose --env-file .env.workshop -f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build backend，这样 ClickStack 遥测才会保持启用。