What Are Review Tasks?
Review tasks are created when a workflow’s human intervention node is triggered. They represent a trace that needs human approval before it can be completed. Not every trace creates a review task. Review tasks only exist when your workflow determines that human oversight is needed.When Review Tasks Are Created
Trace Arrives
A trace is created from your AI system
Policies Assess
Policies evaluate the trace and produce assessments
Workflow Triggers
A workflow trigger matches the trace or its assessments
Human Intervention Node
The workflow hits a human intervention node
Review Task Created
A review task is created and notifications are sent
Review Task Components
Linked Trace
Every review task is linked to the trace that triggered it. The trace contains:- Function Name - What action was attempted
- Arguments - Input data for the action
- Metadata - Additional context
- Session ID - Related traces in the same session
- Assessments - Policy evaluation results
Approval Requirements
Based on the human intervention node configuration:- Number of Approvals Needed - How many people must approve
- Timeout - How long to wait before escalation
- Channels - Where notifications are sent
Decisions
As reviewers respond:- Decision Type - Approved, Declined, or Change Requested
- Reviewer - Who made the decision
- Channel - Where the decision was made
- Reason - Optional explanation
- Timestamp - When the decision was made
Review Task States
| State | Description |
|---|---|
| Pending | Waiting for human decision |
| Processing | Being reviewed |
| Approved | Required approvals received |
| Rejected | Reviewer declined |
| Change Requested | Reviewer wants modifications |
| Requires Intervention | Needs additional review |
Viewing Review Tasks
In the dashboard:- Go to Review Tasks to see all tasks
- Filter by status, project, or date
- Click a task to see:
- The linked trace with full details
- Policy assessments
- Workflow execution history
- Decisions made so far
Making Decisions
Reviewers can respond through connected channels:| Channel | How |
|---|---|
| Slack | Click buttons or use reactions |
| Reply with APPROVE, DECLINE, or CHANGES | |
| Teams | Click adaptive card buttons |
| Web Dashboard | Use the decision panel |
| SMS | Reply with A, D, or C |
Multi-Approver Tasks
When multiple approvals are needed:- Each approver makes an independent decision
- One decline rejects the entire task
- All required approvals must be received
- Progress is shown in the dashboard
What Happens After Decision
| Decision | Result |
|---|---|
| Approved | Workflow continues through Approved path. Trace marked Completed. |
| Declined | Workflow continues through Declined path. Usually leads to rejection. |
| Change Requested | Workflow continues through Change path. Feedback sent to caller. |