Execução em ambiente isolado para agentes de código
Nunca execute código gerado pelo modelo no seu sistema hospedeiro — utilize ambientes isolados com gVisor, Firecracker ou E2B.
Execução em ambiente isolado para agentes de código é uma aula grátis de AI Agents no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de AI Agents, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de AI Agents inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Por que Usar uma Sandbox?
Agentes de código (Devin, Claude Code, OpenDevin) executam código gerado pelo modelo. Se você executar esse código no seu sistema anfitrião, o modelo poderá:
- Ler seus segredos / chaves de API
- Excluir arquivos
- Fazer chamadas de rede de saída
- Minerar criptomoedas
Sandbox = ambiente isolado que limita os danos.
Níveis de Isolamento
| Nível | Ferramenta | Uso |
|---|---|---|
| Processo | subprocess + chroot | Baixa segurança, somente desenvolvimento |
| Contêiner | Docker | Padrão adequado |
| VM / microVM | Firecracker, gVisor | Isolamento forte |
| Sandbox hospedada | E2B, Daytona | Mais fácil para produção |
Docker Sandbox Basics
docker run \
--rm \
--network=none \
--memory=512m \
--cpus=0.5 \
--read-only \
--user=nobody \
-v /tmp/work:/work:rw \
python:3.11-slim \
python /work/script.pyIsolamento de Rede
--network=none desativa o tráfego de saída. Para algumas tarefas, você precisa de internet limitada — use um proxy de saída que permita apenas hosts específicos.
Limites de Recursos
Os limites impedem o uso descontrolado de CPU / memória:
--memory— limite de RAM--cpus— parcela de CPU--pids-limit— quantidade de processos--ulimit— descritores de arquivos
Firecracker / gVisor
Para obter um isolamento mais forte que o do Docker:
- Firecracker — microVM da AWS, usada pelo Lambda
- gVisor — kernel em espaço de usuário do Google, substituto direto do Docker
- Kata Containers — experiência do Docker com isolamento de VM
Sandbox Hospedada E2B
E2B (e2b.dev) oferece uma sandbox remota por meio de uma API:
# pip install e2b
import e2b
sandbox = e2b.Sandbox(template='python', api_key='...')
result = sandbox.run_code('print(2 + 2)')
print(result.stdout) # '4'
sandbox.close()Daytona
Daytona oferece recursos semelhantes de sandbox hospedada, voltados para espaços de trabalho de desenvolvimento.
Sandbox do Sistema de Arquivos
Monte apenas o que o agente precisa para leitura e gravação; deixe todo o restante somente para leitura ou oculto:
docker run -v ${PWD}/workdir:/workdir:rw \
-v ${PWD}/readonly:/readonly:ro ...Limites de Tempo
Limite o tempo total de execução para impedir ciclos intermináveis:
docker run --rm --stop-timeout 30 ... \
python -c 'import resource; resource.setrlimit(resource.RLIMIT_CPU, (30, 30)); exec(open("/work/script.py").read())'Registro
Registre cada comando, cada saída e cada alteração de arquivo. Para agentes de alto risco, registre em um log de auditoria toda a sessão da sandbox.
Sandboxes para Vários Clientes
Sandboxes por usuário impedem que os usuários corrompam o estado uns dos outros. Crie uma sandbox nova por sessão; destrua-a depois.
Custo vs Segurança
Um isolamento mais forte implica um custo maior (sobrecarga por VM). Ajuste o nível ao risco:
- Tutorial / recurso de sandbox para usuários: Docker é suficiente
- Código de produção que acessa segredos: Firecracker / E2B
Bloqueio da Rede
Como impedir que um agente de código faça chamadas de rede de saída?
Recapitulação
Nunca execute código gerado pelo modelo no seu host. Escolha o nível de isolamento conforme o risco: Docker para desenvolvimento, gVisor / Firecracker / E2B para produção. Limite CPU, memória, tempo e rede.
Perguntas Frequentes
A aula “Execução em ambiente isolado para agentes de código” é grátis?
Sim — o texto completo de “Execução em ambiente isolado para agentes de código” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de AI Agents, atualize para CoddyKit PRO. O curso de AI Agents inclui 4 aulas no total.
O que vou aprender em “Execução em ambiente isolado para agentes de código”?
Nunca execute código gerado pelo modelo no seu sistema hospedeiro — utilize ambientes isolados com gVisor, Firecracker ou E2B. Você pratica AI Agents com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar AI Agents?
Nenhuma experiência prévia é necessária. AI Agents no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Execução em ambiente isolado para agentes de código”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de AI Agents?
Sim. Cada aula de AI Agents inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Defesas contra injeção de prompt
- Filtragem de saídas (Llama Guard, NeMo)
- Execução em ambiente isolado para agentes de código
- Controle de acesso às ferramentas