跳到内容
九天共学
海外开放课程 · 中文共读
AGENT FOUNDATIONS / 02 · 中文节选译读

给 Agent 一个说得清的工具

名称、用途、参数与返回结果 · 约 15 分钟(含练习)

这节学会什么为一个只读查询工具写清用途、输入和结果,并说明异常如何返回。

FROM THE OPEN COURSE

原课概念 · 中文节选译文

工具是提供给大语言模型的函数,应当完成一个清楚的目标。工具可以用于搜索网页、检索资料、计算,或访问外部 API。

工具至少要说明函数的用途、可被调用的实现,以及带类型的参数;返回值也可以声明类型。模型生成工具调用的表示,Agent 程序负责识别并执行,再把结果加入上下文,交给模型继续处理。

查看对应英文原文与固定版本 ↗
九天补充 / 自编案例

先做一个只读工具

假设工具叫 query_enrollment,输入 learner_id 和 class_id。它只查询这一名学员在这一班次的报名,不自动付款或改期。返回 status、record_id、checked_at 和 source。这里的工具合同及字段是九天自编练习。

把“查不到”和“没报名”分开

系统连接超时返回 unavailable;查到有效记录返回 found;在明确查询范围内没有匹配记录返回 not_found。身份无法确认则请求补充信息。不要让一个空字符串同时代表以上四种情况。

TRY IT YOURSELF

带走一个小作品

  1. 为自己的任务写一个只读工具,说明它解决哪一个问题。
  2. 给每个参数写类型、来源和必填条件,不把用户姓名直接当稳定身份。
  3. 列出成功、未找到、无权限、超时四种结果;说明哪些情况必须停止或人工核对。

完成标准一份工具合同:名称|用途|输入字段|输出字段|权限范围|错误结果。

仅保存在当前浏览器

查询接口超时,助理应该怎样解释?

接上你的下一步

用本体论进一步说清任务里的对象、规则与动作;需要聊真实业务需求或合作,也可以进入九天 Agent。

使用统计:关闭

帮助心晴了解哪些内容有用。默认关闭;不记录问题正文、私人笔记、手机号或聊天内容。

允许关联后,登录账号的页面与操作可由运营查看。已启用浏览器“不跟踪”时不采集。明细最多保留 90 天,后台读取或每日首次采集时清理。