Reading agent runs
Every time an agent works on a task, on its own or on a schedule, that piece of work is a run. Most days you'll read the note in your inbox and move on. This article is for when you want the detail: checking a result, understanding a failure, or seeing what happened overnight.
Where to find runs
- On the Agents page. Pick the agent, then choose Runs above the list of past conversations on the right. Each run is listed by its task and time.
- From your inbox. A finished run's note has View Chat, which opens the run.
- On the task. The task panel shows the latest run's progress and result.
- On a schedule's page. Open a scheduled task's schedule for its full run history, with a link to each run's conversation.
- On Home. Dashboard widgets such as Recent AI Runs and Agent Roster show recent runs and which agents are busy or need you. Add them from Add widget if they aren't there.
What a run shows
A run opens like a conversation. You see the request the agent started from, a line for each step it took (such as searching your workspace, reading a page or creating a task), any pages or tasks it produced as chips you can open, and its final answer.
When a run goes wrong
The inbox note tells you when a run finished with errors, for example "Alex completed task with errors", with your agent's name. Open the run to see which step failed. Common causes:
- A connected app lost its connection. Reconnect it on the agent's Plugins tab, then run the task again.
- The agent wasn't given the app it needed. Switch the app on in the agent's Plugins tab.
- It stopped early. An agent has a limit on how many steps one run can take. If the task asks for a lot, split it into smaller tasks.
- It's waiting for you. A run that wants to do something sensitive, such as send an email, pauses until you approve or deny it in the run's conversation.
- A temporary error. Run it again.
Running it again
There's no retry button on a run. To run the same work again, open the task, set Frequency to Run now and press Run. From a chat, send the message again.
A new run uses the agent's instructions as they are now, so if you've just improved them, the rerun reflects that.
Tips
- A run you cancel from the task panel stops at its next step.
- Runs belong to their agent. To see everything an agent has done, use All in its list of past conversations; to see every agent's runs, switch to All Agents.
Related
Was this article helpful?
Support
Still need help?
Can't find what you're looking for? Start a conversation and our support team will help.
Open your laptop.The work is already done.
Free to start. No credit card required.