For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navigation principale
Theme

Modal

Exécutez une session de l’API Agents dans un bac à sable Modal.

Consultez les exemples de gestion des bacs à sable par l’application et par webhook dans l’OpenAI Cookbook.

Consultez la section Bacs à sable auto-hébergés pour savoir comment configurer l’exécuteur et quelles conditions remplir pour le connecter.

Choisissez un mode de provisionnement :

  • Gestion par l’application : suivez ce guide pour démarrer et arrêter les bacs à sable depuis votre application.
  • Gestion par webhook : déployez un gestionnaire qui démarre ou reconnecte les bacs à sable en réponse aux webhooks d’OpenAI.

Consultez la section Cycle de vie des bacs à sable pour comparer les deux modes.

Avant de commencer

Munissez-vous d’une clé API de projet OpenAI, de l’identifiant et du secret d’un jeton Modal, ainsi que du paquet Codex CLI.

Utilisez OPENAI_API_KEY pour les requêtes de votre application. Attribuez à OPENAI_EXECUTOR_API_KEY la valeur d’une clé d’environnement, puis transmettez uniquement cette clé au bac à sable via CODEX_API_KEY.

1. Configurez l’environnement Modal

Créez une session auto-hébergée et enregistrez l’identifiant de son environnement. Utilisez le SDK ou l’API de Modal pour créer un bac à sable isolé qui utilise le répertoire de travail configuré. Installez Codex CLI dans le bac à sable, puis démarrez son exécuteur avec l’identifiant et la clé de cet environnement.

2. Exécutez la session

Une fois l’exécuteur Modal connecté, utilisez les exemples HTTP de la section Exécuter et poursuivre des sessions pour envoyer les données d’entrée et recevoir le résultat en continu. Lorsque vous avez terminé, supprimez la session et arrêtez séparément le bac à sable chez Modal.

Références