Consulta los ejemplos de sandboxes administrados por la aplicación y administrados 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 manejador 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
Necesitas una clave de API de un proyecto de OpenAI, el ID y el secreto de un token de Modal, y el paquete de Codex CLI.
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 Modal
Crea una sesión autoalojada y guarda su ID de entorno. Usa el SDK o la API de Modal 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.
2. Ejecuta la sesión
Usa los ejemplos de HTTP de Ejecutar y continuar sesiones para enviar datos de entrada y recibir el resultado en streaming una vez que se conecte el ejecutor de Modal. Al terminar, elimina la sesión y detén el sandbox del proveedor por separado.