学习系列课M3 · 职业版 Agent · 第 2 讲

M3 · 职业版 Agent · 第 2 讲

第 2 讲:工具调用与记忆

能动手,也要记得住

一个真实故障

会议纪要助手调用“发送邮件”工具失败,重试了三次。结果客户收到三封一样的邮件——因为工具不是幂等的,Agent 也不知道自己重复了。

工具设计得好不好,决定了 Agent 是“能干活的助手”还是“会闯祸的脚本”。

本讲目标

一、工具描述五要素

本讲第 1 张表:一、工具描述五要素
要素 写法 反例
名字 动词_对象,如 send_email tool1
用途 一句话说清什么时候用 “很强大的工具”
参数 类型、必填、取值范围 只写“参数”
返回 成功/失败的结构 返回一大段自然语言
错误 可重试还是终止 统一报“出错了”

描述不是给人看的文档,是给模型的决策依据。

二、最小工具集

一个纪要流程只需要三个工具:

  1. 读取转写文本;
  2. 写入纪要文档;
  3. 发送通知(需确认)。

不要一上来接十个系统。工具越多,选错的概率越高。

三、幂等与重试

非幂等工具必须带唯一键,并在重试前查询是否已执行。重试次数上限 2 次,超出转人工。

四、三层记忆

本讲第 2 张表:四、三层记忆
层 存什么 生命周期
会话记忆 当前任务的上下文 一次会话
长期记忆 用户偏好、常用模板 跨会话,可清除
外部知识库 制度、产品文档 长期,按版本更新

记忆不是越多越好。记错的信息,比不记更危险。

五、什么不该记

写一条“记忆清理”规则:超过 90 天未使用的偏好自动归档。

六、30 分钟练习

  1. 为一个流程写三个工具描述(10 分钟);
  2. 标出哪个工具非幂等,补唯一键(5 分钟);
  3. 设计三层记忆各存什么(10 分钟);
  4. 写一条清理规则(5 分钟)。

七、验收清单

八、延伸阅读


下一讲:评测与验证。工具接好之后,先证明它“做对了”,再谈常驻。