Agent IA dans n8n : configurer le RAG et les outils pour un agent autonome

Le noeud AI Agent de n8n permet de creer des agents capables de raisonner, d’utiliser des outils et d’interroger des bases de connaissances. Combine au RAG (Retrieval-Augmented Generation), il transforme un workflow d’automatisation en assistant qui repond a partir de vos donnees internes - pas a partir de son entrainement general. Cet article detaille l’architecture technique, la configuration pas a pas et un retour de deploiement en production sur un service client.

Mis a jour : mars 2026.

Architecture du noeud AI Agent dans n8n

Le noeud AI Agent est le composant central des workflows d’intelligence artificielle dans n8n. Introduit dans la version 1.19.0 (octobre 2023) et refondu en profondeur a partir de la version 1.60 en 2024, il fonctionne comme un orchestrateur qui coordonne quatre types de sous-noeuds (documentation officielle).

• LLM : le modele de langage qui raisonne (Claude, GPT-4, Mistral, Ollama)
• Tools : les outils que l’agent peut appeler (HTTP Request, Calculator, Code, Workflow Tool, MCP Client)
• Memory : le stockage du contexte conversationnel (Window Buffer Memory, Motorhead, Redis)
• Output Parser : le formatage structure des reponses (JSON, liste, texte)

L’agent recoit une requete, la transmet au LLM avec le contexte disponible, et le LLM decide quels outils appeler pour construire sa reponse. Ce mecanisme repose sur le function calling - une capacite native des LLM recents comme Claude (Anthropic) et GPT-4 (OpenAI) - qui permet au modele de generer des appels d’outils structures au lieu de texte libre. Source : docs.n8n.io.

Les trois types d’agents disponibles

n8n propose trois modes de fonctionnement pour le noeud AI Agent. Le choix du type determine comment l’agent raisonne et utilise ses outils.

Tools Agent

Le mode le plus utilise. L’agent utilise le function calling du LLM pour choisir quel outil appeler, avec quels parametres, et dans quel ordre. Il peut enchainer plusieurs appels d’outils dans une meme requete. C’est le mode recommande pour la plupart des cas d’usage, car il produit les resultats les plus fiables avec les LLM recents. Compatible avec Claude, GPT-4, GPT-3.5 Turbo et Mistral.

ReAct Agent

Le mode ReAct (Reasoning + Acting) alterne explicitement entre phases de reflexion et phases d’action. L’agent ecrit son raisonnement a chaque etape avant de choisir une action. Ce mode est plus lent mais offre une meilleure tracabilite - utile pour le debug ou les taches complexes qui necessitent un raisonnement en plusieurs etapes. Il consomme plus de tokens car le raisonnement intermediaire est envoye au LLM a chaque iteration.

Conversational Agent

Concu pour les echanges multi-tours avec un utilisateur. Il maintient le fil de la conversation via la memoire et gere les demandes de clarification. Ce mode est adapte aux chatbots et interfaces conversationnelles ou l’utilisateur interagit en plusieurs messages successifs.

Configurer le RAG dans n8n : le pipeline complet

Le RAG (Retrieval-Augmented Generation) permet a l’agent d’interroger une base de connaissances avant de formuler sa reponse. Au lieu de repondre a partir de son entrainement general, il recupere les documents pertinents et genere une reponse basee sur des donnees concretes. Le pipeline RAG dans n8n se configure entierement via les sous-noeuds, sans ecrire de code.

Etape 1 - Ingestion des documents

Le workflow d’ingestion transforme vos documents bruts en vecteurs stockes dans une base vectorielle. La chaine de traitement dans n8n suit cet ordre : Un exemple concret de ce type de traitement : classer des factures automatiquement avec n8n.

1. Document Loader : charge le contenu (PDF Loader, Text Loader, HTML Loader, ou un noeud custom via HTTP Request)
2. Text Splitter : decoupe le texte en chunks. Le Recursive Character Text Splitter est le plus courant - il decoupe en respectant les limites de paragraphes et de phrases. Taille recommandee : 400-800 tokens avec un overlap de 50-100 tokens
3. Embedding Model : transforme chaque chunk en vecteur numerique. Options natives dans n8n : OpenAI (text-embedding-3-small ou text-embedding-3-large), Cohere, Mistral, Ollama pour des embeddings locaux
4. Vector Store : stocke les vecteurs. Bases supportees nativement : Pinecone, Qdrant, Supabase Vector, PGVector, Chroma, Weaviate, Zep, In-Memory

Source : docs.n8n.io - Sub-nodes.

Etape 2 - Retrieval au moment de la requete

Quand l’agent recoit une question, le sous-noeud Vector Store Tool (ou Retrieve Documents) convertit la question en vecteur via le meme modele d’embedding, puis cherche les N chunks les plus proches dans la base vectorielle. Par defaut, n8n retourne les 4 chunks les plus similaires - ce parametre est configurable dans les options du noeud. Les chunks recuperes sont injectes dans le prompt du LLM comme contexte, et le modele genere sa reponse a partir de ces donnees.

Options de stockage vectoriel

Le choix de la base vectorielle depend du contexte de deploiement. Pour les projets ou la simplicite et l’interface utilisateur comptent, AnythingLLM offre une solution complete qui integre le stockage vectoriel, la gestion des documents et une interface de chat - il se connecte a n8n via API ou webhook. Pour une base vectorielle pure integree a PostgreSQL, Supabase Vector (pgvector) permet de stocker les vecteurs dans la meme infrastructure que les donnees metier. Pour le prototypage rapide, le mode In-Memory de n8n fonctionne sans configuration externe mais ne persiste pas entre les executions.

Les outils que l’agent peut utiliser

La puissance d’un agent depend directement des outils a sa disposition. Dans n8n, chaque outil est un sous-noeud connecte au noeud AI Agent. L’agent lit la description de chaque outil et decide lequel utiliser en fonction de la requete. Une description claire et precise de chaque outil est donc critique - c’est elle qui guide le choix du LLM.

Outils natifs n8n

Outil	Usage	Exemple
Calculator	Calculs mathematiques	Convertir des devises, calculer des totaux
Code	Executer du JavaScript/Python	Transformer des donnees, valider un format
HTTP Request Tool	Appeler une API externe	Interroger un CRM, verifier un stock
Workflow Tool	Executer un autre workflow n8n comme outil	Declencher un envoi d’email, creer un ticket
MCP Client Tool	Appeler un serveur MCP	Acceder a des outils exposes via le protocole MCP
Vector Store Tool	Recherche RAG dans la base vectorielle	Trouver les documents pertinents pour une question

Le Workflow Tool est particulierement utile : il permet a un agent d’executer un workflow n8n complet comme s’il s’agissait d’un simple outil. Cela permet de decomposer des logiques complexes en workflows dedies, reutilisables et testables independamment. Voir aussi : deployer un serveur MCP dans n8n pour connecter des outils via le protocole MCP.

Memoire conversationnelle : maintenir le contexte

Sans memoire, l’agent traite chaque message comme une requete isolee. Le sous-noeud Memory permet de conserver l’historique de la conversation pour que l’agent se souvienne des echanges precedents.

Options de memoire dans n8n

• Window Buffer Memory : stocke les N derniers messages en memoire. Simple et efficace. Limite : la fenetre est fixe (par exemple les 10 derniers messages), donc les conversations longues perdent leur debut. Adapte a la plupart des chatbots
• Motorhead : serveur de memoire externe avec resume automatique des conversations longues. Permet de depasser la limite de tokens en compressant l’historique
• Redis : stockage persistant dans Redis. Adapte aux cas ou la conversation doit survivre a un redemarrage du workflow ou etre partagee entre plusieurs executions

Point technique : la memoire consomme des tokens a chaque appel LLM, puisque l’historique est injecte dans le prompt. Avec un LLM facture au token (Claude, GPT-4), une conversation de 50 messages peut representer plusieurs milliers de tokens de contexte a chaque nouveau message. La Window Buffer Memory avec une fenetre de 10-20 messages offre un bon compromis entre contexte et cout.

Retour terrain : un RAG service client en production

Un cas concret de deploiement illustre les choix techniques et les resultats possibles. Un client disposant d’une base documentaire interne (procedures, fiches produit, conditions generales) avait besoin d’un service client disponible 24h/24, 7j/7. L’objectif : repondre aux questions courantes par chatbot pour liberer du temps au service client humain sur les demandes complexes necessitant un appel ou un echange personnalise.

Architecture deployee

La solution combine AnythingLLM pour le stockage vectoriel et l’interface de chat, connecte a n8n pour l’orchestration des workflows. La base documentaire de l’entreprise est indexee dans AnythingLLM, et les requetes clients transitent par un workflow n8n qui gere la logique metier (routage, escalade, logging). Le LLM utilise est Claude (Anthropic) pour la qualite de ses reponses en francais et le respect des consignes.

Resultats mesures

Indicateur	Resultat
Demandes traitees par le chatbot	50 % des demandes entrantes
Disponibilite	24h/24, 7j/7 - sans intervention humaine
Usage interne	Le service client utilise aussi le RAG comme source documentaire pour traiter les demandes restantes
Impact equipe	Temps libere pour les appels et demandes complexes

Choix du LLM : cloud vs local

Le choix du LLM depend aussi des contraintes de confidentialite. Claude (Anthropic) ou GPT-4 (OpenAI) offrent les meilleures performances en comprehension et generation, mais les donnees transitent par des serveurs americains. Pour les entreprises soumises a des contraintes reglementaires ou qui manipulent des donnees sensibles, des LLM locaux deployes via Ollama (Mistral, Llama, Phi) permettent de garder toutes les donnees en interne. Le compromis : des performances moindres sur les taches complexes, mais aucune fuite de donnees vers l’exterieur. Avec des donnees d’entree bien structurees et un RAG bien configure, des modeles plus legers produisent des resultats fiables sur des domaines specifiques.

Limites et erreurs courantes

Les agents n8n ne sont pas infaillibles. Voici les problemes les plus frequents constates en production et en accompagnement de clients.

Boucles infinies

L’agent appelle un outil, recoit un resultat ambigu, et rappelle le meme outil avec les memes parametres. Ce probleme survient souvent quand les descriptions d’outils sont vagues ou quand le LLM n’arrive pas a interpreter le resultat. Solution : limiter le nombre d’iterations (parametre maxIterations dans le noeud AI Agent, defaut 10) et ecrire des descriptions d’outils precises avec des exemples de parametres attendus.

Hallucinations malgre le RAG

Le RAG reduit les hallucinations mais ne les elimine pas. Si les chunks recuperes ne contiennent pas la reponse exacte, le LLM peut completer avec des informations inventees. Solution : ajouter une consigne explicite dans le prompt systeme (“Si l’information n’est pas dans les documents fournis, reponds que tu ne sais pas”) et verifier la qualite des chunks indexes - des documents mal decoupes ou mal structures produisent des reponses partielles.

Mauvais choix d’outil par l’agent

L’agent selectionne un outil non pertinent pour la requete. Ce probleme vient presque toujours d’une description d’outil trop generique. Chaque outil doit avoir une description qui explique precisement quand l’utiliser, quand ne pas l’utiliser, et quel type de resultat il retourne. Exemple : au lieu de “Recherche dans la base de donnees”, ecrire “Recherche les fiches produit par nom ou reference. Utiliser quand le client pose une question sur un produit specifique. Retourne le nom, le prix et la disponibilite.”

Donnees d’entree mal structurees

C’est le probleme le plus frequent en entreprise. Le RAG ne peut pas compenser des documents source de mauvaise qualite. Si les procedures internes sont ambigues, si les fiches produit ont des informations contradictoires, ou si les documents ne sont pas a jour, l’agent reproduira ces defauts. La qualite du RAG commence par la qualite des documents indexes.

FAQ

Le RAG dans n8n necessite-t-il de coder ?

Non. Le pipeline complet - ingestion, embedding, stockage, retrieval - se configure via les sous-noeuds visuels de n8n. Le Document Loader charge les fichiers, le Text Splitter les decoupe, l’Embedding Model genere les vecteurs, et le Vector Store les stocke. Aucune ligne de code n’est necessaire pour un RAG standard. Le noeud Code n’intervient que pour des transformations specifiques (nettoyage de donnees, logique metier custom).

Combien de documents peut gerer un RAG dans n8n ?

La limite depend de la base vectorielle choisie, pas de n8n. Le mode In-Memory convient pour quelques centaines de documents en test. Supabase Vector (pgvector) ou Qdrant gerent des centaines de milliers de vecteurs en production. AnythingLLM permet aussi de gerer des volumes importants avec son propre systeme de stockage. Le facteur limitant est generalement le cout des embeddings : text-embedding-3-small d’OpenAI coute 0,02 $ par million de tokens (tarif mars 2026).

Peut-on utiliser un LLM local avec l’agent n8n ?

Oui. n8n supporte Ollama comme fournisseur de LLM, ce qui permet d’utiliser des modeles open source (Mistral, Llama 3, Phi-3) heberges sur votre propre infrastructure. Les donnees ne quittent jamais votre reseau. Le noeud Ollama se configure avec l’URL de votre instance locale et le nom du modele. Les performances varient selon le modele et le hardware - un GPU est recommande pour des temps de reponse acceptables en production.

Quelle difference entre le Workflow Tool et le MCP Client Tool ?

Le Workflow Tool execute un workflow n8n interne comme outil de l’agent. Le MCP Client Tool appelle un serveur MCP externe via le protocole standardise (JSON-RPC 2.0). En pratique : utilisez le Workflow Tool pour des logiques internes a votre instance n8n, et le MCP Client Tool pour connecter des outils exposes par des serveurs MCP tiers ou par une autre instance n8n configuree comme serveur MCP.

Comment eviter que l’agent invente des informations ?

Trois leviers : (1) un prompt systeme explicite qui interdit de repondre si l’information n’est pas dans les documents fournis, (2) un RAG bien configure avec des chunks de qualite et des metadonnees pertinentes, (3) une verification humaine sur les cas critiques via un workflow de validation (human-in-the-loop). Aucun LLM ne garantit zero hallucination - le systeme doit etre concu pour detecter et gerer les cas d’incertitude.

Fiche technique

Element	Detail
Noeud principal	AI Agent (n8n >= 1.19.0, refonte 1.60+)
Types d’agents	Tools Agent, ReAct Agent, Conversational Agent
LLM compatibles	Claude (Anthropic), GPT-4/3.5 (OpenAI), Mistral, Ollama (local)
Vector stores natifs	Pinecone, Qdrant, Supabase Vector, PGVector, Chroma, Weaviate, Zep, In-Memory
Embedding models	OpenAI (text-embedding-3-small/large), Cohere, Mistral, Ollama
Outils natifs	Calculator, Code, HTTP Request, Workflow Tool, MCP Client, Vector Store Tool
Memoire	Window Buffer Memory, Motorhead, Redis
Documentation	docs.n8n.io - AI Agent