Ao conceder a um agente de inteligência artificial acesso a um ambiente isolado (Sandbox), surge uma questão fundamental sobre como organizar os arquivos nos quais o agente trabalhará. A plataforma Docker Sandbox (referida como sbx) oferece três modelos principais para gerenciar o código-fonte, cada um com um impacto direto no fluxo de trabalho do desenvolvedor e na sua interação com o agente.
1. Montagem Direta (Shared Mounts)
Esta opção permite compartilhar o diretório de trabalho atual do host diretamente com o ambiente isolado. Ao executar sbx run a partir da pasta do projeto, o diretório é montado no mesmo caminho absoluto dentro do ambiente. Este modelo é ideal para colaboração próxima em uma única tarefa, pois o desenvolvedor pode ver as alterações em seu editor local assim que ocorrem, e os servidores de desenvolvimento local também podem capturar as modificações por meio do recurso de atualização rápida (Hot Reload).
Aviso: É preciso ter cuidado com conflitos de dependências; pacotes que contêm binários nativos (Native Binaries) podem funcionar no ambiente isolado Linux e falhar no macOS ou Windows, portanto, é recomendável padronizar o ambiente de execução ou separar a instalação de dependências.
2. Uso de Árvores de Trabalho Git (Git Worktrees)
Esta opção é adequada para a execução de várias tarefas simultaneamente. Ela atribui a cada tarefa sua própria pasta e branch, permitindo que cada árvore de trabalho seja vinculada a um ambiente isolado separado. A vantagem aqui é o isolamento completo das tarefas, mas ainda existe uma restrição técnica: o arquivo .git aponta para metadados fora do escopo da montagem, o que significa que operações como verificação de status (git status) ou alternância entre branches devem ser feitas a partir do host.
3. Modo de Clonagem (Clone Mode)
Neste modo, a ferramenta sbx cria uma cópia independente do código dentro do ambiente isolado, montando o código do host apenas como leitura. Isso concede ao agente acesso total ao Git dentro do ambiente, tornando-o totalmente independente no gerenciamento de branches e commits. Após a conclusão do trabalho, o desenvolvedor pode buscar as alterações por meio de um repositório Git remoto (Remote).
O que isso muda no fluxo de trabalho do desenvolvedor?
A escolha do método adequado depende da natureza da tarefa e do grau de intervenção direta desejado:
- Colaboração próxima: Use a montagem direta se quiser monitorar o trabalho do agente momento a momento.
- Independência: Use o modo de clonagem ou ambientes totalmente isolados (Mountless) se quiser dar ao agente espaço para gerenciar tarefas sem afetar seu ambiente de trabalho local.
- Gerenciamento de múltiplos projetos: Ferramentas de gerenciamento de espaço de trabalho (Workspace Managers) podem ser usadas para agrupar vários repositórios em um único ambiente, facilitando para o agente lidar com projetos interconectados (como frontend e backend).
Lembre-se de que ambientes isolados que não dependem da montagem de arquivos do host (Mountless) exigem gerenciamento manual de portas (Ports) para acessar os servidores de desenvolvimento a partir do seu navegador local, uma prática que aumenta a segurança do isolamento, mas adiciona algumas etapas extras de configuração.