Consulta los ejemplos de administración desde la aplicación y mediante webhooks en el OpenAI Cookbook.
Consulta Sandboxes autoalojados para conocer la configuración del ejecutor y los requisitos de conexión.
Elige un modo de aprovisionamiento:
- Administrado por la aplicación: sigue esta guía para iniciar y detener sandboxes desde tu aplicación.
- Administrado mediante webhooks: despliega un controlador que inicie o vuelva a conectar sandboxes a partir de webhooks de OpenAI.
Consulta Ciclo de vida del sandbox para comparar los dos modos.
Antes de comenzar
Usa un proyecto de Vercel con acceso a Sandbox. La forma en que se autentica el SDK de Vercel Sandbox depende de dónde se ejecute esta aplicación:
- Ejecución local: configura
VERCEL_TOKEN,VERCEL_TEAM_IDyVERCEL_PROJECT_IDen tu entorno. - Despliegue en Vercel: usa Vercel OIDC.
Usa OPENAI_API_KEY para las solicitudes de la aplicación. Configura OPENAI_EXECUTOR_API_KEY con una clave de entorno y pasa únicamente esa clave al sandbox como CODEX_API_KEY.
1. Configura el entorno de Vercel
Crea una sesión autoalojada y guarda su ID de entorno. Usa el SDK o la API de Vercel para crear un sandbox aislado con el directorio de trabajo configurado. Instala Codex CLI en el sandbox y luego inicia su ejecutor con ese ID de entorno y la clave de entorno.
Para el uso habitual, incluye Codex en una instantánea de Vercel para que el sandbox pueda conectarse más pronto.
2. Ejecuta la sesión
Usa los ejemplos de HTTP en Ejecutar y continuar sesiones para enviar datos de entrada y transmitir el resultado después de que se conecte el ejecutor de Vercel. Al terminar, elimina la sesión y detén el sandbox del proveedor por separado.