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

Modal

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

Consultez les exemples de gestion par l’application et par webhook dans le Cookbook OpenAI.

Consultez Bacs à sable autohébergés pour connaître la configuration de l’exécuteur et les exigences de connexion.

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 à partir des webhooks OpenAI.

Consultez Cycle de vie du bac à sable pour comparer les deux modes.

Avant de commencer

Vous avez besoin d’une clé API de projet OpenAI, de l’identifiant et du secret d’un token Modal, ainsi que du package Codex CLI.

Utilisez OPENAI_API_KEY pour les requêtes de l’application. Attribuez à OPENAI_EXECUTOR_API_KEY une clé d’environnement et ne transmettez que cette clé au bac à sable, sous le nom 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 Modal pour créer un bac à sable isolé avec le répertoire de travail configuré. Installez Codex CLI dans le bac à sable, puis démarrez son exécuteur avec cet identifiant d’environnement et la clé d’environnement.

2. Exécutez la session

Utilisez les exemples HTTP de la page Exécutez et poursuivez des sessions pour envoyer des données d’entrée et recevoir le résultat en streaming une fois l’exécuteur Modal connecté. Une fois la session terminée, supprimez-la et arrêtez séparément le bac à sable du fournisseur.

Références