Veja os exemplos de gerenciamento pela aplicação e gerenciamento por webhooks no OpenAI Cookbook.
Consulte Sandboxes hospedados em infraestrutura própria para ver a configuração do executor e 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
Use um projeto da Vercel com acesso ao Sandbox. A forma de autenticação do SDK do Vercel Sandbox depende de onde esta aplicação está sendo executada:
- Em execução localmente: defina
VERCEL_TOKEN,VERCEL_TEAM_IDeVERCEL_PROJECT_IDno seu ambiente. - Implantada na Vercel: use o OIDC da Vercel.
Use OPENAI_API_KEY para as requisições da aplicação. 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 Vercel
Crie uma sessão com hospedagem própria e salve o ID do ambiente dessa sessão. Use o SDK ou a API da Vercel 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.
Para uso frequente, inclua o Codex em um snapshot da Vercel para que o sandbox possa se conectar mais rapidamente.
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 após a conexão do executor da Vercel. Ao terminar, exclua a sessão e pare o sandbox do provedor separadamente.