Skip to main content
本指南展示如何为您的 LangSmith API 文档自定义 OpenAPI 安全模式。一个文档完善的安全模式有助于 API 消费者理解如何与您的 API 进行认证，甚至能支持自动生成客户端代码。有关 LangGraph 认证系统的更多详细信息，请参阅认证与访问控制概念指南。
实现与文档 本指南仅涵盖如何在 OpenAPI 中记录您的安全要求。要实现实际的认证逻辑，请参阅如何添加自定义认证。
本指南适用于所有 LangSmith 部署（云端和自托管）。如果您不使用 LangSmith，则不适用于 LangGraph 开源库的使用。

​
默认模式

默认安全模式因部署类型而异：
默认情况下，LangSmith 要求在 x-api-key 请求头中包含 LangSmith API 密钥：
使用 LangGraph SDK 时，可以从环境变量中推断此密钥。
默认情况下，自托管部署没有安全模式。这意味着它们只能部署在安全网络上或配合认证使用。要添加自定义认证，请参阅如何添加自定义认证。

​
自定义安全模式

要自定义 OpenAPI 文档中的安全模式，请在 langgraph.json 的 auth 配置中添加 openapi 字段。请记住，这仅更新 API 文档——您还必须按照如何添加自定义认证中所示实现相应的认证逻辑。 请注意，LangSmith 不提供认证端点——您需要在客户端应用程序中处理用户认证，并将生成的凭据传递给 LangGraph API。

​
测试

更新配置后：
  1. 部署您的应用程序
  2. 访问 /docs 查看更新后的 OpenAPI 文档
  3. 使用来自认证服务器的凭据尝试端点（请确保您已先实现认证逻辑）
将这些文档通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。