Logic and UI Smart Components

When the Build Agent implements logic or builds interface elements, it often creates Smart Components. Logic Smart Components handle data processing; UI Smart Components handle rendered interface elements. These are agent-created components, built for the specific module being worked on.

Understanding what these components are and how they behave helps Creators work with them after the agent finishes building.

Logic Smart Components

A Logic Smart Component is a Smart Component the Build Agent creates to handle data processing, calculations, and conditional operations. The agent creates a Logic Smart Component when a logic task is complex enough to warrant it. For simpler operations, the agent might use a standard component like Calculator or Decisions instead.

Logic Smart Components are private to the module they were created in. They appear on the canvas like standard components but have different editing behavior.

What Logic Smart Components Can Do

• Transform, filter, and aggregate submission data.

• Perform calculations based on component values or API responses.

• Apply conditional rules and return different outputs depending on runtime state.

• Chain into other components through Post Trigger or Error Trigger outputs.

What Logic Smart Components Cannot Do

• Render visible interface elements. Logic Smart Components process data only and have no visual output.

• Appear in the component tray. Logic Smart Components are private to the module and not available for manual placement.

UI Smart Components

A UI Smart Component is a Smart Component the Build Agent creates to render interface elements. The agent creates a UI Smart Component when building forms, displays, or other visible components that benefit from a unified, configurable design.

Like Logic Smart Components, UI Smart Components are private to the module they were created in.

What UI Smart Components Can Do

• Render visible interface elements: forms, displays, custom layouts.

• Receive data from submission data and other components.

• Return data to the module through their output type.

What UI Smart Components Cannot Do

• Process data independently without any UI output.

• Appear in the component tray. UI Smart Components are private to the module and not available for manual placement.

Editing and Promoting a Smart Component

When a Logic Smart Component or UI Smart Component is selected on the canvas, two action buttons display in the settings panel:

Editing

To open a component in the Component Builder:

1. Select the component on the canvas.

2. Select Edit.

The Component Builder displays the component's configuration across its available views.

Logic Smart Component views:

UI Smart Component views:

Edits to a private component affect only the module it belongs to.

Promoting to the Shared Library

To make a component available environment-wide, select it on the canvas and select Add to Library in the settings panel.

Once promoted, the component appears in the Smart Components section of the component tray in every module in the environment. Any Creator can place and configure it. Changes to a shared component affect all modules using it.

Smart Components vs. Standard Components

The Build Agent chooses between Smart Components and standard components based on the task:

When a specific standard component is needed, name it in the prompt and the agent will use it.