提示词模板 / Agent
Agent 工具描述优化
为 Agent 的可调用工具（function / tool）优化 name 与 description——这是决定 Agent 会不会正确调用工具的关键。
Agent适合：两者皆可3 个变量
适用场景
- Agent 该调用工具时没调用，或调错工具
- 工具很多，模型分不清该用哪个
- 要给 MCP server 写工具定义
你会得到
- 优化后的工具描述
- 参数说明
- 何时不该调用该工具的边界说明
- 易混淆工具的区分说明
避坑提示
- 描述太短（"查询数据"）是调用错误的第一大原因
- 不写「什么时候不要用」会让模型滥用工具
- 参数 description 也要写，别只写名字
填入变量，生成提示词
0 / 3 已填你是 Agent 工具设计专家。我在构建一个 Agent：【Agent 的整体任务】 【当前工具定义】 【工具的现有定义】 【遇到的问题】 【现在的问题】 请优化这个工具定义，原则： 1. description 结构固定为三段： - 「做什么」：一句话说明功能（含返回值是什么） - 「什么时候用」：列举 2~3 个典型触发场景 - 「什么时候不要用」：说明易混淆的相邻工具，以及不该调用的情形 2. 参数 description 必须写：含义、格式、取值范围、必填与否、示例值 3. 参数命名用 snake_case，语义明确（避免 data、info、param1） 4. 如果某个参数可以从上下文推断，标注「可选，默认值 X」 5. 输出 JSON Schema 格式，可直接用于 function calling 【额外要求】 - 列出与它「最容易混淆」的其他工具，并说明如何在 description 里把区别写清楚 - 指出当前定义中可能导致误调用的具体措辞 【输出】 ## 问题诊断 ## 优化后的定义（JSON Schema） ## 与相邻工具的区分说明
未填的变量会保留为 【变量名】 占位，方便你确认哪里还没补。点击上方按钮复制后粘贴到模型即可。
查看原始模板（含变量占位符）
你是 Agent 工具设计专家。我在构建一个 Agent：{{场景}}
【当前工具定义】
{{工具}}
【遇到的问题】
{{困惑}}
请优化这个工具定义，原则：
1. description 结构固定为三段：
- 「做什么」：一句话说明功能（含返回值是什么）
- 「什么时候用」：列举 2~3 个典型触发场景
- 「什么时候不要用」：说明易混淆的相邻工具，以及不该调用的情形
2. 参数 description 必须写：含义、格式、取值范围、必填与否、示例值
3. 参数命名用 snake_case，语义明确（避免 data、info、param1）
4. 如果某个参数可以从上下文推断，标注「可选，默认值 X」
5. 输出 JSON Schema 格式，可直接用于 function calling
【额外要求】
- 列出与它「最容易混淆」的其他工具，并说明如何在 description 里把区别写清楚
- 指出当前定义中可能导致误调用的具体措辞
【输出】
## 问题诊断
## 优化后的定义（JSON Schema）
## 与相邻工具的区分说明