Ressources · Intégration n8n

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

Un vector store range des représentations mathématiques de tes contenus, pour qu'une IA les retrouve par le sens et pas par mot-clé. Le nœud Qdrant Vector Store n8n lit et alimente une collection Qdrant via 2 paramètres et 4 modes d'opération. Pour qui monte de la recherche documentaire.

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

Pourquoi automatiser

À quoi sert vraiment le nœud Qdrant Vector Store n8n ?

Le nœud relie un workflow à une collection Qdrant, c'est-à-dire un espace nommé où sont rangés les vecteurs. Selon le mode d'opération choisi, il y écrit des documents, en ressort ceux qui collent le mieux à une question, ou met la collection à disposition d'un autre nœud IA qui ira l'interroger tout seul. Un seul nœud, quatre rôles, la même collection derrière.

Premier montage, celui qui remplit. Mode Insert Documents, des contenus qui arrivent des étapes précédentes, et chaque item part dans la collection. La doc n8n montre ce schéma dans un template de chatbot de recommandation de films (workflow 2440) : découpage, vectorisation, écriture dans Qdrant, avant la moindre question. Rien ne répond encore, on garnit les rayons.

Deuxième montage, celui qui cherche. Le mode Get Many prend un Prompt, classe les documents stockés par similarité et renvoie les meilleurs sous forme d'items n8n ordinaires. Ce résultat repart où tu veux : un message Slack à l'équipe support, une ligne dans Google Sheets pour tracer ce qui a été retrouvé, un brouillon de réponse via Gmail. C'est le mode à prendre quand tu veux le texte retrouvé entre tes mains plutôt que dans le prompt d'un modèle.

Troisième montage, celui qui délègue. Retrieve Documents (As Tool for AI Agent) transforme le nœud en outil qu'un AI Agent appelle par son nom, d'où les champs Name et Description qui apparaissent dans ce mode. Retrieve Documents (As Vector Store for Chain/Tool) joue la version discrète : le nœud se place derrière un nœud Vector Store Retriever, et une Question and Answer Chain vient y puiser son contexte. La doc n8n décrit aussi la variante Vector Store Question Answer Tool, qui résume les résultats avant que l'agent ne les voie.

Là où ça s'arrête. Le nœud parle à des collections Qdrant, point. Il ne fabrique pas les embeddings, ces vecteurs viennent d'un nœud séparé, et c'est pour ça que les templates l'associent aux embeddings OpenAI ou Mistral Cloud. Sa version est la 1, donc un vieux workflow peut afficher moins d'options que le panneau décrit ici. Si c'est la qualité des réponses qui coince plutôt qu'un réglage, la Formation n8n traite l'ordre de construction.

Connexion

Qu'est-ce qu'il faut avant que le nœud tourne ?

  1. 01

    Créer le credential Qdrant

    Ajoute le credential Qdrant depuis le menu Credentials : une API Key et ton Qdrant URL. La clé se récupère dans le Cloud Dashboard de Qdrant, section Access Management, rattachée au cluster visé. Tu le fais une fois : le credential est réutilisé par tous les workflows qui parlent à la même instance.

  2. 02

    Le rattacher au nœud

    Pose le nœud Qdrant Vector Store sur le canvas et sélectionne ce credential dans son champ dédié. Le même nœud assure les 4 modes d'opération, donc ce que tu choisis ici servira aussi bien au workflow qui remplit la collection qu'à celui qui l'interroge. Aucun autre champ du panneau n'en dépend, tu peux donc le régler avant même de savoir ce que le nœud fera.

  3. 03

    Viser une collection

    Renseigne Qdrant Collection, le resource locator qui désigne la collection lue ou alimentée. Il est requis dans tous les modes. Un resource locator, c'est un champ qui accepte aussi bien une valeur choisie dans une liste qu'une valeur saisie : pratique quand le nom de collection vient d'une étape précédente sous forme d'expression, par exemple {{ $json.collection }}.

Paramètres

Quels paramètres régler dans le panneau ?

Le nœud Qdrant 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 décide de ce qu'est le nœud, et tout le reste du panneau en découle.

Paramètres clés

  • Operation Mode : insert (Insert Documents) écrit des documents, load (Get Many) renvoie des documents classés, 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 : la requête, et le nombre de résultats de tête, 10 pour les dix meilleurs.
  • Name et Description : ce que voit un agent, company_knowledge_base et son explication.
  • Include Metadata, Rerank Results, ID : les métadonnées avec le texte, le reclassement, l'identifiant d'une entrée d'embedding.
Cas d'usage
un workflow en insert tient à jour une collection de procédures, un autre en retrieve-as-tool l'exploite.
02

Qdrant Collection

qdrantCollection

Ce que tu vois dans n8n

Notes & cas d'usage

Chaque mode a besoin de savoir sur quelle collection il travaille, et c'est ce champ qui le dit. Il s'agit d'un resource locator, le type de champ n8n qui accepte une valeur choisie ou saisie, et il est marqué requis.

Paramètres clés

  • Qdrant Collection : la collection que le nœud lit ou alimente, réglée une fois par nœud, sélectionnée dans le panneau ou construite par une expression comme {{ $json.collection }} quand le nom arrive avec l'item.
Cas d'usage
une agence qui garde une collection par client choisit la valeur dynamiquement, et le même workflow de recherche sert tous les comptes sans duplication.
Besoin d'aide

Besoin d'aide pour automatiser Qdrant 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 Qdrant Vector Store est-il inclus dans n8n ?
Oui. Il fait partie du paquet IA de n8n, le bundle @n8n/n8n-nodes-langchain livré avec n8n : rien à installer, aucun surcoût côté n8n, et aucune manipulation d'instance. C'est vrai sur n8n Cloud, l'offre hébergée par n8n, comme sur une instance auto-hébergée en Community Edition sous licence Sustainable Use, et un workflow s'y comporte exactement de la même façon. Ce qui se facture est ailleurs : le fournisseur du modèle utilisé pour les embeddings facture ses propres appels d'API selon ses conditions, et n8n n'ajoute rien par-dessus.
02Que faut-il pour que le nœud Qdrant Vector Store n8n fonctionne ?
Un credential et une collection. Le credential se crée une fois dans le menu Credentials et se réutilise dans tous les workflows ; la doc n8n du nœud renvoie vers la page de credentials qui liste les valeurs à fournir. Ensuite le champ Qdrant Collection, un resource locator requis, indique la collection visée. Le reste dépend du mode : les modes de recherche demandent un Prompt, et le mode outil pour agent demande un Name et une Description pour que le modèle sache ce qu'il appelle.
03Quelles sont les limites de ce nœud ?
Il travaille avec une collection Qdrant, et c'est tout. Il ne produit pas les embeddings, raison pour laquelle les templates publiés l'accompagnent d'un nœud d'embeddings OpenAI ou Mistral Cloud, d'un découpeur de texte et d'un chargeur de données. Le catalogue donne la version 1 pour ce nœud, donc un ancien workflow peut afficher moins d'options que le panneau actuel. Le filtrage passe par l'option de nœud Metadata Filter, et en Insert Documents l'option Collection Config attend du JSON pour la configuration de création de la collection.
04Que brancher au minimum, et par où commencer ?
Commence par la moitié qui remplit. Un workflow en Insert Documents, un chargeur de données et un découpeur de texte en amont, un nœud d'embeddings pour transformer le texte en vecteurs, et une collection qui se garnit. La partie lecture vient après. Le lecteur le plus simple est Get Many, parce que les résultats reviennent en items n8n que tu peux ouvrir et vérifier. Quand ça remonte ce que tu attends, passe à Retrieve Documents (As Tool for AI Agent) pour confier la collection à un agent, ou place un Vector Store Retriever devant une Question and Answer Chain.
05n8n ou Make pour un workflow de vector store ?
Ça dépend d'où doivent vivre les données. n8n s'auto-héberge en Docker ou npm, ou tourne sur n8n Cloud : un pipeline RAG qui vise ton instance Qdrant peut rester de bout en bout dans ton réseau. Make est hébergé uniquement, sans option d'auto-hébergement, et se facture à l'opération, ce qui change la donne quand une passe d'ingestion écrit des milliers de documents. La logique visuelle diffère aussi. Tranche sur l'hébergement, la maîtrise des données, le modèle de coût et ta façon de construire, pas sur une liste de fonctionnalités.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.