Skip to main content

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.
Agent: I'm about to click the "Submit" button
You: [Approve]
Agent: Clicked "Submit"

Modify

Change what the agent will do.
Agent: I'm about to type "Q1 2023" in the date field
You: [Modify] Type "Q1 2024" instead
Agent: Typed "Q1 2024" in the date field

Skip

Skip this action and continue to the next.
Agent: I'm about to click "Cookie Settings"
You: [Skip]
Agent: Skipped. Continuing...

Cancel

Stop the entire execution immediately.
Agent: I'm about to delete the file
You: [Cancel]
Agent: Execution cancelled

Sensitive Actions

HITL pauses on actions that could cause problems:
Action TypeWhy It’s Sensitive
Clicking Submit/DeleteMay commit changes
Typing sensitive dataPasswords, personal info
File operationsSave, delete, rename
NavigationLeaving current context
System actionsShutdown, restart

Configuring HITL

Process-Level Setting

In your process settings, choose:
ModeBehavior
All ActionsPause before every action
Sensitive OnlyPause only on risky actions
NoneRun 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

Until you’re confident the automation works correctly, keep full HITL enabled.
Once a process runs reliably several times:
  1. Switch from “All Actions” to “Sensitive Only”
  2. After more success, consider “None” for low-risk tasks
If you frequently modify the same action, the process description may need updating.
Read what the agent plans to do. Blind approval defeats the purpose.

Keyboard Shortcuts

Speed up HITL interaction:
ShortcutAction
EnterApprove
MOpen modify dialog
SSkip
EscapeCancel

Modify Examples

Common modifications:
# Fix a typo
Agent: I'll type "recieve" in the message field
You: Type "receive" instead

# Change target
Agent: I'll click the "Save Draft" button
You: Click "Save and Send" instead

# Add a wait
Agent: I'll click the dropdown
You: Wait 2 seconds first, then click

# Change value
Agent: I'll enter "100" in the quantity field
You: Enter "150" instead

Handling Errors

When the agent encounters an issue:
  1. It pauses and describes the problem
  2. Screenshot shows the current state
  3. You can modify the approach or cancel
If the agent repeatedly fails on the same action, consider modifying your process description to be more specific.

Logging HITL Decisions

All HITL interactions are logged:
  • What action was proposed
  • Your decision (approve/modify/skip/cancel)
  • Any modifications you made
  • Timestamps
View these in the run details under “Timeline.”

Next Steps