Application Properties

This page describes the configuration properties defined by the AI Tools add-on. Configure the model provider separately through standard Spring AI properties such as spring.ai.openai.*. See Connecting a Model.

jmix.aitools.enabled

Whether the AI Tools autoconfiguration is enabled.

Default value: true

jmix.aitools.dataload.enabled

Whether the data-load autoconfiguration, including the predefined data-load tools, is enabled.

Default value: true

jmix.aitools.dataload.exclude-system-level-entities

Whether system-level entities are hidden from the AI.

Default value: true

jmix.aitools.dataload.include-entities

Entity names to expose to the AI even if they would otherwise be hidden, as an indexed list. The listed entities are added to the default set and override the system-level, DTO, and exclude-packages exclusions. exclude-entities still takes precedence over this list.

jmix.aitools.dataload.include-entities[0]=sample_Customer
jmix.aitools.dataload.include-entities[1]=sample_Order

Default value: empty (no explicit includes)

jmix.aitools.dataload.exclude-entities

Entity names to hide from the AI, as an indexed list.

Default value: empty

jmix.aitools.dataload.include-packages

Package prefixes whose entities are exposed to the AI even if they would otherwise be hidden, as an indexed list. Like include-entities, this property is additive: matching entities are added to the default set, including entities hidden by default, such as framework or system-level entities. It does not restrict the model to only these packages.

jmix.aitools.dataload.include-packages[0]=com.company.sample

Default value: empty

jmix.aitools.dataload.exclude-packages

Package prefixes to hide from the AI, as an indexed list. By default, the framework’s own entities are excluded. Expose specific ones with include-entities or include-packages.

Default value: io.jmix

jmix.aitools.dataload.max-repair-attempts

Maximum number of attempts to repair an invalid generated query before giving up.

Default value: 1

jmix.aitools.dataload.jpql-execution-max-result

Default maximum number of rows applied when a generated query does not specify one.

Default value: 20

jmix.aitools.dataload.jpql-execution-max-result-limit

Hard upper bound for the number of rows that a single query can request. Any larger value, whether supplied by the query or inherited from the default, is capped to this limit before execution.

Default value: 100

jmix.aitools.ui.chat-hub-recent-chats-count

Number of recent chats shown next to the chat input in the chat hub view. You can also override it per fragment with AiChatHubFragment.setRecentChatsCount(int).

Default value: 6

jmix.aitools.ui.assistant-response-timeout

Timeout for the background task that runs the LLM call and produces the assistant response. When the timeout expires, the task is cancelled and the failure handler is invoked.

Default value: 5m

jmix.aitools.ui.data.enabled

Whether the AI Tools Flow UI data autoconfiguration, including database-backed chat history and the working chat services, is enabled.

Default value: true

jmix.aitools.ui.data.chat-memory-max-messages

Maximum number of most recent conversation messages kept as chat memory and sent with each request.

Default value: 20