Consultez les exemples de gestion des bacs à sable par l’application et par webhook dans l’OpenAI Cookbook.
Consultez le guide Bacs à sable auto-hébergés pour configurer l’exécuteur et connaître les conditions 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 à la réception de webhooks d’OpenAI.
Consultez le guide Cycle de vie des bacs à sable pour comparer les deux modes.
Avant de commencer
Vous avez besoin d’une clé API de projet OpenAI, d’une clé API Blaxel, d’un espace de travail Blaxel et du paquet Codex CLI.
Définissez BL_API_KEY et BL_WORKSPACE, puis utilisez OPENAI_API_KEY pour les requêtes de votre application. Attribuez à OPENAI_EXECUTOR_API_KEY la valeur d’une clé d’environnement. Transmettez uniquement cette clé au bac à sable via CODEX_API_KEY.
Choisissez la région du bac à sable dans votre code de provisionnement. Utilisez us-was-1 si vous souhaitez conserver vos fichiers avec Agent Drive comme indiqué ci-dessous.
1. Configurez l’environnement Blaxel
Créez une session auto-hébergée et enregistrez l’identifiant de son environnement. Utilisez le SDK ou l’API de Blaxel 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 et la clé d’environnement.
L’image Node de Blaxel utilise Alpine Linux. Installez donc ripgrep avec apk. Transmettez la clé d’environnement via CODEX_API_KEY au seul processus de l’exécuteur. Définissez keep_alive=True pour empêcher le bac à sable de passer à zéro instance tant que l’exécuteur fonctionne. Les délais maximaux prévus pour la configuration, l’exécuteur et le bac à sable empêchent les ressources abandonnées de fonctionner indéfiniment.
Pour un usage régulier, créez une image Blaxel dans laquelle Codex et ripgrep sont préinstallés afin que le bac à sable puisse se connecter plus rapidement.
2. Exécutez la session
Utilisez les exemples HTTP du guide Exécuter et poursuivre des sessions pour envoyer des données d’entrée et recevoir le résultat en continu une fois l’exécuteur Blaxel connecté. Lorsque vous avez terminé, supprimez la session et arrêtez séparément le bac à sable chez le fournisseur.
Démarrez le bac à sable avant d’envoyer les données d’entrée. Le tour reste en attente jusqu’à la connexion de l’environnement. La session signale cette connexion en émettant agent.session.environment.connected dans le flux d’événements.
Utilisez agent.session.turn.completed pour vérifier qu’un tour a réussi. L’événement agent.session.idle peut également survenir après l’échec ou l’annulation d’un tour. Une session inactive ne suffit donc pas à confirmer que le tour a réussi.
Facultatif : conservez les fichiers d’une session à l’autre
Utilisez Blaxel Agent Drive pour conserver les fichiers d’un bac à sable à l’autre et d’une session à l’autre. Montez le même disque dans chaque bac à sable pour partager les fichiers. Agent Drive nécessite la région us-was-1 et ne transfère ni l’historique de la conversation ni l’état de la session.
Références
- Consultez la documentation sur les bacs à sable Blaxel
- Consultez la documentation du SDK Python de Blaxel
- Consultez la documentation du SDK TypeScript de Blaxel