All entries
Published

What Is Human-in-the-Loop?

Human-in-the-loop is the designed point at which an automated run stops and a person takes over. It is not the absence of automation, and it is not a review step bolted on afterward. It is the edge of autonomy, stated before the pipeline runs: the class of results this process will not act on by itself, and the person those results go to.

Definition

The decisive question is not whether a human is involved, but when that involvement was decided. "A person will look at anything unusual" is a hope, and it depends on the person noticing. "Any output that fails this contract routes to this owner with this reason" is a rule, and it holds whether or not anyone is paying attention. Only the second is human-in-the-loop. The first is improvisation with a person's name on it.

A handoff carries context rather than a task. When a run is blocked, it arrives with the reason it was blocked, the input that produced it, and the record of the run behind it. The person is not asked to reconstruct what happened. They are asked for a judgment the process deliberately declined to make.

Why it matters

A probabilistic system does not know when it is out of its depth. It produces a plausible result with the same confidence it shows when it is right. Something therefore has to determine that a given case is not the machine's to finish. In a workflow without that determination, the exception is written like every other result and discovered later, when it is expensive to reverse.

The handoff is also what makes the unattended part defensible. A business can allow a pipeline to act without a person in front of each step precisely because it knows which results will never be acted on — the ones routed to a human. The edge does not weaken the automation; it is what earns the right to run the rest of it. Removing the human entirely does not remove the edge. It only moves the moment that edge is discovered to after the damage.

And this is how confidence is produced instead of asserted. "The system is reliable" is a claim that can only be tested by failure. "Here is what it does when it is not reliable, and who it goes to" is a demonstration available in advance. Human-in-the-loop turns trust from a matter of belief into a matter of structure: the boundary, the owner, and the record already exist before anyone needs them.

How Opsyl implements it

In an Opsyl pipeline the handoff is a defined step, not a fallback added after an incident.

  • A contract first. The scope the client approves states what a valid result looks like, before any run. The handoff point is part of that scope, not a decision made in the moment.
  • Blocked, with the reason attached. A result that falls outside the contract is stopped before it can write, and moves to a person carrying the reason it was stopped.
  • A named destination. The exception routes to an owner defined in advance. It is not broadcast to a channel and left for someone to claim.
  • A logged reason. The block and its cause are recorded on the run, so the trail shows not only what was stopped but why.
  • The routine stays automatic. The human handles the edge. The pipeline handles the volume, unattended, and reports on it.

The governing claim holds at this point as much as anywhere: AI is probabilistic, our pipelines are not. Human-in-the-loop is where that claim is enforced — the moment the pipeline would otherwise be guessing, it stops and asks instead.

Where this connects

The handoff lives inside the Operating Layer, the execution layer between a decision and a system of record, and it is one of the controls that make Agent Governance real: a boundary is only a boundary if something happens when it is reached. Read next to Output-Contract Validation, it completes the picture — a contract says what counts as valid, and the human path is what happens when the answer is no.

The commercial consequence

A business does not get a trustworthy automation by removing people from it; it gets one by deciding exactly where the people stay. The first paid step with Opsyl is the Agentic Ops Audit: a fixed-scope week that maps where work actually goes and returns a written assessment of which steps can run unattended and where a handoff belongs. You keep the assessment whether or not you build.

Start with the audit → /pricing/

→ Related: Operating Layer · Agent Governance