某些 工具 某些工具需要用户授权(例如 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 检测到此响应时,它会中断运行,向用户显示认证 UI,并在授权完成后自动重试工具调用。
如果希望自定义工具重复使用相同的认证中断 + UI,请确保工具返回相同结构的 JSON。