Running agents & reading traces
A run is one execution of your project: your input goes in, each agent performs its tasks in order, and you watch it happen live. Every run is saved with its full trace.
Start a run
- Open a project and click Run in the toolbar.
- Type an input if the job needs one — a customer's message, a batch of notes, a question. (Some projects run fine with no input.)
- Click Run. Steps appear live as each agent finishes — you'll see the agent's role and its output, with a pulse while the next step is thinking.
- When the run completes, the full saved trace opens in the Execution tab.
Read a trace (Execution tab)
The Execution tab is the project's run history:
- Left: every past run — your input, when it ran, and whether it succeeded or failed.
- Right: the selected run in full — the input, each step (which agent, what it produced), the final output, and the error if something went wrong.
Traces are how you improve a project: find the step where things went sideways, fix that agent's goal or knowledge, and run again.
Run limits (quotas)
To keep the platform fast and costs sane, runs are limited per day:
| Account | Runs per day |
|---|---|
| Expert | 100 |
| Practice sandbox (Academy) | 10 |
Hit the limit and you'll see "Daily run limit reached" — it resets at midnight UTC. Model usage per run is also recorded; Claude runs are on RAiN, and runs on your own provider keys are billed by that provider.
Download your project
Download in the toolbar exports the project's design (agents, tasks, description) as a JSON file — handy for backups or sharing a setup with the RAiN team.
When a run fails
| Message | What it means | What to do |
|---|---|---|
| "No … key connected" | An agent uses a provider without a stored key | Add your key, or switch that agent to Claude |
| "Daily run limit reached" | You've used today's quota | It resets at midnight UTC |
| A step shows an error mid-trace | That agent's work failed | Read the step, adjust the agent's goal/knowledge, run again |
| "Connection lost during the run" | Your network dropped while streaming | Check the Execution tab — the run itself usually completed |
FAQs
Do runs keep going if I close the tab? The run continues on RAiN's servers and its trace is saved — reopen the project's Execution tab to see the result.
Can I stop a run in progress? Not yet. Runs are short (seconds to a couple of minutes); a stop button is on the roadmap.
Why did my agent make something up? It likely lacked the facts. Put the truth in the project's Knowledge base (Settings) and tell the agent in its goal to answer only from the knowledge.
Where do I see my usage? Each run's trace is in the Execution tab. Workspace-level usage reporting for experts is coming; the RAiN team already monitors platform-wide usage.
Related: Quick start · Designing agents in the studio · Models & LLM connections

