Ressources · Intégration n8n

Nœud Azure AI Search Vector Store n8nConfigurer Azure AI Search Vector Store dans n8n.

Azure AI Search garde tes embeddings, le nœud Azure AI Search Vector Store n8n est le tuyau entre les deux. Deux paramètres de tête pilotent tout : un Operation Mode à 5 choix, de l’insertion de documents à l’exposition de l’index comme outil d’agent, et l’Index Name que n8n crée s’il manque.

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

Pourquoi automatiser

À quoi sert vraiment le nœud Azure AI Search Vector Store n8n ?

Azure AI Search, l'ancien Azure Cognitive Search, est un service de recherche cloud doté de recherche vectorielle pour le RAG et la recherche sémantique. Ce nœud y stocke, y relit et y interroge des embeddings, c'est-à-dire la traduction de ton texte en suite de nombres, à côté du contenu et des métadonnées d'origine. Il tourne comme un nœud d'action normal, une fois par item entrant, et n'a pas de port de sous-nœud à lui.

Premier cas : une base de connaissance interrogeable. Des documents arrivent dans le workflow, un modèle d'embeddings les transforme en vecteurs, le nœud en mode insert les charge dans l'index. Le Batch Size règle le nombre de documents envoyés par lot vers Azure AI Search, ce qui compte dès que les fichiers s'allongent. Personne d'autre dans le workflow n'a besoin de connaître le schéma de l'index, puisque le nœud le crée s'il manque.

Deuxième cas : répondre à des questions depuis un agent. Bascule l'Operation Mode sur retrieve-as-tool et l'index devient un outil que l'AI Agent appelle de lui-même. Les champs Name et Description sont ce que le modèle lit pour décider si l'outil colle à la question. Une description floue, et tu obtiens un agent qui ne cherche jamais. Le modèle de chat, lui, vient d'OpenAI, d'Anthropic ou de Google Gemini, selon le fournisseur dont tu as déjà la clé.

Troisième cas : une recherche ponctuelle et classée. En mode load, le nœud prend un Prompt, classe les documents par similarité et passe le résultat à l'étape suivante, un message Slack ou une ligne ajoutée dans Google Sheets. Include Metadata décide si les métadonnées du document voyagent avec le texte.

Quand prendre autre chose : si tes documents ne bougent jamais et que tu en relis toujours les mêmes trois, une simple recherche dans un tableau coûte moins cher à faire tourner qu'un index. Le vector store prend son intérêt quand la similarité compte plus que l'égalité exacte, ou quand un agent doit chercher sans que tu écrives la requête.

Les limites méritent un détour avant de t'engager. Le nom de l'index est sensible à la casse. La sortie de ton modèle d'embeddings doit correspondre aux dimensions vectorielles de l'index, sinon l'insertion échoue sur un écart de dimensions. Les écritures réclament la clé d'API admin, une clé de requête ne fait que lire. Et le nœud couvre ce que ses 2 paramètres de tête exposent, pas plus : administration de l'index, retouche du schéma et création du service restent dans le portail Azure.

Connexion

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

  1. 01

    Créer le service de recherche dans Azure

    Côté Azure, trois prérequis : un abonnement Azure, un service Azure AI Search qui tourne dedans, et l'authentification par clé d'API configurée sur ce service. Une fois le service en place, il expose un endpoint de la forme https://ton-service.search.windows.net, et c'est cette URL que n8n réclame. Rien de tout ça n'est créé par n8n : commence dans le portail Azure et reviens avec l'endpoint sous la main.

  2. 02

    Choisir la bonne clé d'API

    Azure AI Search distribue deux types de clés, et le choix n’a rien de décoratif. La clé admin couvre les écritures, donc insert et update. La clé de requête est en lecture seule, suffisante pour load, retrieve et retrieve-as-tool. Beaucoup d’échecs d’insertion qui ressemblent à un souci de schéma viennent d’une clé sans droit d’écriture.

  3. 03

    Enregistrer le credential une fois dans n8n

    Dans n8n, le credential Azure AI Search, c’est-à-dire le jeu d’identifiants enregistré une bonne fois, se crée depuis le menu Credentials avec l’endpoint et la clé, puis se réutilise dans tous les workflows. Vrai sur n8n Cloud comme en auto-hébergé. Le nœud n’a aucun sélecteur Authentication : l’authentification se règle uniquement dans le credential.

Paramètres

Quels paramètres régler, et à quel moment ?

Le nœud Azure AI Search 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

Règle ce sélecteur en premier : il commande les champs du panneau.

Paramètres clés

  • Operation Mode : insert (Insert Documents) écrit les documents, load (Get Many) récupère les documents classés, update (Update Documents) les met à jour par ID, retrieve expose le store à une chaîne, retrieve-as-tool à un agent IA.
  • Name et Description : requis en mode outil, lus par le modèle.
  • Prompt : la requête derrière le classement par similarité, souvent {{ $json.question }}.
  • Limit, Include Metadata, Rerank Results : combien de résultats de tête reviennent, si les métadonnées suivent, si les résultats sont reclassés.
  • ID : l’identifiant d’une entrée d’embedding, requis pour la mise à jour.
Cas d’usage
un workflow insère les fiches produit la nuit, un second y répond en mode outil.
02

Index Name

indexName

Ce que tu vois dans n8n

Notes & cas d'usage

Le nom de l'index Azure AI Search que le nœud lit ou alimente. Il est demandé dans tous les modes, et n8n crée l'index automatiquement s'il n'existe pas : autrement dit, une faute de frappe ne lève aucune erreur, elle fabrique sans bruit un second index vide.

Paramètres clés

  • Index Name : une chaîne simple, sensible à la casse, qui désigne un index de ton service ; laisse-la figée pour une base unique, ou pilote-la depuis l'item avec {{ $json.index }} quand un seul workflow sert plusieurs collections.
Cas d'usage
un index par langue ou par client, choisi d'après l'item entrant, pour qu'un seul workflow d'insertion les alimente tous sans branchement conditionnel.
Besoin d'aide

Besoin d'aide pour automatiser Azure AI Search 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 Azure AI Search Vector Store n8n est-il inclus dans n8n ?
Oui. Il fait partie du paquet IA de n8n, @n8n/n8n-nodes-langchain, qui est livré avec n8n. Rien à installer, aucun surcoût côté n8n, aussi bien sur n8n Cloud que sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté se comporte pareil de l'autre. Ce qui coûte de l'argent est ailleurs : ton service Azure AI Search est facturé par Azure, et le fournisseur du modèle d'embeddings facture ses propres appels d'API selon ses conditions. n8n n'ajoute rien à l'une ni à l'autre de ces factures.
02Quel credential faut-il pour ce nœud ?
Un seul, celui d'Azure AI Search. Tu authentifies le service de recherche avec ton endpoint, de la forme https://ton-service.search.windows.net, et une clé d'API issue de ce service. Le choix de la clé dépend de ce que fait le workflow : la clé admin est obligatoire pour les écritures, insert et update, tandis que la clé de requête est en lecture seule et couvre les modes de recherche. Les prérequis tiennent en trois points : un abonnement Azure, un service Azure AI Search qui tourne, l'authentification par clé d'API configurée dessus. Le nœud n'a pas de sélecteur Authentication : le credential se crée une fois depuis le menu Credentials et se réutilise partout.
03Quelles sont les limites du nœud ?
Il expose 2 paramètres de tête, et c'est toute sa surface : Operation Mode avec ses 5 choix, et Index Name. L'administration de l'index reste dans Azure, donc le schéma, le palier de service et les politiques d'accès se règlent dans le portail. Trois pannes reviennent souvent. Un nom d'index qui ne correspond pas, puisque la casse compte et qu'un mauvais nom crée silencieusement un index vide. Un écart de dimensions vectorielles, quand la sortie du modèle d'embeddings ne colle pas au champ vectoriel de l'index. Et des insertions qui échouent à cause d'une clé sans droit d'écriture ou de documents qui ne correspondent pas au schéma. Le nœud n'a pas non plus de port de sous-nœud : il s'exécute sur chaque item entrant.
04Qu'est-ce qu'il faut brancher au minimum pour démarrer ?
En plus du credential, un modèle d'embeddings dont les dimensions de sortie correspondent à l'index, et un nom d'index. Commence en mode insert avec une petite série de documents et laisse n8n créer l'index : il y met les champs vectoriels d'après ton modèle d'embeddings, un graphe HNSW pour la recherche par similarité avec une métrique cosinus, plus les champs de contenu et de métadonnées. Regarde le résultat dans Azure, puis passe un second nœud en mode load avec un Prompt pour vérifier que le classement tient la route. C'est seulement une fois là que brancher retrieve-as-tool derrière un agent devient utile : un outil qui ne renvoie rien se débogue bien plus mal qu'une requête qui ne renvoie rien.
05n8n ou Make pour un workflow de vector store ?
Ça dépend d'où tes données doivent vivre. Make est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : un workflow qui pousse des milliers de documents dans un index a donc un coût qui suit le volume. n8n tourne sur n8n Cloud ou sur ton infrastructure, ce qui pèse quand les documents sont sensibles et que tu préfères qu'ils ne sortent pas du réseau, en particulier à côté d'un service Azure joignable par point de terminaison privé. Les deux se construisent visuellement. Le vrai partage se joue entre confort de l'hébergé et maîtrise des données et du modèle de coût.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.