Transformation

Les nodes de transformation reformatent et modifient les données entre les étapes de votre workflow. Ils ne génèrent pas de contenu nouveau — ils réorganisent, filtrent et mettent en forme ce qui existe déjà. Ce sont les « traducteurs » entre les nodes.

Text Template

Tip

C'est comme un formulaire de lettre avec des champs à remplir. Vous écrivez « Bonjour {{nom}}, votre commande {{numéro}} est prête. » et le template remplace les {{}} par les vraies valeurs.

Text Template crée du texte à partir d'un modèle avec des variables. Vous utilisez la syntaxe {{variable}} pour insérer des données dynamiques. C'est parfait pour formater des prompts, des emails, ou des messages personnalisés.

Exemple

Vous créez un email de suivi automatique. Template : « Bonjour {{nom}},\nVotre dossier {{référence}} a été traité. Résultat : {{résultat}}.\nCordialement. ». Les variables sont remplies par les données du workflow.

Note

✅ Utilisez-le pour formater des messages, des prompts, des emails — tout texte qui suit un modèle avec des parties variables.

Warning

❌ Si vous avez besoin de transformations de données complexes (pas juste du texte), utilisez JSON Transform ou Code Transform.

JSON Transform

Tip

C'est comme un outil de tri et de rangement. Vous avez un tiroir en désordre (des données JSON) et vous en extrayez exactement ce dont vous avez besoin, bien organisé.

JSON Transform extrait ou réorganise des données JSON en utilisant des expressions. Par exemple, $.data.users[0].name extrait le nom du premier utilisateur. C'est utile pour sélectionner, filtrer ou restructurer des données entre deux nodes.

Exemple

Un HTTP Request retourne un gros objet JSON avec des données imbriquées. JSON Transform extrait juste la liste des résultats avec $.response.data.items et la passe au node suivant.

Note

✅ Utilisez-le pour extraire des champs spécifiques, réorganiser des données, ou préparer les données pour un autre node.

Warning

❌ Si vous avez besoin de logique complexe (boucles, conditions, calculs), utilisez Code Transform.

Code Transform

Tip

C'est comme Code Execution, mais spécialement conçu pour transformer des données. Vous écrivez un petit programme qui prend des données en entrée et retourne des données transformées.

Code Transform vous permet d'écrire du code JavaScript pour transformer des données. Contrairement à Code Execution (qui est un outil généraliste), Code Transform est optimisé pour la transformation : il a accès à l'entrée, à l'état du workflow, et aux sorties des autres nodes.

Exemple

Vous recevez une liste de documents avec des scores. Code Transform : return context.input.sort((a, b) => b.score - a.score).slice(0, 3); — trie par score décroissant et garde les 3 meilleurs.

Note

✅ Utilisez-le pour des transformations complexes qui nécessitent de la logique (tri, calculs, reformatage).

Warning

❌ Si vous avez juste besoin de texte avec variables (utilisez Template) ou d'extraction simple (utilisez JSON Transform).

Filter

Tip

C'est comme un tamis de cuisine : vous versez un mélange et seuls les éléments qui passent la condition traversent. Les autres sont récupérés séparément.

Filter prend une liste d'éléments et les sépare en deux groupes : ceux qui passent la condition (filtered) et ceux qui ne passent pas (rejected). C'est utile pour nettoyer des données ou séparer les résultats selon un critère.

Exemple

Vector Search retourne 10 documents. Filter ne garde que ceux avec un score > 0.8. Les 6 documents pertinents vont au LLM Chat, les 4 documents moins bons sont ignorés.

Note

✅ Utilisez-le pour nettoyer des listes, supprimer les éléments de mauvaise qualité, ou séparer des données.

Warning

❌ Si vous avez besoin de transformer les éléments (pas juste les filtrer), utilisez Code Transform.