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.

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

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
});

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.

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.

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
}

Uma fundação de código aberto

A API de Agentes é sustentada pelo harness Codex de código aberto, dando aos programadores visibilidade sobre a lógica central que coordena as chamadas ao modelo, as ferramentas e o contexto. Com a API de Agentes, a OpenAI opera e mantém esse harness, enquanto os programadores podem consultar e aprender com a respetiva base de código pública⁠(abre numa nova janela).

Começa a construir

A API de Agentes está disponível a partir de hoje em versão beta pública para todos os programadores. Não existem custos adicionais pela utilização da API de Agentes — paga apenas pelos tokens e pelas ferramentas que os seus agentes utilizam, conforme indicado na nossa página de preços⁠(abre numa nova janela).

Explore a visão geral da API de Agentes⁠(abre numa nova janela) para saber mais ou siga o guia de início rápido⁠(abre numa nova janela) para começar e integrar o harness por trás do Codex nos seus próprios agentes.

Durante a versão beta pública, vamos iterar rapidamente com base no seu feedback, enquanto trabalhamos para alcançar a disponibilidade geral. Diga-nos o que está a funcionar, onde está a encontrar dificuldades e o que precisa para criar e operar os seus agentes em produção.

Autor

OpenAI