OpenAI Agents API
BetaOpenAI's managed Codex harness, exposed as an API for long-running agents
OpenAI's Agents API is the runtime OpenAI itself rates lowest in integration effort of the three it compares: it exposes the managed Codex harness with durable sessions, context compaction, subagents and hosted or partner sandboxes, and charges no fee beyond tokens, tools and container time. Conditional because it is a public beta that currently offers US-only data residency and no Zero Data Retention. Right for product teams already building on the OpenAI API; wrong for workloads that require ZDR or data residency outside the US.
OpenAI runs the agent loop on its infrastructure: a managed Codex harness drives model calls, tools and sandbox commands in durable sessions
É adequada para ti?
Bom para
- Long-running tasks where OpenAI manages the agent and saves its progress, which is the use OpenAI's runtime comparison assigns to the Agents API
- Shipping an agent without building the loop: OpenAI handles session orchestration, context compaction and recovery on its own infrastructure
- Code execution and file work in an OpenAI-hosted sandbox, in your own infrastructure, or with a partner sandbox such as E2B, Modal, Daytona or Vercel
- Extending agents with your own tools and MCP servers, plus skills loaded from the environment
- Splitting complex work across subagents, which OpenAI's docs describe as breaking work into subtasks and delegating to subagents
- Teams already on OpenAI API billing, since OpenAI says there are no additional fees beyond the tokens and tools agents use
Não recomendado para
- Workloads that require Zero Data Retention, which the Agents API currently does not support
- Data that must stay outside the United States, since data residency is currently supported only in the US
- Production systems that cannot absorb beta changes: it launched as a public beta and every request requires the OpenAI-Beta: agents=v1 header
- Keeping the agent loop inside your own application, a use OpenAI's runtime comparison assigns to the Agents SDK, which runs inside your application
- Budgeting from token prices alone, since OpenAI-hosted sandboxes bill separately at standard container rates
A nossa experiência
Preços
Pago- Model usage billed at the selected model's API rates
- OpenAI tools billed at their standard rates
- OpenAI-hosted sandboxes billed at standard container rates
- Self-hosted and partner sandboxes supported
Receitas de fluxo de trabalho
Run a first agent session
Start one agent session in an OpenAI-hosted sandbox following OpenAI's quickstart
- Create an application API key in your OpenAI Platform project with api.agents.read, api.agents.write and api.responses.write
- Keep the key outside the agent's sandbox and export it as an environment variable
- Install the SDK with pip install --upgrade openai or npm install openai
- Create a session with an agent configuration, environment type openai_hosted and your input instructions, sending the OpenAI-Beta: agents=v1 header
- Stream session events, wait for agent.session.turn.completed, then check the agent's reported execution result
- Save the session_id to continue the work, or delete the session when finished
Ainda sem alterações de veredicto
O relógio começa a contar no primeiro dia: as alterações aparecem aqui à medida que o nosso veredicto evolui.
Fontes
- OpenAI Developer Community, Introducing the Agents API and hosted sandboxes (official)09/2026
- OpenAI API changelog (official)09/2026
- OpenAI API docs, agents runtime comparison (official)09/2026
- OpenAI Developer Pricing Docs09/2026
- OpenAI API docs, Agents API overview (official)09/2026
- OpenAI API docs, Agents API quickstart (official)09/2026
Registo de verificação
Ainda não há verificações
Ainda não registámos nenhuma verificação para esta entrada. Assim que uma for executada, o seu histórico aparece aqui.
Quer isto a funcionar na sua empresa?
Testámos esta ferramenta e construímos com ferramentas assim todos os dias. Diga-nos o fluxo de trabalho e nós instalamos, integramos e entregamos a funcionar.
A conversa funciona com Gnosari, uma das ferramentas deste diretório. Uma conversa real, não um guião de vendas.