- Accueil
- Ressources
- Intégrations
- Supabase Vector Store
Nœud Supabase Vector Store n8nConfigurer Supabase Vector Store dans n8n.
Une recherche vectorielle cherche du sens, pas des mots. Le nœud Supabase Vector Store n8n travaille sur une table de ton propre projet Supabase, avec 2 paramètres et 5 modes qui couvrent l'insertion, la recherche, la mise à jour et l'accès par un agent. Pour qui garde ses documents chez soi.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert le nœud Supabase Vector Store n8n ?
Le nœud lit et écrit dans une table Supabase qui stocke des vecteurs, c'est-à-dire des représentations numériques de tes textes : une recherche renvoie alors les passages proches par le sens d'une question, et pas seulement ceux qui contiennent les mêmes mots. Dans un workflow, il se comporte soit comme un nœud d'action classique, exécuté sur chaque item entrant, soit comme une ressource qu'un modèle interroge. Un paramètre choisit le comportement, l'autre choisit la table.
Premier scénario : un cabinet qui veut interroger ses propres notes. Un workflow récupère les documents, les découpe, puis passe le nœud en mode insert vers une table Supabase. Un second workflow reprend le même nœud en mode load, avec un Prompt et un Limit, et ramène les passages les plus proches de la question posée. Les documents ne sortent jamais du projet Supabase déjà en place.
Deuxième scénario : un assistant qui décide seul d'aller chercher l'information. Le nœud tourne alors en mode retrieve-as-tool et se branche sur le connecteur d'outils d'un AI Agent. Le Name et la Description que tu écris sont lus par le modèle avant qu'il choisisse d'utiliser l'outil : une description vague reste la première raison pour laquelle un agent ignore une base pourtant bien remplie. C'est le schéma du template public 2621, où l'agent discute avec des fichiers stockés dans Supabase.
Troisième scénario : garder la base à jour. Une procédure change, une grille tarifaire évolue, et l'ancien passage dort toujours dans la table, prêt à ressortir. Le mode update prend l'ID d'une entrée existante et la remplace. C'est toute la différence entre une base qui vieillit bien et une base qui répond avec les conditions de l'an dernier.
Quand ne pas prendre ce nœud. Pour retrouver une ligne par sa clé, un identifiant connu, une requête classique sur la table va plus vite et coûte moins cher qu'une recherche par similarité : la recherche vectorielle n'apporte rien. Si une chaîne a juste besoin qu'on lui tende des documents, le mode retrieve alimente un retriever plutôt qu'un agent. Et pour obtenir une réponse rédigée au lieu de passages bruts, le Vector Store Question Answer Tool s'intercale entre l'agent et ce nœud.
Les limites à connaître avant de construire. Le nœud couvre 5 modes, pas un de plus : supprimer des lignes ou réindexer se fait côté Supabase. Il n'a aucun port de sous-nœud, donc le modèle d'embedding qui transforme le texte en vecteurs se choisit ailleurs dans le workflow, avec un credential (un identifiant enregistré une fois dans n8n) chez un fournisseur comme OpenAI ou Google Gemini, qui facture ses propres appels. Enfin, la table doit exister avant, créée depuis le quickstart vector store de Supabase, avec la fonction de correspondance que le nœud appelle. Pour situer la pièce dans l'ensemble, l'Avis n8n et la Formation n8n traitent le reste de la chaîne.
Comment connecter Supabase à n8n ?
- 01
Activer la Data API et récupérer l'URL du projet
Le credential passe par la Data API de Supabase, qui doit être activée. Dans le dashboard Supabase, ouvre le projet concerné, va dans Integrations puis Data API, et copie le Project URL affiché à cet endroit. Cette valeur part dans le champ Host de n8n. C'est aussi l'écran qui indique si la Data API est bien active : autant le vérifier là avant d'accuser la clé.
- 02
Créer une clé secrète
Toujours dans Supabase, ouvre Project Settings puis API Keys. Crée une clé secrète, ou affiche une clé existante, et garde-la sous la main pour la coller. C'est ce que n8n stocke dans Secret Key. Les credentials qui utilisent encore un secret service_role hérité continuent de fonctionner, mais Supabase retire progressivement ces anciennes clés d'API et elles s'arrêtent fin 2026 : mieux vaut créer une nouvelle clé secrète maintenant.
- 03
Enregistrer le credential dans n8n
Dans n8n, ouvre Credentials, crée un credential Supabase et colle le Host puis la Secret Key. Un credential s'enregistre une seule fois et se réutilise dans tous les workflows de l'instance : la même entrée sert à ce nœud et au nœud Supabase classique. Enregistre, puis ouvre le nœud vector store et choisis ta table. Dès que le credential répond, la liste des tables se remplit toute seule.
Quels paramètres le nœud demande-t-il ?
Le nœud Supabase 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.
Sommaire des paramètres
Operation Mode
modeCe que tu vois dans n8n
Notes & cas d'usage
Ce sélecteur commande tout le reste. À régler en premier, puisque les champs affichés en dessous en dépendent.
Paramètres clés
- Operation Mode :
insertécrit des documents,loadrenvoie les mieux classés,retrievealimente une chaîne,retrieve-as-toolexpose la base à un agent,updateremplace un document par son ID. - Name et Description : requis en mode outil, lus par le modèle avant qu'il choisisse l'outil.
- Prompt, Limit, Include Metadata, Rerank Results : le côté recherche, Prompt souvent
{{ $json.question }}. - ID : requis en mode update.
- Options : contient Query Name, soit
match_documentsaprès le quickstart, et Metadata Filter.
insert qui alimente la base, un autre en load qui répond aux questions.Table Name
tableNameCe que tu vois dans n8n
Notes & cas d'usage
Chaque mode lit ou écrit dans une table, et c'est ici qu'on la désigne. Elle doit exister dans Supabase avant l'exécution, avec la colonne vectorielle et la fonction de correspondance issues du quickstart.
Paramètres clés
- Table Name : requis, sous forme de resource locator, c'est-à-dire un champ qui propose une liste dès que le credential fonctionne, et qui accepte aussi une valeur saisie ou une expression comme
{{ $json.table }}quand la table change d'un item à l'autre.
Besoin d'aide pour automatiser Supabase Vector Store avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
Les questions qui viennent ensuite
01Le nœud Supabase Vector Store n8n est-il gratuit ?
02Quels identifiants faut-il pour le connecter ?
03Quelles sont les limites de ce nœud ?
04Que faut-il brancher pour que ça fonctionne ?
05n8n ou Make pour une base vectorielle ?
Reçois nos tips intégration chaque semaine.
Pas de spam. Désinscription à tout moment.

