Stop Node

Le node Stop Node arrête volontairement un workflow avec un message d'erreur personnalisé, pour la validation et les règles métier.

À quoi sert le node Stop Node ?#

Le node Stop Node arrête l’exécution du workflow et renvoie un message d’erreur personnalisé. Utilisez-le comme point de terminaison explicite lorsqu’une condition amont n’est pas remplie : pour valider les entrées au plus tôt, appliquer des règles métier, ou faire remonter un échec clair et lisible à la personne qui exécute (ou supervise) le workflow.

Cas d’usage typiques :

• Stopper le workflow lorsqu’une entrée requise (URL, clé API, dataset) est absente ou invalide.
• Appliquer une règle métier avant de continuer (ex : contenu de moins de 500 mots, score hors [0, 100]).
• Transformer une erreur API molle (HTTP 4xx/5xx) en échec de workflow dur et traçable, avec contexte complet.
• Arrêter tôt lorsqu’une limite de débit ou un quota est atteint.

Configuration rapide#

Suivez ces étapes pour ajouter et configurer le node Stop Node dans votre workflow :

Paramètres de configuration#

Le Stop Node ne prend qu’un seul paramètre texte, mais c’est la qualité du message qui rend ce node utile.

Champs requis#

Champs optionnels#

Que renvoie le node ?#

Le Stop Node n’a pas de port de sortie : il termine l’exécution du workflow au lieu de produire des données. Le moteur d’exécution lève une UserFailedException avec votre message en pièce jointe, qui est restituée dans le log d’exécution et tout canal de supervision abonné.

Comment récupérer l’output ?#

Comme le node met fin à l’exécution, les nodes en aval ne sont jamais atteints. Pour réagir à l’échec, consommez le résultat d’exécution du workflow depuis l’extérieur (webhook API, vue d’historique, alerting). Le message que vous avez rédigé dans le node est exactement ce que le consommateur reçoit.

Exemples d’utilisation#

Cas 1 : Valider une entrée requise au plus tôt#

Garantir qu’une URL est fournie avant de lancer un pipeline de scraping coûteux.

Vérification du Conditional (amont) : {{Text_Input_0.text}} est vide.

Configuration du message d’erreur :

URL is required but was not provided.
Please supply a valid http(s) URL in the Text Input node.

Ce qu’il se passe à l’exécution : lorsque le Conditional route vers le Stop Node, le workflow s’arrête immédiatement. Les nodes Web Scraper / LLM en aval ne sont jamais facturés.

Cas 2 : Imposer une longueur minimale de contenu avec interpolation#

Refuser un contenu de moins de 500 mots avant envoi vers un CMS.

Vérification du Conditional (amont) : {{Count_List_Items_0.count}} < 500.

Configuration du message d’erreur :

Content too short ({{Count_List_Items_0.count}} words).
Minimum required: 500. Expand the article before publishing.

Message généré à l’exécution (exemple) :

Content too short (312 words).
Minimum required: 500. Expand the article before publishing.

Cas 3 : Faire suivre un message d’erreur externe#

Lorsque le message est construit par un node LLM ou API amont, externalisez-le :

1. Dans les paramètres du Stop Node, cochez Use variable for error message.
2. Le champ est remplacé par {{errorMessage}}.
3. Câblez la sortie du node amont vers la variable errorMessage du workflow.

Le node relaie alors le message produit par le node amont, sans aucune édition de chaîne dans le Stop Node lui-même.

Problèmes courants#

Le workflow échoue toujours, même sur le chemin nominal

Cause : le Stop Node a été placé en ligne (sans Conditional en amont), donc chaque exécution l’atteint.

Solution : insérez un node Conditional en amont et reliez le Stop Node uniquement à la branche d’échec. La branche de succès doit le contourner entièrement.

Le message d'erreur contient le placeholder littéral `{{variableName}}`

Cause : le nom de variable ne correspond à aucune sortie amont, ou le node amont n’a pas produit de valeur avant le déclenchement du Stop Node.

Solution : copiez le nom de variable depuis le panneau de sortie du node source. Vérifiez que ce node source est bien en amont du Conditional qui déclenche le Stop Node, afin que sa valeur soit disponible au moment de l’interpolation.

`Use variable for error message` est activé mais le message est vide

Cause : la variable externe {{errorMessage}} n’est pas reliée ou la valeur amont est vide.

Solution : le runner se rabat sur Workflow failed intentionally dans ce cas. Pour obtenir un message exploitable, assurez-vous que le node amont écrit bien une chaîne non vide dans la variable de workflow errorMessage.

Erreur de validation `Error message is required` dans le panneau de paramètres

Cause : le champ est vide et la case d’externalisation est décochée.

Solution : soit saisissez un message (la seule valeur d’apparence vide acceptée est la référence littérale {{errorMessage}}), soit cochez Use variable for error message.

Bonnes pratiques et pièges à éviter#

Comment s’intègre-t-il dans un workflow ?#

Le Stop Node est un node terminal placé sur la branche d’échec d’un Conditional. Le motif est « valider, puis dérouler » : un ou plusieurs Conditional à l’entrée du workflow, chacun gardant un Stop Node, puis les nodes productifs en aval.

graph LR
    Input[Text Input] --> Cond{URL valide ?}
    Cond -->|Non| Stop[Stop Node
<br/>URL absente]
    Cond -->|Oui| Scraper[Web Scraper]
    Scraper --> LLM[LLM]
    LLM --> Output[Output]

Nodes complémentaires#