Visió general

L'API d'agents està disponible en versió beta. Permet als desenvolupadors crear aplicacions amb un agent Codex gestionat per OpenAI que pot treballar en diversos passos i continuar dins de la mateixa sessió.

La teva aplicació proporciona la tasca, les eines i la configuració. OpenAI gestiona la sessió de l'agent i la coordinació entre el model i les eines.

Què pot fer un agent?

Segons les eines i l'entorn d'execució de què disposi, un agent pot executar codi, editar fitxers, utilitzar connexions MCP i generar fitxers per a la teva aplicació. Pots enviar instruccions addicionals o continuar amb una altra tasca a la mateixa sessió.

Consulta la visió general de l'API d'agents per veure les funcionalitats compatibles i alguns exemples.

Com puc començar?

1. Crea una clau d'API per a l'aplicació al teu projecte de la plataforma d'OpenAI. Concedeix els permisos api.agents.read i api.agents.write per a les sessions, i api.responses.write per a les sol·licituds al model.

2. Segueix la guia d'inici ràpid per configurar un agent, crear una sessió i enviar una tasca.

3. Segueix els esdeveniments de la sessió per revisar el progrés i els resultats. Desa l'ID de la sessió si vols continuar la feina.

Mantén la clau d'API fora de l'entorn aïllat de l'agent. Les sol·licituds requereixen la capçalera OpenAI-Beta: agents=v1. Els SDK d'OpenAI afegeixen aquesta capçalera automàticament.

El meu agent necessita un entorn aïllat?

Tria l'entorn que s'adapti a la tasca:

• Sense entorn: L'agent respon preguntes o utilitza eines externes sense necessitar ordres integrades de l'intèrpret d'ordres ni fitxers de l'espai de treball.

• Entorn aïllat allotjat per OpenAI: L'agent necessita executar scripts o treballar amb fitxers i vols que OpenAI en gestioni l'entorn aïllat.

• Entorn aïllat amb allotjament propi: Necessites la teva pròpia infraestructura, programari o xarxa privada. La teva aplicació gestiona el cicle de vida de l'entorn.

Consulta l'arquitectura de l'API d'agents per obtenir informació sobre la configuració.

On puc revisar una sessió?

Obre Registres al tauler de la plataforma, selecciona Agents i cerca l'ID de la sessió. Pots examinar els torns, les crides a eines i l'activitat dels subagents.

La guia d'observabilitat també explica com revisar l'ús de segments registrat.

Què passa si es desconnecta el flux d'esdeveniments?

Recupera la sessió existent i els elements que s'hi han desat abans de tornar-ho a provar. Això t'ajuda a comprovar què ha passat abans d'enviar més feina.

Que un torn s'hagi completat no vol dir que totes les eines s'hagin executat correctament. Revisa el resultat comunicat. El fet que una sessió estigui inactiva no confirma, per si sol, que la tasca hagi finalitzat correctament.

Com es factura l'ús?

A les sol·licituds al model s'apliquen les tarifes de l'API del model seleccionat. A les eines d'OpenAI i als entorns aïllats allotjats per OpenAI s'apliquen les tarifes corresponents d'eines i contenidors.

Consulta els preus de l'API per veure les tarifes vigents.

Com es gestionen les dades i els fitxers de les sessions?

L'API d'agents conserva l'estat de la sessió perquè la feina pugui continuar d'un torn a l'altre. Pots suprimir les sessions i els artefactes publicats quan ja no siguin necessaris. Desa els fitxers que necessitis abans de suprimir una sessió.

Actualment, l'API d'agents només permet la ubicació de les dades als Estats Units. No és compatible amb la retenció de dades nul·la, ni tan sols quan utilitzes un entorn aïllat allotjat a la teva pròpia infraestructura. Consulta la documentació de l'API d'agents per obtenir informació sobre els controls de dades.