OpenAI Agents API vs Responses API vs Agents SDK vs AgentKit: Qual a melhor opção para desenvolver?

Esses quatro nomes atuam em camadas diferentes. A pergunta que os separa é: quem executa o loop do agente? A Responses API é a chamada ao modelo, e o seu código controla o loop. O Agents SDK é uma biblioteca para TypeScript e Python cujo executor roda o loop dentro do seu aplicativo. A Agents API, em beta público desde 10 de setembro de 2026, executa o harness Codex da OpenAI, mantém a sessão e pode gerenciar o sandbox. AgentKit é o pacote lançado em outubro de 2025 com Agent Builder, ChatKit, Connector Registry e Evals; o Agent Builder está programado para ser desativado em 30 de novembro de 2026.

Experimente o Apidog hoje

O DevDay de 29 de setembro adicionou uso de computador à Agents API — veja o resumo do DevDay 2026. Isso torna a escolha entre essas opções ainda mais relevante.

Este guia compara loop, computação, estado, custo e maturidade. Também inclui uma tabela de decisão e um caminho de migração de um loop manual com Responses. Para implementar sessões e aprovações, consulte o guia da OpenAI Agents API. Você pode testar qualquer uma dessas superfícies HTTP no Apidog.

Opções de agentes OpenAI lado a lado

	Agents API	Responses API	Agents SDK	AgentKit
O que é	Runtime de agente gerenciado no harness Codex	Endpoint do modelo: POST /v1/responses	Biblioteca para TypeScript e Python	Pacote com Agent Builder, ChatKit, Connector Registry e Evals
Quem executa o loop	OpenAI	Seu código	Executor do SDK, dentro do aplicativo	Workflows do Agent Builder, exportados para código SDK ou incorporados com ChatKit
Onde a computação é executada	Sandbox hospedado pela OpenAI, seu próprio sandbox ou nenhum	Seu ambiente, além de ferramentas hospedadas	Seus provedores de runtime e sandbox	Não aplicável
Onde o estado reside	Sessão OpenAI: configuração, turnos e itens	Seu histórico, previous_response_id ou API de Conversas	Seu armazenamento, sessões SDK ou estado de Responses	Workflows publicados e versionados
O que você paga	Tokens, ferramentas e contêineres hospedados; sem taxa extra	Tokens e ferramentas	Tokens, ferramentas e sua hospedagem	Uso da API subjacente; sem assinatura separada
Esforço de integração	Baixo	Alto	Médio	Não classificado
Status	Beta público (OpenAI-Beta: agents=v1)	Recomendado para novos projetos	Atual	Agent Builder e Evals serão desativados em 30 de novembro de 2026; ChatKit permanece
Controles de dados	Residência apenas nos EUA; não elegível para ZDR; estado mantido até exclusão	Elegível para ZDR, com limitações; endpoints regionais	Depende das APIs chamadas pelo SDK	Não aplicável

Fontes: comparação de runtimes de agentes, visão geral da Agents API e página de depreciações da OpenAI.

Quem executa o loop?

Essa é a decisão que determina a maioria das demais escolhas de arquitetura.

Responses API: seu código executa o loop

Com a Responses API, você recebe chamadas de função e decide o próximo passo:

1. Envie um prompt com ferramentas.
2. Receba um item function_call.
3. Execute a função no seu backend.
4. Envie function_call_output usando o mesmo call_id.
5. Repita até obter uma resposta final.

Ferramentas hospedadas, como pesquisa web, pesquisa de arquivos, interpretador de código e MCP remoto, podem realizar várias ações em uma única solicitação. Mas as suas funções retornam para o seu aplicativo.

Você também controla:

• quando encerrar o loop;
• como persistir o histórico;
• quando usar previous_response_id;
• quando desativar o armazenamento com store: false;
• quando compactar contexto com context_management e compact_threshold.

Veja o guia da Responses API e o guia de chamada de função para implementar esse fluxo.

Agents SDK: o executor roda no seu processo

No Agents SDK, o executor da biblioteca lida com o loop do agente e com transferências. Ainda assim, sua aplicação continua responsável por:

• implantação;
• implementação de ferramentas;
• armazenamento de estado;
• aprovações;
• observabilidade e auditoria.

Com Sandbox Agents, o harness pode permanecer na sua infraestrutura enquanto comandos são executados em um workspace Unix local, Docker ou provedor hospedado. Isso mantém autenticação, logs de auditoria e revisão humana fora do contêiner.

Agents API: a OpenAI executa o loop

Na Agents API, a OpenAI opera o harness gerenciado. Ele lida com:

• sessões;
• orquestração;
• compactação de contexto;
• recuperação;
• subagentes;
• pesquisa de ferramentas;
• chamada programática de ferramentas.

Servidores MCP remotos são chamados diretamente pela OpenAI.

Seu backend ainda precisa atender chamadas de função. Quando a sessão informar uma function_call em required_actions, envie um evento agent.session.input.tool_result com turn_id e call_id.

Compare as chamadas HTTP

# Responses API: seu código é o dono do loop
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning": {"effort": "low"},
    "tools": [{"type": "web_search"}],
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

# Agents API: uma sessão durável; OpenAI executa o loop
curl https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "model": "gpt-6-astra",
      "tools": [{"type": "web_search"}]
    },
    "environment": {"type": "none"},
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

Os exemplos da documentação da Agents API usam gpt-6-astra. Eles não especificam se outros modelos são aceitos; valide antes de substituí-lo por gpt-6.1-sol.

Computação, estado e custo

Computação

A Agents API pode provisionar e administrar um sandbox durante toda a sessão. Configure environment.type como:

• openai_hosted;
• self_hosted;
• none.

No Agents SDK, você escolhe e paga pelo provedor de sandbox. Com Responses, o código roda onde você o executa, exceto pelas ferramentas hospedadas.

Estado

Uma sessão da Agents API mantém configuração, turnos e itens no lado da OpenAI. Para continuar uma conversa, envie um novo evento para o mesmo ID de sessão.

Com Responses, você pode:

• encadear chamadas com previous_response_id; ou
• usar a API de Conversas.

No SDK, o estado fica no seu armazenamento, nas sessões do SDK ou no estado de Responses.

Custo

Os preços de tokens são os mesmos em todas as opções porque elas chamam os mesmos modelos.

A Agents API não adiciona uma taxa própria, mas contêineres hospedados custam entre US$ 0,03 para 1 GB e US$ 0,48 para 16 GB por sessão de 20 minutos.

No SDK, o custo adicional é a infraestrutura que você opera. O AgentKit não tem assinatura separada, conforme explicado no guia do AgentKit.

Dados e residência

A Agents API suporta apenas residência de dados nos EUA e não suporta Zero Data Retention (ZDR), inclusive com sandbox auto-hospedado.

A página de controle de dados da OpenAI informa que:

• /v1/agents não é elegível para ZDR;
• o estado é mantido até ser excluído;
• /v1/responses é elegível para ZDR, com limitações;
• Responses está disponível em endpoints regionais, como eu.api.openai.com.

Se ZDR ou residência de dados na União Europeia for um requisito, a Agents API não atende esse requisito atualmente.

AgentKit no final de 2026: o que permanece?

O AgentKit foi lançado em 6 de outubro de 2025 com quatro componentes.

• Agent Builder: a depreciação foi anunciada em 3 de junho de 2026, com desligamento programado para 30 de novembro de 2026. O guia de migração permite exportar um workflow como código do Agents SDK ou recriá-lo como um ChatGPT Workspace Agent em Business, Enterprise ou Edu.
• Evals: avaliações existentes se tornam somente leitura em 31 de outubro de 2026. O painel e a API serão desativados em 30 de novembro de 2026.
• ChatKit: permanece disponível para chat incorporado.
• Connector Registry: painel administrativo para conectores e servidores MCP nos produtos OpenAI.

Para um caminho code-first e durável, use o Agents SDK, como detalhado no guia do AgentKit.

Qual opção escolher?

Escolha	Use quando
Agents API	A tarefa dura minutos, precisa de arquivos, comandos ou navegador, e você não quer operar loop, sandbox ou armazenamento de sessão. Residência nos EUA e um cabeçalho beta são aceitáveis.
Responses API	Você quer controlar cada turno, precisa de ZDR ou residência fora dos EUA, faz chamadas únicas ou já possui um loop funcional.
Agents SDK	Seu aplicativo tipado deve controlar ferramentas, armazenamento, aprovações e transferências, com o loop rodando na sua infraestrutura.
ChatKit	Você precisa incorporar uma interface de chat no produto.
Agent Builder	Não inicie novos projetos aqui. Exporte workflows existentes antes de 30 de novembro de 2026.

Na AWS, o Bedrock Managed Agents, desenvolvido pela OpenAI, oferece capacidades centrais da Agents API para execução nativa na AWS.

Para configurar MCP em qualquer caminho code-first, consulte servidores MCP com agentes OpenAI.

Migrando de um loop Responses para a Agents API

Se você já implementou um loop com Responses e quer que a OpenAI o execute, siga esta sequência.

1. Mapeie os componentes

   • Instruções, modelo e ferramentas vão para agent.
   • Seu contêiner passa a ser environment.
   • Seu armazenamento de conversa passa a ser um ID de sessão.

2. Mova servidores MCP remotos para agent.tools

   • Armazene tokens em um cofre associado usando vault_ids.
   • Não coloque segredos no prompt.

3. Reescreva o tratamento de ferramentas de função

   • Substitua o loop que envia function_call_output.
   • Trate agent.session.requires_action no stream.
   • Trate agent.session.action_required em webhooks.
   • Responda com agent.session.input.tool_result.
   • Inclua turn_id e call_id.

4. Mantenha ferramentas de função no agente principal

   • Subagentes não podem chamar ferramentas de função.

5. Remova a compactação manual

   • O harness da Agents API compacta o contexto automaticamente.

6. Monitore eventos de término

   • agent.session.turn.completed
   • agent.session.turn.failed
   • agent.session.turn.cancelled

Uma sessão ociosa não indica sucesso. Use streaming ou webhooks para determinar o resultado do turno.

1. Valide as restrições antes de migrar
   • residência de dados apenas nos EUA;
   • sem ZDR;
   • cabeçalho OpenAI-Beta: agents=v1.

Teste Responses e Agents API no mesmo projeto Apidog

Antes de mudar sua arquitetura, execute os dois fluxos lado a lado.

1. Crie uma pasta Responses.
2. Crie uma pasta Agents API.
3. Compartilhe um ambiente com:
   • {{OPENAI_API_KEY}};
   • uma variável de modelo.
4. Envie os mesmos prompts para as duas APIs.
5. Faça asserções sobre:
   • código HTTP;
   • campos obrigatórios da saída;
   • eventos esperados do turno.
6. Abra o stream da Agents API como uma solicitação SSE para inspecionar eventos.
7. Salve as execuções como um cenário de teste.
8. Execute o cenário no CI com o Apidog CLI.

Dessa forma, mudanças no comportamento beta aparecem como falhas verificáveis no pipeline. O guia de confiabilidade de agentes de IA em produção mostra o que vale a pena validar. Para configurar o projeto, baixe o Apidog.

Perguntas frequentes

A Agents API está substituindo a Responses API?

Não. Nenhuma depreciação foi anunciada. A OpenAI lista Agents API, Agents SDK e Responses API como opções atuais para necessidades diferentes.

O OpenAI AgentKit está depreciado?

Parcialmente. Agent Builder e Evals serão desativados em 30 de novembro de 2026. ChatKit continua disponível.

O Agents SDK usa a Agents API?

Não. O SDK roda no seu aplicativo. A Agents API executa um harness gerenciado no serviço da OpenAI.

O que aconteceu com a Assistants API?

A página de depreciações da OpenAI definiu sua remoção para 26 de agosto de 2026 e orienta desenvolvedores a usar as APIs Responses e Conversations.

Qual opção é mais barata?

Os preços de tokens são os mesmos. A diferença está nos contêineres hospedados da Agents API versus a infraestrutura que você opera com SDK ou Responses.

Escolha um caminho esta semana

Comece decidindo quem deve executar o loop. Depois, valide essa escolha com solicitações reais antes de construir a aplicação completa.

Se você está começando, crie uma sessão na Agents API e compare a saída com sua configuração atual de Responses no Apidog.