# OpenAI Agents SDK Bibliothèque pour développeurs. Fiche relevée le 3 octobre 2026 sur les pages officielles. Page : https://quelleia.com/outils/openai-agents-sdk/ ## En bref L'OpenAI Agents SDK est une bibliothèque open source d'OpenAI pour programmer des agents, seuls ou à plusieurs, en Python ou en JavaScript/TypeScript. On décrit chaque agent avec ses instructions, ses outils et ses garde-fous, et un agent peut passer la main à un autre. La bibliothèque fonctionne avec les modèles d'OpenAI et avec d'autres fournisseurs. Elle s'adresse aux développeurs et ne s'utilise pas comme un assistant tout prêt. - Éditeur : OpenAI - Prix : gratuit, à l'usage - Licence : open source (MIT) - Systèmes : macOS, Linux, Windows - Formes : bibliothèque pour développeurs (SDK) - Site officiel : https://openai.com ## Installer ### Python, tous systèmes (Python 3.10+) ``` mkdir my_project ``` ``` cd my_project ``` ``` python -m venv .venv ``` ### Python, macOS ou Linux ``` source .venv/bin/activate ``` ``` pip install openai-agents ``` ``` export OPENAI_API_KEY=sk-... ``` ### Python, Windows ``` .venv\Scripts\activate ``` ``` pip install openai-agents ``` ``` $env:OPENAI_API_KEY = "sk-..." ``` La dernière commande vaut pour PowerShell ; dans l'invite de commandes, la documentation donne `set "OPENAI_API_KEY=sk-..."`. ### Python avec uv ``` uv init ``` ``` uv add openai-agents ``` ### JavaScript/TypeScript (Node.js 22+, Deno ou Bun) ``` mkdir my_project ``` ``` cd my_project ``` ``` npm init -y ``` ``` npm install @openai/agents zod ``` ``` export OPENAI_API_KEY=sk-... ``` Commandes tirées de https://openai.github.io/openai-agents-js/guides/quickstart/ ; Cloudflare Workers est pris en charge à titre expérimental. ### Démarrer Créer un `Agent` avec un nom et des instructions, puis le lancer avec `Runner.run_sync(agent, "…")` en Python ou `run(agent, "…")` en JavaScript. ### Choisir le modèle Sans réglage, l'agent utilise gpt-5.6-luna. On change de modèle par agent (paramètre `model`), pour toute une exécution (`RunConfig`) ou pour tous les agents avec la variable OPENAI_DEFAULT_MODEL. ``` export OPENAI_DEFAULT_MODEL=gpt-5.6-sol ``` Source : https://openai.github.io/openai-agents-python/quickstart/ (lue le 3 octobre 2026). ## Ce qu'il sait faire - **Passage de main entre agents** : Un agent délègue une tâche à un autre agent, ou l'appelle comme un outil. (https://openai.github.io/openai-agents-python/handoffs/) - **Outils et MCP** : L'agent appelle des fonctions Python ou JavaScript, des outils hébergés par OpenAI et des serveurs MCP, le protocole standard qui relie outils et sources de données à un agent. (https://openai.github.io/openai-agents-python/mcp/) - **Garde-fous** : Des contrôles configurables vérifient ce qui entre dans l'agent et ce qui en sort. (https://openai.github.io/openai-agents-python/guardrails/) - **Agents en bac à sable** : Un agent travaille dans un conteneur : il lit des fichiers, lance des commandes, applique des correctifs et garde son espace de travail sur de longues tâches. (https://openai.github.io/openai-agents-python/sandbox_agents/) - **Sessions** : La bibliothèque gère elle-même l'historique de conversation d'une exécution à l'autre. (https://openai.github.io/openai-agents-python/sessions/) - **Traçage** : Chaque exécution est enregistrée : on la relit pour déboguer ou optimiser l'agent. (https://openai.github.io/openai-agents-python/tracing/) - **Agents vocaux** : Des agents vocaux en temps réel avec gpt-realtime-2.1, ou des chaînes qui enchaînent reconnaissance vocale, agent et synthèse vocale. (https://openai.github.io/openai-agents-python/realtime/quickstart/) Les façons de l'utiliser : - Bibliothèque pour développeurs (SDK) : bibliothèque Python (openai-agents) (https://openai.github.io/openai-agents-python/) - Bibliothèque pour développeurs (SDK) : bibliothèque JavaScript/TypeScript (@openai/agents) (https://openai.github.io/openai-agents-js/) Systèmes : - macOS - Linux - Windows : en natif. Le bac à sable local UnixLocalSandboxClient ne marche que sur macOS et Linux : sous Windows, il faut passer par Docker ou par un bac à sable hébergé ## Sur téléphone Au 3 octobre 2026, l'éditeur ne documente ni application mobile ni pilotage depuis un téléphone. ## Prix et licence Bibliothèque gratuite (licence MIT). On paie les appels au modèle auprès du fournisseur choisi, par exemple l'API d'OpenAI avec une clé OPENAI_API_KEY. (relevé le 3 octobre 2026, https://openai.github.io/openai-agents-python/quickstart/) Licence : Open source, licence MIT. Les dépôts Python et JavaScript portent tous deux la licence MIT. (https://github.com/openai/openai-agents-python/blob/main/LICENSE) ## Modèles Modèles OpenAI par l'API Responses (conseillée) ou Chat Completions. Les autres fournisseurs passent par un point d'accès compatible OpenAI (adresse et clé à fournir), par un fournisseur de modèles personnalisé ou par les adaptateurs LiteLLM et Any-LLM (en bêta). La page des modèles ne cite aucun moteur local (Ollama, LM Studio). - Clé d'API personnelle : oui - Modèles locaux : non établi ## Sources - https://github.com/openai/openai-agents-python - https://github.com/openai/openai-agents-js - https://openai.github.io/openai-agents-python/quickstart/ - https://pypi.org/project/openai-agents/ - https://www.npmjs.com/package/@openai/agents - https://www.npmjs.com/package/zod - https://openai.github.io/openai-agents-python/models/ - https://openai.github.io/openai-agents-python/handoffs/ - https://openai.github.io/openai-agents-python/mcp/ - https://openai.github.io/openai-agents-python/guardrails/ - https://openai.github.io/openai-agents-python/sandbox_agents/ - https://openai.github.io/openai-agents-python/sessions/ - https://openai.github.io/openai-agents-python/tracing/ - https://openai.github.io/openai-agents-python/realtime/quickstart/ - https://github.com/openai/openai-agents-python/blob/main/LICENSE - https://openai.github.io/openai-agents-python/ - https://openai.github.io/openai-agents-js/ Non vérifié : - Aucune page consultée ne donne le pays d'OpenAI. - Le SDK n'a ni application mobile ni pilotage à distance qui lui soit propre, puisque c'est une bibliothèque.