- Accueil
- Ressources
- Intégrations
- Contextual AI
Intégration Contextual AI n8nAutomatiser Contextual AI avec n8n.
Contextual AI répond aux questions posées sur tes propres documents, et ce nœud fait entrer ce travail dans un workflow. L'intégration Contextual AI n8n couvre 13 opérations réparties sur 6 ressources, de la création d'un agent au reclassement d'une liste. Aucun trigger fourni : un autre nœud lance l'exécution.
Nœud communautaire Ce nœud n'est pas livré avec n8n : c'est un paquet communautaire (n8n-nodes-contextualai) à installer depuis Settings › Community nodes sur une instance auto-hébergée. npm
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert vraiment l'intégration Contextual AI n8n ?
Le nœud expose 13 opérations sur 6 ressources : Agent pour créer et gérer un assistant, Datastore pour stocker et ingérer les documents sur lesquels il répond, Query pour interroger cet agent, Reranker pour reclasser une liste de documents selon une requête, LMUnit pour noter une réponse par rapport à un test écrit, et Parser pour extraire le texte d'un fichier. Chacune remplace un appel que tu ferais autrement à la main.
Premier terrain, les contrats. Un dossier de PDF arrive, Parse Document lance un job de lecture, Parse Status dit quand c'est fini, Parse Result rend le texte structuré, et le résumé part dans un message Gmail au juriste. Personne n'ouvre le PDF pour recopier trois clauses.
Deuxième terrain, la documentation interne. Create Datastore crée le magasin, Ingest Document y dépose les fichiers, puis Query agent répond aux questions de l'équipe avec les documents comme seule source. Active Retrievals Only et la même opération renvoie les extraits retrouvés au lieu d'une réponse rédigée, pratique quand ce qu'on veut c'est la liste des sources.
Troisième terrain, la qualité des réponses. Rerank documents classe une présélection large et ne garde que le haut du panier, qui part ensuite vers un AI Agent. Run LMUnit vérifie la réponse contre une règle écrite, et un nœud If décide si elle sort ou si elle part en relecture humaine.
Ce que le nœud ne fait pas mérite d'être dit. Il n'a pas de trigger : un workflow démarre donc avec un Schedule Trigger à intervalle fixe, un Webhook n8n appelé par un service tiers, ou le trigger d'un autre outil. Le parsing est asynchrone, d'où les trois opérations séparées. Et les opérations de liste avancent page par page avec Limit et Cursor, sans bouton Return All.
Quand un endpoint de l'API Contextual AI manque au nœud, le nœud HTTP Request l'appelle directement en réutilisant le même credential via l'authentification prédéfinie. Et si la question reste de savoir si la plateforme te convient, l'Avis n8n pose les avantages et les points durs.
Comment connecter Contextual AI à n8n ?
- 01
Installer le paquet communautaire
Ouvre Settings, va dans Community nodes et installe
n8n-nodes-contextualai. L'opération se fait sur une instance auto-hébergée, qu'elle tourne avec Docker ou npm ; sur n8n Cloud, seuls les nœuds communautaires vérifiés sont installables. Une fois l'installation terminée, le nœud Contextual AI apparaît dans le panneau des nœuds comme n'importe quel autre. - 02
Créer le credential API Key
Dans le menu Credentials, ajoute un credential Contextual AI et colle ta clé. Le nœud s'authentifie par API Key, sous le type
contextualAiApi. Un credential, c'est la fiche d'accès que n8n garde de côté : elle se crée une fois et se réutilise dans tous les workflows, donc changer de clé plus tard tient en une seule modification. - 03
Choisir le credential dans le nœud
Pose le nœud Contextual AI sur le canvas et sélectionne le credential dans sa liste déroulante. Choisis ensuite la ressource, Agent, Datastore, Query, Reranker, LMUnit ou Parser, puis l'opération voulue. Le test le moins risqué reste List Agents : l'opération lit des données et ne modifie rien, donc une erreur ne casse rien côté Contextual AI.
Ce que le nœud Contextual AI sait faire
Le nœud Contextual AI expose 13 opérations sur 6 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
| Ressource | Create Agent | Create Datastore | Delete Agent | Get Document Metadata | Ingest Document | List Agents | List Datastores | Parse Document | Parse Result | Parse Status | Query agent | Rerank documents | Run LMUnit |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Agent | ✓ | ✓ | ✓ | ||||||||||
| Datastore | ✓ | ✓ | ✓ | ✓ | |||||||||
| Query | ✓ | ||||||||||||
| Reranker | ✓ | ||||||||||||
| LMUnit | ✓ | ||||||||||||
| Parser | ✓ | ✓ | ✓ |
Sommaire des opérations
Agent
3 opérationsCreate Agent
Agent.Create AgentCe que tu vois dans n8n
Notes & cas d'usage
Une seule exécution monte l'agent, son magasin de documents et les premiers fichiers. La réponse contient l'identifiant de l'agent, celui que réutilisent toutes les opérations suivantes.
Paramètres clés
- Agent Name : le nom donné au nouvel agent, par exemple un bot de support client.
- Configuration Mode : Pre-Built part d'un modèle Agent Composer, Custom attend ton YAML dans Custom Template.
- Pre-Built Template : Simple Search pour une recherche multimodale rapide, Agentic Search pour du raisonnement en plusieurs étapes.
- Datastore Configuration : créer un magasin via Datastore Name, ou rattacher les existants via Datastore IDs.
- System Prompt : les consignes que l'agent suit quand il rédige une réponse.
List Agents
Agent.List AgentsCe que tu vois dans n8n
Notes & cas d'usage
Ramène les agents du compte avec leur identifiant, ce qui permet à un workflow de retrouver le bon par son nom plutôt que de trimballer un ID écrit en dur.
Paramètres clés
- Limit : requis, le nombre maximal d'agents renvoyés en un appel.
- Cursor : la valeur rendue par l'appel précédent, pour aller chercher la suite des résultats.
Delete Agent
Agent.Delete AgentCe que tu vois dans n8n
Notes & cas d'usage
Supprime un agent définitivement. L'opération est irréversible, donc sa place est derrière une condition, pas au milieu d'un chemin normal.
Paramètres clés
- Agent ID : requis, l'identifiant de l'agent à supprimer, souvent
{{ $json.id }}repris d'une étape List Agents.
Datastore
4 opérationsCreate Datastore
Datastore.Create DatastoreCe que tu vois dans n8n
Notes & cas d'usage
Prépare un magasin vide qui recevra des documents plus tard. Utile quand le magasin doit exister avant que le reste du workflow ne tourne.
Paramètres clés
- Datastore Name : requis, le nom du magasin, par exemple celui qui accueille la documentation produit.
- Configuration (JSON String) : la configuration du magasin en JSON sérialisé ; laissée vide, la configuration par défaut s'applique.
Ingest Document
Datastore.Ingest DocumentCe que tu vois dans n8n
Notes & cas d'usage
Envoie un fichier porté par l'item entrant dans un magasin, où il devient de la matière consultable par un agent.
Paramètres clés
- Datastore ID : requis, le magasin qui reçoit le document.
- Input Binary Field(s) : le nom du champ binaire sur l'item entrant ; laissé vide, tous les champs binaires partent.
- Metadata (JSON String) : une requête de métadonnées en JSON sérialisé, dont
custom_metadataest un dictionnaire plat de clés et de valeurs.
Get Document Metadata
Datastore.Get Document MetadataCe que tu vois dans n8n
Notes & cas d'usage
Lit les métadonnées et l'état de traitement d'un document, ce qui reste la façon la plus simple de savoir si l'ingestion est réellement terminée.
Paramètres clés
- Datastore ID : requis, le magasin qui contient le document.
- Document ID : requis, l'identifiant du document inspecté.
List Datastores
Datastore.List DatastoresCe que tu vois dans n8n
Notes & cas d'usage
Renvoie les magasins du compte, avec la possibilité de ne garder que ceux rattachés à un agent précis.
Paramètres clés
- Limit : requis, le nombre maximal de magasins renvoyés en un appel.
- Cursor : la valeur de l'appel précédent, pour passer à la page suivante.
- Agent ID : filtre la liste sur les magasins liés à cet agent.
Query
1 opérationQuery agent
Query.Query agentCe que tu vois dans n8n
Notes & cas d'usage
Pose une question à un agent et récupère sa réponse, appuyée sur les documents auxquels cet agent a accès.
Paramètres clés
- Agent ID : requis, l'agent qui répond.
- Query : requis, la question elle-même, souvent
{{ $json.question }}venue d'un formulaire. - Retrievals Only : activé, l'opération récupère les extraits et saute la génération.
- Include Retrieval Content Text : ajoute le texte des contenus retrouvés à la réponse.
- Conversation ID : poursuit une conversation existante ; renseigné, l'historique fourni est ignoré.
Reranker
1 opérationRerank documents
Reranker.Rerank documentsCe que tu vois dans n8n
Notes & cas d'usage
Note une série de textes face à une question et les rend triés par pertinence, pour que seuls les bons continuent le parcours.
Paramètres clés
- Query : requis, la question qui sert de référence au classement.
- Documents : requis, la liste des textes séparés par des virgules.
- Model :
ctxl-rerank-v2-instruct-multilingual, sa variante mini, ouctxl-rerank-v1-instruct. - Top N : le nombre de résultats de tête renvoyés ; à 0, tout revient.
- Instruction : une consigne facultative pour orienter le classement.
LMUnit
1 opérationRun LMUnit
LMUnit.Run LMUnitCe que tu vois dans n8n
Notes & cas d'usage
Évalue une réponse contre une règle écrite, ce qui transforme une impression vague sur la qualité en quelque chose sur quoi un workflow peut brancher.
Paramètres clés
- Query : requis, la question qui a été posée.
- Response : requis, la réponse soumise à l'évaluation.
- Unit Test : requis, la règle que la réponse doit respecter, écrite en une phrase.
Parser
3 opérationsParse Document
Parser.Parse DocumentCe que tu vois dans n8n
Notes & cas d'usage
Démarre un job de lecture sur un fichier porté par l'item entrant. Il rend le job, pas le texte, d'où les deux opérations qui suivent.
Paramètres clés
- Input Binary Field(s) : le nom du champ binaire de l'item entrant à parser.
- Parse Mode : Standard est le mode proposé.
- Figure Caption Mode : des légendes de figures Concise ou Detailed.
- Enable Document Hierarchy : conserve la structure du document.
- Page Range : limite le job à une plage de pages.
Parse Status
Parser.Parse StatusCe que tu vois dans n8n
Notes & cas d'usage
Indique où en est un job de lecture. C'est l'étape d'attente entre le lancement du job et la récupération de ce qu'il a produit.
Paramètres clés
- Job ID : requis, l'identifiant du job à contrôler, repris de l'opération qui l'a lancé.
Parse Result
Parser.Parse ResultCe que tu vois dans n8n
Notes & cas d'usage
Récupère la sortie d'un job de lecture terminé et la passe à la suite du workflow.
Paramètres clés
- Job ID : requis, l'identifiant du job dont on veut les résultats.
- Output Types : une liste séparée par des virgules parmi
markdown-document,markdown-per-pageetblocks-per-page.
Besoin d'aide pour automatiser Contextual AI avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.


