P1 · Las 7 piezas con tus palabras
15 minCopia la tabla de arriba y completa cada fila con una frase tuya y la carpeta donde está la pieza.
Listo cuando: Las siete filas están completas y ninguna frase está copiada del texto de la clase.
Clase 1 · 15 min
Las siete piezas de un Jarvis
Todo agente, del más sencillo al más costoso, tiene las mismas siete piezas: una puerta, un corazón, una identidad, un cerebro, una memoria, manos y una bóveda. Quien conoce las piezas elige mejor, gasta menos y no queda atado a un producto. INTELECTO es nuestro ejemplo: pequeño a propósito, para que puedas leerlo.
Empezar la clase
En esta clase vas a
- 1El recorrido de un mensaje, de Telegram al modelo y de vuelta
- 2Qué hace cada una de las siete piezas
- 3Por qué el bucle con freno diferencia a un agente de un chatbot
- 4Cómo los contratos permiten cambiar una pieza sin tocar el resto
Objetivo: explicar el recorrido de un mensaje y decir qué hace cada una de las siete piezas y dónde está en INTELECTO.
01Siete piezas, un camino
Desplázate por la página: cada etapa ilumina una pieza.
Desplázate por la página: cada etapa de abajo ilumina su parte del diagrama.
- 1/8
Canal
Es por donde conversas. En INTELECTO es Telegram: un token y listo, sin una dirección pública en internet. El agente le pregunta a Telegram si llegó un mensaje nuevo, divide las respuestas de más de 4 mil caracteres y muestra el estado «escribiendo» mientras piensa.
- 2/8
Bucle
Recibe el mensaje, piensa, usa una herramienta si hace falta, revisa el resultado y vuelve a pensar, hasta responder con texto. Tiene un freno: como máximo cinco rondas de herramientas por mensaje. Si supera ese límite, tiene que responder.
- 3/8
Identidad
Cuatro archivos simples en la carpeta workspace: el alma, las reglas, tu perfil y los datos iniciales. En cada mensaje, el agente lee los cuatro. Si cambia el texto, cambia el asistente, sin programar.
- 4/8
Cerebro
El modelo de IA. En la nube, OpenRouter: una clave da acceso a más de cien modelos. En tu computadora, Ollama: sin costo por mensaje y sin enviar nada fuera de ella.
- 5/8
Memoria
Guarda lo importante en una base de datos SQLite en tu máquina, con búsqueda por palabras y sin costo de API. En cada mensaje busca lo relevante y lo añade al contexto.
- 6/8
Herramientas
Sin herramientas, solo conversa; con ellas, hace cosas. En el núcleo: leer y escribir archivos, listar carpetas, ejecutar comandos, guardar y buscar en la memoria. Cada herramienta se describe por sí sola, y el modelo lee esa descripción para decidir si la usa.
- 7/8
Bóveda
Claves de API cifradas y vinculadas a la máquina, lista de comandos prohibidos, límite de 60 segundos por comando y un registro de auditoría con todo lo que ejecutó.
- 8/8
Todo el camino
Escribes en Telegram. El bucle reúne la identidad y la memoria, envía el mensaje al modelo, ejecuta la herramienta que este solicite dentro de los límites de la bóveda, y la respuesta vuelve por el mismo canal.
Las mismas siete piezas aparecen en INTELECTO, en OpenClaw, en Hermes o en un Jarvis hecho por ti.
02Tres ideas que mantienen unidas las piezas
Haz clic en cada pestaña.
1. Un solo responsable
INTELECTO es un asistente personal para una sola persona. No admite varios usuarios, no depende de la nube, no necesita Docker, no tiene panel web y no es una caja negra.
El plan prevé unas tres mil líneas y siete dependencias: se puede leer.
Prueba de la caja negra
¿Puedo explicar qué pasa entre mi mensaje y la respuesta? Si no, es una caja negra.
2. Bucle con freno
Un chatbot responde y olvida. Un agente piensa, actúa con una herramienta, observa el resultado y vuelve a pensar.
Sin un límite, un agente puede quedarse dando vueltas y gastar recursos sin terminar. Por eso está el freno de cinco rondas.
Regla del bucle
Máximo 5 rondas de herramientas por mensaje; después, responder con texto.
3. Contratos
Cada pieza se define con un contrato: el canal tiene iniciar, enviar y detener; el proveedor recibe la conversación y las herramientas y devuelve la respuesta.
¿Quieres WhatsApp en lugar de Telegram, u Ollama en lugar de OpenRouter? Es otro archivo con el mismo contrato.
En la práctica
Nueva herramienta = archivo nuevo con el mismo modelo. El registro la encuentra automáticamente, sin tocar el núcleo.
4. Empieza en pequeño
La guía de funciones organiza todo en ocho áreas: identidad, seguridad, canales, memoria, automatización, integraciones, skills y arquitectura.
No necesitas todo. La programación de tareas y la búsqueda web, por ejemplo, están en el plan para la próxima fase.
Montaje mínimo
Bucle + un cerebro + un canal + un SOUL básico. La memoria se agrega enseguida.
03Dónde vive cada pieza
El árbol del núcleo que el agente construye en el ejemplo del repositorio.
exemplo-jarvis · carpetas
jarvis/ channels/ # la puerta: terminal y Telegram agent/ # el corazón: loop.py y context.py providers/ # el cerebro: contrato + modelo de prueba memory/ # la memoria: SQLite con búsqueda tools/ # las manos: archivos, comando, memoria security/ # la bóveda: secretos y lista de bloqueo workspace/ SOUL.md AGENTS.md USER.md MEMORY.md # la identidad
Mi tabla de las 7 piezas
| Pieza | Qué hace (con mis palabras) | Dónde está | |-------------|-----------------------------|------------| | Canal | | | | Bucle | | | | Identidad | | | | Cerebro | | | | Memoria | | | | Herramientas| | | | Bóveda | | |
Ejemplo del repositorio
- Escribes en Telegram.
- El canal recibe el mensaje y se lo entrega al bucle.
- El bucle arma el contexto: SOUL + AGENTS + USER y las memorias relevantes.
- El modelo responde o pide una herramienta; el bucle la ejecuta y devuelve el resultado (hasta 5 rondas).
- La respuesta vuelve por el canal.
Chatbot: responde, olvida cuando termina la conversación, no tiene identidad, no actúa, no te conoce.
Jarvis: recuerda conversaciones pasadas, tiene nombre y valores por escrito, usa herramientas y conoce tu contexto.
04Práctica: identifica las piezas
Antes de construir, entiende qué vas a construir.
P2 · Explica el recorrido en voz alta
5 minExplícale a alguien (o graba un audio) el recorrido de un mensaje desde Telegram hasta la respuesta.
Listo cuando: Mencionaste canal, bucle, identidad, memoria, modelo y herramienta en el orden correcto, sin mirar.
05Las siete piezas en video
Nei muestra INTELECTO pieza por pieza.
INTELECTO: las 7 piezas de un agente de IA · 7 min 46 sPágina del video con guion →
06Pon a prueba lo que aprendiste
La explicación aparece después de tu respuesta.
Pregunta 1 de 4
¿Qué hace que un agente deje de ser solo un chatbot?competencia
Correcto
El bucle transforma la conversación en acción. El modelo puede ser el mismo; lo que cambia es que puede usar herramientas y mirar el resultado antes de responder.No es esa
El bucle transforma la conversación en acción. El modelo puede ser el mismo; lo que cambia es que puede usar herramientas y mirar el resultado antes de responder.Repasar: Tres ideas que mantienen unidas las piezasPregunta 2 de 4
¿Para qué sirve el límite de cinco rondas con herramientas?
Correcto
El límite obliga al agente a responder después de cinco rondas. Un bucle corto, legible y con un límite es lo que separa a un agente útil de uno que gasta sin parar.No es esa
El límite obliga al agente a responder después de cinco rondas. Un bucle corto, legible y con un límite es lo que separa a un agente útil de uno que gasta sin parar.Repasar: Siete piezas, un caminoPregunta 3 de 4
Quieres cambiar Telegram por WhatsApp. ¿Qué cambia?
Correcto
Cada pieza tiene un contrato. Un canal nuevo implementa las mismas tres funciones y el bucle ni nota el cambio.No es esa
Cada pieza tiene un contrato. Un canal nuevo implementa las mismas tres funciones y el bucle ni nota el cambio.Repasar: Tres ideas que mantienen unidas las piezasPregunta 4 de 4
¿Dónde está la personalidad del asistente?
Correcto
SOUL, AGENTS, USER y MEMORY son texto simple. El agente lee los cuatro en cada mensaje: si cambia el texto, cambia el asistente.No es esa
SOUL, AGENTS, USER y MEMORY son texto simple. El agente lee los cuatro en cada mensaje: si cambia el texto, cambia el asistente.Repasar: Dónde vive cada piezaPrueba completada
Acertaste {a} de {n}. Si aciertas todas, la clase se marca como completada.Elige una opción. La explicación aparece después de tu intento.