Les agents peuvent utiliser des outils pour planifier et accomplir des tâches, collaborer avec d’autres agents et conserver le contexte d’une étape à l’autre. Choisissez votre environnement d’exécution en fonction de l’endroit où vous souhaitez orchestrer les agents et de la personne ou du service qui gérera leur état entre les tâches.
Choisissez votre point de départ
| Vous souhaitez | Commencez ici |
|---|---|
| Exécuter un agent avec le harnais Codex géré par OpenAI | API Agents |
| Contrôler la boucle de l’agent dans votre application, réutiliser des agents et des outils et passer le relais entre agents | SDK Agents |
| Travailler directement avec les réponses du modèle et garder la maîtrise de votre intégration | API Responses |
| Intégrer une interface de discussion à votre application | ChatKit |
Comparez les options d’exécution des agents
| API Agents | SDK Agents | API Responses | |
|---|---|---|---|
| Cas d’usage | Confier des tâches de longue durée à un agent dont OpenAI assure la gestion et enregistre la progression | Créer des agents avec des outils et des workflows personnalisés dans votre application | Appeler directement des modèles ou créer un agent de toutes pièces |
| Lieu d’exécution de l’agent | OpenAI gère et exécute le harnais Codex | Le SDK s’exécute dans votre application | Dans votre application, avec une orchestration hébergée en option |
| Effort d’intégration de l’agent | Faible | Moyen | Élevé |
| État entre les tâches | Sauvegarde de la configuration de la session, des tours de conversation et des éléments | Votre système de stockage et les sessions du SDK, ou l’état de la conversation dans l’API Responses | Gestion manuelle de l’historique, chaînage des réponses ou Conversations |
| Exécution des outils | Outils connectés au service, gestionnaires de fonctions de votre application et bac à sable facultatif | Outils et intégrations configurés dans votre application | Outils hébergés et outils exécutés par votre application |
| Environnement d’exécution | Bac à sable hébergé par OpenAI, bac à sable auto-hébergé ou exécution sans bac à sable | Votre environnement d’exécution et vos intégrations avec des fournisseurs de bacs à sable | Votre propre environnement d’exécution |
| Pour commencer | Présentation de l’API Agents | Présentation du SDK Agents | Guide de l’API Responses |
L’API Agents exécute le harnais Codex et gère l’infrastructure sous-jacente pour que vous puissiez vous concentrer sur les tâches de vos agents. Elle assure le compactage automatique du contexte et l’orchestration de plusieurs agents. Elle prend aussi en charge les appels d’outils par programmation et les serveurs MCP. Consultez la présentation de l’architecture.
Avec le SDK Agents, votre application contrôle le déploiement, le stockage, les approbations et l’intégration à l’environnement d’exécution. Le moteur d’exécution du SDK gère la boucle de l’agent et les passages de relais entre agents. Consultez le guide d’exécution des agents.
Ajoutez des outils et des skills, et activez la mise en cache des prompts
Quel que soit le workflow de vos agents, vous pouvez concevoir des outils, réutiliser des skills et mettre les prompts en cache. La configuration et le cycle de vie de ces fonctionnalités peuvent varier selon l’API.
- Commencez par le guide Utilisation des outils pour découvrir l’appel de fonction, MCP et les fonctionnalités hébergées.
- Consultez le guide Appels d’outils par programmation pour orchestrer les appels avec JavaScript et connaître la configuration propre à chaque API.
- Utilisez le guide Skills pour créer des instructions réutilisables et découvrir les mécanismes de chargement pris en charge.
- Consultez le guide Mise en cache des prompts pour comprendre le fonctionnement de la mise en cache commun aux API, puis le guide Observabilité et utilisation de l’API Agents pour savoir comment l’utilisation est comptabilisée par session.
Une session de l’API Agents, une session du SDK, une conversation de l’API Responses et un bac à sable sont des ressources distinctes. Suivez les instructions de gestion de l’état et de nettoyage des ressources propres à l’environnement d’exécution choisi.