Tu Jarvis seguro: INTELECTO v2 y caixa-do-agente|INEMA.CLUB-PRO

Clase 7 · 20 min

La caja del agente en tu proyecto

Necesitas Docker instalado en la clase 6; solo las clases 6 y 7 requieren Docker. Aquí, la caja del agente trabaja en una copia del proyecto. Haz un cambio pequeño sin claves, lee el patch y decide si lo aplicas. También aprenderás cómo dejar que los agentes trabajen en una copia, con un ejemplo opcional que no se ejecuta en este curso.

Empezar la clase
Fotografía editorial que representa la caja del agente en tu proyecto.

En esta clase vas a

  1. 1Entender cómo crear, ejecutar y destruir
  2. 2Revisar el patch y aplicarlo conscientemente
  3. 3Leer la nota del auditor sin confundirla con la nota del modelo

Objetivo: Crear y leer un patch sin claves, aplicar el cambio revisado al proyecto y deshacerlo.

01La maqueta de tu casa

El original solo cambia cuando aplicas el patch que leíste o confirmas una nueva ejecución con --aplicar.

Haz clic en cada bloque del diagrama para ver qué hace.

Haz clic en cada parte para ver qué función cumple.

02Dos herramientas del kit

Haz clic en cada etapa para ver qué hacer.

1. caixa.sh

El flujo crear → ejecutar → destruir usa una copia: .env, las claves .pem y ~/.ssh quedan fuera. La imagen Docker es el molde de la caja; sin --aplicar, el original queda intacto. Hay límites de memoria, CPU y tiempo.

Con --rede, la caja obtiene acceso a la red. Con --env ANTHROPIC_API_KEY, solo entra esa clave. El comando opcional con agente usa tu clave y puede enviar el contenido de la copia al servicio del agente; no se ejecutó en este curso. --dangerously-skip-permissions desactiva las preguntas internas del agente en la copia. Revisa el parche antes de aplicarlo.

En macOS, caixa.sh también necesita el comando timeout: instala coreutils con brew install coreutils, como indica el README del kit.

03Crea, lee y aplica un parche sin clave

Docker de la lección 6 ya debería funcionar. Empieza en tu carpeta personal y usa la ruta completa de caixa.sh; el parche queda en ~. Sustituye AAAAMMDD-HHMMSS por el nombre que muestre la caja.

Terminal · descarga el kit una vez
cd ~ && git clone https://github.com/inematds/caixa-do-agente
macOS · requisito de caixa.sh
brew install coreutils
Ubuntu · comprobar las herramientas de la caja y del parche
rsync --version
patch --version
# si falta alguna:
sudo apt install -y rsync patch
Terminal · crear una nota en la copia, sin clave
cd ~ && ~/caixa-do-agente/caixa.sh ~/intelecto-v2 --imagem python:3.12-slim -- sh -c "echo teste > nota.txt"
Terminal · leer el parche (q sale de less)
less ~/caixa-AAAAMMDD-HHMMSS.patch
Terminal · aplicar el parche leído
cd ~/intelecto-v2 && patch -p1 < ~/caixa-AAAAMMDD-HHMMSS.patch
cat nota.txt
Terminal · deshacer la nota de prueba
cd ~/intelecto-v2 && rm nota.txt
Segunda práctica · pruebas en la imagen del proyecto
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 el proyecto
cd ~/caixa-do-agente
python3 auditar.py ~/intelecto-v2
OPCIONAL · ejemplo de agente en la caja, no ejecutado en este 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
Ejemplo del repositorio
▶ 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 por la sesión principal el 13/11/2026 con el comando de la práctica ejecutado desde ~. El nombre del parche cambia en cada ejecución.

El programa muestra esto en portugués, tal cual.

04Qué hace el ejemplo opcional con agente

Este ejemplo del README de caixa-do-agente no se ejecutó en este curso. Usa tu clave ANTHROPIC_API_KEY y envía la copia del proyecto por la red al servicio del agente. Esto puede consumir tu suscripción o créditos del servicio.

./caixa.sh ~/meu-projeto copia ese proyecto; --rede permite el acceso a internet; --env ANTHROPIC_API_KEY pone solo esa clave en la caja. Después de --, npx -y @anthropic-ai/claude-code -p "rode os testes" inicia el agente con ese pedido; --dangerously-skip-permissions elimina las preguntas internas en la copia. La caja genera un parche para que lo revises antes de aplicarlo al original.

05Haz la prueba de la maqueta

Sigue el orden y marca cada punto solo después de comprobar el resultado.

Haz el cambio y vuelve al original

12

En la carpeta personal, ejecuta el comando sin clave de la imagen python:3.12-slim usando ~/caixa-do-agente/caixa.sh. Copia el nombre del parche impreso. Abre ese archivo con less, presiona q para salir; entra en ~/intelecto-v2, aplícalo con patch -p1, comprueba con cat nota.txt y deshazlo con rm nota.txt.

Listo cuando: El parche leído contiene +teste; patch imprime “patching file nota.txt”; cat muestra “teste”; después de rm, la nota de prueba no queda en el original.

Ejecuta las pruebas en otra caja

8

En ~/intelecto-v2, crea la imagen intelecto-v2-testes con docker build. Después, en ~/caixa-do-agente, ejecuta caixa.sh con esa imagen y python3 -m pytest -q -p no:cacheprovider. La batería bash testes/teste.sh del kit es opcional.

Listo cuando: pytest muestra el resumen de tus pruebas y la caja informa cuántos archivos cambiaron; compara con la medición documentada, sin exigir las mismas cifras.

06Comprueba si lo entendiste

Elige antes de abrir el comentario. Si te equivocas, usa el enlace para repasar.

Pregunta 1 de 3

¿Qué es la “maqueta” en esta clase?

07Lo que te llevas de esta clase

Crea, ejecuta, destruyeLa caja trabaja en una copia sin .env ni claves y empieza sin red. Con --rede, el contenido de la copia puede enviarse; los recursos siguen siendo limitados.
Tú decidesEl parche muestra los cambios. patch -p1 aplica el archivo leído; --aplicar inicia otra ronda y pregunta antes de copiar.
Nota con contextoLa nota depende de los programas de agente instalados en la computadora, no de la inteligencia del modelo.

Fuentes y próximos pasos

Guía de caixa-do-agenteCaso en la guía de INTELECTO
Clase anteriorClase siguiente