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

Ces quatre options se situent à des couches différentes. Le critère décisif est simple : qui exécute la boucle de l’agent ? L’API Responses appelle le modèle et votre code pilote l’orchestration. Le SDK Agents fournit un exécuteur TypeScript ou Python dans votre application. L’API Agents, en bêta publique depuis le 10 septembre 2026, exécute le harnais Codex d’OpenAI, gère les sessions et peut gérer le bac à sable. AgentKit est le bundle lancé en octobre 2025 ; Agent Builder doit être arrêté le 30 novembre 2026.

Essayez Apidog dès aujourd’hui

Le DevDay du 29 septembre a ajouté l’utilisation de l’ordinateur à l’API Agents (voir le récapitulatif du DevDay 2026). Ce guide compare les options selon la boucle, le calcul, l’état, le coût et la maturité, puis propose une stratégie de migration depuis une boucle Responses personnalisée. Pour les sessions et les approbations, consultez le guide de l’API OpenAI Agents. Vous pouvez tester toutes les requêtes HTTP dans Apidog.

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

	API Agents	API Responses	SDK Agents	AgentKit
Ce que c’est	Environnement d’exécution d’agent géré sur le harnais Codex	Point d’accès modèle : POST /v1/responses	Bibliothèque TypeScript et Python	Bundle : Agent Builder, ChatKit, Connector Registry, Evals
Qui exécute la boucle	OpenAI	Votre code	L’exécuteur SDK dans votre application	Workflows Agent Builder, exportables vers le SDK ou intégrables avec ChatKit
Où s’exécute le calcul	Bac à sable OpenAI, auto-hébergé ou aucun	Votre environnement, plus outils hébergés	Votre runtime et vos fournisseurs de bac à sable	Non applicable
Où réside l’état	Session OpenAI : configuration, tours, éléments	Historique applicatif, previous_response_id ou Conversations	Votre stockage, sessions SDK ou état Responses	Workflows publiés et versionnés
Ce que vous payez	Jetons, outils et conteneurs hébergés ; sans frais de plateforme supplémentaires	Jetons et outils	Jetons, outils et hébergement propre	API sous-jacente ; pas d’abonnement séparé
Effort d’intégration	Faible	Élevé	Moyen	Non évalué
Statut	Bêta publique : OpenAI-Beta: agents=v1	Recommandée pour les nouveaux projets	Actuel	Agent Builder et Evals ferment le 30 nov. 2026 ; ChatKit reste
Contrôles des données	Résidence US uniquement, pas de ZDR, état conservé jusqu’à suppression	Éligible ZDR avec limitations ; endpoints régionaux	Dépend des API utilisées	Non applicable

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

Qui exécute la boucle ?

Ce choix détermine votre responsabilité sur les outils, l’état, les reprises et l’infrastructure.

API Responses : votre code pilote l’orchestration

Les outils hébergés — recherche web, recherche de fichiers, interpréteur de code et MCP distant — peuvent effectuer plusieurs opérations dans une requête. En revanche, vos fonctions applicatives restent sous votre responsabilité.

Lorsqu’un modèle retourne un élément function_call :

1. Exécutez la fonction dans votre application.
2. Récupérez son résultat.
3. Envoyez un function_call_output avec le même call_id.
4. Répétez jusqu’à obtenir une réponse finale ou atteindre votre limite d’itérations.

Vous contrôlez aussi :

• l’arrêt de la boucle ;
• le stockage de l’historique ;
• l’utilisation de previous_response_id ;
• la désactivation du stockage avec store: false ;
• la compaction avec context_management et compact_threshold.

Consultez le guide de l’API Responses et le guide d’appel de fonction pour implémenter cette boucle.

SDK Agents : l’exécuteur tourne dans votre processus

Le SDK gère la boucle et les transferts d’agents, mais votre application conserve le contrôle sur :

• le déploiement ;
• les implémentations d’outils ;
• le stockage d’état ;
• les approbations ;
• l’observabilité et les journaux d’audit.

Avec Agents Sandbox, le harnais peut rester dans votre infrastructure tandis que les commandes s’exécutent dans un espace de travail Unix local, Docker ou fourni par un hôte. Vous gardez donc l’authentification, la revue humaine et l’audit en dehors du conteneur.

API Agents : OpenAI pilote le harnais

L’API Agents gère les sessions, l’orchestration, la compaction de contexte et la récupération. Elle ajoute aussi les sous-agents, la recherche d’outils et l’appel d’outils programmatique.

Les serveurs MCP distants sont appelés directement par OpenAI. Vos outils de fonction nécessitent toutefois toujours une réponse de votre application :

1. La session retourne un function_call dans required_actions.
2. Votre backend exécute la fonction.
3. Il renvoie agent.session.input.tool_result avec le turn_id et le call_id.

Voici la même tâche avec les deux API :

# API Responses : votre code gère la boucle autour de l'appel modèle
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 : OpenAI gère la boucle dans une session durable
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 : vérifiez la compatibilité avant d’utiliser gpt-6.1-sol.

Calcul, état et coût

Calcul

L’API Agents peut provisionner un bac à sable pour toute la durée d’une session. Configurez environment.type avec l’une de ces valeurs :

{
  "environment": {
    "type": "openai_hosted"
  }
}

Valeurs possibles :

• openai_hosted : bac à sable hébergé par OpenAI ;
• self_hosted : votre propre bac à sable ;
• none : aucun environnement d’exécution.

Avec le SDK Agents, vous choisissez et financez votre fournisseur de bac à sable. Avec l’API Responses, votre code s’exécute dans votre infrastructure, hors outils hébergés.

État

Avec l’API Agents, une session conserve côté OpenAI :

• la configuration ;
• les tours ;
• les éléments de conversation.

Un suivi devient donc un nouvel événement sur le même identifiant de session.

Avec l’API Responses, utilisez l’une de ces stratégies :

• chaîner les appels avec previous_response_id ;
• gérer votre propre historique ;
• utiliser l’API Conversations.

Avec le SDK Agents, l’état réside dans votre stockage ou dans les mécanismes de session du SDK.

Coût

Les prix des jetons restent identiques, puisque les options appellent les mêmes modèles.

Les différences proviennent de l’infrastructure :

• API Agents : pas de frais supplémentaires annoncés, mais les conteneurs hébergés coûtent entre 0,03 $ pour 1 Go et 0,48 $ pour 16 Go par session de 20 minutes ;
• SDK Agents : vous financez votre hébergement et votre bac à sable ;
• API Responses : vous financez votre infrastructure applicative ;
• AgentKit : pas d’abonnement séparé selon cet explicatif AgentKit.

Données

L’API Agents prend uniquement en charge la résidence des données aux États-Unis et ne prend pas en charge la Rétention Nulle de Données (ZDR), y compris avec un bac à sable auto-hébergé.

La page de contrôle des données d’OpenAI indique que :

• /v1/agents n’est pas éligible à la ZDR ;
• l’état est conservé jusqu’à suppression ;
• /v1/responses est éligible à la ZDR avec certaines limitations ;
• Responses est disponible sur des endpoints régionaux, notamment eu.api.openai.com.

Si vous exigez la ZDR ou une résidence des données dans l’UE, l’API Agents est exclue à ce jour.

AgentKit fin 2026 : ce qui reste

AgentKit a été lancé le 6 octobre 2025 avec quatre composants.

• Agent Builder : dépréciation annoncée le 3 juin 2026, arrêt prévu le 30 novembre 2026. Utilisez le guide de migration pour exporter un workflow en code SDK Agents ou le recréer comme Agent ChatGPT Workspace sur Business, Enterprise ou Edu.
• Evals : les évaluations existantes deviennent en lecture seule le 31 octobre 2026. Le tableau de bord et l’API doivent fermer le 30 novembre 2026.
• ChatKit : reste disponible pour intégrer une interface de chat.
• Connector Registry : panneau d’administration des connecteurs et serveurs MCP dans les produits OpenAI.

La voie durable et orientée code d’AgentKit est le SDK Agents, comme l’explique le guide AgentKit.

Quelle option choisir ?

Choisissez	Quand l’utiliser
API Agents	Vos tâches durent plusieurs minutes, ont besoin de fichiers, de commandes ou d’un navigateur, et vous ne voulez pas gérer la boucle, les bacs à sable ou le stockage de session. Vous acceptez la résidence US et un en-tête bêta.
API Responses	Vous effectuez des appels simples, voulez contrôler chaque tour, avez besoin de ZDR ou d’une résidence hors États-Unis, ou possédez déjà une boucle fonctionnelle.
SDK Agents	Vous voulez une application typée qui contrôle les outils, le stockage, les approbations et les transferts dans votre infrastructure.
ChatKit	Vous devez intégrer une interface de chat dans votre produit.
Agent Builder	Ne démarrez pas un nouveau projet ici. Exportez les workflows existants avant le 30 novembre 2026.

Sur AWS, les Agents gérés Bedrock propulsés par OpenAI apportent les capacités principales de l’API Agents dans AWS. Pour connecter MCP à une approche orientée code, consultez le guide sur les serveurs MCP avec les agents OpenAI.

Migrer d’une boucle Responses vers l’API Agents

Si vous avez déjà une boucle Responses et souhaitez déléguer son exécution à OpenAI, procédez par étapes.

1. Mapper les éléments de configuration

Déplacez :

Dans Responses	Dans Agents
Instructions, modèle, outils	agent
Conteneur ou environnement d’exécution	environment
Magasin de conversation	ID de session

2. Déplacer les serveurs MCP distants

Ajoutez les serveurs MCP distants dans agent.tools.

Ne placez pas les jetons d’accès dans les prompts. Attachez-les plutôt depuis un coffre-fort avec vault_ids.

3. Réécrire la gestion des outils de fonction

Votre boucle Responses traite généralement ce cycle :

function_call -> exécution applicative -> function_call_output

Avec l’API Agents, remplacez-la par un gestionnaire qui :

1. traite agent.session.requires_action en streaming, ou agent.session.action_required avec webhook ;
2. exécute l’outil ;
3. renvoie agent.session.input.tool_result.

Les sous-agents ne peuvent pas appeler des outils de fonction. Gardez ces outils sur l’agent principal.

4. Retirer la compaction manuelle

Supprimez le code de compaction du contexte : le harnais de l’API Agents le gère automatiquement.

5. Suivre les événements de tour

Ne considérez pas une session inactive comme terminée avec succès. Traitez explicitement les événements :

agent.session.turn.completed
agent.session.turn.failed
agent.session.turn.cancelled

Vous pouvez les consommer en streaming ou via webhooks.

6. Vérifier les contraintes avant mise en production

Validez au minimum :

• résidence des données limitée aux États-Unis ;
• absence de ZDR ;
• obligation d’envoyer l’en-tête bêta OpenAI-Beta: agents=v1.

Tester Responses et Agents dans un projet Apidog

Avant de migrer, exécutez les deux implémentations côte à côte.

1. Créez un dossier Responses.
2. Créez un dossier Agents API.
3. Partagez un environnement contenant :
   • {{OPENAI_API_KEY}}
   • une variable de modèle.
4. Envoyez les mêmes prompts aux deux endpoints.
5. Vérifiez les codes HTTP et les champs de sortie attendus.
6. Ouvrez le flux de l’API Agents comme requête SSE pour observer les événements de tour.
7. Enregistrez les requêtes comme scénario de test.
8. Exécutez ce scénario en CI avec l’Apidog CLI.

Cette comparaison permet de détecter un changement de comportement bêta comme un test en échec. Le guide de fiabilité des agents IA en production détaille les assertions utiles. Téléchargez Apidog pour configurer ce flux.

FAQ

L’API Agents remplace-t-elle l’API Responses ?

Non. Aucune dépréciation n’a été annoncée. OpenAI présente l’API Agents, le SDK Agents et l’API Responses comme des options adaptées à des besoins différents.

OpenAI AgentKit est-il déprécié ?

Partiellement. Agent Builder et Evals doivent fermer 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 OpenAI.

Qu’est-il arrivé à l’API Assistants ?

La page des dépréciations d’OpenAI fixe 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 tarifs de jetons sont identiques. La différence dépend du coût des conteneurs hébergés de l’API Agents par rapport à votre propre hébergement avec le SDK ou l’API Responses.

Choisissez une voie cette semaine

Commencez par décider qui doit exécuter la boucle. Testez ensuite les requêtes avant de construire l’application complète.

Si vous démarrez, créez une session API Agents, puis comparez sa sortie avec votre configuration Responses actuelle dans Apidog.