Seu Jarvis seguro: INTELECTO v2 e caixa-do-agente|INEMA.CLUB-PRO

Aula 7 · 20 min

A caixa-do-agente no seu projeto

Você precisa do Docker instalado na aula 6; só as aulas 6 e 7 pedem Docker. Aqui, a caixa-do-agente trabalha numa cópia do projeto. Faça uma mudança pequena sem chave, leia o patch e decida se aplica. Você também aprende como deixar agentes trabalharem numa cópia, em um exemplo opcional não executado neste curso.

Começar a aula
Fotografia editorial que representa a caixa-do-agente no seu projeto.

Nesta aula você vai

  1. 1Entender criar, rodar e destruir
  2. 2Revisar patch e aplicar conscientemente
  3. 3Ler a nota do auditor sem confundi-la com nota do modelo

Objetivo: Criar e ler um patch sem chave, aplicar a mudança revisada no projeto e desfazê-la.

01A maquete da sua casa

O original só muda quando você aplica o patch lido ou confirma uma rodada nova com --aplicar.

Clique em cada bloco do diagrama para ver o que ele faz.

Clique em cada parte para ver sua função.

02Duas ferramentas no kit

Clique em cada etapa para ver o que fazer.

1. caixa.sh

O fluxo cria → roda → destrói usa uma cópia: .env, chaves .pem e ~/.ssh ficam fora. A imagem Docker é o molde da caixa; sem --aplicar, o original fica intacto. Há teto de memória, CPU e tempo.

Com --rede, a caixa ganha acesso à rede. Com --env ANTHROPIC_API_KEY, só essa chave entra. O comando opcional com agente usa sua chave e pode enviar o conteúdo da cópia ao serviço do agente; não foi executado neste curso. --dangerously-skip-permissions desliga as perguntas internas do agente na cópia. Confira o patch antes de aplicar.

No macOS, a caixa.sh também precisa do comando timeout: instale coreutils com brew install coreutils, conforme o README do kit.

03Crie, leia e aplique um patch sem chave

O Docker da aula 6 já deve funcionar. Comece na pasta pessoal e use o caminho completo da caixa.sh; o patch fica em ~. Substitua AAAAMMDD-HHMMSS pelo nome que a caixa imprimir.

Terminal · baixar o kit uma vez
cd ~ && git clone https://github.com/inematds/caixa-do-agente
macOS · requisito do caixa.sh
brew install coreutils
Ubuntu · conferir ferramentas da caixa e do patch
rsync --version
patch --version
# se algum faltar:
sudo apt install -y rsync patch
Terminal · criar nota na cópia, sem chave
cd ~ && ~/caixa-do-agente/caixa.sh ~/intelecto-v2 --imagem python:3.12-slim -- sh -c "echo teste > nota.txt"
Terminal · ler o patch (q sai do less)
less ~/caixa-AAAAMMDD-HHMMSS.patch
Terminal · aplicar o patch lido
cd ~/intelecto-v2 && patch -p1 < ~/caixa-AAAAMMDD-HHMMSS.patch
cat nota.txt
Terminal · desfazer a nota de prova
cd ~/intelecto-v2 && rm nota.txt
Segunda prática · testes na imagem do projeto
cd ~/intelecto-v2
docker build -t intelecto-v2-testes caixa/
cd ~/caixa-do-agente
./caixa.sh ~/intelecto-v2 --imagem intelecto-v2-testes -- python3 -m pytest -q -p no:cacheprovider
Opcional · auditar o projeto
cd ~/caixa-do-agente
python3 auditar.py ~/intelecto-v2
OPCIONAL · exemplo de agente na caixa, não executado neste curso
cd ~/caixa-do-agente
./caixa.sh ~/meu-projeto --rede --env ANTHROPIC_API_KEY -- npx -y @anthropic-ai/claude-code -p "rode os testes" --dangerously-skip-permissions
Exemplo do repositório
▶ 1/3 CRIAR   cópia de ~/intelecto-v2 (sem segredos)
  0 arquivo(s) de segredo ficaram de fora
▶ 2/3 CAIXA   python:3.12-slim · rede desligada · 4g · 2 CPU · 1800s
  saída do comando: 0
▶ 3/3 DESTRUIR
  1 arquivo(s) mudaram dentro da caixa
  patch salvo (o diff de tudo que mudou): ~/caixa-20261113-005926.patch
  container apagado · cópia apagada

Capturada pela sessão principal em 13/11/2026 com o comando da prática rodado a partir de ~. O nome do patch muda a cada execução.

04O que faz o exemplo opcional com agente

Este exemplo do README da caixa-do-agente não foi executado neste curso. Ele usa a sua chave ANTHROPIC_API_KEY e manda a cópia do projeto pela rede ao serviço do agente. Isso pode consumir a sua assinatura ou créditos do serviço.

./caixa.sh ~/meu-projeto copia esse projeto; --rede libera a internet; --env ANTHROPIC_API_KEY põe só essa chave na caixa. Depois de --, npx -y @anthropic-ai/claude-code -p "rode os testes" inicia o agente com esse pedido; --dangerously-skip-permissions remove as perguntas internas na cópia. A caixa gera um patch para você revisar antes de aplicar ao original.

05Faça a prova da maquete

Faça na ordem e marque apenas depois de conferir o resultado.

Faça a mudança e volte ao original

12

Na pasta pessoal, rode o comando sem chave da imagem python:3.12-slim usando ~/caixa-do-agente/caixa.sh. Copie o nome do patch impresso. Abra esse arquivo com less, aperte q para sair; entre em ~/intelecto-v2, aplique com patch -p1, confira com cat nota.txt e desfaça com rm nota.txt.

Pronto quando: O patch lido contém +teste; patch imprime “patching file nota.txt”; cat mostra “teste”; depois de rm, a nota de prova não fica no original.

Rode os testes em outra caixa

8

Em ~/intelecto-v2, crie a imagem intelecto-v2-testes com docker build. Depois, em ~/caixa-do-agente, rode caixa.sh com essa imagem e python3 -m pytest -q -p no:cacheprovider. A bateria bash testes/teste.sh do kit é opcional.

Pronto quando: O pytest mostra seu resumo de testes e a caixa informa quantos arquivos mudaram; compare com a medição documentada, sem exigir os mesmos números.

06Confira se entendeu

Escolha antes de abrir o comentário. Se errar, use o link para rever.

Pergunta 1 de 3

O que é a “maquete” nesta aula?

07Leve desta aula

Cria, roda, destróiA caixa trabalha numa cópia sem .env e chaves, e começa sem rede. Com --rede, o conteúdo da cópia pode ser enviado; os recursos continuam limitados.
Você decideO patch mostra mudanças. patch -p1 aplica o arquivo lido; --aplicar inicia outra rodada e pergunta antes de copiar.
Nota com contextoA nota depende dos programas de agente instalados no computador, não da inteligência do modelo.

Fontes e próximos passos

Guia da caixa-do-agenteCaso no guia do INTELECTO
Aula anteriorPróxima aula