02 트레이싱

워크숍 자료는 공개 langfuse/langfuse-workshop 저장소에서 관리됩니다. 저장소를 사용하여 실행 가능한 앱, 체크포인트 분기, 로컬 설정을 확인하세요.

이 마크다운 파일 보기

학습자 가이드: 02 트레이싱

강사 노트

• 세 개의 시각적 계층에서 진행을 가르치세요: OpenAI 생성, 하나의 에이전트 루트, 그 다음 도구 관찰.
• 코드 변경을 작고 지역적으로 유지하세요. 목표는 Langfuse가 기존 앱 경계를 래핑하는 것이지 아키텍처 재작성을 강제하지 않는 것을 보여주는 것입니다.
• 사용자/세션 전파 섹션은 라이브에서는 선택 사항이지만 나중 체크포인트에 포함되어 있으므로 다음 장에서 속성을 사용할 수 있습니다.

데모 리듬

1. LangfuseSpanProcessor과 observeOpenAI를 추가하고 한 턴을 실행하고 분리된 생성 추적을 표시합니다.
2. runSupportConversationInner을 observe(...)로 래핑하고 다시 실행하고 중첩된 생성을 표시합니다.
3. 두 로컬 도구 헬퍼를 래핑하고 다시 실행하고 전체 트리를 표시합니다.

주의할 점

• 단계 2 직후 dad-it-support-chat-turn 주위의 가끔 빈 부모 컨테이너. 한 번 새로 고치고 코드 버그로 취급하기 전에, 매 턴마다 지속되면 observe(...)을 넘어 우발적인 추가 추적 래퍼를 확인하세요.
• 학습자가 별도 팩토리에서 OpenAI 클라이언트를 래핑하고 있습니다. 워크숍은 의도적으로 래퍼를 인라인으로 유지합니다.
• 학습자가 단계 3 블록을 기존 executeTool 위에 붙여넣는 대신 교체하고 있습니다. 서버는 Multiple exports with the same name "executeTool"으로 종료되며 남은 복사본은 tools.ts에서 추가로 내려갑니다.
• index.ts에서 종료 플러시가 누락되었습니다. 추적이 플러시 없이 지연될 수 있습니다.