---
title: "tool_choice 怎么强制或禁止调用工具"
description: "tool_choice 控制模型是否必须调用工具、调用哪一个。本文对照 auto、any、指定工具、none 的语义，讲强制调用的副作用、结构化输出与工具的区别，以及工具不触发时按哪一层排查。"
updated: 2026-11-13
canonical: https://docai.cc/concepts/tool-choice/
markdown_mirror: https://docai.cc/concepts/tool-choice.md
---
## 它是什么

tool_choice 是请求里的一个参数，用来约束模型这次调用中如何使用你提供的工具。它不定义也不执行工具，只影响模型的选择空间。

[工具定义](/concepts/tool-use/)回答「有哪些工具可用」，tool_choice 回答「这次必须用、可以用、还是不许用」。

## 怎么工作

各家命名不同，语义可以对齐成四档：

- 自动（auto）：模型自行判断，可以直接回答，也可以调用工具。带工具时通常是默认值。
- 必须调用任一工具（Anthropic 的 any，OpenAI 的 required）：必须至少调用一个工具，适合先取数再回答的流程。
- 必须调用指定工具：点名要求调用某个工具，适合第一步必须固定动作，比如先检索再总结。
- 禁止调用（none）：不允许产生工具调用，模型只能用已有上下文作答。

Anthropic 的写法是对象，指定工具时要带工具名；OpenAI 的 Chat Completions 用字符串或带函数名的对象，Responses API 又略有差异。对接时以各家文档为准，别假设字段能原样透传。

## 强制调用会绕过模型判断

把 tool_choice 设成必须调用，等于取消了模型「这次不需要工具」的选项。模型为了满足约束，即使信息不足也会生成一次调用，参数只能靠猜；任务和工具不匹配时，它会硬选一个最接近的，或塞入无意义的参数。

强制调用适合做流程控制，不适合当质量保证。需要保证「先检索」这类顺序时可用；需要模型自己判断该不该查时，应该用 auto，并把工具描述写清楚。

## 和结构化输出的区别

[结构化输出](/concepts/structured-output/)约束最终回答长什么样，比如必须符合某个 JSON Schema；工具调用约束模型可以请求哪个外部动作。

只想要 JSON，不该定义假工具骗模型调用，应该用结构化输出或 [JSON 模式](/concepts/json-mode/)。反过来，需要执行查询、写文件、发请求时，才定义工具。用强制调用提交工具来收集结构化结果是常见绕路，它把执行语义和格式约束混在一起，错误处理也更麻烦。

## 不同厂商字段不兼容时

做适配层时写一张映射表，把内部语义映射到各家形状，不在业务代码里到处判断厂商：

| 语义 | Anthropic | OpenAI |
|---|---|---|
| 自动 | auto | auto |
| 必须调用任一工具 | any | required |
| 必须调用指定工具 | 指定工具名 | 指定函数名 |
| 禁止调用 | none | none |

另有三点：工具定义的字段名不同，参数结构在 Anthropic 叫 input_schema，在 OpenAI 叫 parameters；部分模型或思考模式对强制调用有限制；兼容接口通常沿用 OpenAI 的形状，但完整度不一，官方未说明的差异要自己测。

## 工具不触发时先查哪一层

按从外到内的顺序排查：

1. 原始请求体里有没有 tools，字段名有没有被 SDK 或网关改写。
2. tool_choice 是否被上层设成 none，或系统提示里写了不要调用工具。
3. 响应里的结束原因是不是工具调用；解析代码有没有只读文本、丢掉工具调用块。
4. 流式响应有没有处理工具调用的增量块，这是最常见漏点。
5. 工具的参数结构是否合法，必填字段和枚举有没有写错。
6. 最后才怀疑模型判断：任务是否真的需要工具，工具描述是否说清楚。

## 常见误解

- **auto 就是一定调用工具**：auto 只是允许，模型可以完全不调。
- **none 会把工具定义删掉**：定义仍在上下文里，照样占 token，只是禁止调用；也不保证模型不在文字里提工具名。
- **强制调用能提高准确率**：它只保证调用发生，不保证调对。
- **各家字段可以直接复用**：语义相近，形状不同，需要适配。