Anthropic官方指南: AI Agent 工具设计的正确打开方式

Anthropic官方指南: AI Agent 工具设计的正确打开方式 Anthropic官方指南: AI Agent 工具设计的正确打开方式 Modified September 13, 2025 🔗 原文链接： https://mp.weixin.qq.com/s/eShjSWtn... Anthropic 最近发了个技术指南，专门讲怎么给 AI Agent 写工具，看完感觉学到不少，跟大家分享下。 1.工具不要贪多，够用就行 🎯 很多程序员给 AI Agent 做工具的时候，总想着多多益善，结果反而把 Agent 给搞糊涂了。 其实更好的办法是把相关功能打包在一起。举个例子，与其搞"查用户信息"、"改用户状态"、"删用户"三个工具，不如直接做个"用户管理"工具，用参数来区分要干啥。这样 Agent 用起来更顺手。 2.返回结果要说人话 💬 这个特别重要！千万别让工具吐出一堆代码或者 ID 什么的，要用正常人能看懂的话来描述。 比如说： ❌ 这样不好：user id: 12345, status: 1 ✅ 这样更好：用户张三，目前在线 显然第二种 Agent 更容易理解。 3.省着点用 Token ⚡ 设计的时候得考虑 Token 消耗。比较聪明的做法是给两种返回模式： • 简洁版：就返回重点信息 • 详细版：把所有数据都给出来 这样既效率高，又不浪费宝贵的上下文。 4.起名字要直观 🏷️ 工具名字很重要： 1. 同类工具用相同前缀 2. 一看名字就知道干啥的 3. 少用专业术语 5.测试这事儿不能马虎 🔍 工具做完了一定要测： • 想各种使用场景来试试 • 看看 Agent 用得怎么样 • 让 Agent 自己说哪里不好用 • 然后不断改进 最有意思的是，可以直接问 Agent 哪里用着别扭，然后专门优化。 6.换个思路 🧠 这里有个关键点：给 AI Agent 写工具跟传统开发思路完全不一样。 以前考虑的是：程序员怎么调用这个接口 现在要想的是：AI 怎么理解这个工具是干啥的 原文链接：https://www.anthropic.com/engineering/writing tools for agents https://mp.weixin.qq.com/s/eShjSWtn... 🔗 原文链接： https://mp.weixin.qq.com/s/eShjSWtn... https://mp.weixin.qq.com/s/eShjSWtn... Anthropic 最近发了个技术指南，专门讲怎么给 AI Agent 写工具，看完感觉学到不少，跟大家分享下。 1.工具不要贪多，够用就行 🎯 很多程序员给 AI Agent 做工具的时候，总想着多多益善，结果反而把 Agent 给搞糊涂了。 其实更好的办法是把相关功能打包在一起。举个例子，与其搞"查用户信息"、"改用户状态"、"删用户"三个工具，不如直接做个"用户管理"工具，用参数来区分要干啥。这样 Agent 用起来更顺手。 2.返回结果要说人话 💬 这个特别重要！千万别让工具吐出一堆代码或者 ID 什么的，要用正常人能看懂的话来描述。 比如说： ❌ 这样不好：user id: 12345, status: 1 ✅ 这样更好：用户张三，目前在线 显然第二种 Agent 更容易理解。 3.省着点用 Token ⚡ 设计的时候得考虑 Token 消耗。比较聪明的做法是给两种返回模式： • 简洁版：就返回重点信息 • 详细版：把所有数据都给出来 这样既效率高，又不浪费宝贵的上下文。 4.起名字要直观 🏷️ 工具名字很重要： 1. 同类工具用相同前缀 2. 一看名字就知道干啥的 3. 少用专业术语 5.测试这事儿不能马虎 🔍 工具做完了一定要测： • 想各种使用场景来试试 • 看看 Agent 用得怎么样 • 让 Agent 自己说哪里不好用 • 然后不断改进 最有意思的是，可以直接问 Agent 哪里用着别扭，然后专门优化。 6.换个思路 🧠 这里有个关键点：给 AI Agent 写工具跟传统开发思路完全不一样。 以前考虑的是：程序员怎么调用这个接口 现在要想的是：AI 怎么理解这个工具是干啥的 原文链接：https://www.anthropic.com/engineering/writing tools for agents