The six budget scopes
Budgets stack. A single agent action has to fit inside six envelopes at once:- Company budget — the top line. Every cost in the company rolls up here.
- Team budget — the share allocated to a team for the current period.
- Agent budget — the share allocated to one agent within the team.
- Workflow budget — a ceiling on the workflow definition itself (so a badly written workflow cannot run wild).
- Task budget — the ceiling on one specific task run.
- Loop budget — a hard cap on any single inner loop inside a task, to catch runaway iteration.
What gets counted as cost
The orchestrator captures three kinds of cost:- LLM tokens, priced per model per 1K tokens, at the rates configured under Settings → Pricing
- Tool-call costs (external APIs the agent used, metered per the integration’s own pricing)
- Runtime cost (infra time: minutes of web preview, minutes of a crawler session, gigabytes of storage)
Reading the cost panel
The cost panel lives at Dashboard → Cost and has three views:- Live — spend in the current hour, minute, and current run. This is what you watch when something is running.
- Period — spend across the current fiscal period (day, week, month) with breakdowns by team, agent, and workflow.
- Forecast — projected spend to end of period based on recent run rate, with a confidence band.
Setting a budget
When you create a company, you set a company-level budget and a fiscal period. The system suggests a default team-level split (equal shares across teams, 80% of the company budget, 20% held in reserve). You can override the split at any time under Company → Budgets. Team-level budgets cascade down to agents the same way. Workflow and task-level budgets are set on the workflow or task itself. Loop budgets are set once under Settings → Safety → Loop budget and are global per adapter. The default is aggressive (about one hundred tool calls per loop) so that stuck agents fail fast.When a budget breaches
Breaches come in three flavors:- Soft breach — the agent is running low. The orchestrator sends a warning event and the agent is asked to tighten its own plan.
- Hard breach — the agent is blocked from starting its next action. The task pauses and a human is notified.
- Catastrophic breach — spend rate over a very short window (default: 5x the expected rate for the task class). The orchestrator kills the process group immediately and flags the run.
Top-ups and reserves
If a team is about to breach and the work is important, you can top up the team’s budget from the company reserve (the 20% held back at company creation). Top-ups are logged and shown on the cost panel so there is no ambiguity about why a team went over its original allocation. You can also set auto top-ups: rules that automatically move reserve into a team when the team crosses 80% of its period budget and is on a workflow tagged as critical. Auto top-ups have their own hard ceiling so they cannot drain the reserve without a human in the loop.Why stacked budgets matter
A single global budget is easy to breach in subtle ways. One agent can eat the whole month’s spend in an afternoon if nothing stops it at the team or task level. Stacked budgets force the math to work at every scope. The six envelopes together mean:- A single runaway task cannot drain the team
- A single runaway team cannot drain the company
- A single runaway loop cannot even drain the task
- Every dollar has a clearly attributable owner
Next
- Approvals for how spend thresholds trigger human-in-the-loop gates.
- Activity log for where breach events are recorded.
- Cost reporting if you are the one writing an agent and want to understand how to attribute costs from inside an agent run.