Query Smart Component

Query Smart Components are specialized implementations of the Smart Component framework. Specifically, a Query Smart Component inherits from and operates as a subtype of a Smart Component. They abstract the complexity of querying submission data by letting the UnqorkAI Build Agent generate the underlying query logic from plain-language requirements. Creators describe what data they need; the Build Agent creates or reuses a Smart Component to satisfy those requirements.

Query Smart Components are available to all AI-enabled environments.

How to Use Query Smart Components

To create a Query Smart Component, do the following:

1. Open a module in the Module Builder.

2. Describe the data requirements to the UnqorkAI Build Agent. For example:

   "Create a query that accepts a status input parameter and retrieves submissions from schema 622131946701db01afdd79e8 where the status field matches it, sorted by creation date descending and limited to 10 results. Display the results in a table. The query should fire automatically whenever the status value changes."

3. The Build Agent creates or reuses a Smart Component to retrieve the data.

Data Access

Query Smart Components retrieve submission records. At launch, Query Smart Components support read operations only. Create, update, and delete operations are not supported.

Data Privileging

Query Smart Components do not use Unqork User Groups or schema module RBAC settings. To control data access, apply restrictions at the application layer through Server-Side Execution.

Express RBAC controls are available at the query level. Designers can assign invocation privileges to Express Roles, restricting which roles can invoke a specific Query Smart Component.

Note: For more information on data access controls for Query Smart Components, contact the assigned Unqork Technical Advisor.

Limitations

• Read-only at launch: Create, update, and delete operations are not supported.

• Maximum records: Queries return a maximum of 10,000 records.

• File references: Query Smart Components do not refresh authentication signatures on file links. To retrieve a working file link from a submission, use the /getSubmissions API.

• Data Models: Unqork Data Models are not supported at launch.

• AI-enabled environments: Query Smart Components require an AI-enabled environment.

Note: The /getSubmissions API continues to work as it does today.