AI Tools

Дополнение AI Tools добавляет в приложение Jmix ассистента на базе большой языковой модели (LLM). Оно предоставляет готовый UI чата, в котором пользователи задают вопросы на естественном языке, а ассистент отвечает на них, вызывая инструменты. Дополнение включает предопределенные инструменты для приложений Jmix и позволяет добавлять собственные.

Дополнение построено на основе Spring AI. Оно не включает конкретного провайдера модели. Вместо этого вы выбираете и настраиваете модель Spring AI, например OpenAI, Anthropic, Azure OpenAI или Ollama, а дополнение использует ее через стандартный Spring AI ChatClient.

Обзор

Дополнение предоставляет три группы возможностей:

  • Предопределенные инструменты. Дополнение включает готовые инструменты, которые может вызывать ассистент. Текущая группа, инструменты Data Load, позволяет ассистенту анализировать доступные сущности и их атрибуты, а затем генерировать, валидировать и выполнять запрос JPQL только для чтения, чтобы загрузить запрошенные данные. См. Инструменты.

  • Расширяемый реестр инструментов. Любой Spring-бин может добавить собственные инструменты, а предопределенные инструменты можно переопределить. AiToolRegistry собирает все инструменты приложения. См. Пользовательские инструменты и реестр.

  • UI чата. Готовые экраны и переиспользуемые фрагменты позволяют встроить в приложение полноценный чат, включая стартовый экран чатов с историей чатов и экран отдельного чата. История чатов сохраняется. См. Пользовательский интерфейс.

Кроме того, ассистента можно использовать программно из собственных бинов без UI.

Структура дополнения

Дополнение разделено на слои, поэтому вы можете подключить только то, что нужно:

Стартер Описание

jmix-aitools-starter

Базовый слой: реестр инструментов, предопределенные инструменты и программный API ассистента. Не содержит UI и механизма сохранения данных.

jmix-aitools-flowui-starter

Слой Flow UI: экраны чата, фрагменты и роль безопасности. Сам по себе предоставляет оболочку UI, но сервисы чата остаются заглушками без функциональности.

jmix-aitools-flowui-data-starter

Слой сохранения данных: хранит чаты и сообщения в базе данных и предоставляет рабочие реализации сервисов чата.

Стартеры зависят друг от друга: jmix-aitools-flowui-data-starter → jmix-aitools-flowui-starter → jmix-aitools-starter.

Установка

Для автоматической установки через Jmix Marketplace следуйте инструкциям в разделе Дополнения.

Для ручной установки добавьте следующие зависимости в build.gradle:

implementation 'io.jmix.aitools:jmix-aitools-starter'
implementation 'io.jmix.aitools:jmix-aitools-flowui-starter'
implementation 'io.jmix.aitools:jmix-aitools-flowui-data-starter'

Дополнению также требуется настроенная модель Spring AI. Полная настройка описана в Начало работы.

Важное примечание для приложений в режиме меню Single mode

Если ваше приложение использует режим меню Single mode, вам следует вручную добавить пункты меню после установки дополнения.

  1. Откройте Дизайнер меню в Jmix Studio.

  2. Перейдите на вкладку Structure.

  3. Доступные пункты меню отображаются на левой панели.

    add menu items

  4. Чтобы добавить пункты:

    • Выберите нужные пункты и нажмите кнопку > кнопка (Add Selected).

    • Или перетащите их с левой панели в текущую структуру меню справа.

Этот шаг необходим, потому что приложения в режиме Single mode не выполняют автоматическое слияние меню дополнений с существующей структурой.