Getting Started with the Build Agent

The Build Agent is the UnqorkAI platform's AI assistant for building Unqork modules. You describe what you want in plain language, and the agent creates a plan for your review. Once approved, the agent builds the components, generates tests, and shows you the result.

This guide walks you through your first interaction with the Build Agent.

Before You Begin

The Build Agent is available to Creators with access to the Module Builder. If you do not see the Build Agent panel in your UnqorkAI platform, contact your environment administrator.

Step 1: Open the Build Agent

1. Open any module in the Module Builder.
2. Locate the Build Agent panel in the left panel.
3. Click the tab to open the agent.

Step 2: Send Your First Prompt

A clear, specific prompt produces the best results. Try the following:

Create a contact form with fields for first name, last name, and email address. Set all fields as required. Add a Submit button that collects the form data.

The agent analyzes your request and creates a plan before building anything. The plan opens in the canvas area and includes the following:

• Analysis: A summary of the current module state and what the agent intends to build.
• Detailed Component Specifications: The components the agent plans to create, including types, Property IDs, and validation rules.
• Tests: Test cases the agent will run to verify the form works correctly.
• Execution Plan: The steps the agent will follow to build the module.

Step 3: Review and Approve the Plan

After generating the plan, the agent asks for your approval before proceeding.

Review the plan in the canvas area. To leave feedback, highlight any text in the plan and add a comment. When the plan looks correct, click Build Plan to proceed. If you want changes before building, click Request Changes. The agent revises the plan based on your comments.

The chat input is not available during plan review. All feedback goes through inline plan comments before clicking Request Changes.

Step 4: Review the Results

Once the agent finishes building, it runs the test cases from the plan automatically. It then displays a summary of what it built and a Task Plan completed message. Review the summary to confirm the components and logic match what you requested.

If anything looks incorrect, refine your prompt and send another message to continue.

Step 5: Preview the Result

Preview the module to confirm it behaves as expected. Two options are available:

• UI View: Displays the module rendered live in the canvas.
• Play button: Opens the module in Express in a new browser tab. For modules inside an application, the menu offers View in App or View Module Only.

Step 6: Continue Building

Once the agent finishes, you have the following options:

• Continue Building: Send another prompt in the Build Agent panel.
• Start a New Plan: Click + at the top of the Build Agent panel.
• Rollback: Click Rollback at any checkpoint in the Build Agent panel to revert all changes the agent made after that point.