08 채팅과 Langfuse
모듈 08 강사 노트 — 타이밍, 토크 트랙, 흔한 실패 사례, 초기화 절차.
macOS terminal: Run workshop commands in Terminal using zsh or bash.
학습자 레슨 08 채팅과 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과 세 개의LANGFUSE_*값을 다시 채운 뒤,docker compose --env-file .env.workshop -f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build backend를 실행해 ClickStack 텔레메트리가 계속 활성화되게 하세요.