What is HITL?
Human-in-the-Loop (HITL) means you stay in control during automation. The agent pauses before important actions, letting you approve, modify, or cancel.Why HITL?
Safety
Prevent unintended actions
Accuracy
Correct mistakes before they happen
Learning
Understand how the agent thinks
Trust
Build confidence in automation
HITL Controls
When the agent pauses, you see:Approve
Let the action proceed as planned.Modify
Change what the agent will do.Skip
Skip this action and continue to the next.Cancel
Stop the entire execution immediately.Sensitive Actions
HITL pauses on actions that could cause problems:| Action Type | Why It’s Sensitive |
|---|---|
| Clicking Submit/Delete | May commit changes |
| Typing sensitive data | Passwords, personal info |
| File operations | Save, delete, rename |
| Navigation | Leaving current context |
| System actions | Shutdown, restart |
Configuring HITL
Process-Level Setting
In your process settings, choose:| Mode | Behavior |
|---|---|
| All Actions | Pause before every action |
| Sensitive Only | Pause only on risky actions |
| None | Run without pausing |
Runtime Override
When starting a run, you can override:- “Run with full HITL” - Override to all actions
- “Run unattended” - Override to no HITL
Best Practices
Start with HITL on everything
Start with HITL on everything
Until you’re confident the automation works correctly, keep full HITL enabled.
Gradually reduce oversight
Gradually reduce oversight
Once a process runs reliably several times:
- Switch from “All Actions” to “Sensitive Only”
- After more success, consider “None” for low-risk tasks
Pay attention to modifications
Pay attention to modifications
If you frequently modify the same action, the process description may need updating.
Don't just click Approve blindly
Don't just click Approve blindly
Read what the agent plans to do. Blind approval defeats the purpose.
Keyboard Shortcuts
Speed up HITL interaction:| Shortcut | Action |
|---|---|
Enter | Approve |
M | Open modify dialog |
S | Skip |
Escape | Cancel |
Modify Examples
Common modifications:Handling Errors
When the agent encounters an issue:- It pauses and describes the problem
- Screenshot shows the current state
- You can modify the approach or cancel
Logging HITL Decisions
All HITL interactions are logged:- What action was proposed
- Your decision (approve/modify/skip/cancel)
- Any modifications you made
- Timestamps