---
title: "O que é tool calling (function calling) em APIs de LLM?"
description: "Tool calling permite que um LLM peça ao seu código para executar uma função com argumentos JSON. Como o ciclo funciona, o custo em tokens e o uso por agentes."
url: https://broadrouter.com/pt/glossary/tool-calling/
lang: pt-BR
updated: 2026-11-14
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-calling/) (atualizado em 2026-11-14).

# Tool calling (chamada de ferramentas)

Atualizado em 2026-11-14

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

Também chamado de: chamada de ferramentas, chamada de funções, uso de ferramentas, ferramentas, tool calling, function calling, tool use, tools, tool\_calls

Tool calling é a forma de um modelo de linguagem agir no mundo: ele pede ao seu código para consultar algo, rodar uma query ou editar um arquivo, e depois usa o resultado.

## Como funciona

O guia da OpenAI descreve um ciclo entre o seu app e o modelo:

1.  **Envie as ferramentas.** A requisição lista funções com nome, descrição e um JSON Schema para os argumentos.
2.  **Receba uma chamada de ferramenta.** Se o modelo precisar de uma ferramenta, ele devolve o nome da função e os argumentos em JSON em vez de uma resposta final.
3.  **Execute.** O seu código executa a função. O guia da OpenAI coloca essa etapa “the application side” (tradução: do lado da aplicação); o modelo nunca executa código sozinho.
4.  **Devolva o resultado** com o ID de chamada correspondente.
5.  **Receba a resposta**, ou outra chamada de ferramenta. Repita quantas vezes for preciso.

No formato Chat Completions, a definição de uma ferramenta fica assim:

```json
{
  "type": "function",
  "function": {
    "name": "get_order_status",
    "description": "Look up an order by ID",
    "parameters": {
      "type": "object",
      "properties": { "order_id": { "type": "string" } },
      "required": ["order_id"]
    }
  }
}
```

A resposta traz `finish_reason: "tool_calls"` e uma lista `tool_calls`. Cada entrada tem um `id`, o nome da função e `arguments` como string JSON. Você acrescenta uma mensagem com `role: "tool"`, o mesmo `tool_call_id` e o resultado, e chama a API de novo.

## Por que isso importa

-   **Agentes.** Agentes de programação, bots de suporte e assistentes de dados são, em grande parte, ciclos de chamadas de ferramenta.
-   **Custo.** Cada ida e volta é uma nova requisição que reenvia a conversa, as definições das ferramentas e os resultados como [tokens de entrada](https://broadrouter.com/pt/glossary/input-and-output-tokens/). Em ciclos longos, a [entrada em cache](https://broadrouter.com/pt/glossary/cached-input-tokens/) e uma ordem estável das ferramentas fazem diferença.
-   **Segurança.** Os argumentos vêm do modelo. Valide-os antes de executar qualquer coisa que altere dados ou gaste dinheiro.

Para uma resposta que precisa seguir um schema mas não exige nenhuma função, a ferramenta mais simples é a [saída estruturada](https://broadrouter.com/pt/glossary/structured-output/).

## Na BroadNet Inference

A documentação da BroadNet lista tool calling para [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/) e [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/), ambos com saída estruturada e raciocínio. Ela não informa suporte a ferramentas para DeepSeek V4.1 Flash nem para BroadNet Gemma 4 VL 26B. Teste o seu próprio ciclo de ferramentas no modelo que você pretende colocar em produção.

Os dois modelos listados raciocinam antes de responder, e o raciocínio conta para `max_tokens`, então deixe folga, ou uma chamada de ferramenta pode ser cortada. Veja [tokens de raciocínio](https://broadrouter.com/pt/glossary/reasoning-tokens/). Para ferramentas de agente que trazem o próprio formato de ferramentas, veja o [guia do Cline](https://broadrouter.com/pt/guides/cline-openai-compatible/) e o [guia do Vercel AI SDK](https://broadrouter.com/pt/guides/vercel-ai-sdk-openai-compatible/).

## Erros comuns

-   Tratar `arguments` como objeto. Ele chega como string JSON; decodifique e trate os erros.
-   Esquecer o `tool_call_id`. Sem ele, o modelo não consegue associar os resultados às chamadas.

## Perguntas frequentes

### O modelo executa a minha função?

Não. O modelo só devolve o nome da função e os argumentos. O seu código decide se vai executá-la, executa e devolve o resultado em uma mensagem tool.

### O modelo pode chamar várias ferramentas de uma vez?

Muitas APIs permitem chamadas de ferramenta em paralelo, com várias entradas em tool\_calls em uma única resposta. O seu código executa cada uma e devolve um resultado por tool\_call\_id.

### Quais modelos da BroadNet suportam tool calling?

A documentação da BroadNet lista ferramentas para GLM 5.3 e Qwen3.8 27B. Ela não informa suporte a ferramentas para DeepSeek V4.1 Flash nem para BroadNet Gemma 4 VL 26B, então teste antes de depender disso nesses modelos.

## Veja também

-   [Saída estruturada (structured output)](https://broadrouter.com/pt/glossary/structured-output/) (termo)
-   [Tokens de entrada e de saída](https://broadrouter.com/pt/glossary/input-and-output-tokens/) (termo)
-   [Tokens de entrada em cache (cached input)](https://broadrouter.com/pt/glossary/cached-input-tokens/) (termo)
-   [API compatível com a OpenAI](https://broadrouter.com/pt/glossary/openai-compatible-api/) (termo)
-   [Agente de IA (AI agent)](https://broadrouter.com/pt/glossary/agent/) (termo)
-   [MCP (Model Context Protocol)](https://broadrouter.com/pt/glossary/mcp/) (termo)
-   [JSON mode (modo JSON)](https://broadrouter.com/pt/glossary/json-mode/) (termo)
-   [Prompt injection (injeção de prompt)](https://broadrouter.com/pt/glossary/prompt-injection/) (termo)
-   [tool\_choice](https://broadrouter.com/pt/glossary/tool-choice/) (termo)
-   [Chamadas de ferramentas em paralelo (parallel tool calls)](https://broadrouter.com/pt/glossary/parallel-tool-calls/) (termo)
-   [JSON Schema](https://broadrouter.com/pt/glossary/json-schema/) (termo)
-   [Como usar o SDK Python da OpenAI com a BroadNet Inference](https://broadrouter.com/pt/guides/openai-python-sdk/) (guia)
-   [Use o Cline com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/cline-openai-compatible/) (guia)
-   [Como usar o Vercel AI SDK com a BroadNet Inference](https://broadrouter.com/pt/guides/vercel-ai-sdk-openai-compatible/) (guia)
-   [Como rodar agentes de código em paralelo numa API de LLM de preço fixo](https://broadrouter.com/pt/blog/run-parallel-coding-agents-flat-rate/) (artigo)
-   [Quando vale a pena uma janela de contexto de 1M de tokens (ou não)](https://broadrouter.com/pt/blog/million-token-context-window-guide/) (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-calling&utm_content=page-cta) ·

**Fontes**

-   [OpenAI, guia de function calling](https://developers.openai.com/api/docs/guides/function-calling)
-   [Referência da API da OpenAI, criar chat completion (tools)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Referência da API da BroadNet Inference, modelos (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-glossary-tool-calling&utm_content=sources#models)
