本指南将引导您完成使用自托管 LangSmith 实例的过程。
本指南假设您已经部署了自托管 LangSmith 实例。如果没有,请参阅 kubernetes 部署指南docker 部署指南

配置要与 LangSmith 一起使用的应用程序

LangSmith 有一个用于与 hub 和 LangSmith 后端交互的单一 API。
  1. 部署实例后,您可以在 http(s)://<host> 访问 LangSmith UI。
  2. LangSmith API 将在 http(s)://<host>/api/v1 可用
  3. LangSmith 控制平面将在 http(s)://<host>/api-host 可用
要使用实例的 API,您需要在应用程序中设置以下环境变量:
LANGSMITH_ENDPOINT=http://<host>/api/v1
LANGSMITH_API_KEY=foo # 如果使用 OAuth,请设置为合法的 API 密钥
您也可以直接在 LangSmith SDK 客户端中配置这些变量:
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()
# 代码的其余部分
import langsmith
langsmith_client = langsmith.Client(
    api_key='<api_key>',
    api_url='http(s)://<host>/api/v1',
)

API 参考

要访问 API 参考,请在浏览器中导航至 http://<host>/api/docs
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.