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.
Agent editor with the Run button highlighted in the header bar
  1. From the agents list: Click the play icon on the agent’s row.
Agents list page with play icon to start a run from the list 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. Parameters page showing input fields and settings before starting an agent run

​
Run settings

Below the parameters, you can configure settings for this specific run:
Run settings showing webhook callback URL, proxy location, and AI fallback options

Advanced run settings showing browser session ID, browser address, extra HTTP headers, and max screenshot scrolls

​
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. Agent run block timeline

​
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
Completed agent run showing extracted data, output tabs, and block timeline 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
Run History page in the sidebar showing all past runs with status and duration
  1. Go to the History button (clock icon) in the agent editor: shows runs for this specific agent
Past Runs view for a specific agent showing run statuses and timestamps

​
What’s next

Build an Agent

Create and edit agents in the visual editor

Block Reference

Configuration fields for every block type