Agents API d'OpenAI : ce que gère le harness de Codex
OpenAI héberge la boucle de Codex pour votre application. J'explique la différence avec le SDK, la persistance des sessions et les coûts qui restent.
Sur cette page
L’Agents API d’OpenAI, lancée en bêta publique le 10 septembre 2026, permet d’intégrer l’infrastructure gérée de Codex dans vos applications. OpenAI exécute la boucle de l’agent ; l’application lui confie du travail et reçoit les résultats. L’intérêt est de construire moins d’infrastructure autour du modèle, tout en gardant la responsabilité des outils et des accès. [1] [2]
En quoi l’Agents API diffère-t-elle de Responses et du SDK ?
La différence principale tient à qui exécute l’agent. Avec l’Agents API, OpenAI héberge le harness. Avec l’Agents SDK, votre code exécute un framework qui gère la boucle. En utilisant directement la Responses API, votre application prend davantage en charge les étapes entre les réponses du modèle. La documentation d’architecture et celle du SDK d’OpenAI distinguent explicitement ces options. [2] [9]
Le harness est le logiciel autour du modèle qui fait progresser une tâche : il fournit du contexte, appelle des outils et détermine quand solliciter à nouveau le modèle. Un appel isolé ne représente qu’une partie de ce travail. L’annonce d’OpenAI inclut la gestion des sessions, la compaction du contexte et la délégation parallèle dans l’offre gérée. La compaction raccourcit le contexte accumulé pour permettre à l’agent de continuer quand la conversation s’allonge. [1]
| Responsabilité | Responses API | Agents SDK | Agents API |
|---|---|---|---|
| Boucle de l'agent | Votre application | SDK dans votre environnement | Hébergée par OpenAI |
| Raison habituelle du choix | Contrôler chaque étape | Utiliser un framework d'agents | Utiliser un harness géré |
| Règles de l'application | Vous les définissez | Vous les définissez | Vous les définissez |
J’y vois un choix d’exploitation. Si entretenir la boucle retarde votre produit, confier cette tâche à OpenAI peut être utile. Si le contrôle de chaque transition fait la valeur de votre application, examinez ce compromis avant de migrer. Une nouvelle API ne rend pas une application SDK existante obsolète.
Une discussion sur r/artificial, le 10 septembre, exprimait ces deux réactions : l’intérêt de voir les agents devenir une infrastructure et des questions sur les limites du sandbox. C’est un meilleur point de départ que de se demander si un nouveau framework est à la mode. La question concrète est de savoir quelles responsabilités vous voulez déléguer. [8]
Une session persistante conserve-t-elle tous les fichiers de l’agent ?
Une session persistante conserve la conversation et le travail enregistré de l’agent, mais l’environnement d’exécution a sa propre durée de vie. OpenAI sépare dans son architecture l’application, le harness hébergé et l’environnement. Les considérer comme un seul ordinateur permanent serait une erreur. [2] [3]
L’environnement est l’endroit où les outils exécutent du code et accèdent à un espace de travail. OpenAI peut l’héberger, ou le développeur peut le fournir. L’agent peut aussi fonctionner sans cet environnement : l’option documentée none n’inclut ni Bash, ni l’outil apply-patch, ni système de fichiers de travail, mais permet des outils MCP distants via HTTP. MCP est le protocole qui relie l’agent à des outils externes. [2]
La documentation des sessions demande de réutiliser l’identifiant de session pour poursuivre le travail. Elle distingue aussi les éléments enregistrés des événements en direct : un flux déconnecté ne rejoue pas tous les événements manqués. L’application doit donc récupérer les éléments enregistrés à la reconnexion. Ce détail technique a une conséquence directe pour le produit. L’interface doit retrouver l’état réel de la tâche, sans interpréter le silence comme une absence d’activité. [3]
Pour les fichiers, je définirais explicitement la livraison : ce que l’agent doit produire, où l’application le copiera et quel résultat signifie que la tâche est terminée. Cette exigence relève de la conception du produit même si le fournisseur gère la session. Une conversation réussie n’est pas encore un livrable transmis de façon fiable.
Les sous-agents parallèles ont-ils des permissions distinctes ?
Les sous-agents documentés partagent le système de fichiers et l’environnement du coordinateur et héritent des accès configurés aux outils. Je les considérerais comme des travailleurs dans un même périmètre de sécurité. OpenAI précise également une limite de la bêta : les sous-agents ne prennent pas en charge les outils de fonction. [4]
La distinction compte pour concevoir l’application. Un outil de fonction expose une fonctionnalité propre à votre application ; les outils MCP distants sont une autre voie d’intégration. Si une tâche dépend d’une fonction maison, ne supposez pas que la délégation donne au sous-agent les mêmes capacités qu’au coordinateur. Vérifiez le chemin d’accès aux outils avant de lui confier la totalité du résultat.
Je commencerais par des tâches indépendantes et des résultats bien définis, comme l’examen de modules différents, puis laisserais l’intégration finale au coordinateur. Partager des fichiers facilite la coopération, mais rend aussi possibles des modifications qui se chevauchent. Le parallélisme est utile lorsque les résultats s’assemblent sans devoir annuler le travail des autres.
Il modifie aussi les coûts. OpenAI avertit que l’ajout de sous-agents peut augmenter le nombre de tokens utilisés. Une exécution plus courte peut représenter davantage de travail au total. Il faut donc mesurer séparément le temps écoulé et le coût. [4]
Quelles décisions de sécurité et de données restent à votre charge ?
Les permissions de l’environnement comptent toujours, puisque le code exécuté par l’agent peut atteindre les fichiers, identifiants et ressources réseau qui y sont disponibles. Le guide de sécurité d’OpenAI recommande de restreindre les connexions sortantes et de conserver la clé API de l’application hors de l’environnement d’exécution. Héberger la boucle ne détermine pas quels systèmes métier l’agent peut modifier. [5]
Pour un assistant de revue de code, je commencerais par l’accès au dépôt et un endroit où transmettre les constats. Autoriser un déploiement ou une modification de dossiers clients demanderait une autre décision de produit. La limite importante est l’action permise par votre application, pas la prudence que l’agent affiche dans sa réponse.
Un service avec état peut convenir à un utilisateur qui revient ou à une tâche continue. L’application doit alors définir volontairement le cycle de vie de cet état. Je déciderais quand conserver ou supprimer les sessions au moment de concevoir la fonction, avant de les laisser s’accumuler indéfiniment.
Combien coûte l’Agents API ?
OpenAI indique que l’Agents API n’ajoute pas de frais propres : les développeurs paient les tokens et les outils utilisés. Le budget pertinent couvre donc la tâche entière, y compris les appels répétés au modèle et le travail délégué. Un agent qui continue à travailler pendant des heures ne devient pas gratuit pour autant. [1]
La page des tarifs distingue les frais liés aux tokens du modèle de ceux liés aux outils. Les conteneurs d’exécution hébergés sont facturés selon les ressources et le temps, et des outils comme la recherche web peuvent ajouter des frais par appel. Une estimation doit inclure l’environnement choisi, pas seulement les tokens de sortie. [10]
La documentation d’observabilité précise une limite des compteurs visibles dans l’application. L’utilisation par session et par tour peut être incomplète ou évoluer. OpenAI dit explicitement que ces chiffres ne constituent pas une facture définitive. Ils servent à comprendre une exécution, tandis que les dépenses réelles doivent être rapprochées des données de facturation. [7]
Ma première évaluation serait une petite charge répétable avec une condition de réussite claire. Je noterais si le résultat passe la revue, quelles actions externes ont eu lieu et combien a coûté la tâche terminée. Je comparerais ensuite avec l’application existante, en incluant son entretien.
L’Agents API mérite d’être examinée lorsque l’exploitation de l’infrastructure de l’agent pèse sur le produit. La première question est concrète : quelles responsabilités de boucle, d’état et d’exécution OpenAI peut-il reprendre sans retirer à votre application un contrôle dont elle a besoin ?