1 / 14
← Inicio

🤖 AI Agents en n8n

Automatización inteligente que piensa por ti

Un AI Agent es un sistema de IA que puede razonar, planificar y ejecutar acciones de forma autónoma para lograr un objetivo.

No es solo "preguntar a ChatGPT"... es darle herramientas y dejar que decida cuándo y cómo usarlas.

🧠
🛠️
Herramientas
💾
Memoria
🎯
Objetivos
🔄
Razonamiento

LLM vs AI Agent

¿Cuál es la diferencia?

Aspecto 🗣️ LLM Simple 🤖 AI Agent
Capacidad Responde preguntas Ejecuta tareas completas
Herramientas ❌ No puede usar ✅ Usa APIs, DBs, etc.
Memoria Solo la conversación Corto y largo plazo
Planificación Respuesta directa Divide tareas, itera
Autonomía Espera tu input Decide y actúa solo

💡 En n8n: Usamos el nodo AI Agent para crear agentes que pueden llamar a otras APIs, consultar bases de datos, enviar emails, y mucho más - todo de forma autónoma.

🧩 Anatomía de un AI Agent

Los 4 componentes esenciales

🧠
1. LLM (Cerebro)
El modelo de lenguaje que razona y decide. En n8n: OpenAI, Claude, Gemini, Ollama, etc.
🛠️
2. Tools (Herramientas)
Funciones que el agente puede invocar: APIs, bases de datos, calculadoras, búsquedas.
💾
3. Memory (Memoria)
Contexto de la conversación y conocimiento previo. Buffer, Window, Summary, Vector Store.
📋
4. Prompt (Instrucciones)
Define la personalidad, restricciones y objetivo del agente. El "System Prompt" es clave.

🎯 En n8n se configura así:

AI Agent Node → Conectas: Chat Model + Tools + Memory (opcional) + System Prompt

🛠️ Tools: Las Manos del Agente

Herramientas que el agente puede usar

🔧
HTTP Request Tool
Llama a cualquier API REST. El agente decide cuándo necesita datos externos y hace la petición.
🗄️
Database Tool
Consulta y modifica bases de datos. PostgreSQL, MySQL, MongoDB - el agente genera las queries.
📧
Email Tool
Envía emails cuando el agente lo considera necesario. Gmail, SMTP, cualquier servicio.
🔍
Search Tool
Busca en internet (Serper, Google). Útil para información actualizada en tiempo real.
📊
Calculator Tool
Operaciones matemáticas precisas. Los LLMs son malos con matemáticas, esta tool los salva.
🔗
Custom Tool (Workflow)
¡Crea tu propia herramienta! Cualquier subworkflow de n8n puede ser una tool para el agente.

💡 Pro Tip: Describe bien cada tool con un nombre claro y descripción. El agente lee esto para decidir cuál usar.

📞 Function Calling

Cómo el LLM "llama" a tus herramientas

🔄 El Proceso
Function Calling es la capacidad del LLM de generar JSON estructurado para invocar funciones específicas.
1. Defines la herramienta
{
  "name": "get_weather",
  "description": "Obtiene el clima actual de una ciudad",
  "parameters": {
    "city": "string - nombre de la ciudad",
    "units": "string - celsius o fahrenheit"
  }
}
2. Usuario pregunta
"¿Qué clima hace en Madrid?"
3. LLM decide llamar la función
{
  "function": "get_weather",
  "arguments": {
    "city": "Madrid",
    "units": "celsius"
  }
}
4. n8n ejecuta y devuelve resultado
{ "temp": 22, "condition": "soleado", "humidity": 45 }
5. LLM genera respuesta final
"En Madrid hace 22°C con cielo soleado y 45% de humedad."

💾 Tipos de Memoria en Agentes

Cómo el agente recuerda

📝
Buffer Memory

Guarda los últimos N mensajes de la conversación. Simple pero efectivo para chats cortos.

Últimos 10 mensajes
🪟
Window Memory

Similar a Buffer pero con límite de tokens. Ideal para no exceder el contexto del LLM.

Máx 4000 tokens
📊
Summary Memory

Resume conversaciones largas. El LLM genera un resumen cuando se llena el buffer.

Resumen + Últimos 5
🧠 Vector Store Memory (Avanzado)
Guarda información en una base de datos vectorial (Pinecone, Qdrant, Supabase). Busca por similitud semántica, no solo por orden cronológico. Perfecto para memoria a largo plazo.

💡 En n8n: Conecta el nodo de memoria al AI Agent. Puedes usar Redis, PostgreSQL o archivos para persistir la memoria entre sesiones.

🔄 El Patrón ReAct

Reasoning + Acting = ReAct

ReAct es el patrón que usan los agentes para resolver problemas complejos: Razonan sobre qué hacer, Actúan ejecutando una tool, y Observan el resultado.

🤔 Think
Act
👀 Observe
🔄 Repeat
📝 Ejemplo de ReAct
Usuario pregunta
"¿Cuál es el precio de Bitcoin y cuánto vale mi 0.5 BTC?"
Thought 1
Necesito obtener el precio actual de Bitcoin. Usaré la API tool.
Action 1
call_api(endpoint="coingecko/bitcoin/price")
Observation 1
{"price_usd": 67500}
Thought 2
Tengo el precio. Ahora calculo: 0.5 × 67500 = ?
Action 2
calculator(operation="0.5 * 67500")
Final Answer
Bitcoin está a $67,500 USD. Tus 0.5 BTC valen $33,750 USD.

📋 System Prompt para Agentes

Define la personalidad y reglas del agente

System Prompt Ejemplo
Eres un asistente de soporte técnico para una empresa de software.

Tu rol:
- Ayudar a clientes con problemas técnicos
- Buscar en la documentación antes de responder
- Crear tickets de soporte cuando sea necesario

Reglas:
- SIEMPRE busca en la documentación antes de inventar respuestas
- Si no encuentras la solución, crea un ticket y avisa al cliente
- Responde en español de forma amigable
- Nunca compartas información confidencial

Herramientas disponibles:
- search_docs: Busca en la documentación
- create_ticket: Crea un ticket de soporte
- get_user_info: Obtiene información del cliente

💡 Pro Tip: Sé específico con las instrucciones. Incluye ejemplos de cuándo usar cada herramienta y qué NO debe hacer el agente.

⚠️ Cuidado con:

• Prompts muy vagos ("sé útil")
• No definir límites claros
• Dar acceso a herramientas sin restricciones
• Olvidar manejar errores de las tools

⚙️ Configurando AI Agent en n8n

Paso a paso

1️⃣ Agregar el nodo AI Agent
Busca "AI Agent" en los nodos. Es el cerebro de tu sistema.
2️⃣ Conectar el Chat Model
Conecta OpenAI, Claude, Gemini u Ollama. Este es el LLM que razonará.
Recomendación
OpenAI GPT-4o o Claude 3.5 Sonnet para mejor razonamiento
GPT-3.5 o Claude Haiku para tareas simples (más rápido y barato)
3️⃣ Agregar Tools
Conecta las herramientas que necesite tu agente. Cada tool es un nodo separado.
4️⃣ Configurar Memory (Opcional)
Si necesitas que recuerde conversaciones previas, conecta un nodo de memoria.
5️⃣ Escribir el System Prompt
Define las instrucciones, personalidad y límites en el campo "System Message".

✅ Checklist antes de activar:

□ ¿Las tools tienen descripciones claras?
□ ¿El system prompt define límites?
□ ¿Hay manejo de errores?
□ ¿Limité el número máximo de iteraciones?

💼 Casos de Uso Reales

¿Para qué usar AI Agents?

🎫
Soporte al Cliente

Responde preguntas, busca en docs, crea tickets, escala a humanos cuando es necesario.

📊
Analista de Datos

Consulta bases de datos, genera reportes, responde preguntas sobre métricas.

📝
Asistente Personal

Gestiona calendario, envía emails, busca información, toma notas.

🛒
E-commerce Bot

Recomienda productos, procesa pedidos, consulta inventario, maneja devoluciones.

🔍
Investigador

Busca en web, resume artículos, compara información de múltiples fuentes.

💻
DevOps Assistant

Monitorea logs, ejecuta comandos, diagnostica problemas, envía alertas.

🔧 Ejemplo: Agente Multi-Tool

Un agente con varias herramientas

System Prompt
Eres un asistente de ventas para TechStore.

Herramientas disponibles:
search_products: Busca productos en el catálogo
check_inventory: Verifica stock disponible
get_customer: Obtiene datos del cliente por email
create_order: Crea un nuevo pedido
send_email: Envía confirmación al cliente
Conversación ejemplo
Usuario: "Quiero comprar un iPhone 15, soy juan@email.com"

Agente (piensa): Necesito buscar el producto y verificar datos del cliente.

→ Llama: search_products("iPhone 15") 
← Resultado: {id: 123, name: "iPhone 15 128GB", price: 999}

→ Llama: get_customer("juan@email.com")
← Resultado: {name: "Juan García", address: "Calle 123..."}

→ Llama: check_inventory(product_id: 123)
← Resultado: {stock: 5, available: true}

Agente: "¡Perfecto Juan! El iPhone 15 está disponible a $999. 
        ¿Confirmo el pedido a tu dirección registrada?"

Usuario: "Sí, confírmalo"

→ Llama: create_order({customer: "juan@email.com", product: 123})
← Resultado: {order_id: "ORD-789", status: "confirmed"}

→ Llama: send_email({to: "juan@email.com", subject: "Pedido confirmado"...})

Agente: "✅ Pedido ORD-789 creado. Te envié la confirmación por email."

⚠️ Errores Comunes con Agentes

Y cómo evitarlos

❌ Error 1: Loops Infinitos
El agente sigue llamando tools sin llegar a una respuesta final.
Solución
- Configura "Max Iterations" (ej: 10)
- Mejora el system prompt con instrucciones de cuándo parar
- Agrega una tool de "finish" que el agente llame al terminar
❌ Error 2: Tool Equivocada
El agente elige la herramienta incorrecta para la tarea.
Solución
- Mejora las descripciones de cada tool
- Sé más específico: "Usa SOLO para consultas de precio"
- Agrega ejemplos en el system prompt
❌ Error 3: Alucinaciones
El agente inventa información en lugar de usar las tools.
Solución
- "NUNCA inventes datos, SIEMPRE usa las herramientas"
- "Si no tienes la información, di que no la tienes"
- Usa modelos más capaces (GPT-4 > GPT-3.5)
❌ Error 4: Costos Elevados
Muchas iteraciones = muchos tokens = mucho dinero.
Solución
- Limita iteraciones máximas
- Usa modelos más baratos para tareas simples
- Implementa caché para respuestas repetidas

✅ Best Practices para Agentes

Consejos de un PRO

🎯
1. Un objetivo claro
Define exactamente qué debe lograr el agente. Agentes generalistas son menos efectivos.
📝
2. Tools bien descritas
Nombre claro + descripción detallada + ejemplos de uso. El agente lee esto para decidir.
🔒
3. Límites y guardrails
Define qué NO puede hacer. Max iteraciones, validaciones, y escalación a humanos.
🧪
4. Testea edge cases
¿Qué pasa si la API falla? ¿Si el usuario pregunta algo fuera de contexto?
📊
5. Monitorea y mejora
Revisa las conversaciones reales. Ajusta prompts basado en errores comunes.
💰
6. Optimiza costos
Caché de respuestas, límites de tokens, modelos apropiados para cada tarea.

💡 Regla de Oro: Empieza simple. Un agente con 2-3 tools bien configuradas es mejor que uno con 10 tools mal descritas.

🧠 Quiz Final

¡Demuestra que dominas los AI Agents!

¿Cuál es la principal diferencia entre un LLM simple y un AI Agent?
A) El Agent es más inteligente
B) El Agent puede usar herramientas y ejecutar acciones
C) El Agent es más rápido
D) No hay diferencia real
En el patrón ReAct, ¿cuál es el orden correcto del ciclo?
A) Act → Think → Observe
B) Observe → Act → Think
C) Think → Act → Observe
D) Think → Observe → Act
¿Qué tipo de memoria usarías para un chatbot que necesita recordar información de hace semanas?
A) Buffer Memory
B) Window Memory
C) Vector Store Memory
D) No necesita memoria
Tu agente está entrando en un loop infinito llamando tools sin parar. ¿Cuál es la mejor solución?
A) Usar un modelo más inteligente
B) Configurar Max Iterations y mejorar el prompt
C) Agregar más tools
D) Eliminar la memoria
¿Qué información debe incluir una buena descripción de Tool?
A) Solo el nombre de la función
B) El código fuente de la tool
C) Nombre claro, qué hace, cuándo usarla y parámetros
D) Solo los parámetros requeridos