Clone de Sandbox Legado

1. Conflitos de Experimentos e Contaminação do Ambiente. Quando um AI Agent tenta múltiplas soluções, alterações experimentais no código podem interferir no fluxo de trabalho principal do desenvolvedor ou contaminar o ambiente de execução atual. Quando um experimento dá errado, a recuperação geralmente exige um rollback, e caminhos de exploração valiosos não podem ser preservados.
2. Incapacidade de Explorar Múltiplas Soluções em Paralelo. Restrito a um único ambiente, o AI Agent só consegue testar diferentes abordagens sequencialmente. Esse modo serial não é apenas ineficiente; mais importante, ele limita a amplitude da exploração da IA — impossibilitando a validação simultânea de múltiplas hipóteses ou abordagens de implementação em paralelo.
3. Escalabilidade Limitada do Poder Computacional. Ao enfrentar tarefas que exigem “Wide-Research” (por exemplo, comparar 100 soluções simultaneamente, gerar em lote múltiplas versões de implementação), a arquitetura de ambiente único restringe fundamentalmente a capacidade de paralelizar o processamento de tarefas.

1. Arquitetura de Exploração com Múltiplas Linhas do Tempo: Como uma árvore de decisão, o AI Agent pode partir do mesmo estado de referência e criar múltiplas cópias independentes do sandbox, cada uma explorando um caminho de solução diferente sem interferir nas outras.
2. Capacidade Real de Computação Paralela: Ao dividir tarefas grandes em subtarefas em lote, o AI Agent pode escalar seu poder computacional em dezenas ou até centenas de vezes, processando simultaneamente dezenas ou centenas de ramificações de exploração.
3. Ambiente de Experimentação Sem Risco: Sandboxes clonados são completamente isolados, permitindo que a IA experimente livremente e teste várias possibilidades sem afetar o ambiente original ou o fluxo de trabalho principal do desenvolvedor.
4. Utilização Eficiente de Recursos: Embora várias instâncias de sandbox possam ser iniciadas simultaneamente, ao gerenciar dinamicamente e encerrar prontamente ramificações (instâncias de sandbox) que não têm mais valor, o consumo geral de recursos computacionais pode ser mantido dentro de uma faixa razoável.

​

Terminologia

• Sandbox de Origem: A instância de sandbox original que está sendo clonada.
• Novo Sandbox: A nova instância de sandbox criada por meio da operação de clone.

​

Visão Geral do Recurso

• Clonar um sandbox em estado Running
• Clonar um sandbox em estado Paused

​

Clonando um Sandbox em Execução

• O sandbox de origem será brevemente suspenso durante a clonagem;
• A instância de sandbox fica indisponível durante a suspensão;
• A duração da suspensão é próxima ao tempo necessário para uma única operação de pausa.

• O status é restaurado para running;
• O registro de pausa existente será atualizado para um novo registro de pausa, com base no estado atual do sandbox;
• Um novo registro de template de snapshot é gerado (para excluir esse template de snapshot, você precisa primeiro encerrar tanto o sandbox de origem quanto os sandboxes clonados);

• O status é running;
• Pronto para uso imediato.

​

Clonando um Sandbox Pausado

• O processo de clone não acionará a inicialização do sandbox de origem;
• O sandbox de origem permanece em estado pausado.

• O registro de pausa existente não é removido;
• Um novo registro de template de snapshot é gerado (para excluir esse template de snapshot, você precisa primeiro encerrar tanto o sandbox de origem quanto os sandboxes clonados);

• O status é running;
• Pronto para uso imediato.

​

Regras de Herança de Atributos do Novo Sandbox

​

Descrição dos Parâmetros

• count: O número de instâncias de sandbox a serem clonadas. O valor mínimo é 1, e o máximo não deve exceder o limite de instâncias de sandbox em execução simultânea da plataforma (consulte: Limite de Cota de Sandbox);
• strict: Se deve clonar estritamente de acordo com o número especificado no parâmetro count, o padrão é false.
  • true: Se o número de instâncias clonadas com sucesso for menor que count, uma falha de clone será retornada; os sandboxes criados com sucesso serão liberados automaticamente.
  • false: Retorna o número real de instâncias de sandbox clonadas com sucesso.
• timeout(timeoutMs): O tempo limite para clonar instâncias de sandbox.
  • Se não for especificado:
    • Quando o sandbox de origem está em estado running, ele herda sua configuração de tempo limite;
    • Quando o sandbox de origem está em estado paused, o valor padrão de 5 minutos é usado.

​

Valor de Retorno

​

Exemplos de Código

from novita_sandbox.core import Sandbox

# Create a sandbox
sandbox = Sandbox.create(template="base")
# clone
clones = Sandbox.clone(sandbox.sandbox_id, 2)

print("snapshot:", clones.snapshot_template_id)
for sbx in clones:
    print("clone sandbox:", sbx.sandbox_id)

import { Sandbox } from '@novita-sandbox/core'

// Create a sandbox
const sandbox = await Sandbox.create('base')

// clone
const sbxClones = await Sandbox.clone(sandbox.sandboxId, { count: 2 })

console.log("snapshot:", sbxClones.snapshotTemplateId)
for (const idx in sbxClones.sandboxes) {
    console.log("clone sandboxID[" + idx + "]:", sbxClones.sandboxes[idx].sandboxId)
}

# novita-sandbox-cli sandbox clone [sandboxID] -c [count] -s [strict] -t [timeout]
novita-sandbox-cli sandbox clone 0r0efkbfwzfp9p7qpc1c -c 2