Outils · bibliothèque pour développeurs

OpenAI Agents SDK

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.

En bref

Ce que c'est: 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 de OpenAI Agents SDKFiche relevée le 3 octobre 2026 sur les pages officielles.

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.

Paquets vérifiés sur leur registre : openai-agents (pip), @openai/agents (npm), zod (npm).

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

D'après la documentation officielle (openai.github.io), lue le 3 octobre 2026. Les commandes sont recopiées telles quelles.

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. openai.github.io
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. openai.github.io
Garde-fous: Des contrôles configurables vérifient ce qui entre dans l'agent et ce qui en sort. openai.github.io
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. openai.github.io
Sessions: La bibliothèque gère elle-même l'historique de conversation d'une exécution à l'autre. openai.github.io
Traçage: Chaque exécution est enregistrée : on la relit pour déboguer ou optimiser l'agent. openai.github.io
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. openai.github.io

Les façons de l'utiliser

Systèmes

macOS
Linux
Windowsen 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é

D'après openai.github.io. Un système absent de la liste n'est pas cité par l'éditeur.

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.

Prix relevés le 3 octobre 2026 sur openai.github.io, dans la devise de la page.

Licence

Open source, licence MIT. Les dépôts Python et JavaScript portent tous deux la licence MIT. github.com

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). openai.github.io

Clé d'API personnelle: oui
Modèles locaux: non établi

Sources

Fiche relevée le 3 octobre 2026 sur 17 pages officielles. Une information que nous n'avons pas pu vérifier n'est jamais présentée comme un fait.

Ce que nous n'avons pas pu vérifier (2)

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.

Tous les outils →Le même modèle, des outils différents →Les abonnements d'IA →Signaler une erreur →

Cette fiche existe aussi en texte et en JSON.