跳转到主要内容
工具授权解决“这个账户是否有可用凭据来调用该服务”。单次审批解决“是否允许现在执行这一项具体操作”。两者可能先后发生,不能把授权成功当作批准所有写操作。 先配置并绑定工具。需要在后续任务中才授权的工具应按实际需求声明为 optional;缺少必需授权可能在 Session 初始化阶段就被拒绝。

原 Run 等待时如何恢复

观察 Run 状态和 Tool 调用记录。waiting_authorization 应结合具体调用解释,不能只展示“正在思考”。在 Console 找到对应连接,完成账户授权或更新凭据,验证并启用。正常 worker 将继续处理原 Run,不需要为恢复另外提交一个任务。 OAuth 连接需要部署方配置对应应用注册和正确 callback。凭据代理 tunnel 不是管理 API 或 OAuth callback tunnel。直接提供的外部 access token 不一定具有自动刷新能力;账户范围和服务能力以连接器契约为准。

区分账户修复与操作同意

optional_tools 允许初始化时延后授权,不会让所有依赖检查都变成可选,也不会让执行跳过授权。首次调用仍可能等待。拒绝授权是调用级响应;账户凭据撤销、单 Session 访问撤销和 Run 取消是范围不同的动作。 修复账户后,继续观察原 Run 和调用。若策略要求审批,下一步应展示具体操作,不能宣布整个任务成功。连接版本变化时刷新审批数据,之前显示的同意卡片可能已经失效。

查询与拒绝一次授权请求

Python:
TypeScript:
这些拒绝操作需要当前权限允许的管理身份;普通 application Token 不具有该变更路由权限。浏览器不能直接拿 owner Token;由已授权服务端或 Console 执行。 拒绝只影响这次待授权调用。Harness 收到 tool_authorization_denied,原 Run 可以继续解释限制。它不撤销账户凭据、不取消 Run,也不禁止以后新的调用再次请求授权。 重复相同拒绝返回已记录结果,不重新启动任务。hash 不匹配、非待处理调用、已在执行或取消竞态会被拒绝;重新查询实际状态后决定下一步,不能修改 hash 绕过校验。

凭据失效与外部结果未知

授权失败后补充正确凭据不意味着可以重做任何已发出的操作。若先前写入已经发送但结果未知,按Tool 对账处理。拒绝授权也不能撤销此前已发生的请求。 关闭或取消 OAuth consent flow 与取消 Run 是不同动作。用户离开授权页面时应保留可恢复的等待状态,允许其明确拒绝或稍后完成,不生成新的重复任务。 验证成功路径时确认同一 Run 继续;验证拒绝路径时确认没有新外部调用、凭据未被修改、原任务能够解释拒绝。不同应用的真实账户验证范围参见应用连接器。下一步:人工审批。

通过 SDK 修复手动提供的凭据

对于接受手动凭据的连接器,在后端使用管理客户端,从私有服务端配置取得同一目标账户的新凭据。以下片段更新已有连接,不创建替代 Run,也不会自动批准该操作。
继续观察,不预期调用后立即进入终态。托管 OAuth 连接器应使用对应授权流程,不能用这些手动凭据片段替代,参见应用账户。全程保留原 Run 和 call ID;验证显示账户改变,或者调用已经是 unknown 时,先调查绑定或外部结果再继续。

已记录的成功与拒绝案例

11 月 16 日云旅程记录 Instabox/Pi/SiliconFlow 上双 SDK 的运行时报告授权、随后审批和恰好一次 fixture 报告写入。报告服务是受控测试设施,不是真实 SaaS 账户。授权拒绝记录另行记录 E2B/OpenCode/MiniMax 任务中的 Console 拒绝:原 Run 完成并说明拒绝原因,报告连接保持 draft,没有创建审批,报告写入为零。 这些都是带日期的验收记录。拒绝回归测试还通过真实双 SDK 传输对本地服务检查重复拒绝、hash、租户、取消保护和凭据不变。阅读测试源码不是新一次执行,这些记录也不证明所有账户的过期或刷新流程。 依据:连接管理、Tool broker、应用授权。下一步:审批、凭据轮换、事件和状态。