03 프롬프트 관리

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

이 마크다운 파일 보기

학습자 가이드: 03 프롬프트 관리

강사 노트

• 교육 요점은 추적 대 프롬프트 루프입니다: 모든 생성은 그것을 생성한 프롬프트 버전에 연결되어야 합니다.
• 다른 엔지니어가 나중에 프롬프트를 편집하는 방식을 반영하기 때문에 UI 경로를 먼저 선호하세요.
• 로컬 SYSTEM_PROMPT을 복원력 폴백으로 유지하되, 프롬프트가 게시된 후의 소스 진실로는 유지하지 마세요.

데모 리듬

1. dad-it-support-agent를 텍스트 프롬프트로 생성하고 production으로 레이블을 지정합니다.
2. LangfuseClient로 가져옵니다.
3. 하드코딩된 시스템 메시지를 가져온 텍스트로 교체하고 SYSTEM_PROMPT를 폴백으로 유지합니다.
4. langfusePrompt을 observeOpenAI에 전달합니다.
5. 생성을 열고 프롬프트 배지를 표시합니다.

주의할 점

• .env과 Langfuse 간의 프롬프트 이름/레이블 불일치.
• 학습자가 SDK가 기본적으로 production 레이블을 가져온다는 것을 잊고 있습니다.
• 프롬프트 배지는 연결을 증명하지만 사용을 증명하지는 않습니다. 성적표가 여전히 로컬 SYSTEM_PROMPT을 전송하면 모든 검증 단계를 통과하면서 UI의 프롬프트 편집이 아무 효과도 없습니다. 편집이 효과가 없는 것처럼 보이면 생성 입력을 확인하세요.