Recursos · Integración n8n

Integración Contextual AI n8nAutomatiza Contextual AI con n8n.

Contextual AI responde preguntas sobre tus propios documentos, y este nodo mete ese trabajo dentro de un flujo. La integración Contextual AI n8n reúne 13 operaciones en 6 recursos, desde crear un agente hasta reordenar una preselección. No trae trigger, así que otro nodo arranca la ejecución.

Nodo comunitario Este nodo no viene con n8n: es un paquete comunitario (n8n-nodes-contextualai) que instalas desde Settings › Community nodes en una instancia autoalojada. npm

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

Por qué automatizar

¿Qué resuelve la integración Contextual AI n8n?

El nodo expone 13 operaciones en 6 recursos: Agent para crear y gestionar un asistente, Datastore para guardar e ingerir los documentos sobre los que responde, Query para preguntarle a ese agente, Reranker para reordenar una lista de documentos según una consulta, LMUnit para puntuar una respuesta frente a una prueba escrita, y Parser para extraer el texto de un archivo. Cada una sustituye una llamada que harías a mano.

Empecemos por el caso más directo, la calidad de la respuesta. Rerank documents ordena una preselección amplia frente a la pregunta y se queda con los mejores textos, y solo esos llegan a un paso de OpenAI. Menos ruido de entrada, menos respuestas que no vienen a cuento y menos tiempo perdido revisando lo que el modelo escribió.

Segundo caso, el inventario. List Agents y List Datastores devuelven lo que existe en la cuenta, y un volcado semanal a Google Sheets deja a la vista qué agente apunta a qué almacén. Es aburrido y por eso nadie lo hace a mano.

Tercer caso, el soporte. Ingest Document mete los manuales nuevos en el almacén, Query agent contesta las preguntas del equipo con esos documentos como única fuente, y la respuesta aterriza en Slack. Si activas Retrievals Only, la misma operación devuelve los fragmentos recuperados en lugar de un texto redactado, útil cuando lo que hace falta es la fuente.

Conviene decir qué queda fuera. El nodo no tiene trigger, así que el flujo arranca con un Schedule Trigger a intervalo fijo, con un Webhook de n8n al que llama un servicio externo, o con el trigger de otra herramienta. El parseo es asíncrono, de ahí que sean tres operaciones distintas. Y las listas avanzan página a página con Limit y Cursor, sin interruptor Return All.

Cuando falta un endpoint de la API de Contextual AI, el nodo HTTP Request lo llama y reutiliza el mismo credential mediante la autenticación predefinida. Y si lo que estás decidiendo es la plataforma, la Reseña n8n cuenta lo bueno y lo incómodo.

Conexión

¿Cómo se conecta Contextual AI con n8n?

  1. 01

    Instalar el paquete comunitario

    Entra en Settings, abre Community nodes e instala n8n-nodes-contextualai. Esto se hace en una instancia autoalojada, tanto si corre con Docker como con npm; en n8n Cloud solo se pueden instalar nodos comunitarios verificados. Terminada la instalación, el nodo Contextual AI aparece en el panel de nodos igual que cualquier otro.

  2. 02

    Crear el credential API Key

    En el menú Credentials, añade un credential de Contextual AI y pega tu clave. El nodo se autentica con API Key, bajo el tipo contextualAiApi. Un credential es la ficha de acceso que n8n guarda aparte: se crea una vez y se reutiliza en todos los flujos, así que cambiar la clave más adelante es una sola edición.

  3. 03

    Elegir el credential en el nodo

    Coloca el nodo Contextual AI en el lienzo y selecciona el credential en su desplegable. Después elige el recurso, Agent, Datastore, Query, Reranker, LMUnit o Parser, y la operación que quieras. La prueba más barata es List Agents: lee datos y no modifica nada, de modo que un fallo no deja rastro en Contextual AI.

Acciones

Lo que sabe hacer el nodo Contextual AI

El nodo Contextual AI expone 13 operaciones en 6 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

Matriz recursos × operaciones
RecursoCreate AgentCreate DatastoreDelete AgentGet Document MetadataIngest DocumentList AgentsList DatastoresParse DocumentParse ResultParse StatusQuery agentRerank documentsRun LMUnit
Agent✓✓✓
Datastore✓✓✓✓
Query✓
Reranker✓
LMUnit✓
Parser✓✓✓

Agent

3 operaciones
01

Create Agent

Agent.Create Agent

Lo que ves en n8n

Notas y casos de uso

Una sola ejecución levanta el agente, su almacén y los primeros archivos, y devuelve el identificador que reutilizan las operaciones posteriores.

Parámetros clave

  • Agent Name: el nombre que recibe el agente nuevo, por ejemplo un bot de atención al cliente.
  • Configuration Mode: Pre-Built parte de una plantilla de Agent Composer, Custom espera tu propio YAML en Custom Template.
  • Pre-Built Template: Simple Search para búsqueda multimodal rápida, Agentic Search para razonamiento en varios pasos.
  • Datastore Configuration: crear un almacén con Datastore Name, o enlazar los existentes con Datastore IDs.
  • System Prompt: las instrucciones que el agente sigue al generar una respuesta.
Casos de uso
montar un agente de soporte de producto a partir de una carpeta de manuales, en una ejecución.
02

List Agents

Agent.List Agents

Lo que ves en n8n

Notas y casos de uso

Devuelve los agentes de la cuenta con su identificador, así un flujo localiza el correcto por su nombre y no arrastra un ID escrito a fuego.

Parámetros clave

  • Limit: requerido, el número máximo de agentes que vuelven en una llamada.
  • Cursor: el valor que dejó la llamada anterior, para traer el siguiente grupo de resultados.
Casos de uso
mirar qué hay antes de que un flujo cree un segundo agente con el mismo cometido.
03

Delete Agent

Agent.Delete Agent

Lo que ves en n8n

Notas y casos de uso

Borra un agente para siempre. La operación es irreversible, conviene dejarla detrás de una condición y no en mitad del camino habitual.

Parámetros clave

  • Agent ID: requerido, el identificador del agente que se borra, normalmente {{ $json.id }} desde un paso de List Agents.
Casos de uso
limpiar los agentes desechables que creó un flujo de pruebas, una vez revisada la ejecución.

Datastore

4 operaciones
04

Create Datastore

Datastore.Create Datastore

Lo que ves en n8n

Notas y casos de uso

Prepara un almacén vacío al que llegarán documentos después. Sirve cuando el almacén tiene que existir antes de que corra el resto.

Parámetros clave

  • Datastore Name: requerido, el nombre del almacén, por ejemplo el que guarda la documentación de producto.
  • Configuration (JSON String): la configuración del almacén como JSON serializado; si se deja vacío, se aplica la configuración por defecto.
Casos de uso
dar un almacén propio a cada cliente o línea de producto, creado desde una fila de hoja de cálculo al darlo de alta.
05

Ingest Document

Datastore.Ingest Document

Lo que ves en n8n

Notas y casos de uso

Manda un archivo que viaja en el item entrante a un almacén, donde pasa a ser material consultable por un agente.

Parámetros clave

  • Datastore ID: requerido, el almacén que recibe el documento.
  • Input Binary Field(s): el nombre del campo binario del item entrante; vacío, entran todos los campos binarios.
  • Metadata (JSON String): una petición de metadatos en JSON serializado, cuyo custom_metadata es un diccionario plano de claves y valores.
Casos de uso
meter los contratos que llegan como adjunto directamente en el almacén, etiquetados con el nombre del cliente.
06

Get Document Metadata

Datastore.Get Document Metadata

Lo que ves en n8n

Notas y casos de uso

Lee los metadatos y el estado de procesamiento de un documento, que es como un flujo se entera de si la ingesta terminó de verdad.

Parámetros clave

  • Datastore ID: requerido, el almacén que contiene el documento.
  • Document ID: requerido, el identificador del documento que se consulta.
Casos de uso
repetir la consulta tras un nodo Wait y avisar al equipo solo cuando el documento esté listo.
07

List Datastores

Datastore.List Datastores

Lo que ves en n8n

Notas y casos de uso

Trae los almacenes de la cuenta, con la opción de quedarse solo con los que están enlazados a un agente.

Parámetros clave

  • Limit: requerido, el número máximo de almacenes que vuelven en una llamada.
  • Cursor: el valor de la llamada anterior, para pasar a la página siguiente.
  • Agent ID: filtra la lista a los almacenes enlazados a ese agente.
Casos de uso
sacar cada semana el inventario de almacenes y agentes y dejarlo en una hoja de cálculo.

Query

1 operación
08

Query agent

Query.Query agent

Lo que ves en n8n

Notas y casos de uso

Lanza una pregunta a un agente y recoge su respuesta, apoyada en los documentos a los que ese agente llega.

Parámetros clave

  • Agent ID: requerido, el agente que contesta.
  • Query: requerido, la pregunta en sí, a menudo {{ $json.question }} desde un formulario.
  • Retrievals Only: activado, la operación recupera fragmentos y se salta la generación.
  • Include Retrieval Content Text: añade a la respuesta el texto de los contenidos recuperados.
  • Conversation ID: continúa una conversación existente; si se rellena, el historial enviado se ignora.
Casos de uso
contestar una duda de cliente sin que nadie repase tres manuales.

Reranker

1 operación
09

Rerank documents

Reranker.Rerank documents

Lo que ves en n8n

Notas y casos de uso

Puntúa un conjunto de textos frente a una pregunta y los devuelve ordenados por relevancia, para que solo sigan los que aportan.

Parámetros clave

  • Query: requerido, la pregunta contra la que se puntúan los textos.
  • Documents: requerido, la lista de textos separados por comas.
  • Model: ctxl-rerank-v2-instruct-multilingual, su variante mini, o ctxl-rerank-v1-instruct.
  • Top N: cuántos resultados de cabeza vuelven; en 0, vuelven todos.
  • Instruction: una indicación opcional para orientar el reordenamiento.
Casos de uso
recortar una búsqueda demasiado ancha a los pocos pasajes que un modelo debería leer.

LMUnit

1 operación
10

Run LMUnit

LMUnit.Run LMUnit

Lo que ves en n8n

Notas y casos de uso

Evalúa una respuesta contra una regla escrita, y convierte una sensación difusa sobre la calidad en algo que el flujo puede bifurcar.

Parámetros clave

  • Query: requerido, la pregunta que se formuló.
  • Response: requerido, la respuesta que se somete a evaluación.
  • Unit Test: requerido, la regla que la respuesta debe cumplir, escrita como una frase.
Casos de uso
frenar cualquier respuesta que suspenda la prueba y mandarla a una cola de revisión humana.

Parser

3 operaciones
11

Parse Document

Parser.Parse Document

Lo que ves en n8n

Notas y casos de uso

Arranca un trabajo de lectura sobre un archivo que trae el item entrante. Devuelve el trabajo, no el texto, de ahí las dos operaciones siguientes.

Parámetros clave

  • Input Binary Field(s): el nombre del campo binario del item entrante que se va a parsear.
  • Parse Mode: Standard es el modo disponible.
  • Figure Caption Mode: leyendas de figuras Concise o Detailed.
  • Enable Document Hierarchy: conserva la estructura del documento.
  • Page Range: acota el trabajo a un tramo de páginas.
Casos de uso
convertir un catálogo de proveedor escaneado en texto aprovechable antes de que nadie lo lea.
12

Parse Status

Parser.Parse Status

Lo que ves en n8n

Notas y casos de uso

Dice en qué punto está un trabajo de lectura. Es el paso de espera entre lanzar el trabajo y recoger lo que ha producido.

Parámetros clave

  • Job ID: requerido, el identificador del trabajo que se consulta, tomado de la operación que lo lanzó.
Casos de uso
combinarlo con un nodo Wait para dar tiempo a un documento largo en lugar de romper la rama.
13

Parse Result

Parser.Parse Result

Lo que ves en n8n

Notas y casos de uso

Recoge la salida de un trabajo de lectura ya terminado y la entrega al resto del flujo.

Parámetros clave

  • Job ID: requerido, el identificador del trabajo del que se quieren los resultados.
  • Output Types: una lista separada por comas entre markdown-document, markdown-per-page y blocks-per-page.
Casos de uso
sacar un informe parseado como un único documento markdown y meterlo en un almacén en el paso siguiente.
Necesitas ayuda

¿Necesitas ayuda para automatizar Contextual AI con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Contextual AI y n8n, las dudas habituales

01¿La integración Contextual AI n8n es gratis?
Por el lado de n8n no hay nada que pagar. El nodo es un nodo comunitario, es decir que no viene incluido con n8n: es el paquete npm n8n-nodes-contextualai, que se instala desde Settings y luego Community nodes. Esa instalación ocurre en una instancia autoalojada, con Docker o con npm, y n8n Cloud solo acepta nodos comunitarios verificados. En lo demás funciona como un nodo incluido de serie: mismo lienzo, mismo menú de Credentials, mismas ejecuciones. Lo que cueste Contextual AI como herramienta es otra conversación y aquí no se trata.
02¿Qué credentials necesita el nodo Contextual AI?
Una API Key, guardada en n8n bajo el tipo de credential contextualAiApi. El credential se crea una vez desde el menú Credentials, se pega la clave, y todos los flujos tiran de la misma ficha porque el nodo la ofrece en su desplegable. Parece un detalle menor y no lo es: el día que toque rotar la clave, se edita un credential en vez de abrir nodo por nodo. El nodo HTTP Request reutiliza ese mismo credential mediante la autenticación predefinida, así que una llamada a un endpoint que el nodo no cubre se autentica igual.
03¿Qué límites tiene el nodo Contextual AI?
El nodo cubre 13 operaciones en 6 recursos, y lo que quede fuera de esa lista no está. Tampoco hay trigger, lo que condiciona cómo empieza el flujo. El parseo funciona por trabajos: Parse Document no devuelve el texto, hay que consultar Parse Status y luego recoger Parse Result. Las operaciones de lista avanzan por páginas, con un Limit requerido y un Cursor que viene de la llamada anterior, sin ningún interruptor Return All. Para cualquier endpoint de la API de Contextual AI que el nodo no incluya, el nodo HTTP Request lo llama reutilizando el mismo credential.
04¿Puede Contextual AI disparar un flujo de n8n en tiempo real?
No, porque no existe un nodo trigger de Contextual AI en n8n. Un flujo que use esta integración arranca en otro sitio: un Schedule Trigger que salta a intervalo fijo, un Webhook de n8n, o sea una URL a la que llama un servicio externo cuando pasa algo de su lado, o el trigger de otra herramienta que ya esté en el flujo. En la práctica eso cubre casi todo. Un Schedule Trigger nocturno se encarga de la ingesta de documentos y un Webhook se encarga de una pregunta escrita en un formulario, con el nodo Contextual AI justo detrás.
05¿n8n o Make para Contextual AI?
Depende de dónde tengan que vivir los datos y de cómo prefieras pagar. Make está alojado por Make, sin opción de autoalojamiento, y factura por operación, así que un flujo que parsea cientos de páginas se paga por volumen. n8n corre en tus propios servidores con Docker o npm, o en n8n Cloud, y el flujo queda igual en ambos casos. Aquí hay un matiz que decide: al ser un nodo comunitario, la vía autoalojada es la que permite instalar el paquete. Las dos plataformas se montan en visual, o sea que la elección va de alojamiento y de modelo de coste.