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.
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#
- Open the run from the task that started it, or open the full-screen Formula run view.
- 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.
- Open a step with Open step chat. Steps that have not started yet have no chat link.
- Act where the run waits for you — see the table below.
- 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#
| Node | What you do |
|---|---|
| Check | Choose approve, revise, or reject. revise needs a note. |
| Decision | Choose one of the formula’s own routes, with a note when the route asks for one |
| Input | Write 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.