Review Policies
Define when and how human review is required for AI agent actions.
Overview
Review policies define the rules for human oversight. Configure which actions require approval, who can review them, and what happens on timeout.
Creating Policies
Via UI
- Navigate to Governance → Policies
- Click Create Policy
- Select policy type (HITL, HATL, HOTL)
- Choose target workflow(s)
- Configure conditions and reviewers
- Save and enable
Via SDK
from turingpulse_sdk import instrument, GovernanceDirective
@instrument(
name="financial-agent",
governance=GovernanceDirective(
hitl=True,
reviewers=["finance@company.com"],
severity="high",
)
)
def process_payment(amount: float):
return payment_service.charge(amount)Policy Types
HITL (Human-in-the-Loop)
Require approval before action executes.
- Blocks execution until approved
- Best for high-risk actions
- Can auto-approve/reject on timeout
HATL (Human-after-the-Loop)
Review after action completes.
- No execution delay
- Best for quality audits
- Supports sampling (review X%)
HOTL (Human-on-the-Loop)
Real-time monitoring with intervention capability.
- Alerts on anomalies
- Can pause/stop if needed
- Best for continuous oversight
Policy Configuration
| Option | Description |
|---|---|
workflow_id | Target workflow, or "*" for all |
type | hitl, hatl, or hotl |
condition | When to trigger (always, conditional) |
reviewers | List of reviewer emails |
escalation_channels | Alert channels for escalation |
auto_escalate_after_seconds | Seconds before escalation triggers |
severity | Review priority: low, medium, high |
Conditional Policies
Apply policies only when conditions are met:
Conditions are configured in the platform, not in code. The SDK marks a workflow for governance; the platform evaluates conditions such as cost thresholds, risk scores, or action types.
# Enable HITL via SDK — conditions are configured in the platform
governance = GovernanceDirective(
hitl=True,
reviewers=["finance@company.com"],
severity="high",
)Managing Policies
- Enable/Disable - Toggle policy without deleting
- Edit - Modify configuration
- Clone - Create copy with modifications
- Delete - Remove policy