For the complete documentation index, see llms.txt. This page is also available as Markdown.

Human-in-the-Loop (HITL) Approvals

Human-in-the-Loop (HITL) Approvals lets your agent pause before taking an action that changes something in another tool. Instead of acting immediately, nexos.ai shows you what the agent plans to do and waits for your decision.

This helps you stay in control of actions like sending a message, creating a ticket, or updating a record.

Where to find it

You will see approvals in different places depending on how the agent is running.

For chat agents

The approval appears directly in the conversation when the agent reaches an action that needs your review.

For scheduled agents

The approval appears in the agent’s Activity history. You may also notice it from the Activity panel, where paused agents show that they are waiting for approval.

To get there:

  1. Open Agents.

  2. Find the agent you want to review.

  3. Open the agent’s Activity history or select the notification from the Activity panel.

  4. Review the pending approval card.

How it works

When an agent is about to perform an action that changes something outside nexos.ai, it pauses and shows an approval card.

The card gives you a clear summary of:

  • what the agent wants to do

  • which integration it will use

  • the key details of the action

You can then choose what should happen next.

Turn approvals on or off for each integration

Approval settings are managed per integration inside the agent settings. For each integration added to the agent, you can turn the approval toggle on or off.

If the toggle is on, nexos.ai will ask for approval before the agent takes an action that changes something in that integration. If the toggle is off, the agent can continue with write actions in that integration without asking each time.

To manage it:

  1. Open Agents.

  2. Select the agent you want to update.

  3. Open Studio in the top-right corner.

  4. Select Settings.

  5. Go to Integrations.

  6. For each added integration, turn Require my approval before taking each action on or off.

What you can do

Each approval card gives you three options:

  • Approve The agent performs the action and continues.

  • Decline The agent does not perform the action and stops that run.

  • Always approve Future actions for that agent + integration can continue automatically without asking each time.

What happens next

After you make a decision:

  • if you approve, the action is completed and the agent continues

  • if you decline, the action is canceled and the run stops

  • if you choose always approve, the action is completed and similar future actions for that agent/integration can continue automatically

If no action is taken, the request will eventually expire and the run will stop.

What users need to know

  • Approvals only appear for actions that change something in another system.

  • Read-only actions, like searching or retrieving information, continue without asking for approval.

  • Approval requests stay available even if you leave and come back later.

  • You should always review the action before approving it.

Last updated