Confira no OpenAI Cookbook os exemplos de gerenciamento 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 modo de provisionamento:
- 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
Use um projeto da Vercel com acesso ao Vercel Sandbox. A forma de autenticação do SDK do Vercel Sandbox depende de onde o aplicativo é executado:
- Em execução local: defina
VERCEL_TOKEN,VERCEL_TEAM_IDeVERCEL_PROJECT_IDno seu ambiente. - Implantado na Vercel: use o OIDC da Vercel.
Use OPENAI_API_KEY nas solicitações do aplicativo. Defina OPENAI_EXECUTOR_API_KEY como uma chave de ambiente e passe somente essa chave para o sandbox como CODEX_API_KEY.
1. Configure o ambiente da Vercel
Crie uma sessão auto-hospedada 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 a CLI do Codex no sandbox e, em seguida, inicie o executor com esse ID e a chave do ambiente.
Se você usa o sandbox com frequência, inclua o Codex em um snapshot da Vercel para que o sandbox possa se conectar mais rapidamente.
2. Execute a sessão
Depois que o executor da Vercel se conectar, use os exemplos HTTP em Executar e continuar sessões para enviar dados de entrada e receber o resultado por streaming. Ao terminar, exclua a sessão e, separadamente, pare o sandbox do provedor.