Skip to main content
LangSmith는 프롬프트를 효과적으로 관리할 수 있도록 다양한 도구를 제공합니다. 이 페이지에서는 다음 기능들을 설명합니다:

커밋 태그

커밋 태그는 프롬프트의 버전 기록에서 특정 커밋을 참조하는 레이블입니다. 이를 통해 중요한 버전을 표시하고 다양한 환경에서 실행할 버전을 제어할 수 있습니다. 코드에서 커밋 ID 대신 태그를 참조하면 코드를 수정하지 않고도 사용 중인 버전을 업데이트할 수 있습니다. 각 태그는 정확히 하나의 커밋을 참조하지만, 태그를 다른 커밋으로 재할당할 수 있습니다. 커밋 태그의 사용 사례는 다음과 같습니다:
  • 환경별 태그: production 또는 staging 환경용 커밋을 표시하여 코드를 변경하지 않고 다양한 버전 간에 전환할 수 있습니다.
  • 버전 관리: 프롬프트의 안정적인 버전(예: v1, v2)을 표시하여 코드에서 특정 버전을 참조하고 시간 경과에 따른 변경사항을 추적할 수 있습니다.
  • 협업: 검토 준비가 완료된 버전을 표시하여 협업자와 특정 버전을 공유하고 피드백을 받을 수 있습니다.

태그 생성

태그를 생성하려면 프롬프트의 Commits 탭으로 이동합니다. 태그를 지정할 커밋 옆에 있는 태그 아이콘을 클릭합니다. New Tag를 클릭하고 태그 이름을 입력합니다.

태그 이동

태그를 다른 커밋으로 지정하려면 대상 커밋 옆에 있는 태그 아이콘을 클릭하고 이동할 태그를 선택합니다. 그러면 태그가 자동으로 새 커밋을 가리키도록 업데이트됩니다.

태그 삭제

태그를 삭제하려면 삭제할 태그 옆에 있는 삭제 아이콘을 클릭합니다. 그러면 태그가 완전히 삭제되며 더 이상 어떤 커밋과도 연결되지 않습니다.

코드에서 태그 사용

태그는 코드에서 프롬프트의 특정 버전을 참조하는 안정적인 방법을 제공합니다. 커밋 해시를 직접 사용하는 대신 태그를 참조하면 코드를 변경하지 않고도 업데이트할 수 있습니다. 다음은 Python에서 태그를 사용하여 프롬프트를 가져오는 예시입니다:
prompt = client.pull_prompt("joke-generator:prod")
# prod 태그가 커밋 a1b2c3d4를 가리키는 경우, 이는 다음과 동일합니다:
prompt = client.pull_prompt("joke-generator:a1b2c3d4")
코드에서 프롬프트를 사용하는 방법에 대한 자세한 내용은 프로그래밍 방식으로 프롬프트 관리를 참조하세요.

프롬프트 커밋 시 웹훅 트리거

프롬프트에 커밋이 이루어질 때마다 트리거되도록 웹훅을 구성할 수 있습니다. 이에 대한 일반적인 사용 사례는 다음과 같습니다:
  • 프롬프트 업데이트 시 CI/CD 파이프라인 트리거
  • GitHub 리포지토리와 프롬프트 동기화
  • 프롬프트 수정에 대해 팀원에게 알림

웹훅 구성

왼쪽 사이드바의 Prompts 섹션으로 이동하거나 애플리케이션 홈페이지에서 이동합니다. 오른쪽 상단에서 + Webhook 버튼을 클릭합니다. 웹훅 URL과 필요한 헤더를 추가합니다.
워크스페이스당 하나의 웹훅만 구성할 수 있습니다. 워크스페이스당 여러 개를 구성하거나 각 프롬프트에 대해 다른 웹훅을 설정하려면 LangChain 포럼에 알려주세요.
웹훅을 테스트하려면 Send test notification 버튼을 클릭합니다. 그러면 제공한 웹훅 URL로 샘플 페이로드와 함께 테스트 알림이 전송됩니다. 샘플 페이로드는 다음 필드를 포함하는 JSON 객체입니다:
  • prompt_id: 커밋된 프롬프트의 ID
  • prompt_name: 커밋된 프롬프트의 이름
  • commit_hash: 프롬프트의 커밋 해시
  • created_at: 커밋 날짜
  • created_by: 커밋 작성자
  • manifest: 프롬프트의 매니페스트

웹훅 트리거

구성한 웹훅을 트리거하려면 프롬프트에 커밋합니다.

Playground 사용

Playground에서 이 작업을 수행하면 트리거를 피하려는 웹훅을 선택 해제하라는 메시지가 표시됩니다.

API 사용

API를 통해 커밋하는 경우 skip_webhooks 매개변수를 true로 설정하거나 무시할 웹훅 ID 배열로 설정하여 웹훅 트리거를 건너뛸 수 있습니다. 자세한 내용은 API 문서를 참조하세요.

퍼블릭 프롬프트 허브

LangSmith의 퍼블릭 프롬프트 허브는 LangChain 커뮤니티에서 생성한 프롬프트 모음으로, 참고용으로 사용할 수 있습니다.
프롬프트는 사용자가 생성한 것이며 검증되지 않았습니다. LangChain은 퍼블릭 프롬프트를 검토하거나 보증하지 않으므로 자신의 책임 하에 사용하세요. Prompt Hub 사용은 서비스 약관이 적용됩니다.
왼쪽 사이드바의 Prompts 섹션으로 이동하여 Browse all Public Prompts in the LangChain Hub를 클릭합니다. 여기에서 LangChain Hub에 공개적으로 나열된 모든 프롬프트를 찾을 수 있습니다. 이름, 핸들, 사용 사례, 설명 또는 모델별로 프롬프트를 검색할 수 있습니다. 프롬프트를 개인 조직으로 포크하고, 프롬프트 세부 정보를 확인하고, Playground에서 프롬프트를 실행할 수 있습니다. SDK를 사용하여 모든 퍼블릭 프롬프트를 코드로 가져올 수 있습니다. 워크스페이스에 연결된 프롬프트를 보려면 사이드바의 Prompts 탭을 방문하세요.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
I