Veja os exemplos de gerenciamento pela aplicação e por webhooks no OpenAI Cookbook.
Consulte Sandboxes hospedados em infraestrutura própria para saber como configurar o executor e quais são os requisitos de conexão.
Escolha um modo de provisionamento:
- Gerenciado pela aplicação: Siga este guia para iniciar e parar sandboxes a partir da sua aplicação.
- Gerenciado por webhooks: Implante um manipulador que inicie ou reconecte sandboxes a partir de webhooks da OpenAI.
Consulte Ciclo de vida do sandbox para comparar os dois modos.
Antes de começar
Você precisa de uma chave de API de projeto da OpenAI, do ID e do segredo de um token da Modal e do pacote Codex CLI.
Use OPENAI_API_KEY para as solicitações do aplicativo. Defina OPENAI_EXECUTOR_API_KEY como uma chave de ambiente e passe apenas essa chave para o sandbox como CODEX_API_KEY.
1. Configure o ambiente da Modal
Crie uma sessão auto-hospedada e salve seu ID de ambiente. Use o SDK ou a API da Modal para criar um sandbox isolado com o diretório de trabalho configurado. Instale o Codex CLI no sandbox e, em seguida, inicie seu executor com esse ID de ambiente e a chave de ambiente.
2. Execute a sessão
Use os exemplos HTTP em Execute e continue sessões para enviar dados de entrada e receber o resultado por streaming depois que o executor da Modal se conectar. Ao terminar, exclua a sessão e pare o sandbox do provedor separadamente.