​
What Are Review Tasks?

Review Tasks are the central mechanism in Velatir for managing approval requests. Each task represents a single AI request that needs human oversight, tracking its complete journey from initial submission through final decision.

​
Review Task Lifecycle

1

Creation

AI system submits a request via API, SDK, or integration
2

Policy Assessment

Advanced AI evaluates the request against all active policies
3

Flow Routing

System determines appropriate approval channel based on conditions
4

Human Review

Designated reviewers make approval decisions
5

Resolution

Task completes with final decision and audit trail

​
Task Components

​
Core Information

Every review task contains:

Function Details

Function Name: The AI operation requesting approval
Arguments: Data and parameters for the operation
Description: Human-readable explanation of the request

Context Information

LLM Explanation: How the AI explains its approach
Metadata: Additional context like user ID, session info
Parent/Child Tasks: Hierarchical relationships

​
Assessment Results

Each task includes detailed policy evaluations:
  • Compliance Status - Whether request meets policy requirements
  • Risk Level - Low, Medium, High, or Critical risk assessment
  • Confidence Scores - How certain the AI is in its evaluation
  • Recommendations - Auto-approve or require human intervention
  • Tags - Categorization labels for routing and analytics

​
Task States

Pending

Request submitted and queued for processing

Processing

AI evaluating against policies and determining routing

Decision Point

Low Risk → Approved automatically
Medium/High Risk → Requires Intervention

Human Review

Only for requests requiring intervention
Team member reviews and decides:
  • Approved → Task completed ✅
  • Rejected → Task declined ❌
  • Change Requested → Feedback provided 📝

​
Task Metadata

​
Timestamps

  • Created At - When the request was submitted
  • Processed At - When policy evaluation completed
  • Completed At - When final decision was made

​
Approval Requirements

  • Number of Approvals Needed - How many people must approve
  • Current Approval Count - Progress toward requirement
  • Timeout Settings - How long to wait for decisions

​
Task Hierarchy

Review tasks can have parent-child relationships for complex workflows:

​
Parent Tasks

  • Represent high-level operations
  • Can spawn multiple child tasks
  • Complete only when all children are resolved

​
Child Tasks

  • Handle specific sub-operations
  • Inherit context from parent
  • Can escalate to parent level if needed

​
Use Cases for Hierarchies

  • Multi-step Processes: Each step needs separate approval
  • Batch Operations: Multiple similar requests grouped together
  • Escalation Chains: Initial review → supervisor review → executive approval

​
Integration with Channels

Review tasks are displayed differently across channels:

Slack Integration

Interactive buttons for approve/decline/request changes
Threaded conversations for discussion
Automated status updates

Web Dashboard

Full task details and assessment results
Bulk actions for multiple tasks
Advanced filtering and search

Email Notifications

Summary information with approval links
Reply-to-approve functionality
Digest options for multiple tasks

Microsoft Teams

Adaptive cards for rich interaction
Integration with Teams workflows
Notification scheduling

​
Analytics & Reporting

Track review task patterns for insights:
  • Approval Rates - What percentage of tasks get approved
  • Response Times - How quickly decisions are made
  • Common Rejection Reasons - Why requests are declined
  • Policy Effectiveness - Which policies catch the most issues
  • Channel Performance - Which approval methods work best

Task States Deep Dive

Detailed state explanations

Assessment Process

How AI evaluates requests

Decision Making

Human approval workflows