Chamada de Ferramentas Programática: Ferramentas Orquestradas pelo Modelo
Nesta página
Estado em 5 de novembro de 2026. A família GPT-6 herda as capacidades da API da GPT-5.6, incluindo a Chamada de Ferramentas Programática. A API de Agentes ativa isto por predefinição (Lição 10). A OpenAI recomenda verificar a ficha técnica do modelo antes de a ativar.
Para compreender o que a Chamada de Ferramentas Programática traz para a mesa, precisa primeiro de analisar o custo da chamada de funções clássica. O modelo solicita a execução de uma ferramenta, o seu código executa-a e o resultado regressa ao modelo, que o lê e decide o próximo passo. Uma ida e volta não é grande problema. Dez idas e voltas para uma única tarefa é uma história diferente: cada passo adiciona latência e cada resultado intermédio — mesmo que volumoso ou irrelevante para a resposta final — passa de volta pelo contexto do modelo e é faturado em tokens. Em tarefas com muitas ferramentas, estas idas e voltas dominam tanto a latência como o custo.
O Que Muda
A Chamada de Ferramentas Programática chegou com a GPT-5.6 a 9 de julho de 2026, na API de Respostas. Em vez de solicitar ferramentas uma a uma, o modelo escreve um pequeno programa em JavaScript para as coordenar. Pode lançar chamadas em paralelo, utilizar ciclos e condições, e manter os resultados intermédios dentro do ambiente de execução. Apenas o resultado reduzido — aquele que importa para o próximo passo — regressa ao contexto.
Considere uma API paginada. Na chamada de funções clássica, cada página de resultados atravessa o contexto para que o modelo possa decidir se solicita a seguinte. Com a Chamada de Ferramentas Programática, o modelo escreve um ciclo que itera pelas páginas, soma o que precisa de ser somado e reporta apenas os totais: menos tokens, menos latência e menos código de orquestração para si manter.
A OpenAI executa cada programa num ambiente V8 novo e isolado. Não há Node.js, nem instalação de pacotes, nem acesso direto à rede, nem sistema de ficheiros geral, nem estado preservado entre programas. O programa interage com o mundo apenas através das ferramentas que lhe expõe. Para a API de Respostas, este comportamento é compatível com a Retenção Zero de Dados (ZDR), desde que a ZDR esteja ativada para a organização ou projeto.
Ativação na API de Respostas
Duas definições são suficientes. Adiciona a ferramenta alojada programmatic_tool_calling ao pedido e especifica quem pode chamar cada ferramenta elegível usando allowed_callers: ["direct"] (o comportamento por predefinição, onde o modelo chama a ferramenta diretamente), ["programmatic"] (apenas um programa a pode chamar) ou ambos. A documentação recomenda também descrever a saída de cada função com output_schema para que o código gerado possa confiar nos seus campos.
from openai import OpenAI
client = OpenAI()
tools = [
{
"type": "function",
"name": "read_stock",
"description": "Returns an object with sku (text) and units (number).",
"parameters": {
"type": "object",
"properties": {"sku": {"type": "string"}},
"required": ["sku"],
"additionalProperties": False,
},
"output_schema": {
"type": "object",
"properties": {"sku": {"type": "string"}, "units": {"type": "number"}},
"required": ["sku", "units"],
"additionalProperties": False,
},
"allowed_callers": ["programmatic"],
},
{"type": "programmatic_tool_calling"},
]
response = client.responses.create(
model="gpt-5.6-terra",
input="Check stock for SKUs A12, B07, and C33 and flag those under 10 units.",
tools=tools,
)
Os tipos de ferramentas que podem ser chamadas a partir de um programa incluem funções e ferramentas personalizadas, ferramentas MCP, apply_patch, shell local ou alojado e o interpretador de código. Para uma ferramenta MCP sujeita a aprovação, o programa pausa até que conceda o seu consentimento.
O Que a Sua Aplicação Recebe
A resposta permanece um objeto Respostas padrão com três tipos de elementos a reconhecer. Um elemento program contém o JavaScript gerado. Os elementos function_call correspondem às suas chamadas de função feitas por esse programa; o seu campo caller identifica o programa chamador. Finalmente, um elemento program_output entrega o resultado final do programa, com um estado de completed ou incomplete.
A sua aplicação nunca executa o JavaScript; a OpenAI trata disso. Você apenas executa as suas próprias funções e devolve cada resultado num function_call_output, copiando o campo caller inalterado para que o programa correto possa retomar. Repete este ciclo até que a resposta não contenha mais chamadas para executar.
Identificação de Tarefas Beneficiadas
Nem todas as integrações de ferramentas beneficiam da migração. O guia da OpenAI oferece uma regra clara: a Chamada de Ferramentas Programática adequa-se a passos onde o fluxo é previsível e o código pode devolver um resultado menor e estruturado. Foi concebida para filtrar, juntar, ordenar, eliminar duplicados, agregar ou validar múltiplos resultados, ou para encadear chamadas dependentes onde o fluxo de dados é previsível. A chamada direta permanece preferível para uma única pesquisa ou ação, para pesquisas adaptativas onde cada resultado deve guiar a próxima decisão e para validação final de citações. Permanece também a escolha por predefinição para escritas e ações que exigem aprovação, a fim de manter um limite de autorização claro.
O critério de decisão resume-se a uma pergunta: onde é que o seu agente passa o tempo? Se a resposta for “à espera de idas e voltas de ferramentas”, a Chamada de Ferramentas Programática é a primeira área a avaliar. Se as suas chamadas de ferramentas forem raras e os seus resultados curtos, mantenha a sua arquitetura atual e foque os seus esforços noutro lugar.
Experimente Você Mesmo
Identifique um candidato. Pegue num fluxo do seu agente que chama múltiplas ferramentas. Para cada passo, anote o número de chamadas, o tamanho dos resultados intermédios e se é uma leitura ou uma escrita. Classifique cada passo usando a regra acima. Para o passo mais promissor, escreva um prompt que especifique as ferramentas permitidas, o formato de resultado esperado, a condição de paragem, o número máximo de tentativas e o que permanece uma chamada direta.
Fontes Oficiais: Chamada de Ferramentas Programática · Utilizar a GPT-6 (documentação da API da OpenAI) · Anúncio da GPT-5.6 (OpenAI, 9 de julho de 2026)
Pontos-chave
- O modelo escreve e executa JavaScript para coordenar as suas ferramentas num ambiente isolado gerido pela OpenAI
- Ative-o com a ferramenta
programmatic_tool_callinge o campoallowed_callersem cada ferramenta - A sua aplicação executa apenas as suas funções e devolve o campo
callerintacto - Prefira-o para filtrar, agregar ou encadear chamadas previsíveis; a chamada direta permanece a regra para escritas e aprovações