Ressources · Intégration n8n

Nœud Text Classifier n8nConfigurer Text Classifier dans n8n.

Le nœud Text Classifier n8n lit un texte et le range dans l'une des catégories que tu as écrites toi-même. Sept paramètres règlent sa façon de trancher, et un port lui apporte le modèle qui fait la lecture. Utile dès qu'un workflow doit bifurquer selon le sens d'un message.

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

Pourquoi automatiser

À quoi sert le nœud Text Classifier n8n ?

Il prend chaque item qui arrive, confie le texte à un modèle de langage et décide laquelle de tes catégories lui correspond. Ces catégories ne sont pas une liste fournie par n8n : tu les écris, avec un nom et une description facultative, et le nœud crée une sortie par catégorie. Un item classé dans facturation ressort par la branche facturation, et la suite du workflow reste lisible.

C'est un aiguillage qui sait lire. Un nœud de routage classique compare des valeurs qu'il peut tester : il lui faut un champ qui contient déjà la réponse. Ici, la matière est du langage humain, exactement ce qui arrive quand quelqu'un t'écrit.

Trois situations reviennent souvent. Le tri d'une boîte partagée : un message récupéré par Gmail traverse le classifieur avec les catégories devis, incident et facturation, et chaque branche finit ailleurs. Les retours produit : un avis client part vers le canal Slack de l'équipe concernée au lieu d'atterrir dans un tableau que personne n'ouvre. Les candidatures spontanées : le texte de la lettre décide de la branche, et seule celle qui correspond au poste ouvert déclenche une réponse.

Le nœud ne réfléchit pas tout seul. Tu lui branches un sous-nœud sur son port Chat Model, un modèle de chat comme OpenAI Chat Model ou Anthropic Chat Model, et c'est ce sous-nœud qui porte le credential, c'est-à-dire les identifiants de compte enregistrés dans n8n et réutilisables. Le classifieur, lui, n'a rien à authentifier.

Quand la catégorie ne suffit pas, change de nœud. Text Classifier donne une branche, point final. Si le workflow doit répondre, chercher une information ou appeler d'autres nœuds comme outils, c'est le nœud AI Agent qui joue ce rôle, et le classifieur se place souvent devant lui pour décider s'il y a lieu de le lancer.

Les limites, autant les connaître avant. Les catégories vivent dans le nœud : rien n'est stocké, rien ne s'apprend d'une exécution à l'autre, et un second workflow qui classe pareil redemande la même liste. Un item qui ne correspond à rien disparaît tant que la branche Other n'est pas activée. Enfin, le fournisseur du modèle facture ses propres appels d'API selon ses conditions, indépendamment de n8n.

Connexions

Qu'est-ce qu'on lui branche ?

Ce nœud est un nœud racine : il reçoit les items du workflow par son entrée principale, et les sous-nœuds, ces blocs qui ne s'exécutent jamais seuls, se raccordent aux ports dessinés en dessous.

Ports (ce qui se branche)

  • Chat Modelai_languageModelrequis
01Chat ModelLe port qui fournit le modèle chargé de lire. Tu y tires un sous-nœud modèle de chat, et le classifieur lui envoie chaque texte accompagné de ta liste de catégories. Port vide, le nœud ne démarre pas.

Le port qui fournit le modèle chargé de lire. Tu y tires un sous-nœud modèle de chat, et le classifieur lui envoie chaque texte accompagné de ta liste de catégories. Port vide, le nœud ne démarre pas.

Paramètres clés

  • Required : la classification se fait dans le modèle, donc un port vide bloque l'exécution.
  • OpenAI Chat Model ou Anthropic Chat Model : les deux entrées les plus courantes, chacune avec son credential fournisseur.
  • Ollama Chat Model : le choix quand les textes ne doivent pas quitter ta machine.
  • Mistral Cloud Chat Model : une option hébergée de plus si le compte existe déjà.
Cas d'usage
sur un workflow de tri de mails, un seul sous-nœud modèle alimente le classifieur, et les branches suivantes réutilisent le même compte fournisseur.
Paramètres

Comment régler chaque paramètre ?

Le nœud Text Classifier compte 7 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

Text to Classify

inputText

Ce que tu vois dans n8n

Notes & cas d'usage

C'est le texte que le modèle va lire. Tout le reste du nœud dit comment juger, ce champ dit quoi juger.

Paramètres clés

  • Text to Classify : requis. Utilise une expression, la syntaxe n8n qui va chercher une valeur dans un nœud précédent, ou saisis un texte statique. Par défaut, le champ pointe sur text.
Cas d'usage
derrière un trigger de chat, pointe {{ $json.chatInput }} pour classer la phrase du visiteur, et pas une étiquette saisie plus haut dans le workflow.
02

Categories

categories

Ce que tu vois dans n8n

Notes & cas d'usage

C'est ici que tu écris les cases. Chaque entrée ajoutée avec Add Category devient une sortie du nœud, dans l'ordre où tu les as listées.

Paramètres clés

  • Category : requis, le nom de la catégorie à ajouter. C'est aussi le libellé affiché sur la branche.
  • Description : décris la catégorie quand son sens n'est pas évident, pour que le modèle sache ce que tu mets derrière.
Cas d'usage
sur une boîte commerciale, trois catégories suffisent souvent, et celle qui mérite une description est l'ambiguë : préciser que billing couvre les factures et les remboursements évite que ces demandes partent vers la branche devis.
03

Allow Multiple Classes To Be True

options.multiClass

Ce que tu vois dans n8n

Notes & cas d'usage

Certains textes appartiennent honnêtement à deux cases. Cet interrupteur dit si le nœud a le droit de le reconnaître.

Paramètres clés

  • Allow Multiple Classes To Be True : désactivé, le nœud sort une seule classe par item. Activé, le modèle peut en retenir plusieurs, et l'item ressort par chacune des branches retenues.
Cas d'usage
un message qui signale un bug et réclame un geste commercial doit toucher les deux équipes, donc tu l'actives en acceptant qu'un seul mail crée deux suites. Laisse-le fermé dès qu'une branche écrit dans une fiche qui ne supporte pas d'être modifiée deux fois.
04

When No Clear Match

options.fallback

Ce que tu vois dans n8n

Notes & cas d'usage

Tout ne rentre pas dans les cases. Cette option décide du sort des items qui ne correspondent à rien de net.

Paramètres clés

  • Discard Item (discard) : la valeur par défaut. L'item est ignoré et retiré de la sortie, sans bruit.
  • Output on Extra, 'Other' Branch (other) : crée une sortie supplémentaire nommée Other, par laquelle sortent les items non reconnus.
Cas d'usage
sur une boîte support, le comportement par défaut fait disparaître en silence le message bizarre que personne n'a prévu : bascule sur la branche Other et envoie-la à un humain. Ce qui s'y accumule t'indique en prime la catégorie qui manque à ta liste.
05

System Prompt Template

options.systemPromptTemplate

Ce que tu vois dans n8n

Notes & cas d'usage

Le nœud envoie déjà des consignes au modèle. Cette option remplace ce texte par une chaîne que tu écris.

Paramètres clés

  • System Prompt Template : une chaîne utilisée directement comme system prompt template. Elle s'appuie sur le marqueur {categories}, l'endroit où ta liste de catégories est injectée.
Cas d'usage
à sortir quand les consignes d'origine lisent le texte dans le mauvais esprit, par exemple si le ton compte plus que le sujet. Oublie le marqueur {categories} dans ta chaîne et le modèle ne verra jamais la liste.
06

Enable Auto-Fixing

options.enableAutoFixing

Ce que tu vois dans n8n

Notes & cas d'usage

Il arrive qu'un modèle réponde dans une forme que le nœud n'arrive pas à relire. L'auto-fixing lui laisse une seconde chance au lieu de faire échouer l'exécution.

Paramètres clés

  • Enable Auto-Fixing : activé, le nœud renvoie au modèle l'erreur de parsing du schéma et lui demande de corriger sa sortie pour qu'elle colle au format attendu. Cela peut déclencher un appel de modèle supplémentaire.
Cas d'usage
précieux sur un gros lot traité de nuit, où une sortie cassée ne doit pas arrêter tout le reste. La contrepartie est réelle : cet appel de plus est facturé par le fournisseur comme les autres.
07

Batch Processing

options.batching

Ce que tu vois dans n8n

Notes & cas d'usage

Quand des centaines d'items arrivent d'un coup, le rythme compte plus que la vitesse. Cette collection le règle.

Paramètres clés

  • Batch Size : le nombre d'items traités en parallèle. Pratique pour le rate limiting, mais l'ordre des logs peut en souffrir.
  • Delay Between Batches : un délai en millisecondes entre deux lots, là aussi pour le rate limiting.
Cas d'usage
classer un historique de demandes exporté dans Google Sheets, c'est précisément le moment où un fournisseur commence à refuser les appels : un lot plus petit avec un délai finit plus lentement, mais il finit.
Besoin d'aide

Besoin d'aide pour automatiser Text Classifier avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui viennent ensuite

01Le nœud Text Classifier est-il inclus dans n8n ?
Oui. Il fait partie du paquet IA livré avec n8n, donc il est présent 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. Rien à installer, aucun surcoût côté n8n, quelle que soit la façon dont tu fais tourner l'outil. Ce qui se paie est un cran en dessous : le modèle de chat que tu branches appartient à un fournisseur, et ce fournisseur facture ses propres appels d'API selon ses conditions. n8n n'ajoute rien par-dessus. Un workflow construit sur le cloud se comporte de la même manière une fois déplacé sur ton serveur.
02Que faut-il pour le faire fonctionner ?
Aucun compte, aucun credential, rien à authentifier sur ce nœud. C'est assez rare pour le dire franchement : il n'a pas de sélecteur Authentication parce qu'il n'appelle aucun service directement. Ce qu'il lui faut, c'est un modèle. Branche un sous-nœud modèle de chat sur le port Chat Model, et c'est ce sous-nœud qui porte le credential du fournisseur, autrement dit les identifiants enregistrés dans n8n. Port laissé vide, l'exécution se bloque. Il te faut aussi une valeur dans Text to Classify, le plus souvent une expression qui pointe vers un champ du nœud précédent, et au moins une catégorie.
03Quelles sont les limites du nœud Text Classifier n8n ?
Il classe, et il ne fait que ça. Pas de résumé, pas de réécriture, pas de réponse, pas d'appel d'outil : chaque item ressort sur une branche, inchangé. Les catégories n'existent que dans le nœud, donc rien n'est mémorisé d'une exécution à l'autre et un deuxième workflow a besoin de sa propre copie de la liste. Le catalogue expose aujourd'hui la version 1, avec 7 paramètres ; un workflow ancien peut afficher une version antérieure et moins d'options. Les items qui ne correspondent à rien disparaissent tant que When No Clear Match reste sur la valeur par défaut. Et la justesse obtenue reste celle du modèle branché.
04Quel est le minimum à brancher pour démarrer ?
Un sous-nœud modèle de chat sur le port Chat Model, deux ou trois catégories aux noms nets, et une expression dans Text to Classify qui pointe vers le champ contenant le vrai message. Ça suffit à obtenir un classifieur qui tourne. Pour un premier essai, OpenAI Chat Model ou Anthropic Chat Model sont les chemins les plus courts parce que le compte existe souvent déjà ; Ollama Chat Model se justifie quand les textes ne doivent pas sortir de ton infrastructure. N'ajoute des descriptions aux catégories que le jour où le modèle hésite entre deux d'entre elles, et active la branche Other tout de suite pour voir ce qui passe à travers.
05n8n ou Make pour classer du texte ?
Ça dépend de l'endroit où doivent vivre les données et de la façon dont tu veux payer. Make est hébergé par Make, sans option d'auto-hébergement, et se facture à l'opération : un gros volume de classification se paie donc au volume. n8n tourne sur n8n Cloud ou sur ton propre serveur, ce qui pèse lourd quand les textes classés sont des mails clients que tu préfères garder chez toi, et une instance auto-hébergée reprend le même workflow que le cloud. Les deux se construisent visuellement. Peu d'automatisations et légères, l'hébergé suffit ; dès que ça se multiplie, la maîtrise de l'hébergement finit par trancher.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.