工具设计原则与最佳实践
前面几节我们学会了怎么定义工具、怎么调用工具。但有个问题还没聊：怎么定义一个好用的工具？
这里的"好用"不是指你写代码方便，而是指模型能不能正确理解和使用。
常见误区
工具定义好了、功能能跑，但模型就是不调或者调错——问题往往出在工具定义不够清晰，模型没看懂这工具是干嘛的。工具的 description 质量直接决定模型使用工具的准确率。
这一节咱们来聊聊怎么设计让模型"看得懂、用得对"的工具。
先给你一条总的检查路径。后面这 8 条原则，其实就是把这条路径一项项展开讲细：
原则一：名称和描述要说人话
我们写代码的时候，变量名叫a、b、tmp可能自己能看懂。但给模型用的工具，名称和描述必须清晰明确。
反面教材：
@Tool(description = "处理数据")
public String process(@ToolParam(description = "参数") String param) {
// ...
}
这种定义，模型完全搞不懂：处理什么数据？怎么处理？参数是什么东西？
正确做法：
@Tool(description = "根据订单编号查询订单的详细信息，包括商品列表、收货地址、支付状态等")
public OrderDetail queryOrderDetail(
@ToolParam(description = "订单编号，格式如：ORD202503140001")
String orderId) {
// ...
}
好的描述应该回答这几个问题：
- 这个工具是干什么的？
- 什么时候应该用它？
- 每个参数是什么意思，应该填什么格式？
最佳实践
记住，模型是通过阅读这些文字来理解工具的。描述写得越清楚，模型用起来越准。
付费内容提示
该文档的全部内容仅对「JavaUp项目实战&技术讲解」知识星球用户开放
加入星球后，你可以获得：
- 超级八股文：100万+字的全栈技术知识库，涵盖技术核心、数据库、中间件、分布式等深度剖析的讲解
- 讲解文档：超级AI智能体、黑马点评Plus、大麦、大麦pro、大麦AI、流量切换、数据中台的从0到1的详细文档
- 讲解视频：超级AI智能体、黑马点评Plus、大麦、大麦pro、大麦AI、流量切换、数据中台的核心业务详细讲解
- 1 对 1 解答：可以对我进行1对1的问题提问，而不仅仅只限于项目
- 针对性服务：有没理解的地方，文档或者视频还没有讲到可以提出，本人会补充
- 面试与简历指导：提供面试回答技巧，项目怎样写才能在简历中具有独特的亮点
- 中间件环境：对于项目中需要使用的中间件，可直接替换成我提供的云环境
- 面试后复盘：小伙伴去面试后，如果哪里被面试官问住了，可以再找我解答
- 远程的解决：如果在启动项目遇到问题，本人可以帮你远程解决
进入星球后，即可享受上述所有服务，保证不会再有其他隐藏费用。
