ARTICLE · 1110834
Hermes工具说明:参数约束比功能介绍更重要
Hermes Agent · 双智能体实验室
Hermes工具说明:参数约束比功能介绍更重要
把必填项、格式和失败返回写清楚,Agent调用时才不会靠猜。
很多人处理“工具说明”时,第一反应是继续增加工具、提示词或重试次数。但真正影响结果的,往往是任务边界没有被写清楚,导致Agent不知道该停在哪里、交付什么。
在“工具说明”这类任务里,最容易被忽略的是过程中的中间状态。表面上看只是一次调用,实际上还包含准备、交接、异常和验收。如果没有明确的输入、输出和责任边界,执行越快,错误传播得越快。
更稳妥的做法,是把一次任务看成一条可以回放的链路:先确认材料和权限,再执行具体动作,最后回读真实结果。每一步都留下简短状态,下一阶段只接收必要字段。

明确目标 → 调用工具 → 记录过程 → 回读验收
01 先定义输入和完成标准
先写清楚来源、范围、格式和最终交付位置。在“工具说明”场景中,输入不只是几句话,还包括时间范围、对象范围、不可修改项和必须保留的证据。完成标准也要具体到别人可以复核,而不是只写“处理完成”。
当资料不完整或规则互相冲突时,Agent应该先列出缺口并暂停,而不是用猜测补齐。这样做看似慢一步,实际能避免后续整条链路返工。
02 把执行拆成三个可观察阶段
准备、执行、验证,是比“直接开始”更可靠的结构。准备阶段确认输入和权限;执行阶段只做当前步骤允许做的动作;验证阶段重新读取目标位置,确认状态、内容和格式都符合要求。
如果中途失败,要记录失败发生在哪一段,以及已经产生了哪些副作用。明确检查点后,恢复时可以从最近的可靠状态继续,而不必从头重跑。
03 给高风险动作留下确认点
涉及覆盖、删除、外发、收费或正式提交时,先展示对象和影响范围。确认信息要包含数量、位置、版本和预期结果,让人可以快速判断是否真的要继续。
低风险的搜索、整理、格式化可以自动化;高风险动作则由人保留最终决定。这样的分工既不会让人重复搬运,也不会让自动化越过边界。
实际执行时,可以把这条链路做成一张小清单:任务名称、输入来源、当前状态、已完成动作、异常信息、结果位置和下一步负责人。清单不需要复杂,但必须足够具体,让另一个人能够根据它继续工作。这样既方便人工接手,也方便Agent在下一轮读取。
结果对比:以前只看动作有没有执行,现在同时看输入是否正确、过程是否可追踪、结果是否能直接使用。
判断标准:任何人接手这项任务,都能根据记录知道已经完成什么、还缺什么、下一步由谁负责。
常见误区:把一次成功返回、一个存在的文件或一条发送记录,直接当成完整交付。
你可以从下一次“工具说明”任务开始实践:先写一行交付标准,再列三个阶段,最后安排一次回读。完成后把有效的字段、提示和检查点保存下来,逐渐形成自己的可复用模板。
一句原理:Agent的可靠性来自可观察的过程,而不是来自一次看起来顺利的调用。
当任务有了清晰的输入、动作、状态和证据,效率提升就不再依赖运气。真正值得保存的不是某次偶然成功,而是下一次仍然能够复用的方法。
下篇预告:如何把一次执行记录整理成团队可以共同使用的流程资产。