与自托管的 LangSmith 实例交互

本指南将带你了解如何使用自托管的 LangSmith 实例。

INFO

本指南假设你已部署自托管 LangSmith 实例。如果尚未部署，请参阅 Kubernetes 部署指南。

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

LangSmith 提供单一 API，用于与 hub 和 LangSmith 后端交互。

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 # Set to a legitimate API key if using OAuth

你也可以直接在 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()
# The rest of your code
import langsmith
langsmith_client = langsmith.Client(
    api_key='<api_key>',
    api_url='http(s)://<host>/api/v1',
)

---

API 参考

要访问 API 参考，请在浏览器中打开 http://<host>/api/docs。

---