The Build Agent panel is where Creators interact with the Build Agent in the Module Builder. It has two tabs: Active Task and History.
Active Task Tab
The Active Task tab is the main interface for sending instructions to the Build Agent and reviewing its responses.
![[docs-mockup:DocsAgentChatActiveTaskMockup] Agent Chat panel with an active task](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/base64-converted-image-1787848444823.png?sv=2026-02-06&spr=https&st=2026-08-31T19%3A50%3A12Z&se=2026-08-31T20%3A08%3A12Z&sr=c&sp=r&sig=myenObBImGjRjsws8xXtSUHw0iNB7844dqsIwsYE3qk%3D)
Chat Window
The Chat Window is the scrollable area that shows the full conversation between a Creator and the agent. It displays:
Item | Description |
|---|---|
| Text the Creator has sent to the agent. |
| The agent's replies, rendered as formatted text. |
| A spinner that displays while the agent processes a request. |
| Actions the agent took, shown in collapsible sections. Expand a section to review the agent's actions. |
| The agent's internal reasoning steps when extended thinking is active. |
| Saved points in the conversation with a Rollback button. Select Rollback to restore the module to its state at that checkpoint. |
Inline plan card | A card that displays in the chat when the agent creates a plan. Shows the plan title, creation date, and status. Select the card to open the plan in the History tab. |
Plan approval card | A card that displays after the agent presents a plan for review. Contains two options: Build Plan to approve the plan and begin execution, and Request Changes to ask the agent to revise the plan before building. |
| A structured question the agent displays when it needs clarification before proceeding. Contains selectable options and an optional text field for freeform input. |
Allow/Deny prompts | Confirmation requests for individual agent actions like creating or modifying components. Select Allow to proceed or Deny to cancel. |
Stop Build | A button that displays while the agent executes a plan. Select it to stop execution at the current step. After stopping, send a new message to adjust the plan or continue from where execution stopped. |
Interrupted build banner | An amber warning that displays when the page reloads during an active build. Select Continue to resume execution from where it stopped. |
When no messages have been sent, the chat area displays two starter options: Create an Application and Explain this Workspace. Select either to send a predefined opening message.
Prompt Field
The Prompt Field is the text input at the bottom of the Active Task tab. Enter instructions and press Enter to send. Press Shift+Enter to add a new line without sending. The field accepts up to 100,000 characters.
Type @ in the prompt field to open the mention popup. The popup lists modules and applications in the current workspace. Type to filter by name, then select an item to add it to the chat context. The selected item appears as a chip in the context strip above the prompt and is included as context in the next message sent.
The context strip above the prompt displays all active context items. Items come from the currently open module, mentions, inline comments on plan steps, and components selected on the canvas. When fewer than three items are active, they display inline. When three or more are active, the strip collapses into a Chat context · N header. Select it to expand. Select the trash icon to clear all dismissible items at once.
The open module joins the context automatically. Select the × on its chip to remove it. This is useful when Creators want the Build Agent to build something new instead of working on what is on screen. It stays out until a different module is opened and returned to, or added back from the module toolbar's Add to Agent Context action, the File Explorer menu, or an @ mention.
When another task in the same module is actively running, the composer displays "Agent is working in [task name]" and input is disabled. Switch to the active task to continue, or wait for it to finish.
The Build Agent does not detect changes made to the module outside the agent during a session. If a component or test is edited manually, include a note in the next message describing what changed.
Agent Configuration
The
Agent Configuration button opens a settings popover with two selectors and two toggles.
Mode controls how the agent approaches a request.
Option | Description |
|---|---|
Ask | The agent answers questions and analyzes the module. It does not make any changes. Auto-test and Auto-fix are disabled in this mode. |
Plan & Build | The agent creates a plan for review and approval before building. Default mode. |
Build | The agent builds directly without creating a plan unless explicitly requested. |
The Approvals setting controls how much the Build Agent pauses for review during execution.
Option | Description |
|---|---|
Manual | Review all actions before the agent proceeds. Default setting. |
Protected | The agent creates and edits automatically. Creators review before it deletes. |
Automatic | The agent creates, edits, and deletes without review. |
Auto-test toggle: When set to ON, runs tests after the agent makes changes to verify they work correctly. Disabled when Mode is set to Ask.
Auto-fix toggle: When set to ON, automatically tries to fix issues that tests report. Requires Auto-test to be active. Disabled when Mode is set to Ask.
If a test fails because the Build Agent screenshots the module before it finishes loading, tell the agent to wait longer: "Wait at least 30 seconds before taking the screenshot." The agent respects explicit wait instructions and overrides the automatic 15-second cap.
A risk caption displays below the input area when certain mode and approval combinations are active:
Build mode: "Agent will build without planning."
Build + Automatic approvals: "Agent will build without planning and delete without approval."
Plan & Build + Automatic approvals: "Agent will delete without approval."
Attachments
The
Attachments button adds file context to the next message. Attached files appear as chips in the prompt field. Files can also be dragged directly onto the prompt field or pasted from the clipboard.
Files must be 10 MB or smaller total across all attachments in the conversation. Larger files are rejected at upload. The attachment badge in the toolbar turns red at 9 MB used. Additional limits apply by file type:
File type | Limit |
|---|---|
100 pages total | |
Text files (TXT, MD, JSON, LOG, XML, ) | 500,000 characters total |
, TSV | 5,000 rows and 100 columns |
Spreadsheets (XLSX, XLSM, XLS, ODS) | 10,000 total rows across all sheets; 75 sheets |
Supported image formats: PNG, JPEG, GIF, WEBP.
History Tab
The History tab shows all tasks and plans for the current module, grouped by time: Today, This Week, and Older. The Older group is collapsed by default. The tab label shows the total number of tasks.
![[docs-mockup:DocsAgentChatHistoryMockup] Agent Chat panel showing conversation history](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/base64-converted-image-1787848447234.png?sv=2026-02-06&spr=https&st=2026-08-31T19%3A50%3A12Z&se=2026-08-31T20%3A08%3A12Z&sr=c&sp=r&sig=myenObBImGjRjsws8xXtSUHw0iNB7844dqsIwsYE3qk%3D)
Search and Filter
Control | Description |
|---|---|
Search field | Filters tasks and plans by title. |
Tasks / Plans pills | Toggle to show or hide task rows and plan rows. At least one must remain active. |
Status drop-down | Filters plans by status. Options: All statuses, Open, In Progress, Completed, Cancelled, Blocked. |
Task List
Each task row displays the first message of the conversation as the task title and a timestamp of the last update. An active indicator (a brand-colored dot) marks the currently open task.
Plans belonging to a task display as indented rows beneath it, each with a status badge.
Select the
ellipsis button on a task row to open the task actions menu.
Action | Description |
|---|---|
Download Debug | Downloads a zip file of the task's full activity log. Use this when reporting issues to Unqork Support. |
Delete Task | Permanently removes the task and its full conversation history. A confirmation dialog warns that this action cannot be undone. |
Building a Plan
When the agent finishes creating a plan, a plan approval card displays in the Active Task tab. Select Build Plan to approve the plan and begin execution. To skip individual step confirmations, select Approve All when prompted; the agent proceeds through all remaining steps without pausing.
Select Request Changes to revise the plan. Type specific feedback in the chat input or add inline comments directly on the plan steps. The agent incorporates the feedback before presenting a revised plan for approval.
Request Changes is more effective than adding inline comments before selecting Build Plan. With inline comments only, the agent adds them to context and continues with the original plan structure. With Request Changes, the agent rewrites the plan before presenting it for approval. When a plan needs structural changes, use Request Changes instead of adding inline comments and then selecting Build Plan.
The Build Plan button at the top right of the plan detail view performs the same action as selecting Build Plan in the chat approval card.
Changelog
Date | Change |
|---|---|
2026-08-27 | Renamed folder from agent-chat to build-agent. Added Tips for screenshot wait-time cap and manual-change awareness (EN-8061). |
2026-08-13 | Renamed article from "Agent Chat" to "Build Agent" to match the panel label in the UI. Restructured to reflect the 2-tab layout (Active Task, History). Corrected Agent Configuration to match the actual Mode and Approvals selectors. Added Stop Build, Interrupted Build banner, empty state starter cards, and blocked-by-active-task behavior. Corrected attachment limits (10 MB total, with additional per-type limits). Added History tab section with Search and Filter, Task List (including Download Debug), and moved Building a Plan here. Added Request Changes best practice (EN-7995). |
2026-08-07 | Documented removing the open module from the context strip (UQE-16976). |
2026-07-30 | Added @-mention and context strip documentation to Prompt Field section (EN-7982). |
2026-07-29 | Converted icon-button tables to bulleted lists so icons render correctly; POV sweep; Approve All addition (EN-7971). |
2026-06-30 | Updated Chat Window table: added inline plan card and plan approval card rows (AIML-1281); clarified Allow/Deny prompts are for individual action confirmations. Updated Building a Plan section: Build Plan / Request Changes replaces old Approve/Reject flow. |
2026-05-28 | Added File Context Pill description to Chat Window section. |
2026-05-28 | Added screenshots for Chat, Tasks, KB, and Plans tabs. |
2026-05-28 | Initial publication. |