Ressources · Intégration n8n

Nœud Code Tool n8nConfigurer Code Tool dans n8n.

Le nœud Code Tool n8n transforme quelques lignes de JavaScript ou de Python en outil qu'un agent IA appelle tout seul. Quatre paramètres suffisent : un nom, une description que le modèle lit pour savoir quand s'en servir, le langage et sa zone de code, un schéma d'entrée optionnel.

Tester le nœud Code Tool sur n8nVoir les 4 paramètres

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

Pourquoi automatiser

À quoi sert le nœud Code Tool n8n ?

Code Tool est un sous-nœud, c'est-à-dire un petit nœud qu'on raccorde au port d'un nœud plus gros au lieu de le poser dans le flux principal. Il contient un bout de JavaScript ou de Python et le présente à un agent comme un outil appelable. Quand le modèle juge que l'outil correspond à la demande, n8n exécute le code avec le texte que le modèle a produit, puis renvoie la chaîne de caractères obtenue dans la conversation.

Premier terrain de jeu : le calcul qu'un modèle de langage n'a aucune raison de deviner. Une règle de remise par palier, une répartition de TVA, un nombre de jours ouvrés entre deux dates. Tu l'écris une fois dans la zone JavaScript, tu la décris en une phrase, et l'agent arrête d'improviser des chiffres. Le code lit le texte du modèle via la propriété query et renvoie une seule chaîne, donc l'échange garde une forme prévisible.

Deuxième terrain : la normalisation. Un agent monté sur le nœud AI Agent reçoit souvent du texte sale qu'il faut nettoyer avant d'en faire quoi que ce soit. Un numéro de téléphone à remettre au format, une référence produit à extraire d'une phrase, une date à passer en ISO. Aucun nœud dédié ne couvre ça. Dix lignes de Python le font, et l'agent ne les appelle que lorsqu'il en a besoin.

Troisième terrain : l'entrée sous contrôle. Active Specify Input Schema et le modèle est obligé d'envoyer une structure que n8n valide avant d'exécuter ton code. C'est ce qui rend un outil de code fréquentable à côté d'outils qui écrivent pour de bon, une ligne dans Google Sheets ou un message dans Slack.

Passe à autre chose quand le besoin n'est pas vraiment du code. Appeler un service qui possède déjà son nœud n8n se fait mieux avec ce nœud branché comme outil. Et une transformation qui doit s'appliquer à chaque item, pas au bon vouloir de l'agent, a sa place dans le flux principal. Un modèle qu'il faut supplier pour qu'il appelle ta fonction demande une description plus nette, rarement plus de code.

Deux limites à connaître avant de construire dessus. Python est en bêta sur ce nœud, et l'outil ne renvoie qu'une chaîne : tout résultat structuré doit être sérialisé par ton propre code. Le fournisseur du modèle derrière l'agent, OpenAI ou un autre, facture ses appels d'API selon ses conditions, n8n n'ajoute rien. Pour voir le montage de bout en bout, la Formation n8n passe par les agents et leurs sous-nœuds.

Connexions

Sur quoi brancher le nœud Code Tool ?

n8n coupe ses nœuds IA en deux : un nœud racine se place dans le workflow et reçoit les items, des sous-nœuds se raccordent à ses ports. Code Tool est un sous-nœud : il n'a pas d'entrée principale et ne s'exécute jamais seul.

Sortie (où il se branche)

  • Toolai_tool
01ToolC'est le seul port du nœud. Tu tires son connecteur vers le port outil d'un nœud racine, et à partir de là le modèle peut le lister, le choisir et l'appeler comme n'importe quel autre outil du même agent.

C'est le seul port du nœud. Tu tires son connecteur vers le port outil d'un nœud racine, et à partir de là le modèle peut le lister, le choisir et l'appeler comme n'importe quel autre outil du même agent.

Paramètres clés

  • Required : tant que rien n'est raccordé, le nœud reste inerte. Un sous-nœud ne tourne pas de son côté.
  • AI Agent : l'hôte habituel, un agent conversationnel ou exécutant.
  • AI Agent Tool : un agent lui-même branché comme outil d'un autre agent.
  • MCP Server Trigger : quand l'outil doit être exposé à un client extérieur.
Cas d'usage
le même bout de code sert un agent de support et un serveur MCP, sans recopier la fonction ailleurs.
Paramètres

Que règlent les 4 paramètres du nœud Code Tool ?

Le nœud Code Tool compte 4 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

Name

name

Ce que tu vois dans n8n

Notes & cas d'usage

Avec la description, le nom est ce que le modèle lit quand il parcourt les outils à sa disposition. C'est une étiquette pour une machine, pas un titre pour un humain, et le placeholder My_Tool donne le ton attendu : court, sans espace.

Paramètres clés

  • Name : un champ texte, rien derrière. Un compute_shipping parle mieux à un modèle qu'une phrase entière.
Cas d'usage
dès qu'un agent porte plusieurs outils de code, il faut des noms impossibles à confondre, sinon le modèle attrape le voisin et rend un résultat crédible mais faux.
02

Description

description

Ce que tu vois dans n8n

Notes & cas d'usage

Tout ce que le modèle sait du moment où il doit appeler cet outil tient dans ce champ. Le placeholder du nœud sert de gabarit : il annonce le travail, puis ce que l'entrée doit contenir, dans cet ordre.

Paramètres clés

  • Description : texte libre. Écris la condition de déclenchement et la forme de l'entrée attendue, par exemple une phrase qui dit que l'outil renvoie une couleur au hasard et que l'entrée est une liste de couleurs à exclure séparées par des virgules.
Cas d'usage
un outil jamais appelé vient presque toujours de là. Nommer la situation qui doit le déclencher règle plus de cas qu'une réécriture du code.
03

Language

language

Ce que tu vois dans n8n

Notes & cas d'usage

Ce sélecteur décide de la zone de code qui apparaît en dessous, et il change la façon dont ton bout de code lit l'entrée de l'agent. Choisis-le avant d'écrire, parce qu'en changer ensuite oblige à reprendre l'accès à la valeur.

Paramètres clés

  • Language : deux options, javaScript (JavaScript) et python (Python (Beta)).
  • JavaScript : la zone de code de la première option. L'entrée arrive dans la propriété query et le code doit renvoyer une chaîne unique.
  • Python : la zone de la seconde. Même contrat, sauf que l'entrée se lit dans _query.
Cas d'usage
passer un texte en majuscules, c'est le une-ligne qui valide le branchement avant d'y mettre la vraie logique.
04

Specify Input Schema

specifyInputSchema

Ce que tu vois dans n8n

Notes & cas d'usage

Désactivé, l'outil avale la chaîne que le modèle a écrite. Activé, n8n impose au modèle un format déclaré et le valide contre le schéma avant d'exécuter le code, ce qui arrête un appel mal formé à la porte.

Paramètres clés

  • Specify Input Schema : l'interrupteur lui-même. Il fait apparaître les trois champs suivants.
  • Schema Type : fromJson (Generate From JSON Example) déduit le schéma d'un objet d'exemple, manual (Define using JSON Schema) te le fait écrire.
  • JSON Example : l'objet d'exemple que lit le premier mode.
  • Input Schema : le schéma, au format JSON Schema. La syntaxe $refs n'est pas gérée.
Cas d'usage
un outil qui attend un identifiant de commande et une quantité tient bien plus droit avec un schéma qu'avec une phrase.
Besoin d'aide

Besoin d'aide pour automatiser Code Tool avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Code Tool , les questions qui viennent ensuite

01Le nœud Code Tool n8n est-il gratuit ?
Oui. Il fait partie du paquet IA de n8n, livré avec n8n : rien à installer, aucun surcoût côté n8n, sur n8n Cloud comme sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte pareil qu'il tourne via Docker, via npm ou sur l'offre hébergée par n8n. Ce qui peut coûter se trouve ailleurs : l'agent auquel cet outil se raccorde a besoin d'un modèle de chat, et le fournisseur de ce modèle facture ses propres appels d'API selon ses conditions. n8n n'ajoute rien par-dessus.
02Faut-il un identifiant pour faire tourner le Code Tool ?
Non, rien du tout. Ce nœud n'a ni credential, autrement dit un jeu d'identifiants enregistré dans n8n, ni sélecteur Authentication : c'est pour ça que la page n'a aucune section de connexion. La partie compte se joue sur le sous-nœud modèle de chat branché au même agent, qui porte l'identifiant du fournisseur et reste le seul endroit où une clé se saisit. Ici, le réglage tient à trois choses : la zone de code, la description et le connecteur tiré vers un nœud racine. Si l'outil s'exécute mais que l'agent reste muet, regarde le modèle et sa clé, pas ce nœud.
03Quelles sont les limites du Code Tool ?
Trois à anticiper. Python est marqué bêta sur ce nœud, donc JavaScript reste le choix tranquille pour ce que tu ne veux pas rouvrir dans six mois. L'échange se fait en texte : le code lit l'entrée du modèle dans une seule propriété et doit renvoyer une chaîne unique, tout résultat structuré passe donc par une sérialisation maison. Et l'entrée n'est contrôlée que si Specify Input Schema est activé, avec la syntaxe $refs du JSON Schema non gérée même dans ce cas. La page décrit la version 1 du nœud, la plus haute au catalogue ; un workflow ancien peut en afficher une plus vieille, avec moins d'options.
04Qu'est-ce qu'il faut brancher, et par quoi commencer ?
Au minimum un nœud racine. Code Tool est un sous-nœud doté d'un seul port Tool et d'aucune entrée principale : il ne fait rien tant que son connecteur n'atteint pas un AI Agent, un AI Agent Tool ou un MCP Server Trigger. Ce nœud racine a lui-même besoin d'un modèle de chat raccordé, avec l'identifiant du fournisseur posé sur ce sous-nœud. Un premier montage se fait petit exprès : un agent, un modèle de chat, un outil de code qui met en minuscules ce qu'il reçoit, et une description écrite comme une phrase de déclenchement. Quand l'agent l'appelle sans hésiter, remplace le code par la vraie logique.
05n8n ou Make pour un outil d'agent maison ?
Ça dépend de trois critères. L'hébergement d'abord : n8n s'installe sur tes propres serveurs via Docker ou npm, ou s'utilise sur n8n Cloud, alors que Make est hébergé uniquement, ce qui tranche la question pour une équipe tenue à la maîtrise de ses données. Le modèle de coût ensuite : Make facture à l'opération, un point à simuler quand un agent appelle ses outils en boucle. La logique visuelle enfin : un outil de code veut dire que tu tiens la fonction en JavaScript ou Python dans le workflow, ce qui suppose d'être à l'aise avec ça. Si le sans-code prime, ce confort compte moins. Les deux outils sont sérieux, la réponse suit tes contraintes.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations