第十篇:检查点(Checkpoints)——AI 的后悔药
Hermes Agent 官方教程第十篇:检查点。让 AI 的每一步修改都可回滚。
这篇讲的是:怎么让 Hermes Agent 记住工作到一半的状态,随时“存档”和“读档”,再也不怕跑飞了。
你有没有玩过那种不能存档的游戏?打了一小时,手一滑,从头再来,心态直接崩了。AI 跑任务也一样——如果中途断网、报错、或者你突然想改需求,之前跑了一大半的结果可能全没了。 Hermes Agent 的“检查点”(Checkpoints)功能,就是给 AI 准备的“存档位”。它能把当前的工作进度、对话上下文、甚至临时变量都存下来,下次直接接着跑,而不是从头再来。
下面我们一步步来看怎么用。
第 1 步:开启检查点功能(默认是关的)
在启动 Hermes Agent 的时候,加一个参数就行。打开你的终端(或者命令行工具),输入:
hermes --checkpoint-enable
就这么简单。启动之后,Agent 每完成一个关键步骤(比如调用完一个工具、生成完一段代码),都会自动存一个“检查点”。
注意:如果你用的是配置文件,也可以在
config.yaml里写上checkpoint_enable: true,效果一样。
第 2 步:手动存档(像游戏里按 F5)
有时候你想在某个特定节点存个档,比如“刚处理完数据清洗,还没开始分析”。这时候不用等自动存档,直接对 Agent 说:
请创建一个检查点,命名为“清洗完成”
Agent 会回复你一个检查点 ID(一串字母数字),比如 ckpt_8f3k2a。记下这个 ID,它就是你的“存档编号”。
第 3 步:读档(后悔药怎么吃)
假设第二天你继续跑任务,或者刚才跑崩了。重新启动 Hermes Agent,然后输入:
hermes --checkpoint-load ckpt_8f3k2a
或者直接在对话里说:
从检查点“清洗完成”继续
Agent 会恢复当时的全部状态——包括聊过的内容、变量值、甚至中间产生的临时文件路径。你可以直接说“继续分析”,它就知道从哪开始,不会问你“我们刚才聊到哪了”。
第 4 步:查看和管理存档
存多了记不住?没关系,用这个命令列出所有检查点:
hermes --checkpoint-list
你会看到类似这样的输出:
ID: ckpt_8f3k2a | 名称: 清洗完成 | 时间: 2025-01-15 10:32
ID: ckpt_x9m4q1 | 名称: 分析初稿 | 时间: 2025-01-15 11:02
想删除某个没用的存档(比如实验失败的),就:
hermes --checkpoint-delete ckpt_x9m4q1
第 5 步:给检查点设置“自动过期”(可选)
如果你担心存档太多占空间,可以设置只保留最近 5 个:
hermes --checkpoint-keep 5
这样每次新存档生成,最老的那个会被自动清理。适合跑长任务、但不想手动删档的情况。
生活化比喻总结:检查点就是 AI 的“游戏存档”。自动存档是系统帮你保底,手动存档是你自己掌握节奏,读档是后悔药,列表管理是存档管理界面。强烈建议跑长任务(超过 10 分钟)时开启这个功能,不然中途断了真的会哭。
下一篇预告:第十一篇:记忆(Memory)——让 AI 记住你的偏好,不用每次重复交代。我们聊聊怎么让 Agent 变成“老熟人”。
📖 官方文档
本文根据 Hermes Agent 官方文档编写,原文见:官方文档 › user-guide/checkpoints-and-rollback