- Inicio
- Recursos
- Integraciones
- Contextual AI
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
¿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.
¿Cómo se conecta Contextual AI con n8n?
- 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. - 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. - 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.
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.
| Recurso | Create Agent | Create Datastore | Delete Agent | Get Document Metadata | Ingest Document | List Agents | List Datastores | Parse Document | Parse Result | Parse Status | Query agent | Rerank documents | Run LMUnit |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Agent | ✓ | ✓ | ✓ | ||||||||||
| Datastore | ✓ | ✓ | ✓ | ✓ | |||||||||
| Query | ✓ | ||||||||||||
| Reranker | ✓ | ||||||||||||
| LMUnit | ✓ | ||||||||||||
| Parser | ✓ | ✓ | ✓ |
Índice de operaciones
Agent
3 operacionesCreate Agent
Agent.Create AgentLo 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.
List Agents
Agent.List AgentsLo 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.
Delete Agent
Agent.Delete AgentLo 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.
Datastore
4 operacionesCreate Datastore
Datastore.Create DatastoreLo 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.
Ingest Document
Datastore.Ingest DocumentLo 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_metadataes un diccionario plano de claves y valores.
Get Document Metadata
Datastore.Get Document MetadataLo 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.
List Datastores
Datastore.List DatastoresLo 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.
Query
1 operaciónQuery agent
Query.Query agentLo 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.
Reranker
1 operaciónRerank documents
Reranker.Rerank documentsLo 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, octxl-rerank-v1-instruct. - Top N: cuántos resultados de cabeza vuelven; en 0, vuelven todos.
- Instruction: una indicación opcional para orientar el reordenamiento.
LMUnit
1 operaciónRun LMUnit
LMUnit.Run LMUnitLo 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.
Parser
3 operacionesParse Document
Parser.Parse DocumentLo 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.
Parse Status
Parser.Parse StatusLo 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ó.
Parse Result
Parser.Parse ResultLo 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-pageyblocks-per-page.
¿Necesitas ayuda para automatizar Contextual AI con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.


