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

用户4242

2025年9月13日修改

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 怎么理解这个工具是干啥的

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