Runloop

Consultez l’exemple de gestion par l’application dans l’OpenAI Cookbook.

Ce guide utilise un provisionnement géré par l’application : votre application démarre la Devbox, connecte son exécuteur et l’arrête une fois le travail terminé. Consultez Cycle de vie du bac à sable pour comprendre le fonctionnement du cycle de vie.

Avant de commencer

Utilisez le SDK ou l’API Runloop pour gérer une Devbox, et des requêtes HTTP pour gérer les sessions de l’API Agents.

Définissez RUNLOOP_API_KEY et utilisez OPENAI_API_KEY pour les requêtes de l’application. Affectez une clé d’environnement à OPENAI_EXECUTOR_API_KEY et transmettez uniquement cette clé à la Devbox comme valeur de CODEX_API_KEY.

Gestion par l’application

1. Créez une session auto-hébergée et enregistrez son identifiant d’environnement.
2. Créez une Devbox Runloop avec le répertoire de travail de la session et installez-y Codex CLI.
3. Démarrez l’exécuteur en arrière-plan avec l’identifiant et la clé de l’environnement.
4. Envoyez des données d’entrée et examinez le résultat. Pour une tâche portant sur des fichiers, créez brief.txt dans l’espace de travail et demandez à l’agent de rédiger un plan de migration dans plan.md.
5. Vérifiez que le tour est terminé, récupérez les fichiers dont vous avez besoin, puis arrêtez la Devbox et supprimez la session.

Définissez des délais maximaux pour la configuration et l’exécution, ainsi qu’une durée de vie maximale pour la Devbox au cas où votre application s’arrêterait de manière inattendue. Gardez la session et la Devbox actives si vous avez besoin de tours supplémentaires. Confiez le provisionnement à un seul responsable par session ; n’associez pas de gestionnaire de webhook de provisionnement aux sessions que votre application gère directement.

Références

• Consultez la documentation Runloop
• Consultez le SDK Python Runloop
• Consultez le SDK TypeScript Runloop