Smart Components Overview

Prev Next

Smart Components are reusable component definitions scoped to the environment. Each Smart Component has a single definition. Editing one and publishing the change updates every module that uses it immediately.

Smart Components can be built in the Smart Component Editor or generated by the UnqorkAI Build Agent. Both paths produce the same result: a versioned, environment-wide component definition.

Component Types

Every Smart Component has one of four types. The type is set at creation and cannot be changed afterward.

Type

What it does

UI

Renders a visual interface in a module. Receives typed input values and displays output on the canvas.

Logic

Runs logic in sequence with other components. Has no visual presence. Processes input data and returns output data.

Query

Reads data from a data source. Configured with mapped inputs and output triggers, similar to a Plug-In component.

Agentic

Provides AI-powered in-app experiences. Includes the Chat Agent Smart Component and the AI Summarizer. Requires a separate AI capabilities agreement.

Public and Private

Every Smart Component is either Private or Public. This controls reusability and Build Agent access.

State

Reusable across modules

Visible to Build Agent

Can change back

Private

No (one module only)

No

N/A

Public

Yes

Yes, as a preferred component

No

A new Smart Component is Private by default. Making a component Public is permanent. See Smart Components Hub for details.

Smart Components Hub

The Smart Components Hub is where Creators browse, filter, and manage all Smart Components in the environment. It displays components on separate Public and Private tabs. From the Hub, Creators can open a component in the editor, make a component Public, promote it to another environment, duplicate it, or delete it.

To open the Hub, select LibraryBig Library in the global header, then select Puzzle Smart Components Hub.

See Smart Components Hub for the full reference.

Smart Component Editor

The Smart Component Editor is where Creators write, preview, configure, and test Smart Components. The editor uses the same shell as the Module Builder with area tabs for Definition, Tests, and History.

The views available in the Definition area depend on the component type:

  • UI Smart Components: UI view (live preview canvas) and Logic view

  • Logic and Query Smart Components: Logic view only

See Smart Component Editor for the full reference.

Drafts and Publishing

Editing a Smart Component creates a draft. A draft is a private working copy. Changes are not live in any module until the draft is published.

Only one Creator can hold a draft at a time. When the Creator holds the draft, Review Changes displays in the SC Editor toolbar. Selecting it opens a review showing where the component is used, then offers Publish Changes or Discard Changes.

Publishing a Public component updates every module that uses it immediately.


Changelog

Date

Change

2026-09-08

Editorial pass — removed HR separators, fixed em dashes in table and bullets, changed Note to Warning, added nav entry (EN-8038).

2026-09-08

Full rewrite for 9.0.0 — four component types (added Agentic), Public/Private model, Smart Component Editor, Hub, and draft/publish workflow. Replaced outdated Build-Agent-only creation claim and "Smart Component Library" name (EN-8038).

2026-07-28

Initial draft — Smart Components GA overview (EN-7975).