工具不是魔法按钮，而是 Agent 与世界的契约

模型本身不能读取你的文件、发送邮件或查询数据库。工具把这些外部能力包装成 Agent 可以选择的动作，也同时划定它能够做什么。

好工具要有清楚边界

工具名称应该表达动作，参数应该尽可能少且可验证，返回值要包含下一步判断需要的信息。模糊的“处理数据”比“按订单号读取订单状态”更容易被误用。

错误也属于契约。工具要区分输入无效、权限不足、暂时失败和资源不存在，让 Agent 知道应该修正参数、重试、换路还是请求人工帮助。

写操作比读操作更谨慎

读取通常可以直接执行，修改和删除则应增加确认、幂等键或预览步骤。权限不应该因为 Agent 可能需要就一次性全部开放。

设计工具时，把 Agent 当作能力很强但会误解上下文的调用者。清楚的契约既帮助模型，也保护系统。