Guides → Build Applications via the Builder Agent

Context

This content applies to Incorta Cloud deployments only.

Before you start

Incorta Applications must be enabled for your tenant, and you must have the Application Manager role to create one. If you do not see Application in the Incorta navigation pane, ask your system administrator.

Get started

Step 1: Create the application

In the navigation pane, select Application.
In the chat section, select a framework: Node.js or Python.
Optionally, select the + sign to attach a file, capture a screenshot, or change the location of the new application in the Content Manager.
Note
You can attach up to 10 files per message, (up to 20 MB) to provide reference data, design screenshots, or specifications for the agent to use when building your application. The agent can read images up to 5 MB, PDFs up to 8 MB, and text files up to 512 KB. Other supported file formats, or files exceeding these reading limits, can be stored for use by the application but are not read directly by the agent; however, the agent can still inspect them with other tools.
In the chat box, enter your prompt, and then select the Submit button.
Important
Be concise when describing the application you want, its purpose, target users, and data it needs access to.
You do not have to name it up front, as the agent names the application from your first prompt. You can change the name later.

Step 2: Wait for the agent

Once you submit your prompt, the Application Editor opens with the conversation on one side and the application on the other, and the Builder Agent starts building the first version of your application.
Keep following along, as the Agent might ask questions to complete the application.
For each step, you can check how the Agent thinks about the application. Select one of the activities in the conversation panel to display the details.

A build takes minutes, not seconds. You can keep watching or come back to it. The run continues if you close the tab, and the conversation is there when you return.

Step 3: Refine it in conversation

After you have the first version of your application, you can continue to refine it in conversation. Ask for changes the same way you asked for the application. Each change the agent commits becomes a new version. Nothing is overwritten; you can always go back.

Important

Be specific about what you want to keep from the current version. The agent acts on your instructions. For example, if the current design matters, ask to keep the same.
Make one change at a time. Focused requests are easier to review and revert than multiple changes at once.
Check the preview after each change. Verify the result before proceeding.
Revert when needed. Use version history to undo unwanted changes.

Every version has its own preview address you can send to someone. They see that exact version, signed in as themselves, with their own data access. Note that what you share is a preview version, not a published one.

To share a preview version:

In the Application Editor, select the + sign next to the Publish button.
In the Share dialog, search for and select the users or groups you want to share the preview version with.
Specify the share access, whether View, Share, or Edit.
Select Share.

Step 5: Publish

When the application is ready, publish it to a stable address. Publishing runs a security check first and may ask you to confirm changes before it completes. On the first publish, specify the subdomain for the application address.

To publish your application:

In the Application Editor, select Publish.
In the Publish your app dialog, in the Address box, enter a name for your application to be added to the application URL.
Select Publish v1.

On the first publish, specify the subdomain for the application address.