A aprovação decide se um comando começa; o executor caixa decide onde ele roda. Docker usa uma imagem, o molde da caixa, para criar um container isolado. Só a área de trabalho entra em /trabalho, sem rede nem variáveis do terminal (valores com nome, como chaves guardadas nessa sessão). Saída 0 significa que o comando terminou sem erro.
Objetivo: Rodar uma leitura pelo executor caixa e encontrar “[na caixa, saída 0]” na resposta.
01 · Um comando aprovado, um container
A caixa é opcional e vale para cada comando do INTELECTO.
Clique em cada bloco do diagrama para ver o que ele faz.
Clique em cada parte para ver sua função.
02 · O que a caixa alcança
Clique em cada etapa para ver o que fazer.
1. Área de trabalho
Somente ~/.intelecto2/area entra como pasta de trabalho em /trabalho. O cofre, ~/.ssh e outras pastas pessoais não são montados.
2. Rede
O comando Docker usa --network none: uma tarefa que depende da internet não funciona nesse executor. No Ubuntu, instale o pacote docker.io, dê acesso ao usuário e saia da sessão para entrar novamente. No macOS, instale Docker Desktop em docker.com. Confira com hello-world antes da conversa.
3. Recursos
O código define memória, CPU, processos, tempo e saída máxima. Isso reduz o estrago de um erro, mas container não é máquina virtual.
4. Modelo
Ollama responde fora do container. A caixa isola o comando que o assistente executa, não o processo inteiro da conversa.
03 · Ative e prove
Ubuntu: instale o pacote docker.io, entre novamente na sessão e prove com hello-world. No macOS, instale Docker Desktop em docker.com; depois rode o mesmo hello-world. O manual oficial do Docker está nos links extras.
Ubuntu · instalar Docker
sudo apt install -y docker.io
sudo usermod -aG docker $USER
# Saia da sessão e entre novamente antes do teste.
macOS · instalar Docker Desktop
https://www.docker.com/products/docker-desktop/
Terminal · provar Docker após entrar de novo
docker run --rm hello-world
Terminal · preparar a imagem (molde da caixa)
docker pull python:3.12-slim
Terminal · criar arquivo de prova na área
echo oi > ~/.intelecto2/area/teste.txt
Terminal · conversar com executor caixa
cd ~/intelecto-v2
python3 -m intelecto conversar --provedor mock --executor caixa
Na conversa · conferir a área e a caixa
rode: ls /trabalho
rode: pwd
Terminal · ver o registro
python3 -m intelecto auditoria -n 20
Exemplo do repositório
intelecto> Feito. Resultado de rodar_comando: [na caixa, saída 0] /trabalho
Capturada com --executor caixa e cérebro mock. Com um modelo de verdade, o texto em volta muda; procure [na caixa, saída 0] /trabalho.
04 · Prove a caixa
Faça na ordem e marque apenas depois de conferir o resultado.
Veja a etiqueta da saída
6
Com Docker ligado, abra a conversa com --provedor mock --executor caixa e peça “rode: pwd”. O mock chama rodar_comando. Se usar um modelo real, só conte como prova se ele chamar a ferramenta.
Pronto quando: A saída contém “[na caixa, saída 0] /trabalho” numa linha; isso prova que o comando rodou dentro da caixa.
Confira o alcance
5
Antes de comparar, rode no terminal echo oi > ~/.intelecto2/area/teste.txt. Na conversa com executor caixa, peça “rode: ls /trabalho”. Confira também a auditoria. Não copie senhas para a área.
Pronto quando: A resposta de ls /trabalho mostra teste.txt, o arquivo criado na sua área; a auditoria registra o comando.
05 · Confira se entendeu
Escolha antes de abrir o comentário. Se errar, use o link para rever.
Pergunta 1 de 3
Que parte da operação o executor caixa isola?
Correto
O executor é chamado para cada comando. O cérebro e a conversa ficam fora do container.