Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Chamada de Ferramentas Programática: Ferramentas Orquestradas pelo Modelo

Aula 5 de 12 Atualizada a 5 de novembro de 2026 Intermediario
Nesta página
  1. O Que Muda
  2. Ativação na API de Respostas
  3. O Que a Sua Aplicação Recebe
  4. Identificação de Tarefas Beneficiadas
  5. Experimente Você Mesmo
  6. Pontos-chave

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.

Quem executa o quê Três passos: o modelo escreve um programa JavaScript que a OpenAI executa num ambiente isolado; a sua aplicação executa as chamadas de função desse programa e devolve os resultados com o campo caller intacto; o programa entrega um resultado reduzido em program_output. CHAMADA DE FERRAMENTAS PROGRAMÁTICA Quem executa o quê 1 Programa Escrito pelo modelo 2 As suas funções Executadas por si 3 Resultado program_output reduzido O JavaScript é executado na OpenAI, nunca no seu lado. As escritas sensíveis permanecem chamadas diretas.
Com base no guia de Chamada de Ferramentas Programática na documentação da API da OpenAI (novembro de 2026).

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_calling e o campo allowed_callers em cada ferramenta
  • A sua aplicação executa apenas as suas funções e devolve o campo caller intacto
  • Prefira-o para filtrar, agregar ou encadear chamadas previsíveis; a chamada direta permanece a regra para escritas e aprovações