Runloop

Veja o exemplo de gerenciamento pelo aplicativo no OpenAI Cookbook.

Este guia usa provisionamento gerenciado pelo aplicativo : seu aplicativo inicia o Devbox, conecta o executor dele e o desliga ao terminar. Consulte Ciclo de vida do sandbox para entender o comportamento do ciclo de vida.

Antes de começar

Use o SDK ou a API da Runloop para gerenciar um Devbox e requisições HTTP para gerenciar sessões da API de Agentes.

Defina RUNLOOP_API_KEY e use OPENAI_API_KEY nas requisições do aplicativo. Atribua a OPENAI_EXECUTOR_API_KEY uma chave de ambiente e passe apenas essa chave para o Devbox como CODEX_API_KEY.

Gerenciado pelo aplicativo

1. Crie uma sessão auto-hospedada e salve o ID do ambiente dela.
2. Crie um Devbox da Runloop com o diretório de trabalho da sessão e instale o Codex CLI nele.
3. Inicie o executor em segundo plano com o ID e a chave do ambiente.
4. Envie uma entrada e inspecione o resultado. Para uma tarefa com arquivos, crie brief.txt no workspace e peça ao agente que escreva um plano de migração em plan.md.
5. Verifique se o turno foi concluído, recupere os arquivos de que precisar e, em seguida, desligue o Devbox e exclua a sessão.

Defina tempos limite para a configuração e a execução, além de um limite de duração do Devbox como medida de contingência caso seu aplicativo seja encerrado inesperadamente. Mantenha a sessão e o Devbox ativos se precisar de turnos adicionais. Use um único responsável pelo provisionamento por sessão; não associe um manipulador de webhook de provisionamento a sessões que seu aplicativo gerencia diretamente.

Referências

• Consulte a documentação da Runloop
• Consulte o SDK da Runloop para Python
• Consulte o SDK da Runloop para TypeScript