Skip to main content

Workflows and the inbox

A workflow is a defined sequence of steps the platform runs for you, with branching, approvals and a durable record of every execution. Where a playbook is one body of agent work you run again, a workflow coordinates several steps — some of them agent work, some of them decisions.

Definitions and executions

  • A workflow definition is the shape: the steps, their order, where a human has to decide.
  • A workflow execution is one run of that shape, with its own state and history.

Definitions are versioned and published, so an execution runs against a known version rather than against whatever the definition happened to say at the time.

Approvals

A step can require a person to approve before the workflow continues. Until someone does, the execution waits — it does not time out into a guess.

The inbox

The inbox is where work waiting on you appears: approvals to give, decisions to make. It is the one screen to check when you want to know whether anything is blocked on you.

Tasks

Steps that dispatch work produce tasks, which is how a workflow hands something to an agent and picks the result back up.