Recursos · Integración n8n

Nodo Xata n8nConfigura Xata en n8n.

Una conversación que se borra en cada ejecución no es una conversación. El nodo Xata n8n guarda el historial en una base de datos Xata, así que el agente retoma el hilo donde lo dejó. Dos parámetros, un puerto Memory y una credencial por clave de API. Para agentes de chat que ya salieron de la demo.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo Xata n8n?

Xata es un subnodo, o sea un nodo pequeño que se engancha a otro más grande en lugar de ejecutarse por su cuenta. Se conecta al puerto Memory de un nodo raíz como el AI Agent y conserva las interacciones anteriores en una base de datos Xata. Sin él, cada mensaje llega sin pasado: la misma pregunta dos veces arranca desde cero dos veces.

Tres escenarios donde el nodo se gana su sitio. Una tienda online con un asistente en la web: el visitante pregunta por el plazo de entrega y dos mensajes después dice «¿y si lo devuelvo?», una frase que sin el intercambio previo no significa nada. Un asistente interno que el equipo reabre a lo largo del día, donde la conversación tiene que sobrevivir al cierre del navegador. Un montaje con varios nodos en el que la misma conversación pasa de uno a otro y la memoria se comparte en vez de duplicarse.

Ese último caso esconde una trampa. En cuanto un flujo de trabajo tiene más de un nodo Xata, todos leen por defecto la misma instancia de memoria. Va bien hasta que una acción destructiva, como la operación que sobrescribe todos los mensajes en el nodo Chat Memory Manager, borra una conversación que otra rama seguía usando. Dos conversaciones distintas piden dos identificadores de sesión distintos, puestos a mano.

Cuándo no usarlo: el puerto Memory solo aparece en los nodos raíz que lo ofrecen, y las cadenas de IA de n8n no pueden usar memoria. Si tu flujo resume o clasifica una entrada suelta y termina ahí, no hay nada que recordar ni nada que conectar. La memoria pertenece a los montajes tipo agente, los que se construyen con el nodo AI Agent o se exponen a otro agente mediante AI Agent Tool.

Los límites, sin rodeos. El nodo guarda y devuelve contexto conversacional, nada más: ni búsqueda en tus datos, ni recuperación vectorial, ni carga de documentos. Dos parámetros y ninguna operación que elegir, así que todo lo demás se decide en el nodo raíz y en el modelo de chat que le conectes, por ejemplo OpenAI o Anthropic. El proveedor del modelo factura sus propias llamadas de API según sus condiciones y n8n no añade nada.

Un apunte antes de montar nada: el nodo viene en el paquete de IA que se entrega con n8n, ya está en tu instancia, y el flujo se comporta igual en n8n Cloud que en una instalación autoalojada. Si quieres una mirada más amplia a la plataforma antes de poner un agente en producción, la Reseña n8n repasa los compromisos y el Curso n8n monta un agente paso a paso.

Conexión

¿Cómo se conecta Xata con n8n?

  1. 01

    Prepara la base de datos y genera la clave

    Todo empieza del lado de Xata: hace falta una base de datos, o una cuenta en una base que ya creó otra persona. Después genera la clave que usará la credencial. En la aplicación de Xata entra en Account Settings y elige + Add a key. Copia el valor en ese momento y guárdalo bien, porque el formulario de la credencial es el único sitio donde n8n va a pedírtelo. Ese valor va al campo API Key.

  2. 02

    Arma la dirección de la base

    El campo Database Endpoint le dice a la Workspace API de qué base estás hablando. Su formato es https://{workspace-display-name}-{workspace-id}.{region}.xata.sh/db/{dbname}. El identificador del workspace es único, 6 caracteres alfanuméricos. La región es la que aloja la base. El nombre de visualización del principio es opcional: la API lo ignora, pero ayuda a distinguir credenciales cuando tienes varias guardadas.

  3. 03

    Guarda la credencial y selecciónala en el nodo

    En n8n, abre el menú Credentials y crea la credencial de Xata con los tres valores: la dirección que acabas de armar, la Branch, que es el nombre de la rama de GitHub de tu base, y la API Key. Una credencial es un acceso guardado una sola vez: a partir de ahí, cualquier nodo Xata de cualquier flujo la encuentra en el desplegable. En el nodo no hay nada más que elegir antes de los dos parámetros.

Conexiones

¿Dónde se engancha este nodo?

Un flujo de IA en n8n gira sobre un nodo raíz que recibe los items, con subnodos enganchados a sus puertos, un tipo de subnodo por puerto. Xata es un subnodo: no tiene entrada principal y nunca se ejecuta solo.

Salida (dónde se conecta)

  • Memoryai_memory
01MemoryXata responde al puerto Memory, la toma que expone un nodo raíz cuando sabe llevar una conversación de una ejecución a la siguiente. Arrastra el conector del puerto hasta el nodo Xata y el nodo raíz pasa a leer y escribir su historial en tu base de datos en vez de perderlo.

Xata responde al puerto Memory, la toma que expone un nodo raíz cuando sabe llevar una conversación de una ejecución a la siguiente. Arrastra el conector del puerto hasta el nodo Xata y el nodo raíz pasa a leer y escribir su historial en tu base de datos en vez de perderlo.

Parámetros clave

  • Optional: un nodo raíz funciona sin memoria, simplemente trata cada mensaje como si fuera el primero.
  • AI Agent: el anfitrión habitual, y AI Agent Tool cuando a ese agente lo llama otro.
  • Chat Trigger: por donde entra la conversación al flujo.
  • Chat Memory Manager: para leer o sobrescribir los mensajes guardados por tu cuenta.
Casos de uso
un agente en el chat de la web que acierta con una repregunta porque el intercambio anterior sigue en contexto.
Parámetros

¿Qué parámetros se ajustan en el nodo?

El nodo Xata tiene 2 parámetros. Para cada uno: el nodo tal como lo configuras en n8n, qué cambia el parámetro y nuestras notas de campo.

01

Session ID

sessionIdType

Lo que ves en n8n

Notas y casos de uso

Este ajuste señala qué conversación abre el nodo. Un identificador de sesión equivale a un hilo de historial, así que su valor decide si dos visitantes comparten memoria o cada uno tiene la suya.

Parámetros clave

  • Connected Chat Trigger Node (fromInput): el nodo busca un campo sessionId que llega desde un Chat Trigger conectado directamente.
  • Define below (customKey): una expresión, es decir una fórmula que recoge un dato de los nodos anteriores, o un texto fijo. El campo Key que aparece guarda el identificador de sesión en la memoria, a menudo {{ $json.email }}.
Casos de uso
un chat de pedidos donde el correo del cliente hace de clave y cada cliente conserva su propio hilo.
02

Context Window Length

contextWindowLength

Lo que ves en n8n

Notas y casos de uso

Guardar historial y devolvérselo al modelo no son lo mismo. Este número fija cuántas interacciones pasadas recibe el modelo como contexto en cada llamada, de todo lo que la base conserva.

Parámetros clave

  • Context Window Length: un número. Si sube, el modelo mira más atrás, algo que ayuda en una incidencia que se alarga. Si baja, cada llamada carga menos texto, que es lo que conviene en un asistente breve y con mucho volumen.
Casos de uso
un asistente de atención que mantiene a la vista los últimos intercambios y no vuelve a pedir el número de pedido que ya diste antes.
Necesitas ayuda

¿Necesitas ayuda para automatizar Xata con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Xata y n8n, las dudas habituales

01¿El nodo Xata es gratis en n8n?
Sí, en la parte de n8n. El nodo forma parte del paquete de IA que se entrega con n8n: nada que instalar y ningún coste añadido, tanto en n8n Cloud como en una instancia autoalojada en Community Edition con licencia Sustainable Use. El flujo se comporta igual en los dos casos. Fuera de ese perímetro quedan dos cosas: tu base de datos Xata, que sigue las condiciones de Xata, y el proveedor del modelo conectado al nodo raíz. OpenAI, Anthropic, Google o Mistral facturan sus llamadas de API según sus propias condiciones, y n8n no añade nada encima.
02¿Qué hace falta para que funcione el nodo Xata n8n?
Dos cosas: una credencial y un nodo raíz al que engancharse. La credencial se autentica con clave de API y reúne tres valores. El Database Endpoint, que identifica tu base ante la Workspace API. La Branch, es decir el nombre de la rama de GitHub de la base. Y la API Key, generada desde Account Settings en Xata. Antes de todo eso necesitas una base de datos Xata, o una cuenta en una base existente. En n8n, el nodo no tiene entrada principal y nunca se ejecuta solo, así que no hace nada mientras no responda al puerto Memory de un nodo raíz.
03¿Qué límites tiene la memoria Xata?
El nodo hace un solo trabajo: conservar el contexto de una conversación para que un agente pueda continuarla. No hay operaciones que elegir y solo dos parámetros, Session ID y Context Window Length, de modo que el resto del intercambio se configura en otro sitio. Las cadenas de IA de n8n no pueden usar memoria, lo que descarta los flujos montados como cadena. Hay un comportamiento que sorprende: varios nodos Xata en el mismo flujo comparten por defecto una única instancia de memoria, así que una acción destructiva como sobrescribir todos los mensajes desde Chat Memory Manager borra un historial del que depende otra rama. Identificadores de sesión distintos los separan. Esta página describe la versión 2 del nodo.
04¿Qué hay que conectar como mínimo y por dónde empezar?
Como mínimo, un nodo raíz y un modelo de chat. La memoria es opcional: un AI Agent funciona sin ella, solo que trata cada mensaje como el primero. El orden que evita atascos es montar el agente, conectar el modelo de chat con su credencial, comprobar que responde y solo entonces enganchar Xata al puerto Memory. Para la primera prueba, deja Session ID en el Chat Trigger conectado: el identificador llega solo y no hay nada que escribir. Cambia a Define below cuando cada usuario real necesite su propio hilo.
05¿n8n o Make para una memoria de IA así?
Deciden cuatro criterios y ninguna herramienta gana en todos. El alojamiento: n8n se autoaloja con Docker o npm, o se usa en n8n Cloud, mientras que Make solo existe alojado. El control de los datos va detrás, y pesa cuando el historial guarda mensajes de clientes. El modelo de coste: Make factura por operación, y un agente de chat genera muchísimas operaciones pequeñas. La lógica visual: las dos se montan a golpe de ratón, pero el modelo de subnodos que ves aquí, puertos y nodos pequeños colgados de un nodo raíz, es propio de n8n. La decisión se juega ahí.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.