Chuleta completa de nodos n8n todas las herramientas y trucos del AI Agent

Lo que hay dentro, de principio a fin

Estructura general de un nodo n8n anatomía del JSON

Todo nodo es un objeto JSON con las mismas claves de primer nivel, da igual si dispara un trigger, procesa datos, anota o se conecta a un servicio externo.

Campos de primer nivel:

• id: identificador único (un UUID normalmente). No puede repetirse dentro del mismo workflow.
• name: etiqueta legible. Ejemplos: "When Chat Message Received", "Airtable - Update Records".
• type: define la funcionalidad del nodo. Ejemplos:
• "@n8n/n8n-nodes-langchain.chatTrigger" para disparadores de chat.
• "n8n-nodes-base.stickyNote" para anotaciones.
• Cada herramienta usa su propio identificador.
• typeVersión: versión del esquema (1, 1.1, 1.7...). Versiones altas añaden parámetros.
• position: array [x, y] que coloca el nodo en el lienzo visual.
• parameters: objeto anidado con la configuración propia del nodo (acciones, credenciales, textos, etc.).

Buenas prácticas:

• Nombres descriptivos y posiciones ordenadas para mantener el workflow legible.
• Usa el lenguaje de expresiones de n8n (por ejemplo ={{ $json["campo"] }}) para contenido dinámico.
• Pasa el JSON por un linter para cazar comillas mal puestas, comas colgantes o tipos incorrectos.

Chat Trigger la puerta de entrada del chat

Nodo @n8n/n8n-nodes-langchain.chatTrigger. Escucha mensajes entrantes por webhook o por el widget de chat incrustado. Sirve como punto de partida de los flujos conversacionales.

Parámetros clave:

• webhookId: identificador único que enlaza el nodo con su endpoint.
• mode: normalmente "webhook" para indicar recepción por eventos.
• public (booleano): abre el endpoint a acceso público. Combínalo con allowedOrigins seguros.
• initialMessages: saludo o instrucciones previas (admite Markdown y expresiones).
• options: ajustes avanzados:
• responseMode: cómo se devuelven las respuestas (por ejemplo "responseNode").
• allowedOrigins: dominios autorizados a llamar al endpoint.
• title/subtitle: textos de la interfaz.
• allowFileUploads: activa o desactiva el envío de ficheros.
• loadPreviousSessión: gestiona la persistencia de la sesión (por ejemplo "memory").

Distintas typeVersion (1 frente a 1.1) ofrecen parámetros diferentes: revisa la documentación cuando subas de versión.

Sticky Note documentación dentro del workflow

Nodo n8n-nodes-base.stickyNote. Sirve para anotar, recordar y documentar dentro del propio flujo. No mueve datos, solo aporta contexto visual.

Parámetros:

• content: texto a mostrar. Admite Markdown para encabezados, listas, bloques de código, enlaces e imágenes.
• width y height: tamaño del recuadro en el lienzo.
• color (opcional): código numérico para fijar el color de fondo y distinguir notas.

Consejos de uso:

• Coloca la nota junto a los nodos a los que se refiere.
• Markdown limpio y conciso.
• Actualiza la nota cuando cambie el workflow.

AI Agent el cerebro del flujo conversacional

Nodo n8n-nodes-langchain.agent. Procesa lo que escribe el usuario y genera respuestas contextuales invocando herramientas según el contexto y la memoria.

Parámetros clave:

• text: entrada principal, casi siempre dinámica, por ejemplo ={{ $json.chatInput }}.
• options: contiene un systemMessage detallado que:
• Define el rol y el comportamiento del agente.
• Marca las pautas para gestionar memoria y llamar a herramientas.
• Puede añadir instrucciones de formato para las respuestas.
• promptType: normalmente "define", que obliga a respetar las reglas del system message.

Integración y memoria:

• Se conecta por puertos ai_tool, ai_memory y ai_languageModel.
• Habitualmente se empareja con nodos de memoria tipo memoryBufferWindow para aportar historial.

Ejemplo mínimo de AI Agent:

{
  "id": "agent-1",
  "name": "AI Agent for Chat",
  "type": "@n8n/n8n-nodes-langchain.agent",
  "position": [100, 100],
  "parameters": {
      "text": "={{ $json.chatInput }}",
      "options": { "systemMessage": "=Eres un asistente útil." },
      "promptType": "define"
  },
  "typeVersion": 1.7
}

AI Agent con integración de Calendar:

{
  "id": "agent-2",
  "name": "Calendar AI Agent",
  "type": "@n8n/n8n-nodes-langchain.agent",
  "position": [200, 200],
  "parameters": {
      "text": "={{ $json.chatInput }}",
      "options": { "systemMessage": "=Eres un asistente de Google Calendar. Pide los datos del evento antes de crearlo." },
      "promptType": "define"
  },
  "typeVersion": 1.7
}

AI Agent con memoria:

{
  "id": "agent-3",
  "name": "AI Agent with Memory",
  "type": "@n8n/n8n-nodes-langchain.agent",
  "position": [300, 300],
  "parameters": {
      "text": "={{ $json.chatInput }}",
      "options": { "systemMessage": "=Usa la memoria a largo plazo para responder con contexto." },
      "promptType": "define"
  },
  "typeVersion": 1.7
}

Memory Buffer la memoria del agente

Nodo n8n-nodes-langchain.memoryBufferWindow. Guarda el historial temporal de la conversación.

Parámetros:

• sessionKey: identificador de la sesión (admite expresiones dinámicas).
• contextWindowLength: número de mensajes que se conservan dentro de la ventana de contexto.

Consejos:

• Ajusta contextWindowLength según la complejidad de la conversación.
• Mantén sessionKey estable para que la memoria no se rompa entre turnos.

Herramientas de integración una a una

Repaso de cada integración habitual y sus matices concretos.

06.1. Pinecone

Base de datos vectorial para indexar, insertar y consultar vectores.

Operaciones clave:

• Crear y actualizar índices: define nombre, dimensión y métrica.
• Insertar vectores (upsert): mapea campos del JSON a datos del vector; el esquema debe coincidir con el índice.
• Consultar vectores: recupera los más parecidos según los parámetros de la query.

06.2. Airtable

Gestiona registros dentro de una base de Airtable.

Operaciones clave:

• Leer, crear, actualizar y borrar registros.
• Mapeo de campos: las claves del JSON tienen que coincidir exactamente con los nombres de columna en Airtable.

06.3. PostgreSQL

Ejecuta consultas SQL para manipular datos.

Operaciones clave:

• SELECT, INSERT, UPDATE y DELETE.
• Usa consultas parametrizadas para evitar inyección de SQL.

06.4. Google Docs

Lee y actualiza documentos, útil como almacén de memoria a largo plazo o notas.

Operaciones clave:

• "get" para recuperar contenido, "update" para insertarlo.
• Usa actionsUi (en googleDocsTool) para definir el payload JSON de cada operación.

06.5. Google Calendar

Recupera y crea eventos en Google Calendar.

Operaciones clave:

• Obtener eventos: usa filtros de fecha con expresiones dinámicas.
• Crear eventos: especifica inicio, fin, resumen, descripción y campos adicionales (asistentes, datos de conferencia).

06.6. Telegram

Gestiona el envío y recepción de mensajes.

Tipos de nodo:

• telegramTrigger: recibe mensajes.
• telegram: envía respuestas de texto.
• telegramTool: envía ficheros y documentos.

Parámetros clave: webhookId (en triggers), chatId, text, file (URL) y additionalFields (por ejemplo parse_mode).

06.7. HTTP Request

Llamadas genéricas a APIs HTTP, por ejemplo generación de imágenes con DALL-E.

Parámetros clave: url, method, sendBody, sendHeaders y authentication (credenciales predefinidas o genéricas).

06.8. SerpAPI Tool

Consulta datos de motores de búsqueda a través de SerpAPI.

Parámetros clave: options para ajustes adicionales de la query.

06.9. Workflow Tool

Dispara o ejecuta otros workflows (por ejemplo uno de creación de tareas).

Parámetros clave: name, workflowId, schemaType y inputSchema.

06.10. Gmail Tool

Envía correos a través de Gmail.

Parámetros clave: sendTo, subject, message y additionalFields.

06.11. Supabase

Interactúa con bases de datos en Supabase.

Parámetros clave: tableId y fieldsUi (mapeo de JSON a columnas).

06.12. Nodos genéricos y auxiliares

Cubren operaciones generales: asignar valores, fusionar datos, separar salidas, condicionales y disparar sub-workflows.

Ejemplos:

• Nodos Set: asignan valores (por ejemplo el system prompt).
• Merge, Aggregate, Split Out: orquestan datos.
• If: lógica condicional.
• Execute Workflow Trigger y Respond To Webhook: controlan el flujo.

AI Agent y memoria cómo manipularlos bien

El módulo AI Agent orquesta respuestas inteligentes y llamadas a herramientas.

Aspectos clave:

• Procesa la entrada del usuario con el parámetro text.
• Marca el comportamiento desde options.systemMessage, donde defines reglas de memoria, invocación de herramientas y respuestas de respaldo.
• Se conecta a nodos de memoria (por ejemplo memoryBufferWindow) para conservar el contexto.

Buenas prácticas:

• Redacta system messages completos, cubriendo casos límite.
• Usa expresiones dinámicas para adaptarte a entradas variables.
• Prueba el flujo conversacional completo y comprueba que los valores dinámicos (detalles de un evento, etc.) pasan correctamente entre nodos.
• Valida los JSON de salida para evitar los errores típicos (ver siguiente sección).

Errores frecuentes cuando el LLM genera JSON roto

Lista de los problemas más habituales al pedirle a un modelo de lenguaje que produzca JSON válido.

Pégale este mensaje exactoGenerate ONLY valid JSON. Use double quotes for property names and string values. No trailing commas. Numbers and booleans must not be wrapped in quotes. Close every bracket and brace.

Resumen final lo que te llevas