Set agent execution limits
Open in AgentumPurpose
Kian does not want one runaway request to eat the shop's plan. Control how an agent delivers answers and put hard limits on its runs, model calls and tool calls.
Before you start
The custom agent must belong to your current workspace, and you need permission to manage agents. Larger limits and retries can use more of your plan's usage and never add capacity to it.
Steps
- Open "Agents", find your agent under "My agents" and select it. In the window, open "Agent actions" (the three dots) and choose "Edit agent".
- Open "Execution". Set "Stream responses" (deliver the answer piece by piece), "Timeout" (milliseconds), "Maximum steps" and "Concurrent runs".
- Open "Model". Under "Model middleware", turn on "Model retry" and set "Maximum model retries" (0 to 10 retries after the first attempt). Turn on "Model fallback" to add up to four alternative models, tried in order when the primary model fails; the primary model cannot be its own fallback. Set "Maximum model calls per run" under "Model call limit".
- Open "Plugins". Under "Tool middleware", turn on "Tool retry" with "Maximum tool retries" (0 to 10), set "Maximum tool calls per run" under "Tool call limit", and optionally turn on "LLM tool selector" with "Maximum selected tools" (1 to 50), which narrows the enabled tools to the most relevant ones before each model call. This limits the tools chosen by the selector. Essential tools may remain available in addition to that number.
- Select "Save".
Expected result
| Control | Allowed range | Starts at |
|---|---|---|
| Timeout | 1,000 to 900,000 ms | 180,000 ms |
| Maximum steps | 1 to 100 | 25 |
| Maximum model calls | 1 to 100 | 20 |
| Maximum tool calls | 1 to 500 | 30 |
| Concurrent runs | 1 to 50 | 4 |
A run stops with an error when it passes a hard limit. When more runs start than "Concurrent runs" allows, the extra runs wait for a free slot. Concurrent runs count all users of the agent together.
Troubleshooting
| Problem | What to do |
|---|---|
| A run ends with a timeout or a limit error | Simplify the request, or raise the limit that was reached. |
| A tool action happened twice | A retry repeats the call. Turn off "Tool retry" for tools that change data, such as sending a message. |
| A fallback model is not offered | Only models that are available to you and are not the primary model can be added. |
| "Save" fails | Read the error under the header. Nothing is saved until it is fixed. |