Herramientasn8n
n8n agentes de IA: configura tu primer agente
n8n agentes de IA: configura un primer agente con modelo y herramientas, prueba un caso de marketing y aprende a controlar errores y permisos.
- Autor: humAIns
- 9 min de lectura
índice · 7 apartados
Un agente de IA en n8n combina el nodo AI Agent, un modelo de chat y al menos una herramienta que el modelo puede elegir usar. Aquí montarás un asistente de consulta para datos ficticios de campañas: podrá leer resultados y resumirlos, pero no crear anuncios ni cambiar presupuestos. Esa diferencia entre decidir qué herramienta consultar y seguir una lista fija de pasos es lo que distingue este ejemplo de una automatización convencional.
Si aún estás empezando, primero puedes ver qué es n8n; aquí nos centramos en configurar, probar y limitar un agente concreto.
Antes de construir: delimita el caso
Elige una pregunta acotada que pueda responderse con una tabla de prueba, por ejemplo: «¿Qué campaña tuvo más clics la semana pasada y qué dato falta para comparar el coste?». Crea una hoja con filas inventadas y columnas sencillas: campaña, impresiones, clics y gasto_eur. No cargues datos personales, datos de clientes ni credenciales en el prompt.
Necesitarás una instancia de n8n (en la nube o autoalojada), acceso para editar workflows y credenciales válidas para el modelo y la herramienta elegidos. Guarda las credenciales en el gestor de credenciales de n8n; no las escribas en el texto de instrucciones ni las pegues en capturas o registros compartidos. Configura la conexión a la hoja con el alcance mínimo necesario y, para esta prueba, solo lectura.
La documentación actual de n8n explica que el nodo AI Agent funciona como un Tools Agent y que requiere conectar al menos una herramienta. El ajuste antiguo de tipo de agente está obsoleto. Comprueba la versión de tu instancia si la interfaz no coincide con las instrucciones.
Configura el primer agente paso a paso
1. Añade el disparador de chat
Crea un workflow y busca el nodo Chat Trigger. Este nodo recibe el mensaje de quien conversa con el agente. Para una primera prueba, déjalo accesible solo desde el entorno de test o de desarrollo que controlas; no publiques un endpoint abierto con datos reales.
2. Conecta el AI Agent
Añade AI Agent y conecta la salida del Chat Trigger a su entrada principal. En el agente, escribe instrucciones concretas: qué tarea hace, qué fuente puede consultar, qué debe responder cuando falten datos y qué acciones tiene prohibidas.
3. Añade un modelo de chat
Desde la conexión de modelo del AI Agent, añade el subnodo Chat Model compatible con el proveedor que hayas configurado. El nombre exacto del nodo y los campos disponibles pueden variar según el proveedor y la versión. Selecciona las credenciales guardadas en n8n y comprueba que el modelo responde a una consulta de prueba. Si no aparece o falla la autenticación, revisa la disponibilidad del modelo y sus permisos en la documentación del proveedor; no sustituyas el error por una clave pegada en el workflow.
4. Conecta una herramienta de solo lectura
Añade una herramienta como Google Sheets Tool para consultar la tabla ficticia y conéctala a la entrada de herramientas del AI Agent. Configura la operación para leer las filas o buscar los datos necesarios, no para añadir o modificar registros. Si prefieres probar primero sin conectar una cuenta externa, la herramienta Calculator sirve para comprobar cálculos matemáticos, pero no puede consultar tus campañas: para el ejemplo de hoja hace falta una herramienta que lea esa fuente.
Las herramientas aparecen como subnodos y el agente puede decidir si invocarlas. Comprueba en la ejecución que la herramienta conectada recibió la consulta correcta y devolvió los campos esperados. No des por hecho que mencionar una hoja en el prompt la conecta: la conexión y sus permisos se configuran en el nodo.
5. Añade memoria solo si hay una necesidad
La memoria es opcional. Para responder cada pregunta de forma independiente sobre una tabla, empieza sin ella. Si necesitas que el chat recuerde una aclaración previa, conecta un subnodo de memoria compatible y define qué identificador de sesión separa las conversaciones. La memoria puede persistir o no entre ejecuciones según el componente y su configuración; prueba su comportamiento y evita almacenar información sensible innecesaria.
Ejemplo: consultar una hoja de campañas
En la hoja ficticia, añade tres filas: «Lanzamiento A», «Newsletter B» y «Webinar C», con impresiones, clics y gasto inventados. Pregunta por el mayor número de clics y solicita que el agente compare solo los valores presentes en la hoja.
Puedes empezar con estas instrucciones en el campo de sistema del AI Agent:
Después, ejecuta el workflow en modo de prueba y pregunta: «¿Qué campaña tiene más clics? Indica los clics y las impresiones que has consultado». Verifica en el registro de ejecución el mensaje entrante, la decisión del agente, la llamada al subnodo de Google Sheets y su salida. Compara manualmente la respuesta con las filas. Haz una segunda pregunta sobre una columna inexistente: el resultado correcto debe señalar que falta el dato, no inventarlo.
Un resultado convincente no demuestra que el agente siempre sea fiable. Repite la prueba con filas vacías, nombres parecidos y una pregunta que no pertenezca al caso. Guarda ejemplos de entradas y salidas esperadas para poder repetir la comprobación cuando cambies el prompt, la conexión o el modelo.
Pruebas y errores frecuentes
| Síntoma | Qué revisar | Prueba segura |
|---|---|---|
| El modelo no aparece o la ejecución falla al iniciarlo | Nodo Chat Model, credencial seleccionada, permisos y disponibilidad del modelo en el proveedor | Prueba una pregunta inocua y revisa el detalle del error sin compartir secretos |
| El agente no consulta la hoja | Conexión del AI Agent al subnodo de herramienta, configuración de lectura y credencial | Usa una hoja ficticia con una sola fila identificable |
| La herramienta devuelve error de permisos | Cuenta conectada, acceso al archivo y alcance asignado | Comparte solo la hoja de prueba y confirma que puede leerla, no editarla |
| La respuesta inventa un valor | Instrucción sobre datos ausentes, nombre de columnas y salida real de la herramienta | Pregunta por una columna que no existe y exige que indique la ausencia |
| El agente intenta resolver una tarea ajena | Alcance del prompt y herramientas disponibles | Pregunta algo fuera del caso; el agente debe reconocer el límite y detenerse |
Mantén fuera del primer prototipo cualquier herramienta que envíe correos, publique anuncios, cambie presupuestos o borre información. Si en una fase posterior incorporas acciones, añade una aprobación explícita antes de ejecutarlas y registra quién la autoriza. Limitar las herramientas disponibles es más fiable que confiar únicamente en una frase de «no lo hagas» dentro del prompt.
Costes, privacidad y límites
El coste total puede combinar el plan o alojamiento de n8n, el uso del modelo y los servicios conectados, como una plataforma de hojas de cálculo. La página oficial de planes de n8n describe precios y límites vigentes; revísala al decidir, ya que pueden cambiar. Si autoalojas, considera también infraestructura, mantenimiento, actualizaciones y copias de seguridad. El proveedor del modelo puede aplicar sus propias condiciones y costes, independientes de n8n.
Antes de usar información de trabajo, revisa qué datos salen de tu instancia hacia el proveedor del modelo y los términos aplicables a tu cuenta. Usa datos ficticios para aprender, concede permisos mínimos y limita el acceso a las ejecuciones y credenciales. Que el workflow se ejecute en tu infraestructura no significa que todos los servicios conectados procesen los datos allí.
Un AI Agent no es la opción adecuada para cada tarea. Si el proceso siempre sigue las mismas reglas, un workflow determinista suele ser más fácil de probar. Para entender cuándo conviene uno u otro enfoque, consulta crear agentes de IA y decide qué automatizar primero. Si quieres aplicar IA a procesos de marketing con criterio práctico, conoce la formación en IA para marketing; no necesitas ese curso para seguir estos pasos ni se presupone que cubra este nodo específico.
Preguntas frecuentes
¿Necesito programar para crear un agente en n8n?
No para un prototipo basado en nodos visuales y conectores configurables. Puede hacer falta más conocimiento técnico si necesitas integrar un servicio sin nodo adecuado, transformar datos complejos o administrar la instancia. Empieza con una herramienta documentada y un caso pequeño antes de introducir código.
¿Qué diferencia hay entre AI Agent y un workflow?
El workflow define el recorrido: qué nodo sigue a cuál y qué condiciones se aplican. El AI Agent puede elegir qué herramienta invocar para cumplir el objetivo, entre las que has conectado. En este tutorial, el disparador y la herramienta forman parte de un workflow, mientras que la decisión de consultar la hoja para responder la toma el agente.
¿Es necesaria la memoria?
No. Añádela únicamente si el agente tiene que conservar contexto útil entre mensajes. Decide qué contexto guardar, cómo se identifica una sesión y cuánto dura; comprueba con una nueva ejecución si se mantiene o se reinicia.
¿Qué costes adicionales pueden aparecer?
Además del plan o alojamiento de n8n, puede haber cargos del proveedor del modelo y de servicios externos. Comprueba el consumo y las condiciones de cada cuenta antes de pasar de datos de prueba a uso habitual.
Fuentes oficiales
- Nodo AI Agent de n8n: función, conexión obligatoria de herramientas y cambios del nodo.
- Documentación de IA de n8n: conceptos de agentes, herramientas, memoria y workflows.
- Planes y precios de n8n: consulta las condiciones actuales antes de presupuestar.