Diff Checker
Le node Diff Checker compare deux entrées textuelles et affiche les différences entre elles pendant l'exécution du workflow.
À quoi sert le node Diff Checker ?
Le node Diff Checker compare deux entrées textuelles et affiche les différences entre elles pendant l’exécution du workflow. C’est un outil de contrôle visuel rapide pour confirmer qu’une transformation, une réécriture ou une récupération a produit le résultat attendu, sans avoir à inspecter manuellement l’intégralité du contenu.
Cas d’usage typiques :
- Comparer un article original avec une version réécrite par un LLM pour visualiser ce qui a changé.
- Vérifier que deux appels API ou deux exécutions de scraping retournent des données identiques.
- Auditer une normalisation de texte (Find and Replace, HTML Cleaner) en confrontant la sortie avant/après.
Configuration rapide
Suivez ces étapes pour ajouter et configurer le node Diff Checker dans votre workflow :
Ajouter le node au canevas
Ouvrez la bibliothèque de nodes (Node Library), naviguez dans la catégorie Tools > Data Transformation, puis glissez-déposez le node Diff Checker sur votre espace de travail.
Connecter les deux entrées texte
Reliez le port d’entrée text_1 à la sortie du premier node produisant du texte (le contenu original ou de référence) et le port d’entrée text_2 à la sortie du second node (le contenu modifié ou à comparer).
Exécuter le workflow
Lancez le workflow. Le node Diff Checker affiche le résultat de la comparaison pendant l’exécution, en mettant en évidence ce qui a été ajouté, supprimé ou conservé identique entre les deux entrées.
Paramètres de configuration
Le node Diff Checker n’expose aucun paramètre personnalisé. Il nécessite uniquement que ses deux entrées texte soient connectées ; la comparaison est effectuée automatiquement à l’exécution du workflow.
Champs requis
Name string required default: Diff Checker Nom du node — Utile pour identifier rapidement cette étape de comparaison lors de l’exécution et du débogage du workflow (ex: “Compare LLM rewrite vs original”).
Description string required default: Display a diff checker between two inputs during the run Description du node — Une courte phrase décrivant ce qui est comparé à cette étape.
text_1 string required Premier texte — Le texte original ou de référence. Cette entrée doit être connectée à la sortie d’un node en amont qui produit une string.
text_2 string required Second texte — Le texte modifié ou cible à comparer à text_1. Cette entrée doit elle aussi être connectée à un node produisant une string.
Champs optionnels
Le node Diff Checker n’expose pas de champs optionnels au-delà des champs standard Name et Description. La logique de comparaison est figée et s’exécute dès que les deux entrées sont fournies.
Les deux entrées sont sensibles à la casse et aux espaces. Si vous ne souhaitez comparer que le contenu signifiant, normalisez d’abord les deux entrées en amont avec un node Find and Replace ou HTML Cleaner.
Que renvoie le node ?
Le node restitue une visualisation de diff pendant l’exécution du workflow, mettant en évidence les segments ajoutés, supprimés et inchangés entre text_1 et text_2. Diff Checker est avant tout un node d’inspection visuelle — il n’expose pas de sortie aval chaînable vers d’autres nodes.
Diff result visual Une vue de diff affichée en cours d’exécution montrant les ajouts, suppressions et portions inchangées entre text_1 et text_2. À utiliser comme étape de contrôle plutôt que comme source de données pour des nodes en aval.
Exemples d’utilisation
Exemple 1 : Comparer un article avant et après réécriture par un LLM
Vous disposez d’un article original et souhaitez qu’un LLM l’améliore. Placez le Diff Checker après le node LLM pour voir exactement ce qui a été modifié.
- text_1 : L’article original provenant d’un node Text Input ou Paragraph.
- text_2 : L’article réécrit produit par le node LLM.
- Résultat : Une vue de diff montrant chaque phrase ajoutée, supprimée ou reformulée par le LLM lors de l’exécution.
Exemple 2 : Vérifier la cohérence des données entre deux appels API
Vous récupérez des données depuis une API à deux moments différents de votre workflow et souhaitez confirmer que rien n’a changé entre les appels.
- text_1 : Le corps de la réponse du premier appel API Connector.
- text_2 : Le corps de la réponse du second appel API Connector.
- Résultat : Un diff confirmant que la donnée est identique, ou mettant en évidence les écarts introduits entre les deux requêtes.
Problèmes courants
Une ou les deux entrées ne sont pas connectées
Cause : Le node requiert que text_1 et text_2 soient tous deux connectés. Si l’une des entrées est absente, le node n’a rien à comparer et l’exécution échoue ou produit un diff vide.
Solution : Assurez-vous que les deux ports d’entrée sont connectés à des nodes qui produisent une sortie texte. Vérifiez les connexions dans le canevas avant de lancer le workflow.
Le diff affiche tout comme modifié alors que les textes paraissent identiques
Cause : Les deux entrées diffèrent de manière invisible — espaces en trop, sauts de ligne, encodage ou caractères de fin — même si le contenu visible semble similaire.
Solution : Ajoutez un node Find and Replace ou HTML Cleaner avant chaque entrée du Diff Checker pour normaliser les espaces et retirer les caractères invisibles avant la comparaison.
Je dois utiliser le résultat du diff dans un node en aval
Cause : Diff Checker est un node d’inspection visuelle et n’expose pas son diff comme un point de sortie chaînable.
Solution : Utilisez-le comme garde-fou qualité pendant le développement. Pour exploiter les différences de manière programmatique, envoyez les deux textes à un node LLM avec un prompt qui les compare et renvoie une réponse structurée.
Bonnes pratiques
Utilisez le Diff Checker comme étape de contrôle qualité après tout node qui transforme du texte (réécriture LLM, Find and Replace, HTML Cleaner). Il rend les modifications cachées évidentes et aide à affiner les prompts pendant le développement du workflow.
Diff Checker est conçu pour l’inspection en cours d’exécution, pas pour brancher la suite du workflow. Ne comptez pas dessus pour alimenter d’autres nodes — gardez-le comme un canal de contrôle latéral entre les étapes de transformation.
Nodes complémentaires
Normalisez ou nettoyez le texte en amont du Diff Checker pour ne mettre en évidence que les différences signifiantes.
Générez ou réécrivez du texte, puis placez un Diff Checker juste après pour visualiser les changements pendant l’exécution.
Retirez balises HTML et caractères invisibles avant de comparer deux documents scrapés ou générés.
Comparez les réponses de deux appels API pour détecter une dérive ou confirmer l’idempotence entre requêtes.