处理网关故障
网关故障会以AgentGatewayError 的形式重新抛出:
处理 schema 错误
AgentSchemaValidationError 用于标识无效的工具输入/输出、进度事件或最终输出。应将其视为契约错误,而不是暂时性模型故障。
检查失败的运行
如果运行时可以为失败保存检查点,请检查:result.run.statusresult.run.error- 最新步骤的
status、error和modelAttempts - 用于关联网关日志的
requestId和nativeResponseId
常见检查项
- 确认服务器进程可以读取
PHASEO_API_KEY。 - 为每个工具分配唯一且稳定的
id。 - 批准、拒绝或提供手动输出时,请使用精确的工具调用 ID。
- 限制模型重试次数;验证或审批失败时不要盲目重试。
- 将控制权交还浏览器或队列工作进程前,请先持久化暂停运行的状态。