Human Review: Decisione

flow_human_review_decision · logic · Logica & Flow · Disponibile · v1.0.0

Descrizione

Router di confidence enterprise che implementa il pattern Human-in-the-Loop per workflow AI-assisted production-ready. Confronta una metrica numerica di confidence (tipicamente 0.0 → 1.0) prodotta upstream da classifier LLM (agent_email_triage, agent_email_triage_commercialista, agent_summarizer), modelli computer vision (action_vision_extract), scraper AI (action_scrape_smart) o pipeline OCR, contro una soglia minima configurabile (default 0.70) abbinata a una lista di label "sensitive" che forzano comunque il branch review indipendentemente dalla confidence (es. label "legal_dispute", "fraud_suspected", "regulatory_complaint", "vip_customer", "executive_request" — categorie dove il rischio di errore costa più del ritardo umano). Emette uno dei due output branch del contratto: "auto" quando confidence ≥ soglia AND label non sensitive (il workflow prosegue senza intervento — bassa latenza, zero overhead operativo), "review" quando confidence < soglia OR label sensitive (il flusso si ferma e l'operatore umano riceve un task in coda con tutto il contesto della decisione AI per validare, correggere o sovrascrivere). Audit reason esplicito nell'output: { branch, confidence, threshold, triggeringLabel?, autoApproved? }. Pattern di composizione: la branch "review" si lega tipicamente a action_send_email / action_whatsapp_send / action_email_send_tracked per notificare l'operatore (con link al record da revisionare) + logic_wait_signal per sospendere il run fino al callback umano (un'API HTTP segnata dal trigger_form della dashboard tenant), poi resume con la decisione finale; il branch "auto" prosegue direttamente al downstream. Vantaggio vs implementazione manuale n8n/Zapier: 3-4 nodi (if + switch + set + log) incapsulati in un unico nodo dedicato con audit + GDPR-safe reason code + UI hint per l'operatore. Use case: triage email cliente con confidence < 0.6 va a operatore (evita rispondere male a un cliente arrabbiato), classificazione fattura SDI con label "anomalia_iva" sempre revisionata da contabile, OCR fattura cartacea con confidence < 0.85 → human review per integrazione campi mancanti, sentiment analysis social con label "crisis_signal" sempre escalata al PR manager, decisione di erogazione bonus B2B sopra una soglia di importo sempre con review CFO indipendentemente dalla confidence dell'agent commerciale.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`confidenceThreshold` Soglia confidence (0–1)	`number`	no	`0.7`	Sotto questo valore il branch è "review". Valori tipici: 0.7 (default sicuro), 0.85 (conservativo: più review), 0.5 (aggressivo: più auto). Range [0,1].
`confidenceField` Campo input con la confidence	`string`	no	`confidence`	Percorso top-level del campo numerico (0–1) sull'input. Default "confidence". Cambia se l'upstream usa "score", "probability".
`secondaryConfidenceField` Secondo campo confidence (opzionale)	`string`	no	— consistency_score	Quando valorizzato, viene letta ANCHE la sua confidence. La decisione usa il MINIMO dei due → più conservativa. Util per classifier multi-segnale (es. classifier + consistency check).
`alwaysReviewLabels` Label che forzano sempre review	`string`	no	— legal_request,fraud,payment_failed	Lista comma-separated. Quando il classifier emette una di queste label, il branch è SEMPRE "review" anche se la confidence supera la soglia. Per categorie ad alto rischio dove un falso positivo costa di più (compliance, sicurezza, perdite economiche).
`labelField` Campo input con la label	`string`	no	`label`	Default "label". Solo letto se alwaysReviewLabels è non-vuoto.
`fallbackOnMissing` Review quando confidence / label mancano	`boolean`	no	`true`	Quando ON, se l'input non porta confidence numerica (o label quando alwaysReviewLabels è valorizzato), il branch è "review" (safe-by-default). OFF = scegli "auto" su input incompleti — usa solo se sai che l'upstream è 100% affidabile.
`reasonTemplate` Template reason code	`string`	no	— low_confidence_{label}	Stringa stampata nell'output.reason per audit/UI operatrice. Placeholder: {label} {confidence} {threshold}. Es: "low_confidence_{label}" → "low_confidence_legal_request".

⬆️ Output del nodo

Campi disponibili nei nodi successivi via $node.<alias>.json.<field>:

auto
review

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-flow_human_review_decision-1",
  "defId": "flow_human_review_decision",
  "label": "Human Review: Decisione",
  "config": {
    "confidenceThreshold": 0.7,
    "confidenceField": "confidence",
    "labelField": "label",
    "fallbackOnMissing": true
  }
}

🔗 Nodi correlati nella stessa categoria

Pronto a usare Human Review: Decisione?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi