Skip to main content
Once you’ve built and saved an agent in the Cloud UI, you can run it from the editor or the agents list. Each run creates an independent execution with its own status, logs, and output. You can also trigger agents programmatically from your code. See Run from Code for the SDK and API approach.

​
Starting a run

Two ways to start:
  1. From the editor: Click the Run button (play icon) in the header bar. The editor saves your agent first.
  1. From the agents list: Click the play icon on the agent’s row.
Both take you to the parameters page where you fill in runtime values before the run starts.

​
Filling in parameters

The parameters page shows all agent parameters defined in the editor. Fill in a value for each one, or leave them at their defaults. Parameters without defaults must be filled in before running.

​
Run settings

Below the parameters, you can configure settings for this specific run:

​
Monitoring a run

After clicking Run, you’re taken to the live execution view, the same interface described in Watching Live Execution. For agents, the left panel also shows a block timeline: a list of all blocks in the agent. Completed blocks show a checkmark. The currently executing block is highlighted.

​
Run statuses

​
Viewing results

After a run completes, open it from Runs in the sidebar. The run detail page shows:
  • Block-by-block results: Each block’s output, status, and execution time
  • Recording: Full video replay of the browser session
  • Parameters: The values you submitted for this run
See Reviewing results for details on the Actions, Recording, Parameters, and Diagnostics tabs.

​
Canceling a run

Click the Cancel button during execution. A confirmation dialog appears. The run moves to canceled status and any configured webhook fires.

​
Run history

Access past runs from two places:
  1. Runs in the left sidebar: shows all runs across all agents
  1. Go to the History button (clock icon) in the agent editor: shows runs for this specific agent

​
What’s next

Build an Agent

Create and edit agents in the visual editor

Block Reference

Configuration fields for every block type