Présentation

L’API Agents est offerte 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 connaître les fonctionnalités prises en charge et voir des exemples.

Comment commencer?

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. Enregistrez l’identifiant de la session si vous souhaitez poursuivre le travail.

Conservez votre clé API à l’extérieur 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 d’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 autohébergé : Vous avez besoin de votre propre infrastructure, de vos propres logiciels ou d’un 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, les appels d’outils et l’activité des sous-agents.

Le guide d’observabilité explique aussi comment consulter l’utilisation des 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 terminé ne signifie pas que tous les outils ont réussi. Examinez le résultat indiqué. 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 de l’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 de session sont-ils gérés?

L’API Agents conserve l’état de la session pour que le travail puisse se poursuivre d’un tour à l’autre. Vous pouvez supprimer les sessions et les artefacts publiés lorsqu’ils ne sont plus nécessaires. Enregistrez tous les fichiers dont vous avez besoin avant de supprimer une session.

L’API Agents prend actuellement en charge la résidence des données aux États-Unis uniquement. Elle ne prend pas en charge l’option « aucune conservation des données », même lorsque vous utilisez un bac à sable autohébergé. Consultez la documentation de l’API Agents pour en savoir plus sur les contrôles des données.