---
title: "O que é tool_choice? Forçar ou bloquear o uso de ferramentas"
description: "tool_choice controla se um modelo pode, deve ou não deve chamar uma ferramenta, ou qual deve chamar. As opções da OpenAI e da Anthropic e quando forçar."
url: https://broadrouter.com/pt/glossary/tool-choice/
lang: pt-BR
updated: 2026-11-15
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/glossary/tool-choice/) (atualizado em 2026-11-15).

# tool\_choice

Atualizado em 2026-11-15

tool\_choice é um parâmetro da requisição que controla o uso de ferramentas. No Chat Completions da OpenAI, pode ser auto (o modelo decide), required (precisa chamar uma ou mais ferramentas), none (sem ferramentas) ou uma função específica a forçar. As opções equivalentes da Anthropic são auto, any, tool e none.

Também chamado de: escolha de ferramenta, chamada de ferramenta forçada, function call forçada, tool choice, forced tool call, forced function call

O [tool calling](https://broadrouter.com/pt/glossary/tool-calling/) permite que um modelo peça ao seu código para executar uma função. O tool\_choice decide se isso é opcional, obrigatório ou desligado.

## Como funciona

Você envia `tools` (nomes das funções, descrições e parâmetros em [JSON Schema](https://broadrouter.com/pt/glossary/json-schema/)) e, opcionalmente, `tool_choice`.

| Valor na OpenAI | Significado | Equivalente na Anthropic |
| --- | --- | --- |
| `"auto"` | O modelo escolhe entre uma mensagem e uma ou mais chamadas; padrão quando há ferramentas | `{"type": "auto"}` |
| `"required"` | “The model must call one or more tools” (tradução: o modelo precisa chamar uma ou mais ferramentas) | `{"type": "any"}` |
| `{"type": "function", "function": {"name": "get_weather"}}` | Força aquela ferramenta específica | `{"type": "tool", "name": "get_weather"}` |
| `"none"` | Sem chamadas de ferramenta; padrão quando não há ferramentas | `{"type": "none"}` |

O guia de function calling da OpenAI também descreve uma opção de allowed tools, que restringe as chamadas a um subconjunto mantendo a lista completa de ferramentas inalterada, e a sugere para prompt caching.

```json
{"model": "broadnet/glm-5.3",
 "messages": [{"role": "user", "content": "Weather in Riyadh?"}],
 "tools": [{"type": "function", "function": {"name": "get_weather",
   "parameters": {"type": "object", "properties": {"city": {"type": "string"}},
                  "required": ["city"]}}}],
 "tool_choice": {"type": "function", "function": {"name": "get_weather"}}}
```

A documentação da Anthropic observa que, com `any` ou `tool`, a API preenche o início da resposta, então o modelo não escreve texto antes da chamada, e que alguns modelos Claude rejeitam o uso forçado de ferramentas e devolvem erro 400.

## Por que isso importa

-   **Pipelines confiáveis.** Uma etapa de extração que precisa terminar em uma chamada não deveria receber uma resposta em texto cheia de conversa. Forçar a chamada elimina esse caminho.
-   **Turnos seguros.** Definir `none` em um turno final de resumo impede o modelo de iniciar outra rodada de ferramentas, mantendo a mesma lista de ferramentas.
-   **Cache.** A Anthropic diz que mudar o `tool_choice` invalida os blocos de mensagem em cache, então mantenha-o estável entre turnos sempre que puder.

## Na BroadNet Inference

A [referência da API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-tool-choice&utm_content=body) da BroadNet documenta tool calling apenas para [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/) e [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/), e não documenta `tool_choice`. Teste cada valor que você pretende usar: envie `required` ou uma função específica e confirme que a resposta contém `tool_calls`. Se forçar não funcionar, use `auto` com uma instrução clara e valide o resultado, ou use [saída estruturada](https://broadrouter.com/pt/glossary/structured-output/) nos mesmos modelos. O [post sobre tool calling com modelos abertos](https://broadrouter.com/pt/blog/tool-calling-open-models/) tem um loop de validação e nova tentativa.

## Erros comuns

-   Forçar uma ferramenta em todos os turnos de um loop de agente, de modo que ele nunca consegue dar uma resposta final.
-   Achar que `required` significa uma ferramenta específica. Significa qualquer ferramenta.

## Perguntas frequentes

### Qual é o tool\_choice padrão?

Na API da OpenAI, none quando nenhuma ferramenta é enviada e auto quando há ferramentas. A Anthropic usa os mesmos padrões.

### Quando devo forçar uma chamada de ferramenta?

Quando a única resposta aceitável é uma chamada, como um classificador que precisa chamar submit\_label. Para uma resposta JSON fixa, a saída estruturada costuma ser mais simples.

### A BroadNet Inference suporta tool\_choice?

A BroadNet documenta tool calling para GLM 5.3 e Qwen3.8 27B, mas a referência da API não documenta tool\_choice. Teste cada valor antes de depender dele.

## Veja também

-   [Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/) (termo)
-   [Chamadas de ferramentas em paralelo (parallel tool calls)](https://broadrouter.com/pt/glossary/parallel-tool-calls/) (termo)
-   [Saída estruturada (structured output)](https://broadrouter.com/pt/glossary/structured-output/) (termo)
-   [JSON Schema](https://broadrouter.com/pt/glossary/json-schema/) (termo)
-   [Agente de IA (AI agent)](https://broadrouter.com/pt/glossary/agent/) (termo)
-   [ReAct (reason and act)](https://broadrouter.com/pt/glossary/react-agent/) (termo)
-   [Tool calling com modelos abertos: schemas, chamadas paralelas, retry](https://broadrouter.com/pt/blog/tool-calling-open-models/) (artigo)
-   [Como estruturar prompts para o prefixo entrar em cache](https://broadrouter.com/pt/blog/prompt-structure-for-caching/) (artigo)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-tool-choice&utm_content=page-cta) ·

**Fontes**

-   [Referência da API da OpenAI, criar chat completion (tool\_choice) (conferido em 2026-11-15)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [OpenAI, guia de function calling (tool\_choice) (conferido em 2026-11-15)](https://developers.openai.com/api/docs/guides/function-calling)
-   [Documentação da Anthropic, definir ferramentas: forçar o uso de ferramenta (conferido em 2026-11-15)](https://platform.claude.com/docs/en/agents-and-tools/tool-use/define-tools)
