Clase 02 · Módulo 11
El nodo AI Agent: modelo, memoria y herramientas
El nodo AI Agent: modelo, memoria y herramientas
Qué logras en esta clase
Armas un agente en n8n con sus tres piezas y le escribes instrucciones que limitan lo que hace.
- Conectas modelo, memoria y una herramienta al nodo AI Agent.
- Decides si tu agente necesita memoria y de qué tipo.
- Redactas instrucciones con alcance, límites y salida.
02
Un nodo central y piezas que se le enchufan
El nodo AI Agent no trabaja solo. Es un centro al que le conectas un modelo, una memoria y herramientas.
03
Las tres piezas
| Pieza | Qué aporta | ¿Obligatoria? |
|---|---|---|
| Modelo de chat | El que razona y elige | Sí |
| Herramientas | Lo que el agente puede hacer | Sí, al menos una |
| Memoria | Recordar los mensajes anteriores | No |
n8n llama a esto nodo raíz (el agente) y subnodos (las piezas). Los subnodos se conectan por debajo del agente, no en la línea principal del flujo.
04
Cómo queda dibujado
La primera fila es el flujo de siempre. Las demás son piezas que alimentan al agente. El disparador entrega el texto de la persona; el agente devuelve su respuesta como un ítem más.
05
Ya no se elige «tipo de agente»
Los tutoriales antiguos piden escoger un tipo de agente. Desde la versión 1.82.0 de n8n ese ajuste quedó obsoleto: todos los nodos AI Agent funcionan como agente de herramientas (Tools Agent).
06
Armar el primer agente
- Crea un flujo y agrega un disparador que entregue texto: el de chat de n8n para probar, o el de Telegram del módulo 10.
- Agrega el nodo AI Agent y conéctalo al disparador.
- En su conector de modelo, agrega un modelo de chat con tu credencial (módulo 9).
- En su conector de herramientas, agrega una sola herramienta.
- Ejecuta, escribe un mensaje de prueba y revisa la salida.
07
Elegir el modelo del agente
Los cuatro modelos vigentes de Claude usan herramientas. La diferencia está en el criterio y en el precio.
| Modelo | Cuándo probarlo en un agente |
|---|---|
| Haiku 5.5 | Pocas herramientas y tareas simples; el más barato |
| Sonnet 5.5 | Si Haiku elige mal la herramienta o se enreda |
| Opus 5.5 o Fable 5.2 | Tareas largas con muchos pasos encadenados |
08
Sin memoria, cada mensaje es el primero
El modelo no recuerda nada entre una corrida y otra. La memoria es el historial que n8n vuelve a enviarle en cada mensaje.
09
Cuándo hace falta memoria
- Sí: conversaciones de ida y vuelta, como un bot que pregunta la fecha y después la hora.
- No: tareas de una sola pasada, como «revisa este pedido y dime si está completo».
La memoria se separa con una clave de sesión: un valor distinto por persona, como el identificador del chat de Telegram.
10
Dónde se guarda el historial
| Opción | Dónde vive | Cuándo conviene |
|---|---|---|
| Sin memoria | En ninguna parte | Tareas de una pasada |
| Memoria simple | En la propia instancia | Pruebas y bots chicos |
| Memoria en base de datos | En tu Postgres (módulo 7) | Producción: sobrevive a reinicios |
La lista de memorias y sus nombres cambia entre versiones. Mira las disponibles al pulsar el conector de memoria y confirma en la documentación del nodo.
11
La memoria se paga en cada mensaje
Todo el historial guardado viaja al modelo en cada vuelta. Una conversación de cincuenta mensajes cuesta mucho más en el último que en el primero.
- Limita cuántos mensajes recientes se envían.
- No guardes en la memoria resultados enormes de herramientas.
- Cierra la conversación cuando la tarea termina.
12
Las instrucciones son el contrato
El agente hará lo que las herramientas le permitan. Las instrucciones le dicen qué debe hacer con ellas y dónde parar.
13
Qué debe decir el mensaje de sistema
El mensaje de sistema son las instrucciones fijas que el modelo recibe antes de cada conversación. Para un agente, cubre cinco puntos:
- Rol y objetivo: para quién trabaja y qué resultado se espera.
- Alcance: qué temas atiende y cuáles no.
- Uso de herramientas: cuándo consultar antes de responder.
- Límites: qué nunca hace por su cuenta.
- Salida: idioma, largo y formato de la respuesta.
14
Instrucción vaga contra instrucción acotada
| Vaga | Acotada |
|---|---|
| «Ayuda a los clientes» | «Atiendes consultas de horas de una consulta dental» |
| «Usa la agenda» | «Antes de ofrecer una hora, consulta la agenda; nunca la supongas» |
| «Sé amable» | «Responde en dos frases, en español, sin tecnicismos» |
| (nada) | «Si piden algo fuera de horas, deriva a recepción» |
Cada línea acotada cierra una decisión que el modelo tomaría solo.
15
Dónde se escribe y cómo comprobarlo
El mensaje de sistema, el tope de vueltas y el formato de salida se configuran en los parámetros y opciones del nodo AI Agent.
16
Dile qué hacer cuando no sabe
Un agente sin salida de escape inventa. Escribe en las instrucciones la conducta para tres situaciones:
- Falta un dato: pregunta una sola cosa a la vez.
- La herramienta falla o no devuelve nada: dilo y no completes con suposiciones.
- El pedido queda fuera de alcance: deriva a una persona.
Es la misma rama «no pude» del módulo 9, ahora escrita como instrucción.
17
Leer lo que hizo el agente
Después de cada prueba abre la ejecución y revisa los pasos del agente: qué herramienta llamó, con qué datos y qué recibió.
- Si no llamó ninguna, la instrucción o la descripción de la herramienta no lo empujan a usarla.
- Si llamó varias veces la misma, el resultado no le sirvió.
18
Errores comunes
- Conectar memoria a una tarea de una sola pasada y pagar historial inútil.
- Instrucciones largas que mezclan reglas del negocio con datos que cambian; los datos van en una herramienta.
- Seguir un tutorial de la serie 1.x y buscar un selector de tipo de agente que ya no aplica.
19
Novedad en evolución: agentes reutilizables
Las notas de versión de 2026 anuncian agentes reutilizables, que se crean una vez y se usan desde varios flujos. Están en vista previa.
No bases en ellos un proceso crítico todavía. Revisa su estado en las notas de versión de n8n antes de adoptarlos; lo que aprendes aquí sobre modelo, memoria, herramientas e instrucciones aplica igual.
20
Lo que te llevas
- Un agente en n8n es el nodo AI Agent más un modelo de chat y al menos una herramienta.
- La memoria es opcional, se separa por clave de sesión y se paga en cada mensaje.
- Las instrucciones fijan rol, alcance, uso de herramientas, límites y salida.
- Cada prueba termina leyendo qué herramientas llamó el agente.
21
Hazlo ahora
En quince minutos, arma un agente mínimo en tu n8n.
- Disparador de chat, nodo AI Agent y tu modelo del módulo 9.
- Una sola herramienta de lectura: una hoja de Google Sheets con horarios de un negocio ficticio.
- Escribe instrucciones con los cinco puntos, en menos de diez líneas.
- Hazle tres preguntas: una que la hoja responde, una que no y una fuera de tema.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026