Présentation

L’API Agents est disponible en version bêta. Elle permet aux développeurs de créer des applications avec un agent Codex géré par OpenAI, capable de travailler en plusieurs étapes et de poursuivre dans la même session.

Votre application fournit la tâche, les outils et la configuration. OpenAI gère la session de l’agent et la coordination entre son modèle et ses outils.

Que peut faire un agent ?

Selon ses outils et son environnement d’exécution, un agent peut exécuter du code, modifier des fichiers, utiliser des connexions MCP et produire des fichiers pour votre application. Vous pouvez envoyer des instructions supplémentaires ou poursuivre avec une autre tâche dans la même session.

Consultez la présentation de l’API Agents pour découvrir les fonctionnalités prises en charge et des exemples.

Comment démarrer ?

1. Créez une clé API d’application dans votre projet sur la plateforme OpenAI. Accordez les autorisations api.agents.read et api.agents.write pour les sessions, ainsi que api.responses.write pour les requêtes au modèle.

2. Suivez le guide de démarrage rapide pour configurer un agent, créer une session et soumettre une tâche.

3. Suivez les événements de la session pour consulter la progression et les résultats. Conservez l’identifiant de la session si vous souhaitez poursuivre le travail.

Conservez votre clé API en dehors du bac à sable de l’agent. Les requêtes nécessitent l’en-tête OpenAI-Beta: agents=v1. Les SDK OpenAI ajoutent cet en-tête automatiquement.

Mon agent a-t-il besoin d’un bac à sable ?

Choisissez l’environnement adapté à la tâche :

• Aucun environnement : L’agent répond aux questions ou utilise des outils externes sans avoir besoin de commandes shell intégrées ni de fichiers de l’espace de travail.

• Bac à sable hébergé par OpenAI : L’agent doit exécuter des scripts ou travailler avec des fichiers, et vous souhaitez qu’OpenAI gère son bac à sable.

• Bac à sable auto-hébergé : Vous avez besoin de votre propre infrastructure, de vos logiciels ou de votre réseau privé. Votre application gère le cycle de vie de l’environnement.

Consultez l’architecture de l’API Agents pour en savoir plus sur la configuration.

Où puis-je consulter une session ?

Ouvrez les journaux dans le tableau de bord de la plateforme, sélectionnez Agents et recherchez l’identifiant de la session. Vous pouvez examiner les tours d’échange, les appels d’outils et l’activité des sous-agents.

Le guide d’observabilité explique également comment consulter la consommation de tokens enregistrée.

Que faire si le flux d’événements se déconnecte ?

Récupérez la session existante et ses éléments enregistrés avant de réessayer. Cela vous aide à vérifier ce qui s’est passé avant de soumettre d’autres tâches.

Un tour d’échange terminé ne signifie pas que tous les outils ont réussi. Examinez le résultat renvoyé. Une session inactive ne suffit pas à établir que la tâche s’est terminée avec succès.

Comment l’utilisation est-elle facturée ?

Les requêtes au modèle sont facturées aux tarifs API du modèle sélectionné. Les outils OpenAI et les bacs à sable hébergés par OpenAI sont facturés aux tarifs applicables aux outils et aux conteneurs.

Consultez la tarification de l’API pour connaître les tarifs en vigueur.

Comment les données et les fichiers des sessions sont-ils gérés ?

L’API Agents conserve l’état de la session pour permettre au travail de se poursuivre d’un tour d’échange à l’autre. Vous pouvez supprimer les sessions et les artefacts publiés lorsque vous n’en avez plus besoin. Enregistrez les fichiers dont vous avez besoin avant de supprimer une session.

L’API Agents ne prend actuellement en charge la résidence des données qu’aux États-Unis. Elle ne prend pas en charge la politique de non-conservation des données, même si vous utilisez un bac à sable auto-hébergé. Consultez la documentation de l’API Agents pour en savoir plus sur les contrôles des données.