When to use review
- You want a human gate before delivering results to a downstream system. Set Pause mode to
Always. - You only want humans involved on uncertain runs. Pair
LowConfidencewith a confidence threshold, orUnverified Fieldswith extract’s Field confidence toggle. - You want a fallback path when validation fails on the
Warnaction: route the warned run into review for correction. - You want to gate the run on specific cross-field rules. Add an upstream Validation node and set this node’s pause mode to
Validation failures. Only the runs whose rules recorded a failing field path pause. - You want to catch numeric disagreements between two sources. Add an upstream Reconcile node and set this node’s pause mode to
Reconcile mismatch. Only the runs whose two sources disagree pause. - Skip review when an automated validation check or transform can fix the data deterministically. Reserve human time for cases that genuinely need judgment.
Configuration
Reminders nudge the assigned reviewer while the task is still pending. If the task is unassigned (anyone can claim), no per-person reminder is sent.
Inputs and outputs
Allowed inputs: Extract, validation, reconcile, HTTP, loop, variable, store, prompt. Maximum one input connection. Review pauses on extracted data, so it sits after the node that produced that data, not directly after filter pages or split. Output: Approved (and possibly edited) data, passed to the next connected node.Common pitfalls
Pause mode = Always on a high-volume pipeline
Pause mode = Always on a high-volume pipeline
Always pauses every run. On a busy pipeline this floods the review queue and stalls throughput. Use LowConfidence or Unverified Fields to gate only the runs that need attention.Unverified Fields without Field confidence enabled upstream
Unverified Fields without Field confidence enabled upstream
Unverified Fields mode only triggers when the upstream extract node has Field confidence enabled (Engine 1 only). Without it, no fields are ever marked unverified and the review node never pauses.Validation failures mode without a validation node upstream
Validation failures mode without a validation node upstream
Validation failures activates whenever an upstream Validation node is present and consumes the failing field paths recorded by that node’s Warn action (when its rules can attribute them). The editor hides this pause mode when no Validation predecessor is connected.Reconcile mismatch mode without a reconcile node upstream
Reconcile mismatch mode without a reconcile node upstream
Reconcile mismatch mode requires an upstream Reconcile node. The editor hides this pause mode when no Reconcile predecessor is connected.Min confidence set without testing the score distribution
Min confidence set without testing the score distribution
The right threshold depends on what your runs actually score. Set
Min confidence after you’ve seen real distributions for your documents; defaults that look reasonable can pause everything or nothing.No fallback when reviewers reject a run
No fallback when reviewers reject a run
A reviewer can mark a run failed. Make sure the failure path is intentional: either delete the document, route to a fallback pipeline, or notify a system. Don’t let rejections sit silently.
Related
Human review guide
Set up and manage human review workflows
Review queue
Learn how the review queue works
Extract action
Extract data before review
Transform action
Transform data after review
Reconcile action
Compare two sources before review