Guide: Human‑in‑the‑Loop (HITL)

Record signed, identity‑linked human interventions on AI decisions.

When to record

Approval/rejection of an AI decision.
Override: human changes the outcome (requires new_outcome).
Escalation events for audit trail completeness.

Payload

Field           Type     Required        Notes
actor_email     string   Yes             Human identity (email)
action          string   Yes             APPROVED | REJECTED | OVERRIDE | ESCALATED
reason          string   Yes             Why the human acted
new_outcome     object   If OVERRIDE     New decision payload
evidence_urls   array    No              Links to documents
metadata        object   No              Extra info (duration, checklist)

Examples

approve.pypython

intervention = client.records.intervene(
  record_id=record.id,
  actor_email="analyst@company.com",
  action="APPROVED",  # or REJECTED, OVERRIDE, ESCALATED
  reason="Documentation verified manually"
)

HITL records are signed (RSA‑SHA256), timestamped, and linked to identity. They are included in the evidence bundle.