Consulta los ejemplos de gestió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:
- Gestionado desde la aplicación: sigue esta guía para iniciar y detener sandboxes desde tu aplicación.
- Gestionado 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
Necesitas una clave de API de un proyecto de OpenAI, una clave de API y un espacio de trabajo de Blaxel, y el paquete de Codex CLI.
Configura BL_API_KEY y BL_WORKSPACE, y usa OPENAI_API_KEY para las solicitudes de la aplicación. Asigna una clave de entorno a OPENAI_EXECUTOR_API_KEY y pasa únicamente esa clave al sandbox como CODEX_API_KEY.
Elige la región del sandbox en tu código de aprovisionamiento. Usa us-was-1 si necesitas la opción de persistencia de Agent Drive que se describe más adelante.
1. Configura el entorno de Blaxel
Crea una sesión autoalojada y guarda el ID de su entorno. Usa el SDK o la API de Blaxel 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.
La imagen de Node de Blaxel usa Alpine Linux, así que instala ripgrep con apk. Pasa la clave de entorno como CODEX_API_KEY únicamente al proceso del ejecutor. Configura keep_alive=True para evitar que el sandbox escale a cero mientras el ejecutor esté en ejecución. Los tiempos de espera limitados para la configuración, el ejecutor y el sandbox evitan que los recursos abandonados sigan en ejecución indefinidamente.
Para un uso habitual, crea una imagen de Blaxel con Codex y ripgrep ya instalados para que el sandbox pueda conectarse más rápido.
2. Ejecuta la sesión
Usa los ejemplos HTTP de Ejecutar y continuar sesiones para enviar datos de entrada y recibir el resultado en streaming después de que se conecte el ejecutor de Blaxel. Al terminar, elimina la sesión y detén el sandbox del proveedor por separado.
Inicia el sandbox antes de enviar datos de entrada. El turno espera a que el entorno se conecte, y la sesión informa de la conexión mediante agent.session.environment.connected en el flujo de eventos.
Usa agent.session.turn.completed para identificar un turno completado correctamente. Después de un turno fallido o cancelado también puede aparecer agent.session.idle, así que no consideres que una sesión inactiva demuestra que el turno se completó correctamente.
Opcional: conservar archivos entre sesiones
Usa Blaxel Agent Drive para conservar archivos entre sandboxes y sesiones. Monta la misma unidad en cada sandbox para compartir archivos; Agent Drive requiere la región us-was-1 y no transfiere el historial de conversaciones ni el estado de la sesión.
Referencias
- Consulta la documentación de Blaxel Sandbox
- Consulta el SDK de Python de Blaxel
- Consulta el SDK de TypeScript de Blaxel