Skip to main content
某些工具需要用户授权(例如 Google、Slack、GitHub)。LangSmith Fleet 包含中间件,用于检测工具何时需要授权,并暂停运行,同时向用户显示清晰的提示。用户完成身份验证后,系统会自动重试相同的工具调用。

请求身份验证的返回格式

如果工具检测到缺少授权,请返回包含以下字段的 JSON 字符串:
{
  "auth_required": true,
  "auth_url": "https://auth.example.com/start",
  "auth_id": "opaque-tracking-id"
}
  • auth_required:设置为 true 以表示需要中断。
  • auth_url:用户应重定向至此处进行授权。
  • auth_id:可选的相关 ID,用于跟踪身份验证会话。
当 Fleet 检测到此响应时,它会中断运行,向用户显示身份验证界面,并在授权完成后自动重试工具调用。 如果您希望自定义工具复用相同的“需要身份验证”中断和界面,请确保您的工具返回相同格式的 JSON。
仅将此 JSON 作为工具的输出返回。避免包含额外的文本或内容。Fleet 会解析响应以触发身份验证流程。