OpenAI Agents API vs Responses API vs Agents SDK vs AgentKit : quelle solution choisir

Ces quatre noms se situent à différentes couches, et une question les sépare : qui exécute la boucle de l'agent ? L'API Responses est l'appel de modèle, et votre code exécute la boucle autour d'elle. Le SDK Agents est une bibliothèque TypeScript et Python dont l'exécuteur exécute la boucle au sein de votre application. L'API Agents, en bêta publique depuis le 10 septembre 2026, exécute le harnais Codex d'OpenAI pour vous et maintient la session et, éventuellement, le bac à sable. AgentKit est le bundle d'octobre 2025 composé d'Agent Builder, ChatKit, Connector Registry et Evals, et Agent Builder est programmé pour être arrêté le 30 novembre 2026.

Le DevDay du 29 septembre a ajouté l'utilisation de l'ordinateur à l'API Agents (voir le récapitulatif du DevDay 2026), ce qui a rendu la question de la nomenclature plus difficile à ignorer. Ci-dessous : une comparaison côte à côte sur la boucle, le calcul, l'état, le prix et la maturité, un tableau de décision et un chemin de migration depuis une boucle Responses personnalisée. Pour un aperçu pratique des sessions et des approbations, lisez le guide de l'API OpenAI Agents. Quel que soit votre choix, l'interface HTTP est testable dans Apidog.

Options d'agents OpenAI côte à côte

Sources : la comparaison des environnements d'exécution d'agents d'OpenAI, l'aperçu de l'API Agents, et la page des dépréciations.

Qui exécute la boucle

C'est l'axe qui détermine la plupart des autres lignes.

API Responses : c'est vous qui l'exécutez. Les outils hébergés tels que la recherche web, la recherche de fichiers, l'interpréteur de code et le MCP distant peuvent exécuter plusieurs appels au sein d'une seule requête, mais vos propres fonctions vous reviennent. Lorsque le modèle en appelle une, vous recevez un élément function_call, l'exécutez, et envoyez une function_call_output avec le même call_id dans la requête suivante. Vous décidez quand arrêter, comment stocker l'historique (les réponses sont stockées par défaut ; store: false désactive cela), et quand compacter les contextes longs avec context_management et compact_threshold. Le guide de l'API Responses et le guide d'appel de fonction couvrent cette boucle.

SDK Agents : votre processus l'exécute. La documentation d'OpenAI indique que l'exécuteur du SDK « gère la boucle de l'agent et les transferts », tandis que votre serveur possède le déploiement, les implémentations d'outils, le stockage de l'état et les décisions d'approbation. Avec les Agents Sandbox, le harnais peut rester dans votre infrastructure tandis que les commandes s'exécutent dans un espace de travail local Unix, Docker ou fourni par un hôte, de sorte que l'authentification, les journaux d'audit et la révision humaine restent en dehors du conteneur.

API Agents : OpenAI l'exécute. Le harnais géré gère les sessions, l'orchestration, la compaction de contexte et la récupération, et il ajoute des sous-agents, la recherche d'outils et l'appel d'outils programmatique. Les serveurs MCP distants sont appelés directement par OpenAI. Votre code gère toujours les outils de fonction : lorsque la session signale un function_call dans required_actions, vous renvoyez un événement agent.session.input.tool_result avec le turn_id et le call_id.

La même tâche, des deux manières :

# API Responses : un appel de modèle ; votre code gère la boucle
curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "reasoning": {"effort": "low"},
    "tools": [{"type": "web_search"}],
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

# API Agents : une session durable ; OpenAI gère la boucle
curl https://api.openai.com/v1/agents/sessions \
  -H "OpenAI-Beta: agents=v1" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {"model": "gpt-6-astra", "tools": [{"type": "web_search"}]},
    "environment": {"type": "none"},
    "input": "Summarize the breaking changes in the latest Node.js release."
  }'

Les exemples de la documentation de l'API Agents utilisent gpt-6-astra ; ils ne précisent pas si d'autres modèles sont acceptés, alors vérifiez avant d'utiliser gpt-6.1-sol.

Calcul, état et coût

Calcul. L'API Agents peut provisionner et gérer un bac à sable pour toute la session : définissez environment.type sur openai_hosted, self_hosted ou none. Avec le SDK, vous choisissez et payez le fournisseur de bac à sable. Avec les Réponses, le code s'exécute là où vous l'exécutez, à l'exception des outils hébergés.

État. Une session de l'API Agents conserve la configuration, les tours et les éléments du côté d'OpenAI, donc un suivi est un événement unique sur le même ID de session. Avec les Réponses, vous chaînez previous_response_id ou utilisez les Conversations. Avec le SDK, l'état réside dans votre stockage ou les sessions SDK.

Coût. Les prix des jetons sont identiques partout, car chaque option appelle les mêmes modèles. L'API Agents ne facture « aucun frais supplémentaire », mais les conteneurs hébergés coûtent entre 0,03 $ (1 Go) et 0,48 $ (16 Go) par session de 20 minutes. Le coût supplémentaire du SDK est votre propre hébergement. AgentKit n'a pas d'abonnement séparé, selon notre explicatif AgentKit.

Données. L'API Agents prend en charge uniquement la résidence des données aux États-Unis et ne prend pas en charge la Rétention Nulle de Données (ZDR), même avec un bac à sable auto-hébergé. La page de contrôle des données d'OpenAI liste `/v1/agents` comme non éligible à la ZDR, avec un état conservé jusqu'à suppression, tandis que `/v1/responses` est éligible à la ZDR avec des limitations et disponible sur des points d'accès régionaux tels que `eu.api.openai.com`. Si la ZDR ou la résidence dans l'UE est une exigence, cela exclut l'API Agents aujourd'hui.

AgentKit fin 2026 : ce qui reste

AgentKit a été lancé le 6 octobre 2025 en quatre parties. Voici l'état de chacune :

• Agent Builder : dépréciation annoncée le 3 juin 2026 ; arrêt programmé le 30 novembre 2026. Le guide de migration d'OpenAI exporte un workflow sous forme de code SDK Agents, ou le recrée en tant qu'Agent ChatGPT Workspace sur Business, Enterprise ou Edu.
• Evals : les évaluations existantes deviennent en lecture seule le 31 octobre 2026, et le tableau de bord ainsi que l'API sont programmés pour être arrêtés le 30 novembre.
• ChatKit : reste disponible pour le chat intégré.
• Connector Registry : le panneau d'administration pour les connecteurs et les serveurs MCP à travers les produits OpenAI.

Comme l'guide AgentKit l'indique, la voie durable et « code-first » via AgentKit est le SDK Agents.

Sur lequel construire

Sur AWS, les Agents gérés Bedrock, propulsés par OpenAI, apportent les capacités principales de l'API Agents pour s'exécuter nativement dans AWS. Pour le câblage MCP dans l'une ou l'autre des approches « code-first », consultez les serveurs MCP avec les agents OpenAI.

Passer de votre propre boucle Responses à l'API Agents

Si vous avez construit une boucle sur Responses et que vous souhaitez qu'OpenAI l'exécute :

1. Mappez les éléments. Les instructions, le modèle et les outils se déplacent dans agent ; votre conteneur devient environment ; votre magasin de conversations devient un ID de session.
2. Déplacez les serveurs MCP distants dans agent.tools. Placez leurs jetons dans un coffre-fort attaché avec vault_ids, et non dans les prompts.
3. Réécrivez la gestion des fonctions. Remplacez votre boucle function_call_output par un gestionnaire pour agent.session.requires_action (flux) ou agent.session.action_required (webhook) qui renvoie agent.session.input.tool_result. Les sous-agents ne peuvent pas appeler d'outils de fonction, donc gardez-les sur l'agent principal.
4. Supprimez votre code de compaction. Le harnais compacte le contexte automatiquement.
5. Passez aux événements. Diffusez les résultats des tours (agent.session.turn.completed, agent.session.turn.failed, agent.session.turn.cancelled) ou utilisez des webhooks. Une session inactive ne signifie pas le succès.
6. Vérifiez les contraintes. Résidence aux États-Unis uniquement, pas de ZDR, et un en-tête bêta.

Gardez les deux dans un seul projet Apidog

Avant de changer, exécutez l'ancien et le nouveau côte à côte. Dans un projet Apidog, créez un dossier `Responses` et un dossier `Agents API` qui partagent un environnement avec `{{OPENAI_API_KEY}}` et une variable de modèle. Envoyez les mêmes prompts à travers les deux, affirmez les codes d'état et les champs de sortie requis, et ouvrez le flux de l'API Agents en tant que requête SSE pour surveiller les événements de tour. Enregistrez les exécutions comme un scénario de test et exécutez-le en CI avec l'Apidog CLI, afin qu'un changement bêta apparaisse comme une vérification échouée. Le guide de fiabilité des agents IA en production couvre ce qu'il faut affirmer. Téléchargez Apidog pour le configurer.

FAQ

L'API Agents remplace-t-elle l'API Responses ? Aucune dépréciation n'a été annoncée. L'aperçu des agents d'OpenAI liste l'API Agents, le SDK Agents et l'API Responses comme options actuelles pour différents besoins.

OpenAI AgentKit est-il déprécié ? Partiellement. Agent Builder et Evals sont programmés pour être arrêtés le 30 novembre 2026 ; ChatKit reste disponible.

Le SDK Agents utilise-t-il l'API Agents ? Non. Le SDK s'exécute dans votre application ; l'API Agents exécute un harnais géré dans le service d'OpenAI.

Qu'est-il arrivé à l'API Assistants ? La page des dépréciations d'OpenAI a fixé sa suppression au 26 août 2026 et oriente les développeurs vers les API Responses et Conversations.

Quelle option est la moins chère ? Les prix des jetons sont identiques pour toutes. La différence réside dans les conteneurs hébergés sur l'API Agents par rapport à votre propre hébergement avec le SDK ou les Réponses.

Choisissez une voie cette semaine

Choisissez en fonction de qui doit exécuter la boucle, puis prouvez-le avec des requêtes avant d'écrire une application. Si vous débutez, essayez une session de l'API Agents et comparez sa sortie avec votre configuration Responses actuelle dans Apidog.