跳转到主要内容
本文统一产品文档中的概念用法。API 标识、错误码和代码字段保持英文;中文解释不改变协议名称。状态值必须按对象区分,不能将 Session、Run、Runtime 和云资源的状态混用。

三个容易混淆的表达

  • “任务完成”应指 Run 的真实终态与交付检查,不能仅凭模型说“完成了”。“资源清理完成”另需远端确认。
  • “连接可用”必须说明是结构验证、账户验证、启用还是实际调用成功;ready 不意味着全部操作均有权限。
  • “支持恢复”必须说清保留的是工作区文件、对话、进程还是内存,以及对应 Provider/Harness 的证据。
写作时优先使用“向同一 Session 提交新 Run”“继续观察原 Run”“关闭并确认资源清理”这类明确动作,不用“重启一下”同时指代恢复、重放、新建和删除。

明确操作以及保留的身份

“重放”必须说明对象:重放持久事件是观察,重放外部写入可能再次产生副作用。“重试”同样需要原请求身份和明确策略。见恢复指南。

写作与翻译约定

两种语言都保持 Session、Run、Harness、Runtime 及 API 字段、状态值原样。中文正文可先用本表释义介绍概念,再使用 API 名称保持精确。讨论可复用配置时使用“Agent 模板”,讨论选定版本时使用“Agent revision”;单写“Agent”容易与执行模型循环的引擎混淆。 不要将 waiting_authorization 或 waiting_approval 翻译成另一套协议值。界面标签可以解释含义,但实际动作应依据关联连接、审批和 Tool call 记录。同样,unknown 表示已记录的不确定性,不是 failed 的另一种中文表达。精确状态定义由状态参考维护,本页承担术语入口。 本页依据已链接的对象契约和实现说明整理,不新增接口或状态值。下一步:对象关系、能力与证据。