Le node AI Transform de n8n : transformer ses données avec un prompt plutôt que du code

Reformater la réponse JSON d'une API, aplatir un tableau imbriqué, renommer une poignée de champs avant de les envoyer à Google Sheets : ce sont des besoins minuscules qui reviennent dans presque tous les workflows n8n, et qui obligent pourtant à ouvrir un node Code et à écrire quelques lignes de JavaScript. Le node AI Transform, disponible sur les plans n8n Cloud, propose une autre voie : décrire la transformation en une phrase et laisser un modèle de langage écrire le code à votre place. Voici ce qu'il fait réellement, où il s'arrête, et comment reproduire le même confort si vous êtes en self-hosted.

Qu'est-ce que le node AI Transform

AI Transform est un node natif de n8n qui génère un extrait de code à partir d'un prompt en langage naturel. Contrairement à l'AI Agent ou à une Basic LLM Chain, il ne s'insère pas dans un pipeline conversationnel : il sert un objectif unique, ponctuel — transformer les données qui transitent par le workflow — et le fait en une seule interaction, au moment où vous construisez le workflow, pas à l'exécution.

Sa particularité par rapport à un simple copier-coller depuis ChatGPT : il est contextuel. Le node lit le schéma des données produites par les nodes précédents (noms de champs, types) et s'en sert pour générer un code cohérent avec votre workflow réel, sans que vous ayez à recopier un exemple de payload dans le prompt.

Comment il fonctionne concrètement

L'utilisation tient en trois étapes :

1. Ajoutez le node AI Transform à la suite du node dont vous voulez transformer la sortie.
2. Décrivez la transformation voulue en anglais, dans un champ de prompt limité à 500 caractères — assez pour une instruction précise (« extraire l'email et le nom de chaque contact, mettre le nom en majuscules, ignorer les entrées sans email »), pas pour une spécification complète.
3. Cliquez sur Generate code. Le node affiche le code généré et l'exécute directement sur les données d'entrée, avec un aperçu du résultat.

Le code produit reste en lecture seule dans le node : impossible de corriger une virgule à la main. Deux chemins si le résultat n'est pas exactement ce qu'il faut : reformuler le prompt et régénérer, ou copier le code dans un node Code classique pour l'ajuster ligne par ligne — ce dernier point mérite d'être connu avant de construire un workflow entier autour du node AI Transform, au cas où une correction manuelle s'avère nécessaire plus tard.

Ce qu'il fait bien

Le node AI Transform vise un usage précis : des transformations de structure de données, pas de la logique métier complexe. Quelques exemples représentatifs :

• Aplatir un objet imbriqué — extraire data.customer.address.city en un champ plat ville, sur une réponse d'API à la structure profonde ;
• Renommer et filtrer des champs — passer d'un export CRM en anglais (first_name, last_name, email_address) à des noms français cohérents avec le reste du workflow ;
• Recomposer un tableau — transformer un tableau d'objets [{sku, qty}, ...] en une chaîne récapitulative lisible pour un message Slack ou un email ;
• Nettoyer avant écriture — supprimer les champs vides ou dupliqués avant un insert dans Google Sheets ou Airtable.

Dans tous ces cas, la transformation reste auto-contenue : elle part des données déjà en entrée et produit une sortie, sans appel externe ni décision qui nécessiterait un jugement (auquel cas un node Text Classifier, Information Extractor ou un Structured Output Parser — voir nos guides sur le Text Classifier et l'Information Extractor — restent mieux adaptés).

Ses limites, sans en faire l'économie

Trois limites structurent son usage réel :

• Disponible uniquement sur n8n Cloud. Le node n'apparaît pas dans une instance self-hosted, quelle que soit la version installée — voir plus bas la solution de contournement.
• Aucun accès réseau. L'IA ne manipule que les données déjà présentes dans le workflow ; elle ne peut ni interroger une API, ni enrichir une donnée depuis une source externe. Pour ça, un node HTTP Request en amont reste indispensable.
• Elle connaît le schéma, pas les valeurs. Le modèle voit les noms de champs et leurs types, pas le contenu réel de vos données. Un prompt qui suppose une valeur particulière (« si le statut est "urgent" ») fonctionne mieux quand vous précisez la valeur exacte attendue plutôt que de laisser le modèle deviner le vocabulaire utilisé dans vos données.

Sur des workflows avec de nombreux nodes en amont, la qualité du code généré peut aussi se dégrader — le contexte transmis au modèle devient plus difficile à interpréter avec un historique de nodes long et hétérogène. Dans ce cas, un node Set ou Edit Fields juste avant l'AI Transform, pour ne présenter que les champs pertinents, améliore nettement la fiabilité du résultat — le même réflexe que celui détaillé dans notre guide sur le node Set et Edit Fields.

AI Transform, node Code, et l'assistant IA du node Code : lequel choisir

n8n propose en réalité deux points d'entrée IA pour écrire du code, tous deux réservés au Cloud :

	AI Transform	Assistant IA du node Code
Emplacement	Node dédié	Bouton dans un node Code existant
Code généré	Lecture seule dans le node	Directement éditable
Cas d'usage	Transformation ponctuelle, rapide	Aide ou correction sur un Code node déjà en place
Self-hosted	Non	Non

Pour tout ce qui dépasse une transformation de structure — logique conditionnelle complexe, appel à des modules npm, boucles imbriquées — un node Code écrit ou corrigé à la main (avec ou sans aide IA) reste l'outil le plus fiable. Notre guide sur les expressions JavaScript dans le node Code couvre cette voie en détail, tout comme notre article sur le node Code en Python pour l'alternative Python, non couverte par AI Transform.

Vous êtes en self-hosted ? Reproduisez le même confort

L'absence du node sur une instance self-hosted n'est pas bloquante — elle déplace simplement l'étape IA en dehors de n8n. Le principe : demander la transformation à un modèle de langage une seule fois, en dehors du workflow, puis coller le résultat dans un node Code classique, disponible partout.

Deux façons de procéder :

• Ponctuellement, en collant un exemple de payload JSON et votre besoin dans l'interface web de Claude ou ChatGPT, puis en copiant le code JavaScript produit dans un node Code — l'équivalent manuel du bouton « Generate code », sans les 500 caractères de limite ni la lecture seule.
• Dans le workflow lui-même, avec un node AI Agent ou une Basic LLM Chain connecté à votre propre credential OpenAI ou Anthropic — voir notre guide pour connecter Claude ou GPT à n8n — qui génère le code à la demande et le transmet à un node Code en aval via une expression. Plus verbeux à construire qu'AI Transform, mais entièrement portable, et sans dépendre d'un plan Cloud particulier. Notre comparatif n8n self-hosted vs Cloud détaille plus largement ce type d'arbitrages fonctionnels entre les deux modes d'hébergement, et notre guide des tarifs Cloud précise sur quels plans AI Transform est inclus.

Toujours relire ce que l'IA a écrit

Gagner du temps sur l'écriture du code ne dispense pas de le relire. Une étude de Peng, Kalliamvakou, Cihon et Demirer, menée en 2023 sur des développeurs utilisant GitHub Copilot pour implémenter un serveur HTTP, montre un gain de vitesse spectaculaire — les développeurs équipés de l'assistant IA achèvent la tâche 55,8 % plus vite que le groupe témoin (Peng et al., 2023). Ce même écart de vitesse s'applique au node AI Transform : la question n'est pas de savoir si l'IA produit du code plus vite que vous, mais si le code produit fait exactement ce que vous vouliez. Sur un champ mal orthographié ou une condition inversée, l'aperçu de sortie du node — toujours visible avant d'activer le workflow — reste la vérification la plus rapide et la plus fiable.

En résumé

Le node AI Transform de n8n génère du code JavaScript à partir d'un prompt de 500 caractères maximum, en s'appuyant sur le schéma des données déjà présentes dans le workflow — utile pour reformater, aplatir ou nettoyer des données, pas pour de la logique complexe ou des appels externes. Réservé aux plans Cloud, il se reproduit manuellement en self-hosted via un appel LLM ponctuel suivi d'un collage dans un node Code classique. Cette logique de génération de code assisté par IA, portable à n'importe quelle instance n8n, est exactement celle qu'on retrouve dans les workflows du Pack Inbox IA (79 €) — chaîne LLM, sortie structurée et transformation de données, prêts à l'emploi et modifiables sans dépendre d'un plan Cloud particulier.