以编程方式使用文档

本指南将引导您完成使用 LangSmith 自托管实例的过程。

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

LangSmith 有一个统一的 API 用于与 hub 和 LangSmith 后端进行交互。

  1. 部署实例后，您可以在以下位置访问 LangSmith UI http(s)://<host>.
  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 客户端中配置这些变量：

langsmith_client = langsmith.Client(
    api_key='<api_key>',
    api_url='http(s)://<host>/api/v1',
)

设置上述配置后，您应该能够运行代码并在自己的自托管实例中查看结果。我们建议您先运行 *快速入门指南* 以熟悉 LangSmith 的使用方法。

自签名证书

如果您为自托管 LangSmith 实例使用自签名证书，这可能会出现问题，因为 Python 自带一组可信证书，其中可能不包含您的自签名证书。要解决此问题，您可能需要使用 truststore 将系统证书加载到 Python 环境中。

您可以这样做：

  1. pip install truststore（或根据您使用的包管理器选择类似方式）

然后使用以下代码加载系统证书：

truststore.inject_into_ssl()
# The rest of your code

langsmith_client = langsmith.Client(
    api_key='<api_key>',
    api_url='http(s)://<host>/api/v1',
)

API 参考

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