当你看着日志里又一次"选错了工具"，第一反应几乎一定是去改系统提示。这恰恰改错了层。2026年的可解释性研究已经证明：工具身份在模型吐出第一个token之前，就已经在前置线性表征里被锁定。真正决定调用哪个函数的不是系统提示，而是三件事的优先级——工具描述文本、参数名、上下文里的工具排列顺序。当两个工具职责重叠时，描述信号变模糊，模型不是随机二选一，而是系统性地偏向"声音更大"的那一个，这就是工具阴影税（Tool Shadowing Tax）。τ-bench上训练良好的模型仅约25%的任务能跑通，多数失败都指向工具选择错误而非执行错误；AgentProp-Bench进一步发现，一个参数级的选择错误有约62%的概率级联成错误的最终答案。本文拆解决策窗口、三信号优先级、阴影触发条件、四种失败模式与跨栈缓解手段。
| 框架 / 提供方 | 描述是否为头号裁决信号 | 参数名是否参与裁决 | 对工具顺序的敏感性 | 负约束（when NOT to use）文档化 | 单上下文工具数软上限 | 阴影税主要缓解手段 |
|---|---|---|---|---|---|---|
| Anthropic Claude（tool use） | 是，官方明确"by far 最重要" | 是，强语义权重 | 中高（前置更易被选） | 是，建议每工具3–4句含"何时不用" | ≈10–12 后建议子智能体分桶 | 消歧句 + 负约束 + skills 单触发 |
| OpenAI Agents SDK / Responses | 是 | 是 | 中（受 strict schema 约束） | 部分，靠开发者自写 | ≈10–12 | strict 输出 + 工具分组 |
| Google Gemini（function calling） | 是 | 是 | 中高 | 部分 | ≈10 | 描述精修 + 模式约束 |
| LangChain（Tools/Toolkit） | 取决于底座模型 | 是 | 高（列表顺序即权重） | 否，需手写 | 由检索层稀释 | 动态工具选择器 / retriever |
| CrewAI（@tool） | 是（docstring 即描述） | 是 | 中 | 否 | ≈8–10 | 角色分工天然分桶 |
| AutoGen（Conversable） | 是 | 是 | 高 | 否 | 较低 | 多智能体各持窄工具集 |
说明：所有主流栈都承认描述是头号信号，但只有极少数把"负约束"写进官方建议。这正是阴影税的温床——大多数生产环境的工具定义只有一句话。
我们直觉以为模型是"边写边想选哪个工具"。2026年的一项工具调用可解释性研究发现事实相反：工具身份可以从模型的内部表征中被线性读出，而且是在输出第一个token之前。这意味着当你在日志里看到一次错误的工具调用时，那个决定早在它写下任何回复文字的前一步就已经做出了。这条结论彻底改变了调试的方向：如果你还在用"调整系统提示来纠正工具选择"，你打中的是错误的层。系统提示改变的是任务被框定的方式，却几乎不触及模型用来挑选工具的那个信号。要真正移动选择准确率，必须直接改写工具描述、参数名和工具在上下文中的排列。这是为什么"换个更强的模型"往往救不了选错工具——能力足够，信号却脏。
模型在选择时依次读取三个信号：工具描述文本 → 参数名 → 上下文中的工具顺序。系统提示在筛选时几乎不参与。理解这个优先级就能解释大量"诡异"行为：为什么把一个工具从列表第三挪到第一，它的被选率就上升——顺序是第三层信号，但当前两层模糊时它就拍板；为什么把参数从 query 改名成 search_term，调用语义就收紧——参数名独立携带语义权重；为什么一句"用此工具当X，用另一工具当Y"的消歧句立竿见影——它直接强化了头号信号。Anthropic的工程博客记载，仅靠打磨工具描述（不换模型），就让Claude Sonnet在SWE-bench上达到当时的SOTA。描述是你最重要的工程面，不是文档。
# 一个被忽视的杠杆：把参数名收紧成"作用域受限"的命名
# 差：参数名宽泛，邀请泛化解释，易和相邻工具打架
def search(query: str): ...
# 好：参数名圈定结构化主键，收紧解释空间，降低阴影概率
def search(record_id: str): ...
这是实战中最贵的认知误区。团队遇到"agent又选错工具"，惯性的下一步是改系统提示、加长约束、补一段"请注意区分以下工具"。这套动作对执行层问题有效，对选择层问题几乎无效——因为选择发生在系统提示真正生效之前的那个线性表征阶段。结果就是工程师反复迭代系统提示，日志里的工具选择率纹丝不动，团队得出"模型不行"的错误结论，然后换模型、换框架，把阴影税当成能力税付了一遍又一遍。真正能移动指标的，是把每个工具的描述补成3–4句话，明确"做什么、何时用、何时不用"，以及把重叠工具拆到不同子智能体里。先把描述层修干净，再去动模型和框架——顺序反了就是白烧token。
最能说明问题的证据来自一个极简实验。Mario Zechner的终端agent "Pi"只内置四个工具（read/write/edit/bash），工具定义合计不到1000 token，四个工具职责清晰互斥。在这种干净面下，模型几乎从不选错——因为没有歧义需要它裁决。但加入第五个工具——一个与bash描述部分重叠的文件搜索函数——选择立即退化：模型开始在该用bash时调用搜索工具。模型没坏，是描述的边界塌了。这就是阴影效应：当一个新工具的描述与既有工具在表层兼容同一类请求，它就会"盖过"被它阴影的工具，哪怕后者才是正解。Hugging Face的"skills"框架（Merve Noyan）讲的是同一件事——单一、不重叠的触发条件才能稳定命中；通用API包装器风格的工具，失败率正比于它的重叠程度。
生产环境的选择错误可归为四类，每类修复手段不同，混用会无效：
query/message/input这类宽泛名字会独立放大触发面，即便描述写对了。修复：改名贴合真实作用域（record_id、file_path）。选错工具的可怕之处不在那一次错误本身，而在它的复利。AgentProp-Bench（2026年的工具型agent基准）量化了这一点：一个参数级的选择错误，会以约62%的概率级联成错误的最终答案。也就是说，选错不是终点，而是失败的起点——后续每一步都建立在错误工具返回的结果之上，越往后纠偏越贵。这解释了为什么单轮修复（重试一次）往往不够：重试如果还命中同一个阴影工具，就只是把同样的错误重放一遍。要打断级联，必须在选择层注入确定性——要么靠描述消歧让正解成为唯一信号，要么靠工具重排/分组把阴影源移出候选池，要么靠子智能体分桶缩小候选规模。选错一步的代价不是一步，而是整条链路的方差。
常被忽略的第二重税是"过度调用"。模型在请求并不真正需要外部工具时仍发起调用，原因有二：一是描述里缺能力边界（没写"仅当上下文无法回答时才调用"）；二是工具列表里存在"万能型"工具，任何请求都能沾边。后果是延迟上升、token账单膨胀、且引入了本可避免的失败面（多一次调用就多一次工具异常或注入风险）。这跟"召回塌方"是两个方向：召回塌方是工具太多选不出来，过度调用是工具太"全能"被无差别触发。缓解方式是在描述里硬写能力边界句，并对只读类工具考虑"先答后验"的策略——先让模型尝试直接作答，仅在置信不足时才落工具。
可落地的缓解分两层，按规模叠加。描述层（小规模）：①每个易重叠工具加消歧句（"用此工具当X，用[另一个]当Y"）；②每工具补一句负约束（"不要在用户问X时调用，改用Z"）；③参数名收紧到结构化主键；④只读工具加能力边界句。这四步不换模型，只动文本。架构层（规模化）：当工具数突破约10–12件，单上下文里的候选池过大会让前述信号全部被稀释——这时要把工具按职能分发给专门的子智能体，每个agent持一个窄而连贯的工具集，选择准确率因候选池变小且语义互斥而回升。这也是为什么单agent架构在真实任务复杂度下会断裂。两套缓解不是二选一，而是同一问题在不同尺度上的解：小规模靠描述，大规模靠分桶。
flowchart TD
A[用户请求进入上下文] --> B{读取三信号<br/>描述 > 参数名 > 顺序}
B --> C[首token前<br/>线性表征锁定工具身份]
C --> D{工具职责是否重叠?}
D -- 否:信号干净 --> E[命中正确工具<br/>低阴影税]
D -- 是:信号模糊 --> F[阴影效应<br/>偏向描述更强者]
F --> G[选错工具 / 无差别调用]
G --> H[结果级联污染<br/>约62%拖垮最终答案]
E --> I{工具数 > 10-12?}
I -- 否 --> J[描述层修复<br/>消歧+负约束+参数名]
I -- 是 --> K[架构层修复<br/>子智能体分桶缩小候选池]
J --> E
K --> L[各agent窄工具集<br/>信号恢复清晰]
L --> E
H -.重试若仍命中阴影源.-> F
[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。