Human in the Loop

Le node Human in the Loop met en pause l'exécution du workflow et demande à un réviseur humain de valider le contenu avant de continuer.

À quoi sert le node Human in the Loop ?

Le node Human in the Loop met en pause l’exécution du workflow et présente le contenu à un réviseur humain pour approbation avant de reprendre. Il permet d’insérer un point de contrôle manuel à n’importe quelle étape critique de votre workflow — pour relire du contenu généré par l’IA, valider des données ou approuver des actions avant qu’elles ne s’exécutent en aval.

Cas d’usage typiques :

• Relire des articles ou résumés générés par l’IA avant publication sur un CMS.
• Valider des données extraites avant écriture dans un système externe (CRM, base de données, tableur).
• Contrôler la qualité du contenu d’un email ou d’un message client avant envoi.
• Approuver des opérations sensibles ou irréversibles avant qu’elles ne s’exécutent.

Configuration rapide

Suivez ces étapes pour ajouter et configurer le node Human in the Loop dans votre workflow :

Paramètres de configuration

La configuration du node consiste à brancher le contenu à relire et, optionnellement, à fournir une instruction claire au réviseur.

Champs requis

Champs optionnels

Que renvoie le node ?

Le node renvoie le contenu tel qu’approuvé par le réviseur. Le workflow reste en pause tant qu’un humain n’a pas traité la demande de revue ; ensuite, l’exécution reprend avec ce contenu en entrée du node suivant.

Comment récupérer l’output ?

Dans Draft & Goal, vous n’avez pas besoin de chercher un nom de variable complexe généré par le système. Pour exploiter le résultat :

1. Tirez un lien depuis le port Output du node Human in the Loop.
2. Connectez-le à l’entrée du node suivant.
3. Dans ce node suivant, créez et nommez votre propre variable (par exemple, contenu_approuve). La valeur relue y sera automatiquement injectée.

Exemples d’utilisation

Cas 1 : Approuver un article généré par l’IA avant publication dans Notion

S’assurer qu’un article généré par un LLM est exact et conforme à la marque avant qu’il n’arrive sur votre CMS.

Workflow :

1. Web Scraper — Récupère une page source utilisée comme matière première.
2. LLM — Génère un article structuré à partir de cette source.
3. Human in the Loop — Content connecté à la sortie du LLM. Custom Message = “Vérifiez l’exactitude factuelle, le ton et la complétude de l’article avant publication dans Notion”.
4. Notion Database Writer — Reçoit l’article approuvé et le publie.

Cas 2 : Valider un email personnalisé avant envoi

Repérer les mauvais noms client, les offres cassées ou un ton hors charte avant qu’un email automatique ne parte.

Workflow :

1. LLM — Génère un email personnalisé à partir des données CRM.
2. Human in the Loop — Content connecté au corps de l’email. Custom Message = “Vérifiez le nom du client, les détails de l’offre et le ton professionnel. Rejetez si quelque chose cloche”.
3. Email Sender — Envoie l’email approuvé.

Problèmes courants

Le workflow est bloqué sur le node Human in the Loop

Cause : Le node fait exactement son travail — il met en pause le workflow et attend qu’un humain valide la demande de revue. Il n’y a pas de timeout automatique.

Solution : Ouvrez le panneau d’exécution du workflow et cherchez une demande de revue en attente sur ce node. Le réviseur doit lire le contenu et l’approuver pour que le workflow reprenne.

Le réviseur ne sait pas quoi vérifier

Cause : Le champ Custom Message est vide ou trop vague, donc le réviseur ne voit que du contenu brut sans critères d’acceptation.

Solution : Remplissez Custom Message avec une instruction précise listant ce que le réviseur doit vérifier (champs spécifiques, ton, faits, formatage). Plus le message est clair, plus la revue sera rapide et cohérente.

Aucun contenu n'arrive au réviseur

Cause : L’entrée Content n’est pas connectée, ou le node en amont a produit une sortie vide.

Solution : Vérifiez que le port Content est connecté au bon node en amont. Exécutez le node en amont seul pour confirmer qu’il produit une sortie non vide avant de reconnecter.

Bonnes pratiques et pièges à éviter

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

Human in the Loop agit typiquement comme une porte d’approbation entre la génération de contenu et toute action en aval irréversible. Voici un schéma typique d’intégration pour du contenu généré par IA qui finit dans un système externe :

graph LR
    Source[Web Scraper / Source données] --> LLM[LLM génère le contenu]
    LLM --> HITL[Human in the Loop
<br/>réviseur approuve]
    HITL --> Publish[Notion / Email / CRM]

Nodes complémentaires