Agent Space任务中断后需从断点精准接续:先查Tasks中status为paused且含checkpoint_id的任务;再用agent-cli resume按thread_id、checkpoint版本或override参数恢复;最后通过日志、中间产物和空消息验证是否成功定位至中断节点。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Agent Space任务执行到一半被中断后,需要从断点处精准接续,而不是重新加载对话或重跑全部流程。
确认当前任务是否已持久化状态
打开 Agent Space 控制台 → 进入「Tasks」标签页 → 查找目标任务 ID 对应的记录。若该任务行末显示 【Status: paused】 且有非空的 checkpoint_id 字段,则说明系统已自动保存执行快照;若仅显示 running 或 missing,则未触发有效存档,需手动补救。
这一步不可跳过。没有 checkpoint_id 的任务无法恢复,强行 resume 会触发全新任务实例,导致重复修改、测试错位或文件覆盖。
使用 CLI 恢复挂起任务
方法一:通过 thread_id 直接恢复
在终端中执行:agent-cli resume --thread-id session-7a3f9d。注意 thread_id 必须与中断前完全一致,大小写和连字符都不能错。
方法二:指定 checkpoint 版本恢复
若存在多个 checkpoint(例如因多次 interrupt_before 工具调用生成),先运行 agent-cli list-checkpoints --thread-id session-7a3f9d 查看时间戳和步骤摘要,再选择最接近中断时刻的版本号:agent-cli resume --thread-id session-7a3f9d --checkpoint v3。
方法三:带参数覆盖恢复(仅限执行参数更新场景)
当用户在中断后提出新条件(如“把超时设为120秒”),可在恢复命令中追加 --override timeout=120。该操作会更新当前任务计划,但不改变 task_id 和已完成步骤清单。
验证恢复是否成功
第一步:检查日志头行
运行 agent-cli logs --thread-id session-7a3f9d --tail 5,确认最新日志以 “Resumed from checkpoint v2 at step: modify_module_b” 开头,而非 “Started new task”。
第二步:比对中间产物
进入项目目录 → 执行 ls -l .agent_state/ → 确认 【modified_files.json】 内容与中断前最后一次 commit 中的变更列表一致;若该文件为空或缺失,说明状态未正确加载,立即停止后续操作。
第三步:触发下一步动作
向 Agent Space 发送一条空消息:agent-cli send --thread-id session-7a3f9d --content ""。若返回 “Waiting for tool result: write_test_case” 类提示,则表示已准确定位至中断节点;若返回 “Analyzing project structure…” 则恢复失败,需回退至上一阶段人工干预。


















