Qu’est-ce que OpenAI Agents SDK ?
Le OpenAI Agents SDK est la bibliothèque Python open source d'OpenAI pour les agents et les workflows multi-agents. Ses primitives sont les agents (un modèle avec des instructions, des outils, des garde-fous et des handoffs), les handoffs et les agents-comme-outils pour la délégation, les garde-fous sur l'entrée, la sortie et les appels d'outils, les sessions pour l'historique de conversation, les approbations human-in-the-loop et le traçage intégré.
Depuis une mise à jour d'avril 2026, il a aussi des agents en bac à sable, qui travaillent dans un espace de travail avec des fichiers, des commandes shell et des patchs sur de longues tâches. Cet espace de travail peut être la machine locale, Docker, ou un fournisseur hébergé : E2B, Modal, Daytona, Cloudflare, Vercel et Blaxel ont tous des clients. Les agents vocaux en temps réel et un pipeline de parole le complètent, et une version TypeScript vit dans un dépôt séparé.
Il appelle les API Responses ou Chat Completions d'OpenAI par défaut et atteint d'autres fournisseurs via des adaptateurs LiteLLM ou any-llm. Il a besoin de Python 3.10+ ; la version 0.24.0 est sortie le 15 octobre 2026 et le projet est encore pré-1.0.
OpenAI Agents SDK vaut-il le coup ?
Le Agents SDK est la route la plus courte d'une clé d'API OpenAI à un système multi-agents fonctionnel, et ses réglages par défaut sont la partie à lire avant de livrer. Le traçage est activé d'emblée et exporte chaque appel de modèle, appel d'outil, handoff et garde-fou vers le tableau de bord Traces d'OpenAI. Vous le désactivez avec OPENAI_AGENTS_DISABLE_TRACING=1 ou par exécution, et il n'est pas disponible pour les organisations sous Zero Data Retention : utile en développement, une question de flux de données dans une revue de sécurité.
Le cœur est petit. Un Agent plus Runner.run_sync est un programme fonctionnel ; les handoffs et les agents-comme-outils couvrent la plupart des patterns de délégation, et les garde-fous peuvent bloquer une requête avant que l'agent ne démarre ou vérifier les entrées individuelles des outils. Le dépôt a environ 30 200 étoiles et a livré huit versions entre le 16 août et le 15 octobre 2026, de 0.21.1 à 0.24.0, alors attendez-vous à du turnover tant qu'il reste sous 1.0.
Les agents en bac à sable le poussent vers un harnais de production, et la documentation est franche sur leurs limites. Le UnixLocalSandboxClient par défaut lance les commandes comme des processus hôte ordinaires : sur Linux, il n'ajoute aucun confinement au niveau de l'OS, sur macOS sandbox-exec restreint les fichiers mais pas le réseau, et chaque commande hérite de tout l'environnement de l'hôte, clés d'API comprises, sauf si vous réglez inherit_host_environment=False. L'entrée non fiable a sa place dans le client Docker, où network_mode="none" coupe le réseau, ou avec un fournisseur hébergé.
La neutralité des fournisseurs est réelle mais de second rang. Les adaptateurs atteignent d'autres modèles, pourtant les outils hébergés et le tableau de bord de traçage sont des services OpenAI, et les nouvelles primitives arrivent réglées pour les modèles OpenAI comme gpt-realtime-2.1. Pydantic AI et LangGraph font moins d'hypothèses sur le fournisseur, et LangGraph donne un flux de contrôle de graphe explicite que ce SDK laisse aux handoffs et au Python simple. Les contributeurs externes ne peuvent pas du tout envoyer de pull requests ; le dépôt ne les accepte que de collaborateurs.
Là où il fait la différence
Un ingénieur backend dans une start-up fintech déjà sur l'API OpenAI
Router les chats de support entre un agent de triage et des spécialistes de la facturation et des remboursements
Définissez trois agents avec des handoffs et un garde-fou d'entrée qui rejette les requêtes hors sujet avant le début de l'exécution ; les traces montrent chaque passage de relais. Le SDK est gratuit sous MIT, si bien que la facture est les tokens, et chaque passage ajoute des appels de modèle. Désactivez le traçage ou vérifiez l'accord de données avant que des données clients n'y transitent.
Une équipe plateforme qui construit un bot de revue de code interne
Laisser un agent cloner un dépôt, lancer les tests et proposer un patch
Un SandboxAgent avec une entrée de manifeste GitRepo et le DockerSandboxClient (openai-agents[docker]) garde les commandes dans un conteneur ; network_mode="none" isole le code non fiable. Passer à E2B, Modal ou Daytona plus tard change la config d'exécution, pas la définition de l'agent.
Un chef de produit dans une entreprise SaaS de 50 personnes qui cadre un assistant vocal
Prototyper un agent de support parlé sans assembler des services de parole
RealtimeAgent tourne via WebSocket avec gpt-realtime-2.1, ou VoicePipeline enchaîne la parole-vers-texte, l'agent et le texte-vers-parole. Le prototype réutilise les mêmes outils et garde-fous que les agents texte, mais les tokens audio deviennent le coût principal et la conception est liée aux modèles en temps réel d'OpenAI.
Avant de vous engager
- Mise en route
- `pip install openai-agents` (ou `uv add openai-agents`) sur Python 3.10+, définissez OPENAI_API_KEY, et le premier agent du README tourne en quelques minutes. Extras : [voice], [redis] pour les sessions, [docker] pour les bacs à sable en conteneur.
- Intégrations
- OpenAI Responses et Chat Completions par défaut ; d'autres modèles via LiteLLM ou any-llm ; outils de fonction, serveurs MCP et outils hébergés ; clients de bac à sable pour E2B, Modal, Daytona, Cloudflare, Vercel et Blaxel ; processeurs de traces personnalisés pour envoyer les traces ailleurs.
- Données et confidentialité
- Le traçage est activé par défaut et exporte les données d'exécution vers OpenAI ; il n'est pas disponible sous Zero Data Retention et peut être désactivé globalement ou par exécution. Le bac à sable Unix-local passe tout l'environnement de l'hôte aux commandes par défaut et ne donne aucun confinement sur Linux. Licence MIT.
- Coût à grande échelle
- Le SDK est gratuit ; le coût de production est les tokens de modèle et les appels d'outils hébergés aux prix d'API d'OpenAI, plus le calcul d'un fournisseur de bac à sable si vous en utilisez un. Les conceptions multi-agents multiplient les appels par requête utilisateur, si bien que la dépense croît avec le nombre d'agents qu'une requête traverse.
- Limites
- Pré-1.0 avec des versions fréquentes ; les fonctions de bac à sable ont été lancées en Python d'abord ; pas de flux de contrôle de style graphe ; contributions limitées aux collaborateurs.
Les points forts
- Un Agent et un Runner font un programme fonctionnel
- Handoffs, garde-fous et approbations intégrés
- Clients de bac à sable pour Docker, E2B, Modal, Daytona et plus
- Traçage activé par défaut, avec des processeurs personnalisés pour d'autres backends
Les points faibles
- Pré-1.0, avec huit versions en deux mois
- Le traçage envoie les données d'exécution à OpenAI sauf désactivation
- Le bac à sable local hérite de l'environnement de l'hôte et n'a pas de confinement Linux
- Pull requests uniquement de collaborateurs
Idéal pour
Les développeurs qui construisent des agents principalement sur des modèles OpenAI et veulent un SDK minimal et bien documenté.
Alternatives à OpenAI Agents SDK
OpenAI Agents SDK : questions fréquentes
- OpenAI Agents SDK vaut-il le coup ?
- Un petit SDK d'agents lisible dont les réglages par défaut supposent discrètement OpenAI : le traçage envoie vos exécutions à son tableau de bord, et le bac à sable local fait confiance à votre machine. Nous lui donnons 4.4 sur 5.
- Combien coûte OpenAI Agents SDK ?
- Gratuit et open source sous la licence MIT. Vous payez l'usage de modèle.
- Quels sont les inconvénients de OpenAI Agents SDK ?
- Pré-1.0, avec huit versions en deux mois; le traçage envoie les données d'exécution à OpenAI sauf désactivation; le bac à sable local hérite de l'environnement de l'hôte et n'a pas de confinement Linux; pull requests uniquement de collaborateurs.
- À qui s’adresse OpenAI Agents SDK ?
- Les développeurs qui construisent des agents principalement sur des modèles OpenAI et veulent un SDK minimal et bien documenté.
- Combien coûte OpenAI Agents SDK pour une équipe ou en production ?
- Le SDK est gratuit ; le coût de production est les tokens de modèle et les appels d'outils hébergés aux prix d'API d'OpenAI, plus le calcul d'un fournisseur de bac à sable si vous en utilisez un. Les conceptions multi-agents multiplient les appels par requête utilisateur, si bien que la dépense croît avec le nombre d'agents qu'une requête traverse.
- OpenAI Agents SDK est-il sûr pour les données de l’entreprise ?
- Le traçage est activé par défaut et exporte les données d'exécution vers OpenAI ; il n'est pas disponible sous Zero Data Retention et peut être désactivé globalement ou par exécution. Le bac à sable Unix-local passe tout l'environnement de l'hôte aux commandes par défaut et ne donne aucun confinement sur Linux. Licence MIT.
- Quelles sont les meilleures alternatives à OpenAI Agents SDK ?
- Les alternatives les plus proches que nous avons testées sont Pydantic AI, LangGraph, Google Agent Development Kit (ADK) et Microsoft Agent Framework.
Réponses vérifiées le 23 oct. 2026.