Regulated HITL Approval Flow¶
End-to-end pattern: sensitive agent output requires human approval before downstream agents consume it.
When to use¶
- Financial / legal / medical workflows
- Any action that mutates external systems after LLM reasoning
Flow¶
sequenceDiagram
participant U as User
participant S as Scheduler
participant W as Worker Agent
participant H as HITL Gate
participant D as Downstream Agent
U->>S: Submit intent
S->>W: Schedule task
W->>H: Request approval (payload)
H->>U: Notify (Studio / webhook)
U->>H: Approve or reject
H->>S: Resume or abort
S->>D: Schedule only if approved
Minimal code¶
See examples/03_hitl_approval.py:
from hiveflow import HiveFlow, HiveFlowConfig, ECM, HITLManager
hf = HiveFlow(HiveFlowConfig())
await hf.start()
hitl = HITLManager(hf.blackboard)
# Register agents, then gate sensitive writes through hitl.request_approval(...)
Studio¶
- Build workflow with a HITL node in Orchestrator
- Approve from Dashboard or webhook callback
- Audit trail is on
SecureBlackboard— see Concepts — Blackboard