原 Run 等待时如何恢复
观察 Run 状态和 Tool 调用记录。waiting_authorization 应结合具体调用解释,不能只展示“正在思考”。在 Console 找到对应连接,完成账户授权或更新凭据,验证并启用。正常 worker 将继续处理原 Run,不需要为恢复另外提交一个任务。
OAuth 连接需要部署方配置对应应用注册和正确 callback。凭据代理 tunnel 不是管理 API 或 OAuth callback tunnel。直接提供的外部 access token 不一定具有自动刷新能力;账户范围和服务能力以连接器契约为准。
区分账户修复与操作同意
optional_tools 允许初始化时延后授权,不会让所有依赖检查都变成可选,也不会让执行跳过授权。首次调用仍可能等待。拒绝授权是调用级响应;账户凭据撤销、单 Session 访问撤销和 Run 取消是范围不同的动作。
修复账户后,继续观察原 Run 和调用。若策略要求审批,下一步应展示具体操作,不能宣布整个任务成功。连接版本变化时刷新审批数据,之前显示的同意卡片可能已经失效。
查询与拒绝一次授权请求
Python:tool_authorization_denied,原 Run 可以继续解释限制。它不撤销账户凭据、不取消 Run,也不禁止以后新的调用再次请求授权。
重复相同拒绝返回已记录结果,不重新启动任务。hash 不匹配、非待处理调用、已在执行或取消竞态会被拒绝;重新查询实际状态后决定下一步,不能修改 hash 绕过校验。
凭据失效与外部结果未知
授权失败后补充正确凭据不意味着可以重做任何已发出的操作。若先前写入已经发送但结果未知,按Tool 对账处理。拒绝授权也不能撤销此前已发生的请求。 关闭或取消 OAuth consent flow 与取消 Run 是不同动作。用户离开授权页面时应保留可恢复的等待状态,允许其明确拒绝或稍后完成,不生成新的重复任务。 验证成功路径时确认同一 Run 继续;验证拒绝路径时确认没有新外部调用、凭据未被修改、原任务能够解释拒绝。不同应用的真实账户验证范围参见应用连接器。下一步:人工审批。通过 SDK 修复手动提供的凭据
对于接受手动凭据的连接器,在后端使用管理客户端,从私有服务端配置取得同一目标账户的新凭据。以下片段更新已有连接,不创建替代 Run,也不会自动批准该操作。unknown 时,先调查绑定或外部结果再继续。