---
title: "Build Agent Limits"
slug: "build-agent-limits"
tags: ["administration", "unqorkai"]
status: "new"
updated: 2026-11-13T17:06:57Z
published: 2026-11-13T17:06:57Z
canonical: "docs.unqork.io/build-agent-limits"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unqork.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Build Agent Limits

The Limits administration page lets administrators set how long the [Build Agent](/unqorkai/docs/build-agent-overview) can run on its own between messages from a Creator. Two limits apply to each run: the LLM call count and the run time. A run is the work the Build Agent does between one Creator message and the next.

Only Designer Administrators can open this page. For other Creators, the **Limits** item in the Settings sidebar is unavailable. The page is available only when UnqorkAI is on for the environment.

To open Limits, navigate to ![icon](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261113_170656_e9e0f8a89e43461587432c27f61581f6.svg?sv=2026-02-06&spr=https&st=2026-11-14T00%3A14%3A45Z&se=2026-11-14T01%3A14%3A45Z&sr=c&sp=r&sig=NOedd4NAV9FdssVDFEurrhhDJkh19AkXARiMoxld4w4%3D) **Administration** > ![icon](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261113_170656_8b6a8a9448724fd2bdfe8b46ccf04224.svg?sv=2026-02-06&spr=https&st=2026-11-14T00%3A14%3A45Z&se=2026-11-14T01%3A14%3A45Z&sr=c&sp=r&sig=NOedd4NAV9FdssVDFEurrhhDJkh19AkXARiMoxld4w4%3D) **Environment Settings** > ![icon](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261113_170656_ff14d642cb4e4f12a56391ef6e50a5ad.svg?sv=2026-02-06&spr=https&st=2026-11-14T00%3A14%3A45Z&se=2026-11-14T01%3A14%3A45Z&sr=c&sp=r&sig=NOedd4NAV9FdssVDFEurrhhDJkh19AkXARiMoxld4w4%3D) **Build Agent** > **Limits**.

![[docs-interactive-image:{"surface":"admin/build-agent-limits"}] Limits administration page with the LLM calls per run and Run time limit fields, both blank to use the defaults, and Save Changes](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/api_upload_20261113_170656_1989c1673061471383c6896a91223100.png?sv=2026-02-06&spr=https&st=2026-11-14T00%3A14%3A45Z&se=2026-11-14T01%3A14%3A45Z&sr=c&sp=r&sig=NOedd4NAV9FdssVDFEurrhhDJkh19AkXARiMoxld4w4%3D)

## Per-Run Limits

The **Per-run limits** card has one field for each limit. Both limits apply to the Build Agent only. A field left blank uses the default, which the field displays as a placeholder.

| Setting | Description |
| --- | --- |
| **LLM calls per run** | The maximum count of LLM calls the Build Agent makes in one run. Accepts whole values between 1 and 10,000. The default is 500. |
| **Run time limit (minutes)** | The maximum time the Build Agent runs in one run. Accepts whole values between 1 and 1,440 minutes (24 hours). The default is 60 minutes. |

The page rejects a value outside the accepted range. The field displays a message, like **Must be at least 1 call** or **Maximum is 1,440 minutes (24 hours)**.

## Saving Changes

Select **Save Changes** to save both limits. After a successful save, the page displays **Build Agent limits have been saved.** The new limits apply to runs that begin after the save. Changes are recorded in the audit log.

To return to a default, clear the field and select **Save Changes**.

## When a Run Reaches a Limit

When a run reaches either limit, the Build Agent stops and pauses the work. The pause is expected. The Build Agent panel displays an amber notice and a **Continue** button. The notice names the limit the run reached. A step limit notice means the run reached **LLM calls per run**. A time limit notice means the run reached **Run time limit (minutes)**.

Selecting **Continue** sends the reply **continue**, which begins a new run. The Build Agent picks up where it left off, and the limits apply to the new run from the beginning. A Creator can also type **continue** in the prompt area. The **Continue** button is available only on the latest turn, and only while no run is active.

---

**Changelog**

| Date | Change |
| --- | --- |
| 2026-10-26 | Created the article from source. |
| 2026-11-03 | Updated the navigation for the renamed **Build Agent** sidebar group. |

Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.

Large Language Models (LLM) are artificial intelligence (AI) programs that use deep learning algorithms to analyze and generate text and other content based on large amounts of data.

Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform.

A definition