Ressources · Intégration n8n

Nœud Zep Vector Store n8nConfigurer Zep Vector Store dans n8n.

Une base vectorielle ne sert à rien tant qu'un workflow ne sait pas y écrire et y relire. Le nœud Zep Vector Store n8n fait les deux avec 2 paramètres et 4 modes, de la simple insertion jusqu'à l'outil qu'un agent interroge tout seul quand la question l'exige.

Tester le nœud Zep Vector Store sur n8nVoir les 2 paramètres

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Zep Vector Store n8n ?

Il relie un workflow à une base vectorielle Zep, ce stockage qui garde un texte sous forme de tableaux de nombres pour qu'une recherche retrouve le sens plutôt que les mots exacts. Un paramètre dit quoi faire, Operation Mode, l'autre dit où, Collection Name. Le reste du panneau apparaît ou disparaît selon le mode retenu.

Premier usage, l'alimentation. En insert (Insert Documents), un workflow récupère une série de fiches produit, les découpe et le nœud les écrit dans une collection nommée. Rien n'est encore interrogé. L'option Is Auto Embedded reste active par défaut dans ce mode : la vectorisation se fait côté Zep, pas en amont dans n8n.

Vient la lecture, et là les quatre modes cessent de se ressembler. load (Get Many) lance une recherche et renvoie les documents trouvés au nœud suivant, sous forme d'items exploitables. retrieve (Retrieve Documents (As Vector Store for Chain/Tool)) ne renvoie rien de lui-même : il expose la base à une chaîne, c'est-à-dire une suite d'appels prédéfinis à un modèle. retrieve-as-tool transforme la base en outil qu'un AI Agent appelle de sa propre initiative, les champs Name et Description lui servant à comprendre ce qu'il consulte.

La doc décrit quatre montages autour du nœud. Il reste dans le flux classique pour insérer et relire. Il se branche directement sur le connecteur d'outils d'un agent. Un nœud Vector Store Retriever peut le lire et alimenter une Question and Answer Chain. Ou un Vector Store Question Answer Tool se glisse entre l'agent et la base pour résumer les résultats au lieu de rendre les documents bruts.

Reste le point qui commande tout le reste : ce nœud est déprécié depuis n8n 1.108.0. Pour un nouveau projet de recherche sémantique, autant partir sur une autre base vectorielle. Cette page sert les workflows déjà en production et les instances restées sous cette version. Côté Zep, l'équipe a aussi déprécié la version open source Zep Community Edition en avril 2025 : la procédure auto-hébergée peut ne plus se comporter comme la doc le décrit.

Les appels de modèle qui gravitent autour du nœud sont facturés par le fournisseur, OpenAI ou un autre, selon ses propres conditions. n8n n'ajoute rien par-dessus. Pour arbitrer avant d'engager une architecture entière, l'Avis n8n situe la plateforme, et la Formation n8n fait construire ces workflows en vrai.

Connexion

Comment connecter Zep à n8n ?

  1. 01

    Générer la clé dans Zep

    Il te faut un serveur Zep avec au moins un projet. Sur Zep Cloud, ouvre Project Settings, va dans la section Project Keys et clique sur Add Key. Donne un Key Name qui dit à quoi elle sert, par exemple n8n integration, puis valide avec Create. Copie la clé tout de suite : cet écran est le seul moment où elle s'affiche en clair.

  2. 02

    Enregistrer le credential dans n8n

    Dans n8n, ouvre le menu Credentials et crée un credential Zep, c'est-à-dire l'identifiant stocké une fois et réutilisé par tous tes workflows, pour qu'aucune clé ne traîne dans un nœud. La méthode d'authentification supportée est la clé d'API, et le credential demande deux champs : une API URL et une API Key. Colle la clé copiée dans API Key, puis active l'interrupteur Cloud.

  3. 03

    Ou viser ton propre serveur

    En auto-hébergement de Zep Open Source, les trois valeurs changent de sens. Le jeton JWT de ton serveur Zep va dans API Key, l'interrupteur Cloud reste désactivé, et l'URL de ton serveur va dans API URL. Même credential, autre remplissage. Il authentifie aussi le nœud de mémoire Zep : tu le crées une fois, tu le sélectionnes dans les deux.

Paramètres

Quels paramètres propose le nœud Zep Vector Store ?

Le nœud Zep Vector Store compte 2 paramètres. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Operation Mode

mode

Ce que tu vois dans n8n

Notes & cas d'usage

Ce sélecteur fixe le rôle du nœud : il écrit, il lit, il sert une chaîne, ou il devient un outil d'agent. À régler en premier.

Paramètres clés

  • 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 et Limit : la requête, souvent {{ $json.question }}, et le nombre de meilleurs résultats ramenés, 10 par exemple.
  • Name et Description : ce que lit le modèle avant d'appeler la base.
  • Include Metadata, Rerank Results et ID : les métadonnées, les résultats réordonnés, l'identifiant d'une entrée d'embedding.
Cas d'usage
un workflow en insert remplit la base la nuit, un autre en retrieve-as-tool y puise ses réponses le jour.
02

Collection Name

collectionName

Ce que tu vois dans n8n

Notes & cas d'usage

La collection, c'est le compartiment nommé dans lequel Zep range les vecteurs. Ce champ indique lequel le nœud alimente ou consulte, et il est requis dans tous les modes : une faute de frappe sépare une recherche qui répond d'une recherche vide.

Paramètres clés

  • Collection Name : chaîne de caractères requise. Valeur fixe quand le workflow ne sert qu'un seul jeu de données, expression du type {{ $json.workspace }} quand un même workflow en sert plusieurs.
Cas d'usage
un assistant support et un assistant produit partagent l'instance et le credential mais lisent deux collections distinctes, pour qu'une réponse ne cite jamais le mauvais corpus.
Besoin d'aide

Besoin d'aide pour automatiser Zep Vector Store avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Zep Vector Store et n8n, les questions qui reviennent

01Le nœud Zep Vector Store est-il inclus dans n8n ?
Oui. Il fait partie du paquet IA livré avec n8n, aussi bien sur n8n Cloud que sur une instance auto-hébergée. Rien à installer, rien de plus à payer côté n8n. L'auto-hébergement passe par Docker ou npm, en Community Edition sous licence Sustainable Use, et un workflow se comporte pareil des deux côtés. Ce qui peut coûter, c'est Zep lui-même et, dès qu'un modèle entre en jeu, son fournisseur : il facture ses propres appels d'API selon ses conditions, sans que n8n prélève quoi que ce soit. Une réserve avant de construire : le nœud est déprécié depuis n8n 1.108.0.
02Que faut-il pour faire tourner le nœud ?
Un credential Zep, et derrière lui un serveur Zep avec au moins un projet. La méthode d'authentification supportée est la clé d'API, et le credential réclame deux valeurs : une API URL et une API Key. Sur Zep Cloud, la clé se crée dans Project Settings, section Project Keys, puis l'interrupteur Cloud doit être activé. En auto-hébergement de Zep Open Source, c'est le jeton JWT du serveur qui sert d'API Key, l'interrupteur Cloud reste éteint et l'API URL pointe sur ta propre adresse. Le credential vit dans le menu Credentials et se réutilise dans chaque workflow concerné.
03Quelles sont les limites du nœud Zep Vector Store n8n ?
La première tient à son statut : déprécié depuis n8n 1.108.0, donc à éviter pour un nouveau chantier. Le nœud en est à la version 1. Le chemin auto-hébergé s'est fragilisé aussi, puisque l'équipe Zep a déprécié la version open source Zep Community Edition en avril 2025 et que la procédure décrite peut ne plus fonctionner après cette date. Au quotidien, surveille Embedding Dimensions, la taille du tableau de nombres qui représente un texte : elle doit être identique à l'écriture et à la lecture, sinon les recherches ne ramènent plus rien d'exploitable.
04Qu'est-ce qu'on lui branche pour démarrer ?
Rien sur lui directement : il n'a aucun port de sous-nœud et s'exécute comme un nœud d'action classique, item par item. Le câblage se joue autour, et la doc donne quatre montages. Le garder dans le flux normal pour insérer et relire des documents. Le brancher sur le connecteur d'outils d'un AI Agent pour qu'il soit interrogé quand une question réclame tes données. Placer un Vector Store Retriever devant lui pour alimenter une Question and Answer Chain. Ou intercaler le Vector Store Question Answer Tool entre l'agent et la base quand tu veux une synthèse plutôt que des documents bruts.
05n8n ou Make pour ce type de workflow ?
Ça dépend surtout d'où doivent vivre les données. n8n s'auto-héberge sur Docker ou npm, ou tourne sur n8n Cloud : le workflow de recherche et les documents qu'il lit peuvent rester sur une infrastructure que tu contrôles. Make est hébergé uniquement, sans option d'auto-hébergement, et facture à l'opération, ce qui rend le coût lisible par exécution sans serveur à maintenir. Les critères sont l'hébergement, la maîtrise des données, le modèle de coût et le confort de la logique visuelle. Autour d'une base vectorielle dépréciée, pouvoir figer sa propre version pèse plus lourd que d'habitude.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations