Pular para o conteúdo principal
OpenAI

10 de setembro de 2026

ProdutoAPI

Apresentamos a API de Agentes

Crie e execute agentes na nuvem com o harness do Codex, totalmente gerenciado pela OpenAI.

Carregando…

Ao levarmos o Codex e o ChatGPT for Work a milhões de pessoas em todo o mundo, aprendemos o que é necessário para que agentes de longa duração funcionem bem na prática. Agentes úteis precisam de um harness avançado que gerencie o contexto, use ferramentas com eficiência e coordene subagentes. Eles também precisam de uma infraestrutura que os mantenha em execução confiável por dias, com ambientes onde possam trabalhar com arquivos, executar código e salvar resultados intermediários.

Hoje, apresentamos a API de Agentes⁠(abre em uma nova janela) em beta público, levando aos desenvolvedores o mesmo harness e a mesma infraestrutura que sustentam o Codex por meio de uma API simples e flexível.

O que nossos clientes dizem sobre a API de Agentes

1 de 8
"Com a API de Agentes, nossa pontuação de avaliação passou de 0,71 para 0,85. O suporte a subagentes na API é excelente e acelerou drasticamente nosso fluxo de trabalho. Antes, observar e orquestrar subagentes em nossa configuração antiga era bem trabalhoso, mas as novas APIs reduziram a latência em quatro vezes. Passamos muito tempo tentando otimizar isso, e os fluxos de subagentes trouxeram um enorme ganho imediato."
Jack Weissenberger, CTO, Ciridae

Crie agentes na nuvem com uma única chamada de API

Com a API de Agentes, você pode criar um agente pronto para produção com uma única chamada de API, especificando a tarefa, o modelo, as ferramentas e o ambiente:

JavaScript

1
import OpenAI from "openai";
2

3
const client = new OpenAI();
4

5
const session = await client.beta.agents.sessions.create({
6
agent: {
7
model: "gpt-6-astra",
8
tools: [
9
{
10
type: "mcp",
11
server_label: "observability",
12
transport: {
13
type: "http",
14
server_url: "https://observability.example.com/mcp",
15
},
16
},
17
],
18
multi_agent: { enabled: true, max_concurrent_subagents: 3 },
19
},
20
vault_ids: ["vault_YOUR_VAULT_ID"],
21
environment: {
22
type: "openai_hosted",
23
capability_directories: ["/workspace/capabilities/skills"],
24
},
25
input:
26
"Investigate service-api’s elevated 5xx rate over the last 30 minutes. " +
27
"Delegate deployment, error, and dependency analysis to subagents. " +
28
"Save findings, evidence, and recommended mitigation in /workspace/outputs.",
29
});

A OpenAI hospeda e mantém o harness. Você escolhe o ambiente computacional do agente: um sandbox gerenciado pela OpenAI, sua própria infraestrutura ou um de nossos parceiros de sandbox. A API de Agentes oferece uma base sólida para criar agentes sobre nosso harness e nossa infraestrutura otimizados para agentes, permitindo que você se concentre nas ferramentas, no conhecimento e nos fluxos de trabalho que tornam seu agente único.

Uma aplicação envia tarefas à API de Agentes e recebe eventos e resultados. A API de Agentes executa o harness gerenciado do Codex, enviando chamadas de ferramentas a um sandbox e recebendo os resultados. A aplicação controla a computação auto-hospedada.

A API de Agentes oferece aos seus agentes o mesmo harness e a mesma infraestrutura por trás do Codex.

Escolha o ambiente do seu agente

Diferentes cargas de trabalho exigem diferentes opções de computação, armazenamento e implantação. A API de Agentes permite escolher um sandbox adequado à sua aplicação.

Estamos formando parcerias com provedores do ecossistema⁠(abre em uma nova janela), incluindo Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop e Vercel, para oferecer integrações de alto nível para diversas necessidades:

  • Ambientes totalmente gerenciados ou implantações em sua VPC

  • Mecanismos específicos para armazenamento de arquivos e segredos

  • Diferentes configurações de CPU, GPU e memória, com perfis de desempenho, inicialização a frio e custo adequados ao fluxo de trabalho da sua empresa.

Parceiros de sandbox: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B e DigitalOcean.

A API de Agentes oferece integrações de alto nível com provedores populares do ecossistema.

Sandboxes hospedados pela OpenAI

Para desenvolvedores que querem começar rapidamente e escalar com eficiência, também apresentamos o sandbox hospedado pela OpenAI⁠(abre em uma nova janela). Ele utiliza a mesma infraestrutura de sandbox que sustenta o Codex e o ChatGPT.

A OpenAI provisiona e gerencia o sandbox, oferecendo ao seu agente um ambiente seguro e eficiente para executar código, trabalhar com arquivos e produzir artefatos. Esses sandboxes podem ser configurados de forma flexível com seus arquivos, pacotes, habilidades e plugins para fornecer ao agente o necessário para concluir a tarefa.

Crie com um harness do Codex em constante evolução

Aproveitar novos recursos dos modelos muitas vezes exige reformular o harness, consumindo um tempo valioso que poderia ser dedicado a melhorar sua aplicação. A API de Agentes oferece acesso versionado a esses recursos a cada lançamento de modelo. Mantemos e aprimoramos continuamente o harness junto com nossos modelos, ajudando seus agentes a obter melhor desempenho a cada atualização. Por exemplo, melhorias recentes no harness incluem:

Mantenha os agentes trabalhando em sessões longas

Para dar suporte a modelos que trabalham por horas, criamos um sistema de gerenciamento de contexto que ajuda os agentes a manter informações relevantes ao longo de sessões mais extensas. A API de Agentes compacta automaticamente⁠(abre em uma nova janela) o contexto anterior conforme uma sessão se aproxima do limite de contexto, preservando as informações de que o agente precisa para continuar. Os desenvolvedores podem criar fluxos de trabalho que abrangem várias janelas de contexto sem implementar uma lógica própria de compactação.

Ajude os agentes a usar mais ferramentas com eficiência

A API de Agentes ajuda os agentes a encontrar as ferramentas certas e usá-las com eficiência. A busca de ferramentas⁠(abre em uma nova janela) carrega as definições de ferramentas relevantes conforme necessário, ajudando a reduzir o uso de tokens e os custos sem invalidar o cache do modelo. Quando as ferramentas estão disponíveis, a chamada programática de ferramentas⁠(abre em uma nova janela) permite que os agentes executem chamadas em paralelo, encadeiem operações relacionadas e filtrem ou combinem resultados no código. Assim, eles podem processar grandes volumes de dados e trazer de volta ao contexto apenas os resultados relevantes. A API de Agentes oferece suporte a MCP, funções personalizadas e ferramentas integradas, como busca na web.

JSON

1
"agent": {
2
"tools": [
3
{
4
"type": "mcp",
5
"server_label": "openai_docs",
6
"transport": {
7
"type": "http",
8
"server_url": "https://developers.openai.com/mcp"
9
}
10
},
11
]
12
}

Permita que os agentes paralelizem o trabalho com subagentes

Com o suporte a múltiplos agentes⁠(abre em uma nova janela), a API de Agentes pode dividir tarefas complexas em partes independentes e delegá-las a subagentes que trabalham em paralelo. Cada subagente mantém seu próprio contexto, o que o ajuda a se concentrar em sua atribuição, enquanto o agente principal coordena o trabalho e reúne os resultados. Isso pode acelerar tarefas de pesquisa, análise e programação que se beneficiam do trabalho paralelo, sem exigir que você crie sua própria orquestração.

JSON

1
"agent": {
2
"model": "gpt-6-astra",
3
"multi_agent": {
4
"enabled": true,
5
"max_concurrent_subagents": 3,
6
}
7
}

Uma base de código aberto

A API de Agentes utiliza o harness de código aberto do Codex, oferecendo aos desenvolvedores visibilidade da lógica central que coordena chamadas de modelos, ferramentas e contexto. Com a API de Agentes, a OpenAI opera e mantém esse harness, enquanto os desenvolvedores podem inspecionar e aprender com sua base de código pública⁠(abre em uma nova janela).

Comece a criar

A Agents API está disponível em beta público a partir de hoje para todos os desenvolvedores. Não há tarifas adicionais pelo uso da Agents API: você paga apenas pelos tokens e pelas ferramentas que seus agentes usam, conforme descrito na nossa página de preços⁠(abre em uma nova janela).

Explore a visão geral da Agents API⁠(abre em uma nova janela) para saber mais ou siga o guia de início rápido⁠(abre em uma nova janela) para começar e levar o ambiente de execução por trás do Codex aos seus próprios agentes.

Durante o beta público, faremos melhorias rápidas com base no seu feedback enquanto avançamos rumo à disponibilidade geral. Conte para nós o que está funcionando, onde você encontra dificuldades e do que precisa para criar e executar seus agentes em produção.

Autor

OpenAI