Running and monitoring actions
Running and monitoring actions
While a robot runs, it matters that you understand how its actions are executed and how to follow their progress. This guide covers the run options and how to watch an action's status live.
Run options
Run options sit at the bottom of every action's settings panel and control what the robot does if the action runs into trouble.
Stop the robot on error
Whether the robot stops when this action fails.
- Yes (the default): the robot stops entirely and the run ends in an error
- No: the robot skips the failed action and carries on with the next ones
When "No" makes sense:
- Optional actions that are not critical to the flow
- When you want the robot to push on despite a partial failure
- In validations where you want the error recorded but not the process stopped
Use "do not stop on error" carefully. If later actions depend on the result of the one that failed, they may fail too, or produce something unexpected.
Number of attempts
How many times the action is retried before it counts as failed.
- Minimum: 1 (the default)
- Recommended: between 1 and 3, depending on the action
When more attempts help:
- Actions that depend on the network (downloading files, HTTP requests)
- Interactions with elements that may take a moment to appear
- Operations that can fail briefly because something is unstable
For example: set to "3 attempts", an action that fails twice and works on the third try counts as a success.
The visual states during a run
Running the robot in test mode updates each action's card as it goes, so you can watch what the robot is doing in real time.
| State | Look | What it means |
|---|---|---|
| Running | A blue border, pulsing | The action is executing right now |
| Succeeded | A green badge with a check | The action ran with no errors |
| Error | A red border with an error badge | The action failed after all its attempts |
| Skipped | Faded | The action was skipped because an earlier one failed (in "do not stop" mode) |
Looking at an error
When an action fails, click its card to open the settings panel. There you get:
- The error message: what went wrong
- Technical details: extra information for diagnosis
- Attempts made: how many times the action ran before failing
That is usually enough to work out the problem and fix the flow.
The full cycle
The complete cycle of using an action, from configuration to monitoring:
1. Open the catalog
↓
2. Pick the action you want
↓
3. Configure it in the panel:
├── Set the action's ID (e.g. "checkBalance")
├── Pick the mode (where there is one)
├── Fill in the input fields
├── Enable the output fields you will use
└── Set the run options
↓
4. Save
↓
5. Next action: reference this one's outputs
↓
6. Run the robot
↓
7. Watch the cards' status
↓
8. On an error: read the message in the panel
Good practice
Set the attempts sensibly
Do not pile up attempts on an action that is unlikely to work however many times it repeats. It only makes the run slower.
Use "do not stop" with care
Always ask whether the following actions can work without the result of the one that might fail. Where there is a dependency, it is better to let the robot stop.
Watch the first run
When you are testing a new flow, follow the run visually — it is the fastest way to see where the problems are.
Write down the common errors
If an action keeps failing, note the cause and the fix. It makes the next round of maintenance much shorter.
Next
- The anatomy of an action — the run options panel again
- Chaining actions — how an error affects chained actions
- Introduction to actions — back to the basics