Les agents peuvent planifier des tâches et les mener à bien à l’aide d’outils, collaborer avec d’autres agents et conserver le contexte d’une étape à l’autre.
Exécutez votre premier agent
Suivez le guide de démarrage rapide du SDK Agents pour installer le SDK, définir un agent et l’exécuter. Une fois votre agent opérationnel, revenez sur cette page pour choisir la prochaine fonctionnalité à intégrer à votre application.
Accédez au SDK Agents
Consultez les dépôts GitHub pour trouver d’autres exemples, parcourir les issues GitHub et accéder à la documentation de référence propre à chaque langage.
Ouvrez le dépôt du SDK TypeScript sur GitHub.
Ouvrez le dépôt du SDK Python sur GitHub.
Choisissez votre point de départ
| Si vous souhaitez… | Commencez par | Pourquoi |
|---|---|---|
| Créer une application d’agents directement dans votre code | Démarrage rapide | C’est le moyen le plus rapide d’obtenir une intégration fonctionnelle du SDK. |
| Définir précisément un agent spécialisé | Définition des agents | Commencez ici si vous êtes encore en train de définir le contrat d’un agent. |
| Choisir les modèles, les paramètres par défaut et le mode de transport | Modèles et fournisseurs | Consultez ce guide si le choix du modèle, la configuration du fournisseur ou la stratégie de transport influe sur votre workflow. |
| Comprendre la boucle d’exécution et l’état de l’agent | Exécution des agents | Ce guide décrit la boucle de l’agent, le streaming et les stratégies de poursuite de l’exécution. |
| Exécuter des tâches dans des conteneurs | Agents en bac à sable | Consultez ce guide si l’agent a besoin de fichiers, de commandes, de paquets, d’instantanés, de points de montage ou de liens vers des fournisseurs. |
| Répartir les responsabilités entre agents spécialisés | Orchestration et passage de relais | Consultez ce guide si vous avez besoin de plusieurs agents et devez décider lequel se charge de la réponse. |
| Ajouter une validation ou une vérification humaine | Garde-fous et vérification humaine | Consultez ce guide si le workflow doit empêcher la poursuite d’une opération risquée ou la mettre en pause. |
| Comprendre ce que renvoie une exécution | Résultats et état | Cette page décrit la sortie finale, l’état qui permet de reprendre l’exécution et les interfaces disponibles pour le tour suivant. |
| Ajouter des outils hébergés, des outils définis par des fonctions ou la prise en charge de MCP | Utilisation des outils et Intégrations et observabilité | La documentation des outils de la plateforme explique leur fonctionnement. Le guide du SDK couvre l’intégration de MCP et le traçage. |
| Examiner et améliorer les exécutions | Intégrations et observabilité et Évaluation des workflows d’agents | Utilisez d’abord les traces pour le débogage, puis passez aux cycles d’évaluation. |
| Créer un workflow centré sur la voix | Agents vocaux | Utilisez le pipeline vocal du SDK et les techniques de conception d’agents en temps réel. |
Développez avec le SDK
Choisissez le SDK si votre serveur gère le déploiement, l’implémentation des outils, le stockage de l’état et les décisions d’approbation, tandis que le SDK exécute la boucle de l’agent et appelle les outils. Cette approche est la plus adaptée si vous souhaitez :
- écrire du code applicatif typé en TypeScript ou en Python
- contrôler directement les outils, les serveurs MCP et le comportement à l’exécution
- utiliser un stockage personnalisé ou gérer les stratégies de conversation côté serveur
- intégrer étroitement vos agents à la logique existante de votre produit ou à votre infrastructure
Vous pouvez parcourir la documentation du SDK dans l’ordre suivant :
- Suivez le guide de démarrage rapide pour afficher le résultat d’une première exécution.
- Consultez Définition des agents et Modèles et fournisseurs pour définir précisément un premier agent spécialisé.
- Poursuivez avec Exécution des agents, Orchestration et passage de relais et Garde-fous et vérification humaine à mesure que votre workflow se complexifie.
- Consultez Résultats et état et Intégrations et observabilité si la logique de votre application dépend de l’objet renvoyé par l’exécution ou nécessite une analyse plus fine du comportement de l’agent.
Comparez les options d’exécution des agents
Consultez la présentation des agents pour comparer le SDK Agents, l’API Agents et l’API Responses. Le SDK Agents s’exécute dans votre application. L’API Agents exécute un harnais géré au sein du service d’OpenAI.