Pause, resume, retry or cancel a run
Control a run while it works and after it ends, and learn which buttons appear for each status.
You can step in while a run is working. The buttons you see depend on the run's status.
What each control does
- Pause holds a run at its next safe point. A step that has started is allowed to finish and be recorded first, so nothing is cut in half. A paused run holds no resources.
- Resume carries on from where it stopped. The run continues from its recorded steps.
- Keep going appears while a pause is waiting to take effect, and withdraws the pause request.
- Retry starts a new run with the same input once a run has ended as Done, Failed or Cancelled.
- Cancel ends a run for good.
Which buttons for which status
- Queued: Pause, Cancel.
- Running: Pause, Cancel. After you press Pause it shows "Pausing…" until it reaches a safe point.
- Paused: Resume, Cancel.
- Waiting for your approval or a budget decision: Cancel. Decide the request in Approvals to move it on.
- Done, Failed, Cancelled: Retry.
Test runs and replays do not offer Retry. Use Replay on the run page instead. See Test and replay an agent.
Pause a run, or pause an agent?
They are different. Pause on a run holds that one run. Pause (then save) at the top of an agent's page stops its schedules and webhooks from starting new runs. To stop an agent from working at all, pause the agent and cancel any active runs.
Good to know
- A paused run counts as active, so it still counts toward the limit on active runs. Resume it or cancel it when you are done.
- A run that finishes before it reaches a safe point simply finishes.
- Retry keeps the link to the original, so you can compare the two.
- Cancelling or deleting an agent expires its pending approvals.
More guides in PGB Agents
What a PGB Agent is and what it can do
An agent is a saved job with instructions, a list of allowed tools, a budget and a record of every step it takes.
Create an agent from scratch or from the Marketplace
Make a blank agent in two clicks, or add a ready-made one from PGB Marketplace and review it before it runs.
Write good instructions for an agent
How to word the Instructions box so an agent does the right job, stays inside its limits and tells you when it is unsure.
Choose tools and understand which need approval
The list of tools an agent can use, what each does, and which ones always pause for your approval.
Start agents manually, on a schedule or from a webhook
Run an agent by hand, set it to repeat with the schedule builder, or give it a private web address that starts a run.
Set budgets and know when a run will stop
Put a dollar limit on each run and each month, and learn the other limits that stop an agent from running away.