Consulta los ejemplos de gestión desde la aplicación y mediante webhooks en el OpenAI Cookbook.
Consulta Sandboxes autoalojados para ver cómo configurar el ejecutor y qué requisitos debe cumplir para conectarse.
Elige un modo de aprovisionamiento:
- Gestión desde la aplicación: sigue esta guía para iniciar y detener sandboxes desde tu aplicación.
- Gestión mediante webhooks: despliega un controlador que inicie o vuelva a conectar los sandboxes cuando reciba webhooks de OpenAI.
Consulta Ciclo de vida del sandbox para comparar los dos modos.
Antes de empezar
Usa un proyecto de Vercel con acceso a Vercel Sandbox. El método de autenticación del SDK de Vercel Sandbox depende de dónde se ejecute la aplicación:
- Si se ejecuta localmente: configura
VERCEL_TOKEN,VERCEL_TEAM_IDyVERCEL_PROJECT_IDen tu entorno. - Si está desplegada en Vercel: usa OIDC de Vercel.
Usa OPENAI_API_KEY para las solicitudes de la aplicación. Configura OPENAI_EXECUTOR_API_KEY con una clave de entorno y pasa solo esa clave al sandbox como CODEX_API_KEY.
1. Configura el entorno de Vercel
Crea una sesión autoalojada y guarda el ID de su entorno. Usa el SDK o la API de Vercel para crear un sandbox aislado con el directorio de trabajo configurado. Instala la CLI de Codex en el sandbox y luego inicia el ejecutor con ese ID y la clave del entorno.
Si usas Codex con frecuencia, inclúyelo en una instantánea de Vercel para que el sandbox pueda conectarse antes.
2. Ejecuta la sesión
Una vez que se conecte el ejecutor de Vercel, usa los ejemplos de HTTP de Ejecutar y continuar sesiones para enviar datos de entrada y recibir el resultado en streaming. Cuando termines, elimina la sesión y detén por separado el sandbox del proveedor.
Referencias
- Consulta la documentación de Vercel Sandbox
- Consulta la referencia del SDK de Vercel Sandbox para Python
- Consulta la referencia del SDK de Vercel Sandbox para JavaScript/TypeScript