Saltar 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 Codex, totalmente gerido pela OpenAI.

A carregar…

Ao disponibilizarmos o Codex e o ChatGPT for Work a milhões de pessoas em todo o mundo, aprendemos o que é necessário para que os agentes de longa duração funcionem bem na prática. Os agentes úteis precisam de um harness avançado que gira o contexto, utilize ferramentas de forma eficiente e coordene subagentes. Também precisam de infraestrutura que os mantenha a funcionar de forma fiável durante vários dias, com ambientes onde possam trabalhar com ficheiros, executar código e guardar resultados intermédios.

Hoje, apresentamos a API de Agentes(abre numa nova janela) em versão beta pública, disponibilizando aos programadores, através de uma API simples e flexível, o mesmo harness e a mesma infraestrutura que sustentam o Codex.

A OpenAI aloja e mantém o harness. Pode escolher o ambiente computacional do agente: uma sandbox gerida pela OpenAI, a sua própria infraestrutura ou um dos nossos parceiros de sandbox. A API de Agentes oferece uma base sólida para criar agentes sobre a nossa infraestrutura e o nosso harness otimizado para agentes, para que possa concentrar-se nas ferramentas, no conhecimento e nos fluxos de trabalho que tornam o seu agente único.

«Com a API de Agentes, a nossa pontuação de avaliação subiu de 0,71 para 0,85. O suporte de subagentes na API é excelente e acelerou drasticamente o nosso fluxo de trabalho. Anteriormente, observar e orquestrar subagentes na nossa configuração antiga era bastante complicado, mas as novas APIs reduziram a latência em quatro vezes. Passámos muito tempo a tentar otimizar este processo, e os fluxos de subagentes trouxeram uma melhoria enorme logo de início.»
Jack Weissenberger, CTO, Ciridae
Uma aplicação envia tarefas para a API de Agentes e recebe eventos e resultados. A API de Agentes executa o harness Codex gerido, envia chamadas de ferramentas para uma sandbox e recebe os respetivos resultados. A aplicação controla os recursos computacionais autoalojados.

A API de Agentes disponibiliza aos seus agentes o mesmo harness e a mesma infraestrutura que sustentam o Codex.

Crie agentes na nuvem com uma única chamada à API

Com a API de Agentes, pode criar um agente pronto para produção com uma única chamada à 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
});

O que dizem os nossos clientes sobre a API de Agentes

1 de 8
«Com a API de Agentes, a nossa pontuação de avaliação subiu de 0,71 para 0,85. O suporte de subagentes na API é excelente e acelerou drasticamente o nosso fluxo de trabalho. Anteriormente, observar e orquestrar subagentes na nossa configuração antiga era bastante complicado, mas as novas APIs reduziram a latência em quatro vezes. Passámos muito tempo a tentar otimizar este processo, e os fluxos de subagentes trouxeram uma melhoria enorme logo de início.»
Jack Weissenberger, CTO, Ciridae

Escolha o ambiente do seu agente

Diferentes cargas de trabalho exigem diferentes opções de computação, armazenamento e implementação. A API de Agentes permite-lhe escolher uma sandbox adequada à sua aplicação.

Estamos a estabelecer parcerias com fornecedores do ecossistema(abre numa nova janela), incluindo Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop e Vercel, para oferecer integrações de primeira classe para diversas necessidades:

  • Ambientes totalmente geridos ou implementações na sua VPC
  • Mecanismos específicos para armazenar ficheiros e segredos
  • Diferentes configurações de CPU, GPU e memória, com perfis de desempenho, arranque a frio e custos 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 primeira classe com fornecedores populares do ecossistema.

Sandboxes alojadas pela OpenAI

Para os programadores que pretendem começar rapidamente e escalar de forma eficiente, apresentamos também a sandbox alojada pela OpenAI(abre numa nova janela). Esta utiliza a mesma infraestrutura de sandbox que sustenta o Codex e o ChatGPT.

A OpenAI aprovisiona e gere a sandbox, proporcionando ao seu agente um ambiente seguro e eficiente para executar código, trabalhar com ficheiros e produzir artefactos. Estas sandboxes podem ser configuradas de forma flexível com os seus ficheiros, pacotes, competências e plug-ins, para dar ao agente tudo o que precisa para concluir a tarefa.

Crie com um harness Codex em evolução

Tirar partido das novas capacidades dos modelos implica muitas vezes reformular o seu harness, desviando tempo valioso da melhoria da sua aplicação. A API de Agentes fornece acesso com controlo de versões a estas capacidades a cada lançamento de um modelo. Mantemos e melhoramos continuamente o harness em paralelo com os nossos modelos, ajudando os seus agentes a obter melhor desempenho com cada atualização. Por exemplo, as melhorias recentes no harness incluem:

Mantenha os agentes a trabalhar durante sessões longas

Para apoiar modelos que trabalham durante horas, criámos uma gestão de contexto que ajuda os agentes a manter as informações relevantes ao longo de sessões mais longas. A API de Agentes compacta automaticamente(abre numa nova janela) o contexto anterior quando uma sessão se aproxima do respetivo limite de contexto, preservando as informações de que o agente precisa para continuar. Os programadores podem criar fluxos de trabalho que abrangem várias janelas de contexto sem implementarem a sua própria lógica de compactação.

Ajude os agentes a utilizar mais ferramentas de forma eficiente

A API de Agentes ajuda os agentes a encontrar as ferramentas certas e a utilizá-las de forma eficiente. A pesquisa de ferramentas(abre numa nova janela) carrega as definições das ferramentas relevantes conforme necessário, ajudando a reduzir a utilização de tokens e os custos, sem invalidar a cache do modelo. Quando as ferramentas estão disponíveis, a chamada programática de ferramentas(abre numa nova janela) permite aos agentes executar chamadas em paralelo, encadear operações relacionadas e filtrar ou combinar resultados em código. Assim, podem processar grandes volumes de dados e devolver ao contexto apenas os resultados relevantes. A API de Agentes é compatível com MCP, funções personalizadas e ferramentas integradas, como a pesquisa 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 distribuam o trabalho por subagentes

Com o suporte multiagente(abre numa 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 o seu próprio contexto, o que o ajuda a concentrar-se na tarefa atribuída, enquanto o agente principal coordena o trabalho e reúne os resultados. Isto pode acelerar tarefas de investigação, análise e programação que beneficiam do trabalho em paralelo, sem exigir que crie a 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
}

An open-source foundation

The Agents API is powered by the open-source Codex harness, giving developers visibility into the core logic that coordinates model calls, tools, and context. With the Agents API, OpenAI operates and maintains that harness while developers can inspect and learn from its public codebase(abre numa nova janela).

Start building

Agents API is available in public beta today to all developers. There are no additional fees for using the Agents API – you simply pay for the tokens and tools your agents use, as outlined on our pricing page(abre numa nova janela).

Explore the Agents API overview(abre numa nova janela) to learn more, or follow the quickstart(abre numa nova janela) to get started and bring the harness behind Codex into your own agents.

During the public beta, we’ll iterate quickly based on your feedback as we work toward general availability. Let us know what’s working, where you’re running into friction, and what you need to build and run your agents in production.

Autor

OpenAI