Salta al contingut principal
OpenAI

10 de setembre del 2026

ProducteAPI

Presentem l'API d'agents

Crea i executa agents al núvol amb l'entorn d'execució de Codex, gestionat íntegrament per OpenAI.

S'està carregant…

A mesura que hem ampliat Codex i ChatGPT per a Work a milions de persones d'arreu del món, hem après què cal perquè els agents de llarga durada funcionin bé a la pràctica. Els agents útils necessiten un entorn d'execució potent que gestioni el context, utilitzi les eines de manera eficient i coordini els subagents. També necessiten una infraestructura que els mantingui en funcionament de manera fiable durant dies, amb entorns on puguin treballar amb fitxers, executar codi i desar resultats intermedis.

Avui presentem l'API d'agents⁠(s'obre en una finestra nova) en beta pública, que posa a disposició dels desenvolupadors el mateix entorn d'execució i la mateixa infraestructura que impulsen Codex mitjançant una API senzilla i flexible.

Què diuen els nostres clients sobre l'API d'agents

1 de 8
"Amb l'API d'agents, la nostra puntuació d'avaluació va passar de 0,71 a 0,85. La compatibilitat de l'API amb subagents és excel·lent i ha agilitzat enormement el nostre flux de treball. Abans, observar i orquestrar subagents amb la nostra configuració anterior era força complicat, però les noves API ens han permès reduir quatre vegades la latència. Vam dedicar molt de temps a intentar optimitzar-ho, i els fluxos de subagents van aportar una millora enorme des del primer moment."
Jack Weissenberger, director de tecnologia de Ciridae

Crea agents al núvol amb una sola crida a l'API

Amb l'API d'agents, pots crear un agent preparat per a producció amb una sola crida a l'API especificant la tasca, el model, les eines i l'entorn:

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

OpenAI allotja i manté l'entorn d'execució. Tu tries l'entorn de computació de l'agent: en un espai aïllat gestionat per OpenAI, a la teva pròpia infraestructura o amb un dels nostres socis d'espais aïllats. L'API d'agents t'ofereix una base sòlida per crear agents sobre la nostra infraestructura i el nostre entorn d'execució optimitzat per a agents, perquè et puguis centrar en les eines, els coneixements i els fluxos de treball que fan únic el teu agent.

Una aplicació envia tasques a l'API d'agents i rep esdeveniments i resultats. L'API d'agents executa l'entorn d'execució gestionat de Codex, envia crides a eines a un espai aïllat i en rep els resultats. L'aplicació controla la computació autoallotjada.

L'API d'agents dota els teus agents del mateix entorn d'execució i la mateixa infraestructura que impulsen Codex.

Tria l'entorn del teu agent

Cada càrrega de treball requereix opcions diferents de computació, emmagatzematge i desplegament. L'API d'agents et permet triar un espai aïllat que s'adapti a la teva aplicació.

Estem col·laborant amb proveïdors de l'ecosistema⁠(s'obre en una finestra nova), com Blaxel, Cloudflare, Daytona, DigitalOcean, E2B, Modal, Oracle, Runloop i Vercel, per oferir integracions de primer nivell per a necessitats diverses:

  • Entorns totalment gestionats o desplegaments dins del teu VPC

  • Mecanismes específics per emmagatzemar fitxers i secrets

  • Diverses configuracions de CPU, GPU i memòria, amb perfils de rendiment, arrencada en fred i cost adaptats al flux de treball de la teva empresa.

Socis d'espais aïllats: Modal, Cloudflare, Daytona, Blaxel, Runloop, Vercel, Oracle, E2B i DigitalOcean.

L'API d'agents ofereix integracions de primer nivell amb proveïdors populars de l'ecosistema.

Espais aïllats allotjats per OpenAI

Per als desenvolupadors que vulguin començar ràpidament i escalar de manera eficient, també presentem l'espai aïllat allotjat per OpenAI⁠(s'obre en una finestra nova). Utilitza la mateixa infraestructura d'aïllament que impulsa Codex i ChatGPT.

OpenAI aprovisiona i gestiona l'espai aïllat, de manera que el teu agent disposa d'un entorn segur i d'alt rendiment per executar codi, treballar amb fitxers i generar artefactes. Aquests espais aïllats es poden configurar de manera flexible amb els teus fitxers, paquets, habilitats i connectors perquè l'agent disposi de tot el que necessita per completar la tasca.

Crea amb un entorn d'execució de Codex en evolució

Aprofitar les noves capacitats dels models sovint implica refer l'entorn d'execució, cosa que resta un temps valuós a la millora de l'aplicació. L'API d'agents ofereix accés versionat a aquestes capacitats amb cada llançament d'un model. Mantenim i millorem contínuament l'entorn d'execució juntament amb els nostres models perquè els teus agents treguin més rendiment de cada actualització. Per exemple, entre les millores recents de l'entorn d'execució hi ha:

Mantén els agents actius durant sessions llargues

Per admetre models que treballen durant hores, hem creat una gestió del context que ajuda els agents a conservar la informació rellevant al llarg de sessions més extenses. L'API d'agents condensa automàticament⁠(s'obre en una finestra nova) el context anterior quan una sessió s'acosta al límit de context, tot preservant la informació que l'agent necessita per continuar. Els desenvolupadors poden crear fluxos de treball que abastin diverses finestres de context sense implementar una lògica pròpia de condensació de context.

Ajuda els agents a utilitzar més eines de manera eficient

L'API d'agents ajuda els agents a trobar les eines adequades i utilitzar-les de manera eficient. La cerca d'eines⁠(s'obre en una finestra nova) carrega les definicions d'eines rellevants quan cal, cosa que ajuda a reduir l'ús de segments i el cost alhora que preserva la memòria cau del model. Quan les eines ja estan disponibles, les crides programàtiques a eines⁠(s'obre en una finestra nova) permeten als agents executar crides en paral·lel, encadenar operacions relacionades i filtrar o combinar resultats mitjançant codi. Així poden processar grans volums de dades i retornar al context només els resultats rellevants. L'API d'agents admet MCP, funcions personalitzades i eines integrades, com ara la cerca 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
}

Permet que els agents paral·lelitzin la feina amb subagents

Amb la compatibilitat amb diversos agents⁠(s'obre en una finestra nova), l'API d'agents pot dividir les tasques complexes en parts independents i delegar-les a subagents que treballen en paral·lel. Cada subagent manté el seu propi context, cosa que l'ajuda a centrar-se en la seva tasca, mentre que l'agent principal coordina la feina i aplega els resultats. Això pot agilitzar les tasques de recerca, anàlisi i programació que es beneficien del treball en paral·lel, sense que hagis de crear la teva pròpia orquestració.

JSON

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

Una fundació de codi obert

L'API d'agents funciona amb l'entorn d'execució de codi obert de Codex, que ofereix als desenvolupadors visibilitat sobre la lògica principal que coordina les crides als models, les eines i el context. Amb l'API d'agents, OpenAI opera i manté aquest entorn d'execució, mentre que els desenvolupadors poden examinar-ne la base de codi pública⁠(s'obre en una finestra nova) i aprendre'n.

Comença a crear

L'API d'agents està disponible avui en beta pública per a tots els desenvolupadors. No hi ha cap tarifa addicional per utilitzar l'API d'agents: simplement pagues pels segments i les eines que utilitzen els teus agents, tal com s'indica a la nostra pàgina de preus⁠(s'obre en una finestra nova).

Explora la descripció general de l'API d'agents⁠(s'obre en una finestra nova) per obtenir-ne més informació o segueix la guia d'inici ràpid⁠(s'obre en una finestra nova) per començar i incorporar l'entorn d'execució del Codex als teus propis agents.

Durant la beta pública, iterarem ràpidament a partir dels teus comentaris mentre treballem per a la disponibilitat general. Fes-nos saber què funciona, on trobes dificultats i què necessites per crear i executar els teus agents en producció.

Autor

OpenAI