OpenAI Agents SDK : le framework d'agents officiel d'OpenAI

Un SDK volontairement minimaliste

L’OpenAI Agents SDK est publié par OpenAI depuis mars 2025, en Python puis en TypeScript, sous licence MIT. La documentation le présente comme l’aboutissement de Swarm, un ancien projet expérimental. Son idée : offrir juste assez de briques pour construire un agent IA sérieux, sans imposer une architecture lourde.

Trois notions forment le cœur du SDK :

• l’agent : un grand modèle de langage avec des instructions et des outils (fonctions qu’il peut déclencher grâce à l’appel d’outils) ;
• le transfert (handoff) : un agent passe la main à un autre, plus spécialisé, ce qui permet de bâtir un système multi-agents ;
• les garde-fous : des vérifications sur ce qui entre et ce qui sort, pour bloquer une demande hors sujet ou une réponse non conforme.

Autour, le SDK ajoute des sessions (mémoire de la conversation), une validation humaine avant certaines actions, un traçage intégré pour voir chaque étape, la connexion à des serveurs MCP, des agents vocaux et des « sandbox agents » qui travaillent dans un conteneur sur des tâches longues.

Concrètement, à quoi ça sert ?

Exemples typiques : un service client où un agent d’accueil oriente vers un agent « facturation » ou « technique » ; un assistant interne qui interroge une base de données puis rédige une synthèse ; un agent vocal qui répond au téléphone. Le SDK gère la boucle de l’agent (appeler le modèle, exécuter l’outil, relancer) ; vous écrivez la logique métier.

Comment démarrer

Il faut Python 3.10 ou plus récent. On installe le paquet openai-agents avec pip, on définit sa clé API dans une variable d’environnement, puis on crée un agent en quelques lignes et on le lance avec le « Runner » du SDK. La documentation officielle propose des exemples prêts à adapter, y compris pour la version TypeScript.

Forces et limites

Forces : peu de concepts à retenir, documentation claire, traçage inclus, licence permissive, compatibilité avec d’autres fournisseurs de modèles.

Limites : le SDK reste pensé d’abord pour l’écosystème OpenAI, et certaines fonctions (temps réel, outils hébergés) n’existent qu’avec ses modèles. Il n’offre pas de graphe d’états aussi détaillé que d’autres frameworks, ni d’hébergement clé en main : vous déployez vous-même. Enfin, chaque appel de modèle a un coût ; le calculateur de coût d’un agent aide à l’estimer.

Alternatives

Pour un contrôle fin du déroulé, LangGraph est plus adapté. Google ADK couvre davantage de langages, Pydantic AI mise sur le typage strict, et le Claude Agent SDK fournit un agent déjà équipé d’outils. La liste des frameworks d’agents permet de comparer.