跳转到主要内容
先保存 Session、Run、操作 ID 和最后事件 cursor,再调查。重试前确认动作是否可能已经生效;不要把所有错误都归因于用户凭据或建议重新创建任务。

症状索引

示例:没有新事件

读取 Run:若 waiting_approval,则查看审批记录与 Tool 调用;用户确认后由有权限身份提交决定。如果 Run 已 completed,则问题可能在游标处理,补读事件并读取 output。如果 Runtime unreachable,记录原绑定与阶段,观察恢复,不另启 Harness。 这三种情况界面都可能“没有新文本”,但操作完全不同。网络连接恢复不代表外部写入已确认,Tool outcome unknown 要进入对账流程。

先做一次有界的只读检查

已有 Session / Run ID 时,可使用仓库中的诊断程序。先按示例准备说明安装对应 SDK,再从仓库根目录选择一种客户端执行:
将占位 ID 替换为原任务标识。这两个 CLI 使用本地工作区发现,不是 hosted Token 配置示例。程序先核对 Run 属于指定 Session,再读取状态、有限事件页和产物元数据;不会提交、取消、批准或关闭任务。输出仍含私有资源 ID,按本地诊断记录保管。
  • run_state 与 error_code 帮助选择症状分支;无 error_code 不代表所有依赖健康。
  • event_type_counts 只是本次读取范围内的计数,不能当作全部历史统计。
  • reached_empty_event_page 不代表任务完成;last_observed_cursor 不是应用已处理事件的持久检查点。
  • 查询不是原子快照,过程中状态可能变化。不要因几次字段不一致就重建任务,应按同一标识继续核对。

真实记录:凭据入口停止后的恢复

2026-11-18 自动凭据入口验收记录了一个真实云场景:控制平面仍在运行,但受保护模型请求使用的凭据入口被有意停止。它证明“API 能访问”与“Sandbox 能完成受保护上游调用”是两条不同链路。 同一记录还保留了一次实现问题:恢复保护条件曾把空闲 Runtime 也当成必须阻止替换入口的活动任务,后续缩小到已持久化的非终态 invocation;没有删除原任务资源来绕过保护。排查时应区分保护条件误判与真实活动调用,不能通过杀掉原任务来制造“恢复成功”。 如果当前出现 credential_ingress_recovery_blocked,先查看是否仍有需要原入口的持久活动 invocation。对显式禁用或外部 / hosted 入口,平台遵循部署策略,不会擅自打开开发隧道。按网络入口指南处理对应部署,并以原任务状态、实际调用结果与清理为完成信号。

把症状定位到负责的层

收集可用问题报告

包含代码 / SDK 版本、Provider 与 Harness 版本、模型协议、发生阶段、脱敏错误、复现步骤、预期与实际结果、相关证据路径、资源是否已清理。私有资源 ID 留在本地便于后续清理,公开报告使用脱敏引用。不要粘贴 owner Token、数据库连接密码、预览 ticket、原始 header 或供应商响应体。 有历史失败但后来成功时,分别说明每次尝试;不要删除失败记录让结果看似全部通过。模拟复现与真实云复现也分别标明。

对应操作手册

本索引依据当前各操作契约组织,具体错误以原始状态和受控诊断为准。完成排障需观察目标行为恢复并确认资源结果,不能仅以错误提示消失为完成。