Conditional

Le node Conditional évalue des règles IF/ELIF/ELSE et oriente le workflow vers la branche correspondante.

À quoi sert le node Conditional ?

Le node Conditional (nom interne IF/ELSE) est un outil de contrôle de flux qui évalue un ou plusieurs cas de règles (IF, ELIF, ELSE) et active uniquement la sortie correspondant au premier cas qui se révèle vrai. C’est la manière standard de brancher un workflow selon les valeurs des données, sans écrire de code.

Cas d’usage typiques :

• Orienter un enregistrement selon la valeur d’un champ (statut, type, score, région).
• Vérifier qu’un node précédent a bien renvoyé du contenu non vide avant de continuer.
• Construire un pipeline à plusieurs niveaux (lead chaud / tiède / froid, succès / retry / échec).
• Filtrer les éléments qui ne correspondent pas à une règle métier avant de les envoyer à un node coûteux (LLM, appel API).

Configuration rapide

Paramètres de configuration

Le node Conditional n’a pas de champ texte libre. Toute la configuration porte sur les cas et leurs conditions.

Champs requis

Champs optionnels

Que renvoie le node ?

Le node ne transforme pas la donnée — il décide simplement quelle sortie activer. Chaque cas de votre configuration devient une sortie dédiée sur le canevas.

Exemples d’utilisation

Cas 1 : Vérifier le contenu scrapé avant analyse LLM

Un Web Scraper renvoie parfois des pages vides. Vous voulez sauter l’appel LLM quand il n’y a rien à analyser.

Configuration :

• Case 1 (IF) : Variable {{WebScraper_0.content}} · Operator is_not_empty
• Default (ELSE) : fourre-tout

Câblage :

• Case 1 → node LLM qui résume la page.
• Default → node Logger qui écrit “Aucun contenu scrapé”.

Cas 2 : Routage de leads par tranches

Orienter les leads entrants vers des flows hot / warm / nurture selon le score.

Configuration :

• Case 1 (IF) : {{lead.score}} greater_equal 80
• Case 2 (ELIF) : {{lead.score}} greater_equal 50
• Default (ELSE) : tout ce qui est sous 50

Câblage :

• Case 1 → Hot Lead Flow.
• Case 2 → Warm Lead Flow.
• Default → Nurture Flow.

graph LR
    A[Lead] --> B{score >= 80?}
    B -->|true| C[Hot Lead Flow]
    B -->|false| D{score >= 50?}
    D -->|true| E[Warm Lead Flow]
    D -->|false| F[Nurture Flow]

Cas 3 : Filtre multi-critères en AND

Ne traiter que les clients premium en zone EU.

Configuration (un seul cas IF, deux sous-conditions, logicalOperator = AND) :

• Sous-condition 1 : {{customer.plan}} equals "premium"
• Sous-condition 2 : {{customer.region}} equals "EU"

Case 1 exécute le pipeline EU-premium dédié. Default écarte l’enregistrement.

Problèmes courants

Un cas prend toujours la branche True (ou toujours False)

Cause : Mauvais type — la variable est résolue en chaîne alors que la valeur de droite est un nombre, donc equals ou greater_than renvoie un résultat inattendu.

Solution : Inspectez la valeur réelle dans les logs de run. Vérifiez que les deux côtés sont du même type, et retirez les guillemets autour des valeurs numériques.

Rien n'est connecté en aval de la branche ELSE et le workflow s'arrête en silence

Cause : La sortie Default (ELSE) n’est pas câblée et aucun cas IF / ELIF n’a matché.

Solution : Connectez toujours la sortie Default, ne serait-ce qu’à un logger ou un node Fail, pour rendre les entrées inattendues visibles.

Un ELIF plus loin ne se déclenche jamais alors que sa condition est vraie

Cause : Les cas sont évalués dans l’ordre ; un cas précédent a déjà matché.

Solution : Réordonnez les cas pour que les conditions les plus spécifiques arrivent en premier, ou resserrez les cas précédents pour qu’ils ne couvrent pas accidentellement les mêmes entrées.

Une référence variable n'est pas résolue

Cause : Mauvais chemin dans le template {{...}}, ou le node amont n’a pas tourné.

Solution : Utilisez le Variables Picker pour insérer les références, et vérifiez que le node référencé est bien connecté en amont.

Bonnes pratiques et pièges à éviter

graph LR
    Input[Node amont] --> Cond{Conditional}
    Cond -->|Case 1| A[Branche A]
    Cond -->|Case 2| B[Branche B]
    Cond -->|Default| C[Fallback / Log]

Nodes complémentaires