Ressources · Intégration n8n

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

Pourquoi automatiser

À 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.

Connexion

Comment connecter Supabase à n8n ?

  1. 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é.

  2. 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.

  3. 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.

Paramètres

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.

01

Operation Mode

mode

Ce 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, load renvoie les mieux classés, retrieve alimente une chaîne, retrieve-as-tool expose la base à un agent, update remplace 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_documents après le quickstart, et Metadata Filter.
Cas d'usage
un workflow en insert qui alimente la base, un autre en load qui répond aux questions.
02

Table Name

tableName

Ce 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.
Cas d'usage
une table par domaine, la documentation produit d'un côté, les procédures internes de l'autre, puis un changement de table dans le sélecteur plutôt qu'un filtre sur une base unique et encombrée à chaque requête.
Besoin d'aide

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

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui viennent ensuite

01Le nœud Supabase Vector Store n8n est-il gratuit ?
Oui, sur n8n Cloud comme en auto-hébergement. Le nœud fait partie du paquet IA livré avec n8n : rien à installer, aucun surcoût côté n8n, que tu utilises l'offre hébergée par n8n ou ta propre installation Docker ou npm en Community Edition, sous licence Sustainable Use. Un workflow se comporte de la même façon des deux côtés. Ce qui coûte est ailleurs : ton projet Supabase, et le fournisseur du modèle d'embedding qui transforme tes textes en vecteurs, lequel facture ses propres appels d'API selon ses conditions.
02Quels identifiants faut-il pour le connecter ?
Un credential Supabase, construit à partir de deux valeurs. Le nœud s'authentifie par clé d'API : tu renseignes un Host, qui est l'URL de projet copiée depuis l'écran Data API, et une Secret Key créée dans Project Settings puis API Keys. La Data API doit être activée sur le projet, sinon rien ne se connecte. Les credentials qui utilisent encore un secret service_role hérité fonctionnent toujours, mais Supabase retire ces anciennes clés et elles s'arrêtent fin 2026 : crée une nouvelle clé secrète plutôt que de recycler l'ancienne. Le credential s'enregistre une fois et sert partout.
03Quelles sont les limites de ce nœud ?
Il fait cinq choses et s'arrête là. La version 1 du nœud couvre l'insertion, la récupération de plusieurs documents, la mise à disposition pour une chaîne, l'exposition comme outil d'agent, et la mise à jour par ID. Supprimer des entrées, modifier le schéma ou réindexer se passe dans Supabase, pas ici. Le nœud suppose aussi que la table et la fonction de correspondance existent déjà, selon le quickstart vector store de Supabase, et des réglages différents de ceux du quickstart changent ce qu'il faut mettre dans les paramètres. Sans port de sous-nœud, il ne choisit jamais le modèle d'embedding.
04Que faut-il brancher pour que ça fonctionne ?
Au minimum un credential Supabase et un modèle d'embedding dans le workflow, puisqu'il faut bien produire les vecteurs avant de les stocker ou de les comparer. Ensuite, tout dépend du mode. En insert, tu lui fournis des documents chargés et découpés en amont. En retrieve-as-tool, le nœud se relie au connecteur d'outils d'un agent IA, avec un Name et une Description clairs. En retrieve, un retriever s'intercale entre le nœud et une chaîne. Pour un premier montage, l'enchaînement insert puis load reste le plus simple à déboguer, parce que tu vois ce qui remonte.
05n8n ou Make pour une base vectorielle ?
Ça dépend d'où tes documents ont le droit de vivre et de ta façon de payer. n8n s'auto-héberge en Docker ou npm, ou tourne sur n8n Cloud : une chaîne de recherche sur des documents sensibles peut rester sur une infrastructure que tu maîtrises, à côté du projet Supabase qui porte les vecteurs. Make est hébergé uniquement, sans option d'auto-hébergement, et facture à l'opération, ce qui se lit autrement quand une seule campagne d'ingestion touche des milliers de morceaux de texte. Les deux sont visuels. Tranche sur l'hébergement, la maîtrise des données et le modèle de coût.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.