이 가이드는 자체 호스팅된 LangSmith 인스턴스를 사용하는 과정을 안내합니다.
이 가이드는 이미 자체 호스팅된 LangSmith 인스턴스를 배포했다고 가정합니다. 아직 배포하지 않았다면 kubernetes 배포 가이드 또는 docker 배포 가이드를 참조하세요.

​
LangSmith와 함께 사용할 애플리케이션 구성하기

LangSmith는 hub와 LangSmith backend 모두와 상호작용하기 위한 단일 API를 제공합니다.
  1. 인스턴스를 배포한 후 http(s)://<host>에서 LangSmith UI에 접근할 수 있습니다.
  2. LangSmith API는 http(s)://<host>/api/v1에서 사용할 수 있습니다.
  3. LangSmith Control Plane은 http(s)://<host>/api-host에서 사용할 수 있습니다.
인스턴스의 API를 사용하려면 애플리케이션에서 다음 환경 변수를 설정해야 합니다: 
LANGSMITH_ENDPOINT=http://<host>/api/v1
LANGSMITH_API_KEY=foo # Set to a legitimate API key if using OAuth
LangSmith SDK client에서 직접 이러한 변수를 구성할 수도 있습니다: 
import langsmith
langsmith_client = langsmith.Client(
    api_key='<api_key>',
    api_url='http(s)://<host>/api/v1',
)
위의 설정을 완료한 후 코드를 실행하고 자체 호스팅된 인스턴스에서 결과를 확인할 수 있습니다. LangSmith 사용 방법을 익히기 위해 빠른 시작 가이드를 진행하는 것을 권장합니다.

​
자체 서명 인증서

자체 호스팅된 LangSmith 인스턴스에 자체 서명 인증서를 사용하는 경우, Python이 자체 신뢰할 수 있는 인증서 세트와 함께 제공되며 여기에 자체 서명 인증서가 포함되지 않을 수 있어 문제가 될 수 있습니다. 이를 해결하려면 truststore와 같은 도구를 사용하여 시스템 인증서를 Python 환경에 로드해야 할 수 있습니다. 다음과 같이 수행할 수 있습니다:
  1. pip install truststore (또는 사용 중인 패키지 관리자에 따라 유사한 명령)
그런 다음 다음 코드를 사용하여 시스템 인증서를 로드합니다: 
import truststore
truststore.inject_into_ssl()
# The rest of your code
import langsmith
langsmith_client = langsmith.Client(
    api_key='<api_key>',
    api_url='http(s)://<host>/api/v1',
)

​
API reference

API reference에 접근하려면 브라우저에서 http://<host>/api/docs로 이동하세요.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I