工具契约、执行循环与失败退出

AI 生成的实现建议，未作为真实执行记录。

1. 用本地样例实现工具

先用固定字典或 JSON 文件保存 3 条笔记。read_note 只接收这些笔记的编号；查找不到返回结构化错误。让工具在没有模型时也能独立运行，便于分清工具错误与模型选择错误。

2. 写清参数契约

用 JSON Schema 表达必填字段、字符串长度和结果数量范围。服务端再次校验输入；即使模型给出的 JSON 结构正确，也必须校验编号属于允许集合。不要把字符串直接拼接成 shell 命令或数据库语句。

3. 建立有限调用循环

每轮保存请求编号、工具名称、经过脱敏的参数、开始/结束毫秒时间和结果状态。执行前检查本轮调用额度，发生超时或连续失败时停止，并告诉读者哪些资料未能读取。

4. 对齐调用与答案

回答只能使用本轮已经取得的笔记片段。最终输出给出引用编号和不足信息；没有调用成功时不要声称已经检索、已经核对或已经完成。资料里的指令文字不能改变工具权限。

5. 准备边界样例

• 正常问题：搜索到一篇笔记后读取并回答。
• 无相关资料：返回没有足够依据，不换成猜测。
• 异常参数：模型请求不存在的编号，程序拒绝并留下失败状态。
• 重复调用：同一请求反复搜索，达到局部上限后退出。
• 含指令笔记：笔记声称要求读取目录外文件，仍被工具白名单拒绝。

下一步

补入真实工具实现、调用过程和失败案例，再决定是否增加界面或检索能力。本示例不需要生产账号、真实消息通道或网站后台权限。