Set a usage budget or spending limit
A usage budget caps how much AI usage your agents can consume before Creatio warns you or stops them, which keeps spending predictable and protects against runaway loops. Configure a budget on the Usage app and choose whether reaching the limit only warns or blocks further requests.
Creatio meters AI usage in AI actions or in tokens, depending on your workspace configuration. This article uses AI actions. If your workspace uses tokens, the budget section is named Token Budget and the limit is Token Limit, and the steps are otherwise the same.
When to use a usage budget
Set a budget where uncontrolled AI usage is a risk. That can be a workspace shared by many agents, or a single high-volume agent. A budget protects three time windows, and you can enforce any combination of them:
Window | Use it for |
|---|---|
Hour | Short-burst control that catches a runaway loop before it consumes much. |
Day | The everyday operational guardrail. |
Month | The long-range planning window. |
A workspace budget applies to every agent. To have an agent run against a different limit from the rest, set a budget for a single agent. Read more >>>
Set a workspace budget
Your team must not run more than 1,000 AI actions per day across all agents, and runs must stop once that limit is reached. The steps below cap the workspace at a daily limit and block new requests when it is exceeded.
-
Log in to Creatio AI Studio.
-
Go to the Runtime section → Usage.
-
Click Configure Budget in the AI Actions Budget section, or Edit if a budget already exists.
-
Enable the Day window and enter an AI Actions Limit for it, such as "1,000." Enable the Hour or Month windows too if you want to enforce them.
-
Set the Warning Threshold for the window, such as "80", so Creatio flags it once usage reaches that percentage of the limit.
-
Turn on Hard Stop for the window to block new requests once the limit is reached.
With Hard Stop on, agents stop serving requests for the rest of the window once the limit is reached, and resume only after the window resets. Budget windows reset on UTC boundaries — the hour on the clock hour, the day and month at 00:00 UTC. Leave Hard Stop off to warn at the threshold without interrupting agents.
-
Click Save.
As a result, the workspace runs against the daily limit. Creatio tracks utilization for the window, warns you at the threshold you set, and, with Hard Stop on, blocks new requests once the limit is reached until the window resets at 00:00 UTC.
Set a budget for a single agent
A workspace budget applies to every agent. To hold one agent to its own limit, set a budget on the agent:
- Log in to Creatio AI Studio.
- Go to the Managed agents section → Agents.
- Open the agent you want to limit.
- Go to the Agent Metrics tab.
- Click Configure Budget in the AI Actions Budget panel, or Edit if a budget already exists.
- Set the limits for the windows you want to enforce. The window, limit, Warning Threshold, and Hard Stop fields work the same as for a workspace budget.
- Click Save.
As a result, Creatio will apply the agent budget on top of the workspace budget.