Skip to content

Set budgets

Settings → AI Configuration → Budgets caps every run in your workspace. It needs the manage_model_policy permission.

A budget is not only money. It is four ceilings, because a run can go wrong in four ways: it can cost too much, take too long, read or write too much, or loop.

FieldCapsAlpenglow
Soft capSpend that triggers a warning$4
Hard capSpend that aborts the run$12
Wall-clock timeoutElapsed time per run1800 s
Max input tokensTokens read per run400,000
Max output tokensTokens written per run120,000
Max iterationsAgentic loops per run24
Throttle thresholdFraction of the hard cap where throttling starts0.8

Leave a field blank to inherit the system default. These apply to every run without a task-type override.

Tenant budget defaults with the per-task-type table under them, the content row overridden.

The gap between the soft and hard caps is the part worth thinking about. Too narrow and a warning is indistinguishable from an abort. Alpenglow’s 4 and 12 give a run room to finish after it has been noticed.

Run execution sits with the budgets rather than with the AI runtime, and it answers a different question: whose runner executes new runs, as opposed to who produces completions. Inheriting the system default is right for almost every workspace.

The table under the defaults holds one row per task type. Click Edit to override any of the seven ceilings for that type; a dash means the row inherits.

Alpenglow overrides one type. Content runs get $1 soft, $3 hard, 600 seconds, and 8 iterations, because writing a launch post is a shorter and cheaper job than working through a code change, and a content run that has looped eight times is stuck rather than thorough.

Override a type when its work has a genuinely different shape. Overriding all seven for all seven types is a sign the tenant default is wrong.

To an agent, a budget is not advice.

  • At the soft cap, the run is warned and throttled: it keeps working with less headroom, and the warning is on the run.
  • At the hard cap, the run stops. The attempt ends with the cap as its reason, and whatever it had produced is kept rather than discarded.
  • At the wall clock, the token ceilings, or the iteration limit, the same thing happens, with that limit named.

A stopped run is not a lost one. It reports what it did, what it spent, and which ceiling it hit, and you can raise the budget for that run and let it continue.