00 설정
학습자 가이드: 00 설정
워크숍 자료는 공개 langfuse/langfuse-workshop 저장소에서 관리됩니다. 저장소를 사용하여 실행 가능한 앱, 체크포인트 분기, 로컬 설정을 확인하세요.
학습자 가이드: 00 설정
강사 노트
checkpoint/00-setup을 안정적인 기본 앱 체크아웃으로 사용하세요. 이것은checkpoint/01-base-app과 동등해야 하며, 완전한 참조 앱이 아닙니다.main은 완전한 참조 구현을 포함하지만, 학습자는 설정 및 기본 앱 방향이 동일한 시작 상태를 공유하도록 체크포인트를 사용해야 합니다.- 학습자가 두 로컬 서비스를 모두 확인하도록 하세요:
127.0.0.1:3333의 Vite, 그리고127.0.0.1:8787/api/health또는127.0.0.1:8787/api/support-context의 Express API. - EU Langfuse 호스트 값을 강조하세요:
LANGFUSE_BASE_URL=https://cloud.langfuse.com. - Node 서버 및 헬퍼 스크립트는 저장소
.env을 재정의 활성화된 상태로 로드하므로 다른 로컬 프로젝트의 오래된 내보낸LANGFUSE_*,OPENAI_*또는DATASET_NAME값이 우선하지 않습니다. 학습자가 키나 프로젝트를 전환해야 할 때.env를 편집하도록 하세요. - 여기서 Project Settings → LLM Connections 앞에 로드하지 마세요. 학습자는
04-monitoring에서 기본 평가자 모델을 설정하며, 이때 LLM 판사 평가자가 처음 관련성이 생깁니다. - 키 처리를 명시적으로 유지하세요: 실제 API 키는
.env이나 Langfuse 비밀 필드에만 들어가며, 공유 성적표, 노트 또는 채팅에는 들어가지 않습니다. - 한 번의 성공적인 채팅 턴 후, 학습자가
checkpoint/02-tracing로 전환하여 첫 번째 빌드 단계를 진행하도록 하세요.
주의할 점
.env값이 누락되었습니다. 앱이 렌더링될 수 있지만 모델 호출이 실패합니다.^20.19.0 || >=22.12.0보다 오래된 Node. 방 안에서node -v확인 가치가 있으며, 누군가npm install를 실행하기 전에, npm이 Vite의 선택적 기본 바이너리를 자동으로 건너뛰기 때문에 실패는npm run dev내부에서만 나중에 표면화됩니다. 나중에 업그레이드하는 학습자는npm ci이 필요하며, 단순 재시작이 아닙니다.- 사람들이 개발에서
127.0.0.1:8787/를 확인하고 있습니다. API 서버가 해당 포트에서 실행되지만 브라우저 앱은127.0.0.1:3333의 Vite에서 제공되므로 서버 확인에 API 경로를 사용하세요. 또한 충돌한 Vite를 숨깁니다:concurrently는 API 서버를 계속 실행하고8787/는ENOENT ... dist/index.html으로 응답합니다. - 학습자가
.env을 대신 셸 내보내기를 편집하고 있습니다. 워크숍은 의도적으로.env을 Node 측 소스의 진실로 취급합니다. - 사람들이 초기 설정 중에 평가자 설정을 예상하고 있습니다. 앱은 Langfuse 측 LLM 연결이 있기 전에 올바르게 실행되고 추적할 수 있습니다.
checkpoint/00-setup또는checkpoint/01-base-app에서 추적을 예상하는 사람들. 둘 다 의도적으로 추적되지 않습니다. 추적은02-tracing편집 후에만 시작됩니다.main에 남아있는 사람들이 추적 중입니다.main은 이미 완성된 참조 구현입니다.