OpenAI vend le harnais Codex comme une API

Ce qui se passe

OpenAI ouvre en bêta l'Agents API : le harnais de Codex, son agent de code, devient une API managée. L'application fournit les outils et choisit l'environnement d'exécution ; OpenAI gère les sessions, l'orchestration, la compaction du contexte et la reprise. L'agent peut tourner dans un bac à sable où il exécute du code, édite des fichiers, se connecte à des serveurs MCP et produit des artefacts.

Quatre objets structurent l'API :

• Agent : modèle, instructions, outils et serveurs MCP disponibles.
• Environment : bac à sable optionnel, hébergé par OpenAI ou par vous (self_hosted), où l'agent lit des fichiers, charge des skills et lance des commandes.
• Session : instance durable de l'agent, qui garde configuration, tours et items entre les tâches.
• Events et items : ce qu'on envoie à l'agent et ce qu'il produit, suivi en flux ou par webhook.

Le cycle : créer une session, envoyer une tâche, suivre les événements, puis continuer sur la même session ou redresser l'agent pendant son tour. Le harnais gère la compaction, la délégation à des sous-agents (multi_agent, avec max_concurrent_subagents), l'appel programmatique d'outils, les skills et la reprise d'une session interrompue.

Comment s'y prendre

• Créer une clé d'application avec les scopes api.agents.read, api.agents.write et api.responses.write, et la garder hors du bac à sable.
• Envoyer l'en-tête OpenAI-Beta: agents=v1 ; les SDK l'ajoutent, cURL non.
• Utiliser le namespace client.beta.agents.sessions des SDK à jour.
• Lire les événements avec soin : agent.session.turn.completed ne garantit pas que chaque outil a réussi ; turn.failed, turn.cancelled et session.failed signalent l'échec ; agent.session.idle seul ne veut pas dire succès. Si le flux se coupe, récupérer la session et ses items avant de réessayer.

La documentation situe l'Agents API face aux deux autres options : l'Agents SDK garde la boucle dans votre application (effort moyen, état chez vous), la Responses API vous laisse tout construire (effort élevé). L'Agents API est l'option à effort faible pour les tâches longues dont OpenAI sauvegarde la progression.

Ce que ça change

Le harnais, c'est la partie qu'on réécrit dans chaque projet d'agent, et celle qui casse le plus. La proposer en service managé aligne OpenAI sur les Managed Agents d'Anthropic. Vercel a branché son Sandbox le jour même, avec webhooks signés et files pour recréer et reconnecter les environnements, dans une architecture sans worker permanent.

Le prix cumule trois lignes : le modèle à son tarif API, les outils OpenAI à leur tarif standard, et les bacs à sable hébergés au tarif conteneur.

À retenir

Deux limites pèsent pour une entreprise européenne : résidence des données aux États-Unis uniquement, et pas de Zero Data Retention, y compris avec un bac à sable auto-hébergé. À évaluer sur un cas interne avant d'y faire passer des données clients.

Source : Agents API, OpenAI API