Consulta el ejemplo de gestión desde la aplicación en el OpenAI Cookbook.
Esta guía usa el aprovisionamiento gestionado por la aplicación : tu aplicación inicia el Devbox, conecta su ejecutor y lo apaga al terminar. Consulta Ciclo de vida del sandbox para conocer el comportamiento del ciclo de vida.
Antes de comenzar
Usa el SDK o la API de Runloop para gestionar un Devbox y solicitudes HTTP para gestionar las sesiones de la API de agentes.
Configura RUNLOOP_API_KEY y usa OPENAI_API_KEY para las solicitudes de la aplicación. Asigna a OPENAI_EXECUTOR_API_KEY una clave de entorno y pasa solo esa clave al Devbox como CODEX_API_KEY.
Gestión desde la aplicación
- Crea una sesión autoalojada y guarda su ID de entorno.
- Crea un Devbox de Runloop con el directorio de trabajo de la sesión e instala Codex CLI dentro de él.
- Inicia el ejecutor en segundo plano con el ID y la clave del entorno.
- Envía datos de entrada e inspecciona el resultado. Para una tarea con archivos, crea
brief.txten el espacio de trabajo y pídele al agente que escriba un plan de migración enplan.md. - Verifica que el turno haya finalizado, recupera los archivos que necesites, luego apaga el Devbox y elimina la sesión.
Establece tiempos de espera limitados para la configuración y la ejecución, además de un límite de duración del Devbox como respaldo en caso de que tu aplicación se cierre inesperadamente. Mantén la sesión y el Devbox activos si necesitas turnos de seguimiento. Usa un único responsable del aprovisionamiento por sesión; no asocies un controlador de webhooks de aprovisionamiento a las sesiones que tu aplicación gestiona directamente.
Referencias
- Consulta la documentación de Runloop
- Consulta el SDK de Python de Runloop
- Consulta el SDK de TypeScript de Runloop