Nodo Zep Vector Store n8nConfigura Zep Vector Store en n8n.
Guardar documentos en una base vectorial solo sirve si un flujo sabe escribirlos y volver a encontrarlos. El nodo Zep Vector Store n8n hace las dos cosas con 2 parámetros y 4 modos, desde una inserción simple hasta una herramienta que un agente consulta solo.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Para qué sirve el nodo Zep Vector Store n8n?
Conecta un flujo con una base vectorial de Zep, ese almacén que guarda el texto como listas de números para que una búsqueda encuentre el significado y no las palabras exactas. Un parámetro decide qué hace el nodo, Operation Mode, y otro dónde lo hace, Collection Name. El resto del panel aparece o desaparece según el modo elegido.
El primer uso es llenar la base. Con insert (Insert Documents), un flujo recoge un lote de manuales internos, los trocea y el nodo los escribe en una colección con nombre. Todavía no se consulta nada. La opción Is Auto Embedded viene activada en este modo, así que la vectorización ocurre dentro de Zep y no antes, en n8n.
Luego llega la lectura, y ahí los cuatro modos dejan de parecerse. load (Get Many) lanza una búsqueda y devuelve los documentos encontrados al nodo siguiente, como ítems que puedes enviar o registrar. retrieve (Retrieve Documents (As Vector Store for Chain/Tool)) no devuelve nada por sí mismo: expone la base a una cadena, es decir una secuencia fija de llamadas a un modelo. retrieve-as-tool convierte la base en una herramienta que un AI Agent decide llamar cuando la pregunta lo pide, con Name y Description como única pista de qué está consultando.
La documentación describe cuatro montajes alrededor del nodo. Puede quedarse en el flujo normal para insertar y recuperar documentos. Puede ir directo al conector de herramientas de un agente. Un nodo Vector Store Retriever puede leerlo y alimentar una Question and Answer Chain. O un Vector Store Question Answer Tool se coloca entre el agente y la base para resumir resultados en lugar de soltar los documentos en crudo.
Y queda el dato que condiciona todo lo anterior: este nodo está obsoleto desde n8n 1.108.0. Para un proyecto nuevo de búsqueda semántica, mejor otra base vectorial. Esta página es para los flujos que ya están en producción y para las instancias por debajo de esa versión. El equipo de Zep también dio de baja la versión open source Zep Community Edition en abril de 2025, así que el camino autoalojado puede no comportarse como dice la documentación.
Las llamadas al modelo que rodean al nodo las factura su proveedor, OpenAI u otro, según sus propias condiciones, y n8n no añade nada encima. Si necesitas decidir antes de montar toda una arquitectura, la Reseña n8n sitúa la plataforma y el Curso n8n monta estos flujos con las manos.
¿Cómo se conecta Zep con n8n?
- 01
Genera la clave en Zep
Necesitas un servidor Zep con al menos un proyecto. En Zep Cloud, abre Project Settings, entra en la sección Project Keys y pulsa Add Key. Pon un Key Name que diga para qué es, por ejemplo
n8n integration, y confirma con Create. Copia la clave en ese momento: esa pantalla es la única que te la muestra entera. - 02
Guarda la credencial en n8n
En n8n, abre el menú Credentials y crea una credencial de Zep, o sea el acceso que se guarda una vez y se reutiliza en todos los flujos para que ninguna clave quede escrita dentro de un nodo. El método de autenticación admitido es la clave de API, y la credencial pide dos campos: una API URL y una API Key. Pega la clave copiada en API Key y activa el interruptor Cloud.
- 03
O apunta a tu propio servidor
Con Zep Open Source autoalojado, los tres valores cambian de sentido. El token JWT de tu servidor Zep va en API Key, el interruptor Cloud se queda apagado y la dirección de tu servidor va en API URL. Misma credencial, relleno distinto. Esa credencial también autentica el nodo de memoria de Zep: la creas una vez y la seleccionas en los dos.
¿Qué parámetros ofrece el nodo Zep Vector Store ?
El nodo Zep Vector Store 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.
Operation Mode
modeLo que ves en n8n
Notas y casos de uso
Este selector fija el papel del nodo: escribe, lee, alimenta una cadena o pasa a ser herramienta de un agente. Se ajusta primero.
Parámetros clave
- Operation Mode:
insert(Insert Documents),load(Get Many),retrieve(Retrieve Documents (As Vector Store for Chain/Tool)),retrieve-as-tool(Retrieve Documents (As Tool for AI Agent)). - Prompt y Limit: la consulta, muchas veces
{{ $json.question }}, y cuántos resultados vuelven, por ejemplo10. - Name y Description: lo que lee el modelo antes de consultar la base.
- Include Metadata, Rerank Results e ID: los metadatos, los resultados reordenados y el identificador de una entrada de embedding.
insert llena la base de madrugada y otro en retrieve-as-tool responde con ella de día.Collection Name
collectionNameLo que ves en n8n
Notas y casos de uso
La colección es el cajón con nombre donde Zep ordena los vectores. Este campo dice cuál alimenta o consulta el nodo, y es obligatorio en todos los modos: una errata aquí separa una búsqueda que responde de otra que vuelve vacía.
Parámetros clave
- Collection Name: cadena de texto obligatoria. Valor fijo cuando el flujo atiende un solo conjunto de datos, expresión del tipo
{{ $json.workspace }}cuando un mismo flujo atiende a varios.
¿Necesitas ayuda para automatizar Zep Vector Store con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
Zep Vector Store y n8n, las dudas habituales
01¿El nodo Zep Vector Store viene incluido en n8n?
02¿Qué hace falta para que el nodo funcione?
03¿Qué límites tiene el nodo Zep Vector Store n8n?
04¿Qué se le conecta para empezar?
05¿n8n o Make para este tipo de flujo?
Recibe nuestros tips de integración cada semana.
Sin spam. Cancela cuando quieras.
