资讯动态

infiAgent 断点恢复机制详解:崩溃、断网、手动停止后如何无损续跑长任务

发布时间:2026/10/13 13:59:25 来源:尧图企业网站定制
人工智能大模型AI AgentAgent 框架多智能体AI 技能/插件【免费下载链接】infiAgentBuild your own Cowork, AI Scientist and other SoTA Agents just by editing config files. Support anthropic skills. An infinite-horizon agent framework designed for long-running, complex tasks.项目地址https://gitcode.com/gh_mirrors/inf/infiAgent点击查看免费下载infiAgent 是一个面向长程复杂任务的 Agent 框架主打**断点恢复resume**能力无论是进程崩溃、网络抖动还是手动 CtrlC 停止任务都可以从断点无损续跑而不是从头再来。本文带你快速理解它每轮自动存档 启动时自动对账 LLM 重试兜底的三层恢复设计以及 CLI 中一键续跑的操作方法。一、长任务为什么会中断infiAgent 的设计目标是让 Agent 连续运行数小时甚至更久比如文献调研、报告写作、代码重构。这类长任务必然会遇到三类中断中断场景表现infiAgent 的应对网络故障LLM API 连接重置、超时自动指数退避重试多数抖动直接自愈手动停止用户按 CtrlC 或/quit任务状态已存档可随时/resume续跑进程崩溃 / 断电进程直接消失重启相同任务即可从断点加载不丢进度下面拆解它是怎么做到的。二、断点恢复的核心三层持久化状态infiAgent 的每个任务都会把运行状态实时写入本地 JSON 文件这是无损续跑的根基。1. 每轮自动存档_actions.json检查点文件Agent 执行完每一轮工具调用后core/agent_executor.py 中的_save_state()会立即把完整现场写入检查点文件已执行的action_history动作轨迹用于重建对话消息pending_tools已解析但还没执行完的工具调用current_turn当前轮次续跑时从这里 1 继续latest_thinking最新思考摘要、工具调用计数器等文件由 utils/conversation_storage.py 的save_actions()负责落盘命名为{任务哈希}_{任务名}_{agent_id}_actions.json。只要进程还活着进度就是每轮级别的粒度——崩溃最多损失正在执行的那一轮。2. 任务级共享上下文stack 与 share_context除了单 Agent 的检查点整个任务还维护两份全局状态文件由 core/hierarchy_manager.py 管理{任务哈希}_{任务名}_stack.jsonAgent 调用层级栈记录当前跑到哪一层子 Agent{任务哈希}_{任务名}_share_context.json共享上下文包含current进行中的 Agent 状态、history历史归档、指令记录等这两份文件决定了任务是否可恢复以及恢复到哪个层级。SDK 文档中对恢复条件的定义很清晰只要存在可恢复的 stack任务就可以 resume见 docs/SDK_GUIDE.md。3. 运行登记防止复活成两个任务任务启动时utils/runtime_control.py 会把task_id pid agent_name user_input写入运行登记文件并通过 PID 心跳判断任务是否真的在跑。入口脚本 start.py 启动前会先检查如果发现同名任务仍存活直接报任务已在运行退出避免两个进程同时写同一份状态导致数据错乱。三、断网与临时故障LLM 调用自动重试兜底很多断网中断其实根本不需要人工介入。services/llm_client.py 的对话调用内置了增强重试循环指数退避默认最多重试 3 次间隔 2s → 4s → 6s网络错误识别connection reset、connection aborted、connection refused等典型网络抖动都会被识别为可重试错误错误提醒注入重试时自动在 system prompt 里追加重试警告提示 LLM 避免重复已失败的动作参数自修复工具参数类型错误会先做就地修复重试不消耗重试配额换句话说WiFi 闪断、API 偶发 5xx 这类问题绝大多数会在你按下/resume之前就已经自动恢复。四、手动停止 / 崩溃后两种无损续跑方式进程停止后重启任务时core/state_cleaner.py 的clean_before_start()会做一次对账这是续跑语义的关键输入与上次相同→ 判定为续跑保留所有 running 状态的 Agent 和调用栈接着上次干输入变了→ 判定为新任务把上一轮中断的 Agent 归档进history状态标记为interrupted附上最新思考和已完成的子任务输出然后清空 current 重新开始方式 1重新输入相同任务自动续跑最简单粗暴也最可靠的办法——用相同的 task_id 和相同的任务描述再跑一次 start.pypython start.py --task_id /path/to/my_task --agent_system OpenCowork --user_input 写一份调研报告启动时会看到检测到相同任务将续跑然后自动跳过已完成的部分。恢复时还有两个贴心细节见 core/agent_executor.py如果上次已经产出了final_output直接返回上次结果不做任何重复工作如果上次停在工具已决定、尚未执行的状态_recover_pending_tools()会按 core/agent_executor.py 的逻辑把挂起的工具调用逐条补执行并写回历史方式 2CLI 交互模式下的/resume命令在--cli交互模式下见 utils/cli_mode.py按 CtrlC 中断任务后界面会提示✅ 任务已中断 输入 /resume 回车可续跑输入新内容开始新任务此时输入/resumeCLI 会列出发现的中断任务——包括 Agent 名、任务描述、中断时间、调用栈深度——确认后一键恢复。完整命令表参见官方文档 docs/CLI_GUIDE.md。五、SDK / 后台恢复一条调用让停止的任务复活除了 CLIinfiAgent 的 SDK 也提供后台恢复能力。utils/task_runtime.py 的resume_task_with_fresh()会在任务不在运行时从 stack 和 share_context 中读取恢复元数据agent_name、user_input、agent_system重新加载 Agent 配置、工具注册表、MCP 与 Skill 缓存在后台守护线程里重建AgentExecutor并继续执行配套的append_task_message()utils/task_runtime.py还支持先追加消息、任务未运行则自动拉起恢复的组合操作——这对多 Agent 协作场景如 CheapClaw 应用非常实用。典型用法参考 docs/SDK_GUIDE.md。在 VS Code 插件中你甚至可以直接在 IDE 里观察任务执行过程并随时介入恢复六、断点恢复实战速查表我想……该怎么做手动停掉后继续CLI 输入/resume确认恢复崩溃 / 断电后继续用相同--task_id和--user_input重新启动重新开始、丢掉旧进度启动时加--force-new参数断网期间怎么办不用管LLM 调用自动指数退避重试通过 SDK 拉起已停止任务调用resume_task_with_fresh()或append_task_message(resume_if_neededTrue)查看任务状态 / 进度看 share_context 文件或 Web 界面总结infiAgent 的断点恢复机制可以概括为一句话每轮自动存档启动自动对账网络故障自动重试。检查点文件保证最多丢一轮state_cleaner 的对账逻辑保证相同任务续跑、新任务干净起步而/resume命令和 SDK 的后台恢复则让无损续跑变成了一次回车或一行调用的事。对于需要跑几小时的长任务这套机制正是它最让人放心的能力。赞分享人工智能大模型AI AgentAgent 框架多智能体AI 技能/插件【免费下载链接】infiAgentBuild your own Cowork, AI Scientist and other SoTA Agents just by editing config files. Support anthropic skills. An infinite-horizon agent framework designed for long-running, complex tasks.项目地址https://gitcode.com/gh_mirrors/inf/infiAgent点击查看免费下载相关推荐Friend Maker恢复任务指南暂停、中断、崩溃后如何续画长图完整步骤Friend Maker恢复任务指南暂停、中断、崩溃后如何续画长图完整步骤 Friend Maker 是一款面向 macOS / Windows 的桌面工桌面应用智能硬件固件图像处理BuilderPulse入门指南如何在10分钟内开始使用这个AI信号分析工具BuilderPulse入门指南如何在10分钟内开始使用这个AI信号分析工具 BuilderPulse是一个AI驱动的每日情报工具专门为独立开发者和创业者设VoiceCraft错误恢复机制网络中断后的任务续跑方案VoiceCraft错误恢复机制网络中断后的任务续跑方案 引言训练中断的隐形成本 在语音合成Text to Speech, TTS模型的训练过程中网络人工智能大模型语音音频创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑