目标:让 Agent 在明确边界内调用工具
只读工具调用学习助手
本文为 AI 生成的学习示例,不对应真实用户已经上线的助手,不包含运行成功率或完成履历。
要学习什么
理解模型提出工具调用、程序校验并执行、模型读取结果这三个步骤各自的责任。首版只操作自己准备的少量样例笔记,让每一次调用都可以解释和复核。
两个工具
| 工具 | 输入 | 返回 | 边界 |
|---|---|---|---|
search_notes |
关键词、结果上限 | 笔记编号、标题、短摘要 | 仅检索固定样例集合 |
read_note |
笔记编号 | 原文片段、来源编号 | 仅允许已登记的编号 |
工具不接受任意文件路径、网址或命令,不修改文件,不向外部账号发消息。模型选择工具不等于已经获得执行权限,实际范围由程序校验。
最小闭环
用户提出问题,助手选择搜索工具,程序返回候选笔记,再按需读取并组织带来源的回答。每轮最多 3 次工具调用,到达上限时返回当前结果与不足,不无限重试。这个数字是本学习示例的局部约定,不修改网站统一规则。
验收清单
- 未登记的工具名和参数均被拒绝。
- 编号不存在、参数为空、工具超时时有可解释的失败结果。
- 回答里引用的编号在本轮实际读取结果中存在。
- 调用记录只包含练习数据,不包含 API Key 或真实个人信息。
当前状态
已准备目标、工具契约与实现路线;具体模型接入、代码与真实调用记录留待实践。