Documentação do Oracle Cloud Infrastructure

Sandboxes na OCI Generative AI

Use um sandbox para executar comandos de código e shell em um espaço de trabalho Linux gerenciado e temporário com seus próprios arquivos, processos e ambiente de rede.

Um sandbox oferece ao seu aplicativo ou agente de IA um ambiente de execução que ele pode criar sob demanda e endereçar por ID. Faça upload de entradas, execute comandos, inspecione os resultados e faça download dos arquivos de saída. A Oracle gerencia a infraestrutura subjacente.

Use sandboxes para tarefas como testar código gerado, transformar dados, produzir relatórios e executar visualizações temporárias do aplicativo. Defina os recursos, o acesso à rede e o tempo de vida necessários para cada tarefa.

Como funcionam os sandboxes

  1. Crie um projeto de IA Generativa com sandboxes habilitados ou habilite sandboxes em um projeto existente.
  2. Selecione a configuração de rede de saída do projeto e, opcionalmente, configure pools de aquecimento.
  3. Crie um sandbox por meio da CLI ou do SDK do OCI. Selecione seu runtime, forma de computação e duração de expiração.
  4. Aguarde o sandbox chegar a RUNNING, faça upload de arquivos e execute comandos.
  5. Faça download dos resultados ou salve um snapshot do sistema de arquivos antes de interromper o sandbox ou permitir que ele expire.

Você pode reutilizar um ID de sandbox em execução em várias chamadas para trabalhar no mesmo espaço de trabalho. Cada sandbox tem sua própria vida útil. O serviço termina a execução quando o sandbox expira. Use um instantâneo para criar um novo sandbox com base em arquivos salvos; os instantâneos não preservam a memória ou os processos em execução.

Projetos e piscinas quentes

Um project contém configuração compartilhada para seus sandboxes. Os sandboxes no mesmo projeto usam a configuração de rede do projeto e o acesso do OCI concedido aos controladores de sandbox desse projeto. Use projetos separados ou permissões com escopo para diferentes requisitos de acesso.

Um pool quente prepara a capacidade ociosa para novas solicitações de sandbox. Pools quentes são opcionais. Eles têm sua própria configuração dentro de um projeto.

Recursos do Agente Relacionado

Um aplicativo hospedado pode coordenar um fluxo de trabalho, criar sandboxes para tarefas individuais, coletar suas saídas e interromper as sandboxes. Mantenha o estado do workflow e os resultados finais no armazenamento durável quando eles tiverem que sobreviver a um runtime.

Capacidade Utilize-o para
Aplicativos hospedados Execute um aplicativo, agente, API ou serviço de ferramenta implantado.
Sandboxes Controlar diretamente um espaço de trabalho de execução temporária por meio de operações de comando, arquivo, snapshot e ciclo de vida.
API de Contêineres Gerencie recursos de execução usados por ferramentas nas interações de API de Respostas do OCI.

Trabalhando com Sandboxes