前言

上一篇文章我们讲了 Agent 的三要素：LLM 是大脑。Tools 是手脚，Messages 是记忆。

Tool 是 Agent 能从“聊天机器人”升级为“能干活的助理”的关键。没有 Tool，AI 只能空谈；有了 Tool，AI 能读文件、写代码、查数据库、发邮件——真正把手伸进现实世界。

但这套手脚怎么装？LLM 怎么知道什么时候用哪个 Tool？参数怎么传，这篇文章把 Tool 的一切讲清楚。

一、Tool 的本质：函数 + 说明书

Tool 就是一个普通的函数，但多了一层 JSON 格式的“说明书”。LLM 读不懂你的代码，它读的是这份说明书。老实说，

说明书→ 给 LLM 看的，让它知道什么时候用、怎么传参实现 → 给运行时执行的，真正干活的代码

一个完整的 Tool 定义长这样：

{
说到type。"function",function: {
说到name，"get_closing_price",// 函数名：snake_case，动词开头
description: "获取指定股票的最近收盘价。需要股票全称，如'青岛啤酒'、'贵州茅台'。",parameters: { // 参数 JSON Schema
说到type，"object",properties: {
再看name，{
type的观点是，"string",description: "股票全称，如'青岛啤酒'"
}
},required:
}
}
}

五个字段各司其职：

二、description：Tool 的灵魂

痛点一：描述模糊导致 LLM 无法正确选择 Tool。

LLM 不理解你的代码。其实，它只看 description。

description 的好坏直接决定了 LLM 能不能在正确的时机选中正确的 Tool、传正确的参数。它是 LLM 和你的 Tool 之间唯一的语义接口。

// ❌ 差 — LLM 不知道该不该调
// description: "获取股票信息"
// ❌ 也差 — 何时用、用什么参数都不清楚
// description: "获取收盘价"
// ✅ 好 — 功能、场景、边界、输入格式全说清楚了
// description:
// "根据完整股票名称查询最近交易日收盘价。" +
// "支持 A 股主板，不支持港股和美股。" +
// "一周内未开盘则返回最近交易日数据。" +
// "输入须为股票全称，如'青岛啤酒'，不要用代码。"

description 写作黄金法则：

作用

示例

功能 - 这个 Tool 做什么 如 “查询最近交易日收盘价”

📌 必填项*

"功能"- 明确告诉 LLM “我想做什么”

❗️缺少功能会导致无工具被选中❗️

如 “查询最近交易日收盘价” 等…

🔒 用来限制使用范围或条件，以免误调用；比如 “仅限 A 股主板”，或者 “当价格低于某值时才调用”。

📂 对接第三方 API 时可以写成一句话就行，例如 “调用第三方行情接口返回 JSON”。