Consulte no OpenAI Cookbook os exemplos de gerenciamento de sandboxes pelo aplicativo e por webhook.
Consulte Sandboxes auto-hospedados para saber como configurar o executor e quais são os requisitos de conexão.
Escolha um dos modos de provisionamento abaixo.
- Gerenciado pelo aplicativo. Siga este guia para iniciar e parar sandboxes pelo seu aplicativo.
- Gerenciado por webhook. Implante um manipulador que inicie ou reconecte sandboxes ao receber 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 um projeto da OpenAI, de uma chave de API e de um espaço de trabalho da Blaxel e do pacote da CLI do Codex.
Defina BL_API_KEY e BL_WORKSPACE e use OPENAI_API_KEY nas requisições do aplicativo. Defina OPENAI_EXECUTOR_API_KEY com o valor de uma chave de ambiente e passe apenas essa chave para o sandbox como CODEX_API_KEY.
Escolha a região do sandbox no código de provisionamento. Use us-was-1 se precisar da opção de persistência com o Agent Drive descrita abaixo.
1. Configure o ambiente da Blaxel
Crie uma sessão auto-hospedada e salve o ID do ambiente dessa sessão. Use o SDK ou a API da Blaxel para criar um sandbox isolado com o diretório de trabalho configurado. Instale a CLI do Codex no sandbox e inicie o executor com esse ID e a chave de ambiente.
A imagem do Node da Blaxel usa Alpine Linux. Por isso, instale ripgrep com apk. Passe a chave de ambiente como CODEX_API_KEY apenas para o processo do executor. Defina keep_alive=True para evitar que o número de instâncias do sandbox caia a zero enquanto o executor estiver em execução. Os limites de tempo para a configuração, o executor e o sandbox evitam que recursos abandonados continuem em execução indefinidamente.
Para uso frequente, crie uma imagem da Blaxel com o Codex e o ripgrep já instalados para que o sandbox possa se conectar mais rapidamente.
2. Execute a sessão
Use os exemplos de HTTP em Executar e continuar sessões para enviar dados de entrada e receber o resultado por streaming depois que o executor da Blaxel se conectar. Ao terminar, exclua a sessão e, separadamente, pare o sandbox no provedor.
Inicie o sandbox antes de enviar os dados de entrada. O turno aguarda a conexão do ambiente, e a sessão informa que a conexão foi estabelecida pelo evento agent.session.environment.connected no fluxo de eventos.
Use agent.session.turn.completed para identificar um turno concluído com sucesso. O evento agent.session.idle também pode ocorrer após um turno que falhou ou foi cancelado. Portanto, uma sessão ociosa por si só não confirma que o turno foi concluído com sucesso.
Opcional: preserve arquivos entre sessões
Use o Blaxel Agent Drive para preservar arquivos entre sandboxes e sessões. Monte a mesma unidade em cada sandbox para compartilhar os arquivos. O Agent Drive exige a região us-was-1 e não transfere o histórico da conversa nem o estado da sessão.
Referências
- Consulte a documentação dos sandboxes da Blaxel
- Consulte a documentação do SDK da Blaxel para Python
- Consulte a documentação do SDK da Blaxel para TypeScript