Skip to content
Browse the docs

Formula runs in chat

A formula run opens on its own canvas: see where it is, act on checks, decisions, and inputs, open a step’s chat, and cancel or restart the run.

Updated 2 min readView as MarkdownOpen in Nested

A formula is a reusable, typed workflow: a graph of steps and gates with checked input. Each step runs as an ordinary task on the agent. You design formulas in the pack builder; watching, deciding, and cancelling happen on the run canvas next to the chat that started it.

Before you start#

  • Formulas come from packs attached to the agent. Author them in the pack builder.
  • A run starts when an agent calls a formula, when an automation runs one, or when a parent formula starts it.
  • Acting on a run needs manage access on the agent. Without it, you see “You need manage access on this deployment to act.”

Steps#

  1. Open the run from the task that started it, or open the full-screen Formula run view.
  2. Read the canvas: the formula name, version, status, and where the run is now. Live follows the run; Replay steps through its history, and Back to live returns.
  3. Open a step with Open step chat. Steps that have not started yet have no chat link.
  4. Act where the run waits for you — see the table below.
  5. Select Cancel run to stop the steps still running. A failed or cancelled run can be revived with Restart run.

What a run can ask you#

NodeWhat you do
CheckChoose approve, revise, or reject. revise needs a note.
DecisionChoose one of the formula’s own routes, with a note when the route asks for one
InputWrite a reply to the step and select Submit

Runs that wait on you also appear under Needs you, and notifications can tell you when “A formula needs a decision” or “A formula needs input”.

Example#

A bug-fix run reaches a human check after the agent writes a patch. You open the step chat, read the diff, and choose approve. The next step starts, and its chat is one click away. Later a flaky test fails a step; you select Restart run and the run picks up again.

Questions

What is a formula in Nested?
A formula is a typed workflow shipped in a pack: steps that run as agent tasks, joined by gates that route by rules or by a person.
Why can’t I approve a formula check?
Acting on a run needs manage access on the agent. Ask the agent’s owner, or have them act on the run.