Agent 与工作流实战工具MCP接口
工具描述：写给 Agent 看的接口说明
工具名、何时用、参数含义、返回结构、失败怎么办，写清才不会被乱调。
提示词模板
请帮我写一个工具的调用说明（给 Agent 用的 function / tool 定义）。
工具做什么：{{一句话}}
底层接口：{{方法、URL、鉴权方式}}
参数：{{逐个列出：名称、类型、是否必填、取值范围、含义}}
返回：{{成功结构、失败结构、错误码}}
限制：{{频率、超时、单次上限、付费}}
请输出：
1. 工具名（动词开头，snake_case，不超过 4 个词）；
2. description：3–5 句，说明什么时候该用、什么时候不该用、和其他工具的区别；
3. 参数 JSON Schema，每个字段带 description 和示例值；
4. 返回值说明 + 一个真实响应示例；
5. 失败处理约定：超时、限流、空结果、参数错误分别该重试还是放弃；
6. 三个容易误用的场景，以及正确的调用方式。
description 里不要写实现细节，要写「什么时候用」。需要替换的部分
复制模板后，把下面这些 {{…}} 换成你的真实信息；没有的信息宁可留空，也不要让模型编。
{{一句话}}{{方法、URL、鉴权方式}}{{逐个列出：名称、类型、是否必填、取值范围、含义}}{{成功结构、失败结构、错误码}}{{频率、超时、单次上限、付费}}
什么时候用
接 MCP、写 function calling、做 Agent 工具集。
示例
搜索工具要写清「查实时信息用它，查已收录内容用库检索，不要两个都调」。
使用建议
- 1「什么时候不该用」比「能做什么」更能减少误调。
- 2参数取值范围写死，别让模型猜。
- 3失败约定要明确，否则 Agent 会无限重试。
方法来源：工具调用设计实践（原创整理）。模板为中文改写与整理，可按你的任务继续修改。