Recursos · Integración n8n

Nodo Workflow Retriever n8nConfigura Workflow Retriever en n8n.

Hay respuestas que no están en una base vectorial sino al final de una llamada a una API. El nodo Workflow Retriever n8n delega esa búsqueda a otro flujo de n8n y devuelve lo que ese flujo produce. Expone 8 parámetros, no tiene entrada principal y se engancha a un nodo raíz por un único puerto.

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

Por qué automatizar

¿Para qué sirve el nodo Workflow Retriever n8n?

El nodo Workflow Retriever deja que una cadena de preguntas y respuestas busque sus documentos en un flujo de n8n en lugar de en un índice ya construido. Cuando la cadena necesita contexto, este nodo llama al flujo que le has indicado, le pasa los valores que hayas definido y entrega a la cadena lo que ese flujo devuelve. Es un subnodo, es decir, un nodo que se conecta a un nodo raíz y nunca se ejecuta por su cuenta.

Primer escenario: aprovechar una búsqueda que ya existe. Una asesoría tiene un flujo que consulta su herramienta de expedientes y devuelve los que coinciden. Con Source en database y el identificador de ese flujo, esa búsqueda pasa a ser el paso de recuperación de una cadena de preguntas y respuestas. Nada que indexar, nada que recalcular cuando un expediente cambia.

Segundo escenario: datos demasiado frescos para indexarlos. Existencias, facturas abiertas, las reservas de hoy. Un flujo que lee una hoja de cálculo y filtra las filas se llama en el momento de la pregunta, así que la cadena ve siempre el estado real. Aquí encaja bien con un flujo de Google Sheets, o con lo que ya automatizas en Slack y Gmail.

Tercer escenario: el desvío. Como el flujo llamado recibe los valores que armas en los campos del nodo, puedes mandarle una categoría, un identificador de cliente o un idioma y dejar que él decida qué fuente consultar. La lógica de recuperación vive entonces en un flujo que pruebas por separado, algo mucho más fácil de depurar que una instrucción escondida en un prompt.

¿Cuándo conviene otra cosa? Si tus documentos son ficheros estables y las preguntas son semánticas, un retriever de base vectorial sigue siendo mejor: está pensado para la búsqueda por similitud y no ejecuta un flujo en cada pregunta. Si prefieres que el modelo decida cuándo ir a buscar algo, usa una herramienta conectada a un AI Agent, porque a un retriever lo llama la cadena y no lo elige el modelo. Y si solo quieres una respuesta a partir del prompt, basta con un modelo de chat de OpenAI o Anthropic, sin paso de recuperación.

Conviene dejar claros los límites desde el principio. Este nodo no tiene entrada principal ni ajustes para cuántos documentos devolver, cómo ordenarlos o si conviene guardarlos en caché: lo que devuelve el flujo llamado es exactamente lo que recibe la cadena, así que filtrar es tarea de ese flujo. La página describe la versión 1 del nodo, la más alta del catálogo; un flujo antiguo puede mostrar menos opciones. Por el lado de n8n no se factura nada, aunque el proveedor del modelo de chat que conectes cobra sus propias llamadas de API.

Conexiones

¿Dónde se conecta este nodo?

n8n reparte el trabajo de IA entre un nodo raíz, que recibe los items del flujo, y subnodos enganchados a sus puertos, un tipo de subnodo por puerto. Como este es un subnodo, la única conexión que importa es el puerto que alimenta.

Salida (dónde se conecta)

  • Retrieverai_retriever
01RetrieverEs el puerto de salida por el que el nodo entrega el contenido recuperado a un nodo raíz. Arrastra desde la toma retriever del nodo raíz, elige Workflow Retriever y la cadena llamará a tu flujo cada vez que necesite material.

Es el puerto de salida por el que el nodo entrega el contenido recuperado a un nodo raíz. Arrastra desde la toma retriever del nodo raíz, elige Workflow Retriever y la cadena llamará a tu flujo cada vez que necesite material.

Parámetros clave

  • Required: un nodo raíz con puerto retriever no arranca mientras no haya nada conectado ahí.
  • Question and Answer Chain: la pareja habitual, la cadena pregunta y este nodo aporta con qué responder.
  • MultiQuery Retriever: se coloca entre la cadena y este nodo, y reformula la pregunta de varias maneras antes de llamarlo.
  • Contextual Compression Retriever: también lo acepta, y recorta lo que vuelve antes de que la cadena lo lea.
Casos de uso
una cadena de preguntas y respuestas sobre pedidos en curso, con la búsqueda del pedido guardada en su propio flujo.
Parámetros

¿Qué parámetros ofrece el nodo?

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

01

Source

source

Lo que ves en n8n

Notas y casos de uso

Le dice a n8n a qué flujo llamar cuando la cadena pide documentos. Todo lo demás del panel describe qué se le envía a ese flujo, así que este campo se ajusta primero.

Parámetros clave

  • Source: database (Database) carga el flujo desde la base de datos por su identificador, parameter (Parameter) lo carga desde un parámetro.
  • Workflow ID: obligatorio con Database, es el identificador del flujo a ejecutar.
  • Workflow JSON: obligatorio con Parameter, es el código JSON completo del flujo, pegado en el nodo.
Casos de uso
mantener el flujo de recuperación en la base mientras lo retocas, y reservar Workflow JSON para cuando quieras una copia autónoma viajando dentro del nodo.
02

Name

fields.name

Lo que ves en n8n

Notas y casos de uso

Pone nombre a uno de los valores que se entregan al flujo llamado. Ese flujo lo lee como cualquier campo entrante, así que el nombre que escribas aquí es el que él espera de su lado.

Parámetros clave

  • Name: nombre del campo cuyo valor se define, admite notación con puntos, por ejemplo data.person[0].name; el panel muestra e.g. fieldName mientras no escribas nada.
Casos de uso
un flujo que filtra clientes por segmento espera un campo segment, ese es el nombre que va aquí, y el valor viaja en el campo de valor correspondiente.
03

Type

fields.type

Lo que ves en n8n

Notas y casos de uso

Declara qué clase de valor lleva el campo. Lo que elijas aquí manda sobre el campo de valor que aparece debajo, y por eso el nodo tiene un parámetro de valor por cada tipo.

Parámetros clave

  • Type: stringValue (String), numberValue (Number), booleanValue (Boolean), arrayValue (Array), objectValue (Object).
Casos de uso
una consulta por identificador de cuenta se queda en String, mientras que un indicador que permite incluir registros archivados va en Boolean.
04

Value

fields.stringValue

Lo que ves en n8n

Notas y casos de uso

Guarda el texto que lleva el campo en cuanto Type vale String. Aquí acaba la mayoría de los parámetros de recuperación: identificadores, nombres de categoría, códigos de idioma, un término tomado de la pregunta.

Parámetros clave

  • Value: una cadena, escrita tal cual o construida con una expresión como {{ $json.customerId }} cuando el valor viene del item que entró en el nodo raíz.
Casos de uso
pasar una referencia de producto para que el flujo llamado solo devuelva las páginas de documentación ligadas a ese producto.
05

Value

fields.numberValue

Lo que ves en n8n

Notas y casos de uso

Lleva un valor numérico para un campo cuyo Type es Number. El panel lo trata como una cadena, así que una expresión que acabe en un número funciona igual que una cifra escrita a mano.

Parámetros clave

  • Value: un campo de texto para el número a enviar, muchas veces una expresión tipo {{ $json.limit }} en vez de una cifra fija.
Casos de uso
indicar al flujo llamado cuántas filas traer, para que una misma búsqueda sirva a una respuesta breve y a otra detallada.
06

Value

fields.booleanValue

Lo que ves en n8n

Notas y casos de uso

Manda un sí o un no al flujo llamado cuando Type vale Boolean. Va bien para los interruptores que ese flujo lee en un nodo If antes de escoger su rama.

Parámetros clave

  • Value: true (True) o false (False), elegidos en el selector y no escritos.
Casos de uso
un indicador que permite o no los borradores, para que una cadena interna los vea y otra de cara al cliente los ignore.
07

Value

fields.arrayValue

Lo que ves en n8n

Notas y casos de uso

Hace viajar varios valores bajo un mismo nombre cuando Type vale Array. El flujo llamado los recibe como una lista, para recorrerla o usarla como conjunto de filtros.

Parámetros clave

  • Value: un campo de texto para la lista, escrito con la forma que muestra la pista del panel, e.g. [ arrayItem1, arrayItem2, arrayItem3 ].
Casos de uso
enviar las etiquetas que toca la pregunta para que el flujo consulte de una vez todas las carpetas que coinciden en vez de ser llamado varias veces.
08

Value

fields.objectValue

Lo que ves en n8n

Notas y casos de uso

Transporta una carga estructurada cuando Type vale Object. Se recurre a él en cuanto el flujo llamado espera un pequeño conjunto de valores relacionados y no un dato suelto.

Parámetros clave

  • Value: un campo json, o sea contenido escrito en JSON, con claves anidadas si hace falta.
Casos de uso
reenviar un objeto de filtro con un rango de fechas y un estado, que el flujo llamado copia directamente en su consulta a la API.
Necesitas ayuda

¿Necesitas ayuda para automatizar Workflow Retriever con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Lo que se pregunta después

01¿El nodo Workflow Retriever n8n viene incluido?
Sí. Forma parte del paquete de IA que se entrega con n8n, así que no hay nada que instalar ni coste añadido por el lado de n8n. Se comporta igual en n8n Cloud, la oferta alojada por n8n, y en una instancia que alojes tú con Docker o npm, en Community Edition bajo licencia Sustainable Use. Un flujo construido en un sitio corre en el otro sin cambios. La única facturación que aparece alrededor de una cadena de IA viene del proveedor del modelo de chat conectado al nodo raíz, que cobra sus propias llamadas de API según sus condiciones.
02¿Qué hace falta configurar para que el nodo funcione?
Nada por el lado de la cuenta. Este nodo no tiene credential, es decir una credencial guardada en n8n, ni selector de autenticación: ninguna clave que crear, ningún permiso que conceder para el nodo en sí. Lo que necesita es un flujo al que llamar, alcanzable por su identificador con Source en Database o pegado en JSON con Source en Parameter, y un nodo raíz con puerto retriever donde engancharse. La autenticación solo entra por el subnodo de modelo conectado a ese nodo raíz, que lleva la credencial del proveedor, y por lo que consulte el flujo llamado.
03¿Qué límites tiene el nodo?
No tiene entrada principal y nunca se ejecuta solo, así que no puedes probarlo pulsándolo por separado: arranca cuando el nodo raíz pide contexto. Sus 8 parámetros no controlan cuántos documentos vuelven, cómo se ordenan ni si se guardan en caché, porque eso es cosa del flujo llamado. Filtrar, quitar duplicados y recortar se hacen allí, en el flujo que tú controlas y pruebas aparte. Esta página documenta la versión 1, la más alta del catálogo, y un flujo antiguo puede mostrar un panel más corto.
04¿Qué hay que conectar como mínimo y por dónde empezar?
Empieza con una Question and Answer Chain como nodo raíz y engancha este nodo a su puerto retriever. La cadena pide además un subnodo de modelo de chat, el que habla con el proveedor y guarda la clave de API. Luego construye el flujo llamado aparte, hasta que devuelva elementos limpios con una entrada de prueba, porque un retriever vale lo que le da su flujo. MultiQuery Retriever y Contextual Compression Retriever también aceptan este nodo, y se entienden mejor una vez que la cadena sencilla ya responde bien.
05¿n8n o Make para este tipo de recuperación con IA?
Depende de dónde pueden vivir tus datos y de cómo quieras pagar. n8n corre en tu propio servidor o en n8n Cloud, así que un flujo de recuperación que toca expedientes sensibles puede quedarse dentro de tu red. Make solo está alojado y se factura por operación, algo previsible con volumen estable pero que sube cuando una cadena llama a un retriever en cada pregunta. En la construcción, n8n ofrece este modelo de subnodos donde un flujo entero hace de paso de recuperación, mientras que Make favorece escenarios lineales. Decide por alojamiento, control de datos, modelo de coste y lógica visual.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.