Telephone number 530-820-3390 530-820-3390 Support Support

Documentation

Human-in-the-Loop: HITL

The HITL action allows you to include a human decision step in your automation. Each decision option is represented as a branch. You can configure up to five branches, and each branch can run automatically or require the user to choose during execution.

By using the HITL action, you can combine automated processing with human judgment. Each branch defines a clear path and can contain any actions or functions already available in HuLoop. This gives you flexibility while maintaining control in scenarios that require human review.

Important: The HITL action is fully supported only in Grid View.
Before adding or configuring HITL, switch to Grid View to ensure all branches and configuration options appear correctly. See more: How to switch between Views.

Steps to Configure:

  1. Add the HITL Action
    • Switch to Grid View.
    • Drag and drop the HITL action into your automation.
    • In the configuration pane, two default HITL branches appear below the Element Key
    • Select both branches before saving the step. If the branches are not selected, an error may occur.
    • Click Save.

HITL_action_config

After saving, the HITL step appears as shown:

HITL_action_steps

  1. Configure the HITL Branches

You can rename and update each branch as needed.

To edit a branch:

    1. Select the three-dots menu on the branch.

HITL_branch_click_three_dot_menu

    1. Click Edit

HITL_branch_edit

    1. The Edit HITL Branch dialog opens:

HITL_branch_edit_dialog
You can update:

    1. Branch Name
    2. Description
    3. Auto-Execute Default Branch (On/Off): Let’s you decide whether the reviewer must choose a branch or whether the system should auto-run a branch during execution.
    • Auto-Execute Default Branch OFF:
      • A pop-up appears during execution
      • The reviewer selects the branch from a dropdown
      • The use case inside the selected branch runs automatically
    • Auto-Execute Default Branch ON:
      • The branch runs automatically
      • No pop-up appears
      • If multiple branches have Auto-Execute ON, those branches run in order
    1. Click Save to apply changes.
  1. Add More Branches (Optional)

You can add a maximum of five branches.

To add a branch:

    1. Drag and drop the Branch placeholder into the HITL step.
    2. A new branch appears and is ready to configure.

HITL_add_more_branch

  1. Delete a Branch
    • Select the three-dots menu on the branch.
    • Use the delete option to remove the branch if needed.

  1. Add Actions or Functions Inside Each Branch

Each branch represents a complete use case. To define what happens within that use case, you can add HuLoop actions or functions under the branch.

To Add Actions/Functions under HITL Branch:

    1. drag and drop the required action or function under the desired HITL branch.
    2. The configuration pane opens automatically. Configure the action/function as needed.
    3. Repeat as required to build your complete use case inside that branch.

This allows each HITL branch to run its own sequence of steps during automation.

HITL_add_action_function_each_branchExpected output on Execution

When the automation reaches the HITL step:

  1. If Auto-Execute is OFF, a pop-up appears on the agent window.
  2. The reviewer chooses the appropriate branch from the dropdown.
  3. The automation executes the actions or functions contained within the selected branch.
  4. If Auto-Execute is ON, the branches runs sequentially without any pop-up.

Last updated: Dec 23, 2025
Back To Top