Skip to main content

Following runs

Every trigger creates a run: an object with frozen input, a step-by-step timeline, output, and an outcome.

The timeline​

It shows what happened, in order, in product language:

ElementContent
StepsEach one, with its state, duration, and attempt
Input and outputWhat each step received and produced
Failure reasonWhen there was one, with the step that stopped
Child runsWhen the agent called another, with links to them

The timeline is append-only: nothing is rewritten afterwards.

What the timeline does not show

It records semantic state: what the run did. It does not show the model's internal reasoning, nor "thinking…", nor tokens. What matters for diagnosis is what happened, not the monologue.

The outcomes​

OutcomeMeaning
CompletedA Result step completed; the output is what it assembled
FailedA step failed with no error path
CancelledSomeone requested cancellation
ExpiredThe total deadline ran out
Not approvedAn approval was rejected

While running, it can be running, waiting (a wait or a retry), or waiting for approval.

When it fails, the screen says where​

A run that did not complete opens showing the step that stopped, the reason in product language, and a shortcut to open that configuration.

Cancelling​

A run can be cancelled at any moment. Cancellation is cooperative: it is checked between steps, never in the middle of a call in flight.

Child runs are cancelled along with it.

Re-running​

Re-running creates a new run from the same active version. The previous one's history stays intact.

  • With nothing supplied, it re-runs with the same effective input.
  • With different input, it replaces the original and goes through the same validations.

Re-running a production run requires a publishing role.

Durable waits​

A run can legitimately sit still:

SituationState
Waiting for someone to approveWaiting for approval
In a Wait stepWaiting
Between retriesWaiting
Waiting for a child runWaiting

In all those cases it releases resources and comes back on its own. A run sitting for days waiting for approval is not a stuck run.

Test runs​

They appear in the same list, marked as tests. They are real runs — only with a different origin. See Testing before publishing.

Common errors​

SymptomLikely causeWhat to do
The run does not leave "waiting"A pending approval or a Wait stepCheck the current step in the timeline
It failed right at the startNo active version in the environment, or an inactive service accountSee Publishing and Service account
It completed, but the result came back incompleteAn error was handled by a diversionLook at the steps with handled failures in the result
An AI step failedThe objective was not met verifiablySee AI task

Next steps​