Vercel

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

Consultez la section Bacs à sable auto-hébergés pour configurer l’exécuteur et connaître les conditions requises pour sa 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 d’un webhook d’OpenAI.

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

Avant de commencer

Utilisez un projet Vercel ayant accès à Vercel Sandbox. Le mode d’authentification du SDK Vercel Sandbox dépend de l’endroit où s’exécute votre application :

• Exécution locale : définissez VERCEL_TOKEN, VERCEL_TEAM_ID et VERCEL_PROJECT_ID dans votre environnement.
• Déploiement sur Vercel : utilisez l’authentification OIDC de Vercel.

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 dans la variable CODEX_API_KEY.

1. Configurez l’environnement Vercel

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

Pour un usage régulier, incluez Codex dans un instantané Vercel afin que le bac à sable puisse se connecter plus rapidement.

2. Exécutez la session

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

Références

• Consultez la documentation de Vercel Sandbox
• Consultez la référence du SDK Python de Vercel Sandbox
• Consultez la référence du SDK JavaScript/TypeScript de Vercel Sandbox