학습자를 위해

docs/learner/의 학습자 레슨으로 시작하세요. 각 레슨은 어떤 체크포인트를 확인해야 하는지, 코드에서 무엇을 변경하거나 Langfuse에서 구성해야 하는지, 그리고 결과를 어떻게 확인하는지 알려줍니다.

다음을 원하는 경우 학습자 경로를 사용하세요:

• 실제 LLM 앱에서 첫 번째 트레이스를 기록하고 보고 있는 것을 이해합니다.
• 프롬프트를 Langfuse로 옮겨서 변경 사항이 버전 관리되고 트레이스와 연결됩니다.
• 모든 트레이스를 수동으로 읽지 않고 프로덕션 동작을 모니터링합니다.
• 데이터 세트를 구축하고, 실험을 실행하며, 증거를 통해 변경 사항을 평가합니다.
• 패턴을 복사할 수 있는 완전한 TypeScript 참고 구현을 검사합니다.

강사가 필요하지 않습니다. 학습자 레슨은 워크숍을 자습 모드로 실행하기에 충분합니다.

진행 방법

main은 완전한 참고 구현입니다. 실습을 하려면 시작하는 레슨에 지정된 체크포인트를 확인하고, 누락된 변경 사항을 만든 후, 진행하기 전에 결과를 확인하세요.

checkpoint/00-setup와 checkpoint/01-base-app은 의도적으로 동일한 추적되지 않은 기본 앱을 포함합니다. Setup은 해당 상태를 사용하여 키, 종속성 및 포트를 검증하고, Base App은 방향 정보를 위해 사용합니다. 추적은 02-tracing에서 시작됩니다.

워크숍 서버 및 npm 도우미 스크립트는 저장소 .env를 Node 측의 진실의 원천으로 취급합니다. 다른 프로젝트에서 내보낸 로컬 셸 내보내기는 .env을 재정의하지 않으므로, 해당 파일에서 워크숍 키, Langfuse 호스트, 프롬프트 레이블 및 데이터 세트 이름을 변경하세요.

워크숍은 한 번에 완료할 수 있을 정도로 작으며, 루프의 한 부분만 신경 쓴다면 모든 모듈을 독립적으로 사용할 수도 있습니다.

다음 단계

• docs/learner/00-setup.md에서 시작하여 모듈을 순서대로 진행하세요.
• 배우고 싶은 것과 일치하는 장으로 이동하세요.
• Langfuse 스킬 (/langfuse)을 설치하여 이 워크숍의 패턴을 자신의 코드베이스에 적용하세요.
• 각 장에 대한 더 큰 그림 자료는 Langfuse Academy를 사용하세요.