给 Agent 一个说得清的工具
名称、用途、参数与返回结果 · 约 15 分钟(含练习)
这节学会什么为一个只读查询工具写清用途、输入和结果,并说明异常如何返回。
原课概念 · 中文节选译文
工具是提供给大语言模型的函数,应当完成一个清楚的目标。工具可以用于搜索网页、检索资料、计算,或访问外部 API。
工具至少要说明函数的用途、可被调用的实现,以及带类型的参数;返回值也可以声明类型。模型生成工具调用的表示,Agent 程序负责识别并执行,再把结果加入上下文,交给模型继续处理。
查看对应英文原文与固定版本 ↗先做一个只读工具
假设工具叫 query_enrollment,输入 learner_id 和 class_id。它只查询这一名学员在这一班次的报名,不自动付款或改期。返回 status、record_id、checked_at 和 source。这里的工具合同及字段是九天自编练习。
把“查不到”和“没报名”分开
系统连接超时返回 unavailable;查到有效记录返回 found;在明确查询范围内没有匹配记录返回 not_found。身份无法确认则请求补充信息。不要让一个空字符串同时代表以上四种情况。
带走一个小作品
- 为自己的任务写一个只读工具,说明它解决哪一个问题。
- 给每个参数写类型、来源和必填条件,不把用户姓名直接当稳定身份。
- 列出成功、未找到、无权限、超时四种结果;说明哪些情况必须停止或人工核对。
完成标准一份工具合同:名称|用途|输入字段|输出字段|权限范围|错误结果。
仅保存在当前浏览器