返回目录 / Agent 恢复
从保存的运行状态恢复中断Agent任务
保存可恢复运行状态,在进程中断后继续同一次Agent工作流。
目标
在临时中断后恢复运行,而不是把部分结果误当成完成答复。
步骤
- 区分完整最终答复、工具调用等待和可恢复的中间运行状态。 [openai-results] [openai-running]
- 运行后通过
state=result.to_state()保存RunState;必要时用state.to_json()/RunState.from_json(...)持久化。 [openai-results] [openai-running] - 在原session backend与session_id下恢复:
await Runner.run(agent, state, session=session);先独占原session历史。 [openai-results] [openai-running] - 处理状态过期或不兼容时显式失败,并提供从安全检查点重新开始的路径。 [openai-results] [openai-running]
- 模拟中断和恢复,确认已完成的副作用不会被无条件重复。 [openai-results] [openai-running]
验证方式
对可恢复的未终态运行保存/恢复RunState并续跑;若原session历史精确匹配,SDK先对账已完成工具结果,不重复执行工具。
故障处理
若保存状态不兼容,安全失败并从已验证检查点重启,不要盲目重放所有工具。
权限边界
前置条件
- Python 3.10+、固定提交兼容的 openai-agents、获准模型提供商凭据(本地模拟测试例外)
权限边界
- 只在本地或隔离测试环境操作;涉及外部数据或副作用时使用最小权限并先审批
限制
如果原session历史被并发改写或与待提交工具批次不精确匹配,恢复会fail closed。最终答复/终态hook已接受但保存失败的RunState不可恢复,必须开始新run。
固定上游来源
- 仓库
- openai/openai-agents-python
- 文件路径
- docs/results.md
- 固定提交
f53c62451c7f34c15f0c87fa745e05404025420f- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT