Configuring Your Agent

Updated by SushamaG

The Agent tab in Settings controls how long the Web Agent keeps working on a prompt and how many times it retries a failed step. These settings apply to every run on your account that uses this agent.

Open the Agent settings

  1. Click Settings in the left menu.
  2. Select the Agent tab. It shows the agent assigned to your account, for example Web Agent.

Available settings

Setting

Range

Default

What it does

Maximum Steps

0 - 100

50

The most actions the agent can take in one run. When it reaches the limit, the run stops.

Maximum Number of Retries

0 - 10

5

How many failed actions the agent tolerates before it gives up on the run.

Change and save

  1. Drag the sliders to the values you want.
  2. Click Save Settings. The new values apply to your next run.
  3. To return to the defaults, click Reset to Defaults, then Save Settings.

Choosing values

  • Raise Maximum Steps for long end-to-end prompts, such as a full checkout or onboarding flow. If a run ends early with the work half done, the step limit is the usual cause.
  • Lower Maximum Steps for short checks, so a confused run fails fast instead of wandering.
  • Raise Maximum Number of Retries for slow or flaky pages. Lower it when you want failures reported quickly.

What isn't set here

  • Browser, screen size, orientation and light/dark mode are chosen per run or per schedule under Browser Settings. See Running Saved Prompts and Browser Configuration.
  • Reusable actions are set up on the Skills page. See Creating and Using Skills in Prompts.
  • Data protection (PII guardrails) is set per project. See Managing Projects.


How did we do?