Sonata

Documentation · For everyone

Workflows

A workflow chains agents into a repeatable process. You provide the input, choose how much supervision you want, and follow the run step by step.

Running a workflow

From My Workflows, pick an active workflow and choose Run. You give it the starting input, pick the autonomy level, and start. The run view shows each step as it executes: what went in, what came out, and how long it took.

Watchers: workflows that run themselves

Some workflows run on a schedule instead of waiting for someone to press Run. Watchers have their own guide: Watchers.

Supervised and autonomous

A supervised run pauses at every checkpoint a workflow defines and before any action that changes something outside Sonata. An autonomous run clears its own checkpoints, but here is the important part: even an autonomous run still pauses before any write. No workflow sends, files, or creates anything without a person approving that specific action.

Approvals

When a run pauses, it shows an approval card: what the step wants to do, named plainly. For an action an agent proposed itself, you can open a disclosure to see exactly what it will send before deciding. Approve and the action runs once; deny and the run handles it gracefully.

The run record

Every run keeps a complete, ordered record: each step, its input and output, and whether a person approved it or it proceeded automatically, with who decided. Runs survive even if the workflow that produced them is later deleted, because each run stores its own copy of the steps it executed.

How to

Run a workflow

  1. Open Workflows in the rail and pick My workflows.
  2. Select Run on an active workflow.
  3. Provide the starting input under Input for this run; the first step receives it.
  4. Choose the autonomy for this run: Supervised pauses at every checkpoint, Autonomous clears checkpoints itself but still pauses before any write.
  5. Select Start run and follow the run view.

Approve a paused run

  1. A paused run shows its approval card at the top of the run view, naming what the step wants to do.
  2. For an action an agent proposed itself, open Show what it will send to read the exact content first.
  3. Select Approve to let that one action run, or Deny. Only the person who started the run can decide.

Read a run record

  1. Open any run: each step lists its input, its output, its status, and how long it took.
  2. Approvals show who decided. The record is the run’s own copy, so it survives even if the workflow is later deleted.

All documentation · Everything above describes the product as it ships today. If something here doesn’t match what you see, tell us.

← Back to documentation