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

  1. Navigate to Governance → Policies
  2. Click Create Policy
  3. Select policy type (HITL, HATL, HOTL)
  4. Choose target workflow(s)
  5. Configure conditions and reviewers
  6. 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

OptionDescription
workflow_idTarget workflow, or "*" for all
typehitl, hatl, or hotl
conditionWhen to trigger (always, conditional)
reviewersList of reviewer emails
escalation_channelsAlert channels for escalation
auto_escalate_after_secondsSeconds before escalation triggers
severityReview 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

Next Steps