Ressources · Intégration n8n

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

Le nœud Chroma Vector Store n8n branche une collection Chroma sur un workflow, en lecture comme en écriture. Un seul nœud, quatre modes d'opération et trois paramètres à régler : le mode, la collection visée, et le choix entre une instance auto-hébergée et Chroma Cloud.

Tester le nœud Chroma Vector Store sur n8nVoir les 3 paramètres

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

Pourquoi automatiser

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

Chroma est une base de données vectorielle, et ce nœud est la porte d'entrée de n8n vers elle. Il y écrit des documents sous forme d'embeddings, la représentation chiffrée d'un texte qui permet de chercher sur le sens plutôt que sur les mots exacts, et il les relit classés par proximité avec une question. Le nœud fait partie du paquet IA de n8n, s'exécute sur chaque item entrant comme un nœud d'action ordinaire, et regroupe quatre métiers différents derrière un unique sélecteur Operation Mode.

Premier métier : remplir la base. En mode insert, le nœud prend les documents qui arrivent sur son entrée et les écrit dans la collection Chroma choisie. Comptes rendus de réunion, fiches produit, réponses types du service client, tout ce qui circule dans le workflow sous forme de texte. Le réflexe qui change tout : brancher cette branche sur un déclencheur planifié, pour que la collection suive la source au lieu de figer l'état du premier import.

Deuxième métier : la recherche sèche, sans intelligence artificielle autour. Le mode load, affiché Get Many, prend un Prompt et renvoie les documents les plus proches. Une ligne ajoutée dans Google Sheets décrit une demande entrante, le nœud remonte les passages utiles, et la réponse repart avec ses sources. Aucun agent dans l'histoire, juste une recherche qui comprend une phrase.

Troisième métier, celui qu'on vient chercher : retrieve-as-tool transforme la collection en outil, c'est-à-dire en capacité qu'un agent peut appeler de lui-même quand il estime en avoir besoin. C'est ce mode qu'on relie à un AI Agent. Les champs Name et Description pèsent plus lourd qu'ils n'en ont l'air : la description est la seule chose que le modèle lit avant de décider s'il appelle l'outil. Le mode retrieve rend le même service à une chaîne plutôt qu'à un agent.

Quand vaut-il mieux autre chose ? Quand la recherche est exacte. Un numéro de commande, un identifiant client, un code pays : une recherche de ligne classique va plus vite, coûte moins cher et ne renvoie jamais un résultat approchant. La recherche par similarité prend son sens dès que la question est posée en langage humain et que la réponse se cache dans un paragraphe. Pour une veille web en direct, un appel à Perplexity répond à un autre besoin : la collection Chroma sert les documents qu'on maîtrise, pas le web ouvert.

Les limites, tant qu'à faire. Le nœud est en version 1 et expose ces quatre modes, rien de plus : pas de suppression, pas de gestion de collection. Le champ Chroma Collection est obligatoire, donc la collection existe avant le premier run. Côté facture, le fournisseur des embeddings, OpenAI ou un autre, facture ses propres appels d'API, n8n n'ajoute rien par-dessus. Et si le sujet des bases vectorielles est neuf pour l'équipe, la Formation n8n couvre ce terrain.

Connexion

Comment connecter n8n à Chroma ?

  1. 01

    Choisir le type d'authentification

    Ouvre le nœud et commence par le sélecteur Authentication : c'est lui qui décide du credential que n8n va réclamer ensuite. Deux options, pas une de plus. chromaSelfHostedApi, affiché Self-Hosted, vise une instance ChromaDB hébergée par tes soins. chromaCloudApi, affiché Cloud, vise Chroma Cloud. Le bon choix est celui qui correspond à l'endroit où les documents vivent déjà.

  2. 02

    Créer le credential une seule fois

    Un credential, dans n8n, c'est un jeu d'informations de connexion enregistré à part du workflow. Crée-le depuis le menu Credentials, ou directement depuis le nœud avec Create New. Il devient réutilisable : tous les autres workflows qui touchent la même instance Chroma pointent vers cette entrée unique. Une clé à changer plus tard ? Un seul endroit à modifier, pas un nœud après l'autre.

  3. 03

    Sélectionner la collection

    Dernière étape, le champ Chroma Collection. C'est un resource locator, le contrôle n8n qui laisse choisir dans une liste, coller un identifiant, ou composer la valeur avec une expression du type {{ $json.collection }} quand le nom vient d'un nœud précédent. Le champ est obligatoire, et la liste ne se remplit qu'avec un credential valide : voilà pourquoi cette étape arrive en troisième et pas en première.

Paramètres

Quels paramètres régler sur le nœud ?

Le nœud Chroma Vector Store compte 3 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 décide de ce que le nœud est ici : un écrivain, une recherche, ou l'outil d'un nœud IA. À régler en premier.

Paramètres clés

  • Operation Mode : load (Get Many) renvoie les documents classés, insert (Insert Documents) les écrit, retrieve (Retrieve Documents (As Vector Store for Chain/Tool)) sert une chaîne, retrieve-as-tool (Retrieve Documents (As Tool for AI Agent)) sert un agent.
  • Prompt et Limit : le texte cherché, souvent {{ $json.question }}, et le nombre de résultats.
  • Name et Description : ce qu'un agent voit, par exemple company_knowledge_base.
  • Include Metadata, Rerank Results, Options, ID : les métadonnées, un second classement, les options, une entrée.
Cas d'usage
une branche en insert rafraîchit la collection chaque nuit, une autre en retrieve-as-tool la sert à un agent.
02

Authentication

authentication

Ce que tu vois dans n8n

Notes & cas d'usage

Rien à voir avec la recherche ici : ce paramètre dit quel Chroma le nœud doit joindre, et donc quel type de credential n8n affiche en dessous.

Paramètres clés

  • Authentication : chromaSelfHostedApi (Self-Hosted) se connecte à une instance ChromaDB auto-hébergée, chromaCloudApi (Cloud) se connecte à Chroma Cloud.
Cas d'usage
une équipe qui garde ses documents sur ses propres serveurs reste en Self-Hosted, rien ne sort du réseau. Une petite structure sans serveur à maintenir prend Cloud et retrouve exactement le même comportement de nœud. Basculer plus tard revient à créer l'autre credential : le mode, le prompt et la collection ne bougent pas.
03

Chroma Collection

chromaCollection

Ce que tu vois dans n8n

Notes & cas d'usage

Une instance Chroma héberge plusieurs collections, et ce champ désigne celle que le nœud lit ou alimente. Il est obligatoire : laissé vide, il arrête le nœud avant toute action.

Paramètres clés

  • Chroma Collection : un resource locator, donc une valeur prise dans la liste, collée sous forme d'identifiant, ou calculée par une expression comme {{ $json.collection }}.
Cas d'usage
une collection par langue ou par client, et ce champ devient à lui seul la logique d'aiguillage. Le workflow calcule le nom en amont, le pose dans l'expression, et une seule branche sert tout le monde au lieu d'un nœud dupliqué par public.
Besoin d'aide

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

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Chroma Vector Store dans n8n, les questions fréquentes

01Le nœud Chroma Vector Store est-il inclus dans n8n ?
Oui. Il appartient au paquet IA de n8n et arrive avec n8n, sur n8n Cloud comme sur une instance auto-hébergée : rien à installer, aucun surcoût côté n8n, et un workflow se comporte pareil des deux côtés. Ce qui coûte quelque chose est ailleurs. Le fournisseur dont tu utilises les embeddings facture ses propres appels d'API selon ses conditions. Chroma, de son côté, est soit une instance que tu héberges, soit un compte Chroma Cloud, selon l'option retenue dans le sélecteur Authentication. Le nœud est donc gratuit, les services autour suivent leur propre tarification, et n8n ne prend rien au passage.
02Que faut-il pour faire tourner le nœud Chroma Vector Store n8n ?
Trois choses, et elles collent aux trois paramètres. D'abord un choix dans Authentication : Self-Hosted pour une instance ChromaDB que tu fais tourner, Cloud pour Chroma Cloud. C'est ce choix qui détermine le type de credential. Ensuite le credential lui-même, créé une fois depuis le menu Credentials, puis réutilisé par tous les workflows qui touchent la même instance. Enfin une collection, choisie dans le champ Chroma Collection ou construite par une expression ; elle est obligatoire, un champ vide bloque l'exécution. Une fois ces trois points réglés, il ne reste qu'à choisir le mode d'opération, qui commande tout le reste du panneau.
03Quelles sont les limites du nœud ?
Il est en version 1, et le sélecteur Operation Mode propose quatre choix : Get Many, Insert Documents, Retrieve Documents comme base vectorielle pour une chaîne ou un outil, et Retrieve Documents comme outil pour un agent. Tout ce qui sort de ces quatre modes sort du nœud. Aucun mode ne supprime de document ni ne gère les collections : la collection doit donc exister avant le premier run, ce qui explique aussi que le champ Chroma Collection soit obligatoire et pas optionnel. Côté lecture, la surface de réglage reste volontairement courte : un Prompt, un Limit, Include Metadata, Rerank Results, une collection Options et un ID pour une entrée précise.
04Que faut-il brancher dessus dans un workflow IA ?
Rien, justement. Les workflows IA de n8n reposent sur un nœud racine et des sous-nœuds, ces petits nœuds raccordés à ses ports qui ne s'exécutent jamais seuls. Celui-ci n'est pas un parent de ce genre : il tourne comme un nœud d'action normal, une fois par item entrant. Dans les deux modes Retrieve, c'est lui qu'on raccorde ailleurs, soit comme base vectorielle pour une chaîne, soit comme outil qu'un agent appelle quand il juge qu'une question mérite un document. Dans Get Many et Insert Documents, il reste une étape de la chaîne, qui reçoit des items et transmet un résultat.
05n8n ou Make pour un workflow Chroma ?
Tout dépend de l'endroit où les documents ont le droit de vivre. Make est une plateforme hébergée, sans auto-hébergement possible, facturée à l'opération : pratique quand personne n'a envie de maintenir un serveur et qu'un éditeur visuel prévisible suffit. n8n fonctionne aussi bien avec Chroma Cloud qu'avec une instance ChromaDB posée sur le réseau interne, et c'est ce point qui tranche dès que les documents sont des contrats, des notes médicales ou des dossiers sensibles. Autre détail concret : un workflow de recherche boucle et se réajuste beaucoup pendant les réglages, et une facturation à l'opération se sent davantage à ce moment-là. Aucune des deux réponses n'est fausse, c'est la contrainte qui décide.
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