LangSmith는 prompt를 효과적으로 관리할 수 있는 여러 도구를 제공합니다. 이 페이지에서는 다음 기능을 설명합니다:
  • 버전 관리 및 환경 관리를 위한 Commit tag
  • Prompt가 업데이트될 때 워크플로우를 자동화하기 위한 Webhook trigger
  • 커뮤니티에서 만든 prompt를 발견하고 사용하기 위한 Public prompt hub

​
Commit tags

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

​
Tag 생성

Tag를 생성하려면 prompt의 Commits 탭으로 이동합니다. Tag를 지정할 commit 옆의 tag 아이콘을 클릭합니다. New Tag를 클릭하고 tag 이름을 입력합니다.

​
Tag 이동

Tag를 다른 commit으로 이동하려면 대상 commit 옆의 tag 아이콘을 클릭하고 이동할 tag를 선택합니다. 그러면 tag가 자동으로 새 commit을 가리키도록 업데이트됩니다.

​
Tag 삭제

Tag를 삭제하려면 삭제할 tag 옆의 삭제 아이콘을 클릭합니다. 그러면 tag가 완전히 삭제되고 더 이상 어떤 commit과도 연결되지 않습니다.

​
코드에서 tag 사용

Tag는 코드에서 prompt의 특정 버전을 참조하는 안정적인 방법을 제공합니다. Commit hash를 직접 사용하는 대신 코드를 변경하지 않고도 업데이트할 수 있는 tag를 참조할 수 있습니다. 다음은 Python에서 tag로 prompt를 가져오는 예제입니다: 
prompt = client.pull_prompt("joke-generator:prod")
# If prod tag points to commit a1b2c3d4, this is equivalent to:
prompt = client.pull_prompt("joke-generator:a1b2c3d4")
코드에서 prompt를 사용하는 방법에 대한 자세한 내용은 프로그래밍 방식으로 prompt 관리하기를 참조하세요.

​
Prompt commit 시 webhook 트리거

Prompt에 commit이 이루어질 때마다 트리거되도록 webhook을 구성할 수 있습니다. 일반적인 사용 사례는 다음과 같습니다:
  • Prompt가 업데이트될 때 CI/CD 파이프라인 트리거
  • GitHub repository와 prompt 동기화
  • Prompt 수정에 대해 팀원에게 알림

​
Webhook 구성

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

​
Webhook 트리거

구성한 webhook을 트리거하려면 prompt에 commit합니다.

​
Playground 사용

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

​
API 사용

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

​
Public prompt hub

LangSmith의 public prompt hub는 LangChain 커뮤니티에서 만든 prompt 모음으로 참고용으로 사용할 수 있습니다.
Prompt는 사용자가 생성한 것이며 검증되지 않았습니다. LangChain은 public prompt를 검토하거나 보증하지 않으므로 본인의 책임 하에 사용하세요. Prompt Hub 사용은 당사의 서비스 약관이 적용됩니다.
왼쪽 사이드바의 Prompts 섹션으로 이동하여 Browse all Public Prompts in the LangChain Hub를 클릭합니다. 여기에서 LangChain Hub에 공개적으로 나열된 모든 prompt를 찾을 수 있습니다. 이름, handle, 사용 사례, 설명 또는 model로 prompt를 검색할 수 있습니다. Prompt를 개인 organization으로 fork하고, prompt의 세부 정보를 보고, Playground에서 prompt를 실행할 수 있습니다. SDK를 사용하여 모든 public prompt를 코드로 가져올 수 있습니다. workspace에 연결된 prompt를 보려면 사이드바의 Prompts 탭을 방문하세요.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I