Skip to main content
代理认证目前处于 Beta 版本，正在积极开发中。如需提供反馈或使用此功能，请联系 LangChain 团队。

​
安装

pip install langchain-auth

​
快速开始

​
1. 初始化客户端

from langchain_auth import Client

client = Client(api_key="your-langsmith-api-key")

​
自托管配置

对于自托管的 LangSmith 实例，请使用实例上的 /api-host 路径指定 API URL。 
export LANGSMITH_API_URL="https://your-langsmith-instance.com/api-host"
然后正常初始化客户端：
client = Client(api_key="your-langsmith-api-key")

​
2. 设置 OAuth 提供方

在代理能够进行身份验证之前，您需要按照以下流程配置一个 OAuth 提供方：
  1. 为您的 OAuth 提供方选择一个在 LangChain 平台中使用的唯一标识符（例如，“github-local-dev”、“google-workspace-prod”）。
  2. 转到您的 OAuth 提供方的开发者控制台，并创建一个新的 OAuth 应用程序。
  3. 在您的 OAuth 提供方中设置回调 URL： 
https://smith.langchain.com/host-oauth-callback/{provider_id}
例如，如果您的 provider_id 是 “github-local-dev”，请使用：
https://smith.langchain.com/host-oauth-callback/github-local-dev
  1. 使用 client.create_oauth_provider() 并传入您 OAuth 应用的凭证：
new_provider = await client.create_oauth_provider(
    provider_id="{provider_id}",  # 提供任意唯一 ID
    name="{provider_display_name}",  # 提供任意显示名称
    client_id="{your_client_id}",
    client_secret="{your_client_secret}",
    auth_url="{auth_url_of_your_provider}",
    token_url="{token_url_of_your_provider}",
)

​
3. 从代理进行身份验证

客户端 authenticate() API 用于从预配置的提供方获取 OAuth 令牌。在首次调用时，它会引导调用者完成 OAuth 2.0 认证流程。

​
在 LangGraph 上下文中

默认情况下，令牌的作用域通过 Assistant ID 参数限定到调用代理。 
auth_result = await client.authenticate(
    provider="{provider_id}",
    scopes=["scopeA"],
    user_id="your_user_id"  # 任何用于将此令牌限定到人类调用者的唯一标识符
)

# 或者显式指定 agent_id 以获取代理作用域的令牌
auth_result = await client.authenticate(
    provider="{provider_id}",
    scopes=["scopeA"],
    user_id="your_user_id",
    agent_id="specific-agent-id"  # 可选：显式设置代理作用域
)
在执行过程中，如果需要身份验证，SDK 将抛出一个 中断。代理执行暂停，并向用户展示 OAuth URL：
用户完成 OAuth 认证并收到提供方的回调后，他们将看到认证成功页面。
然后代理从暂停点恢复执行，该令牌可用于任何 API 调用。我们存储并刷新 OAuth 令牌，以便用户或代理未来使用该服务时无需再次进行 OAuth 流程。 
token = auth_result.token

​
在 LangGraph 上下文之外

向用户提供 auth_url 以进行带外 OAuth 流程。 
auth_result = await client.authenticate(
    provider="{provider_id}",
    scopes=["scopeA"],
    user_id="your_user_id"
)

if auth_result.status == "pending":
    print(f"请在以下地址完成 OAuth: {auth_result.url}")
    # 等待用户完成 OAuth
    completed_auth = await client.wait_for_completion(auth_result.auth_id)
    print("身份验证已完成！")
else:
    token = auth_result.token
    print(f"已通过身份验证，令牌: {token}")

​
故障排除

​
自托管：405 方法不允许

如果您收到 405 Method Not Allowed 错误，请确保 LANGSMITH_API_URL 指向 /api-host 路径： 
export LANGSMITH_API_URL="https://your-instance.com/api-host"

​
自托管：OAuth 回调 URL 格式错误

确保您的 OAuth 提供方的重定向 URI 与您的 LangSmith 实例 URL 匹配： 
https://your-instance.com/host-oauth-callback/{provider_id}
将这些文档 通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。