Перейти к содержанию

Управление пользовательскими графиками

Glarus BI позволяет системным администраторам загружать собственные визуализации в виде JS-плагинов. Каждый плагин становится доступен внутри визуализации «Свой график». Данные запроса передаются в загруженный JavaScript-пакет, который отрисовывает диаграмму произвольным способом — средствами SVG, Canvas, WebGL, через сторонние библиотеки (echarts, d3, plotly) или с использованием WebAssembly.

Плагины могут быть как написаны разработчиком на TypeScript/JavaScript, так и генерироваться администраторами с применением средств искусственного интеллекта в интерфейсе Glarus BI (требуется интеграция с ИИ-агентом) или в отдельном приложении для генерации кода с использованием документации разработчика.

Мы предоставляем несколько демонстрационных плагинов:

Плагин Описание
Hello World Минимальный плагин: отображает приветствие, число строк и значение первой ячейки первой записи. Нет требований к данным, должен работать с любым запросом.
Радар Визуализация "Радар": запрос должен содержать как минимум один столбец измерений (метку оси) и три или более числовых показателя. Отображается только первая строка (для примера). Запрос должен возвращать минимум одну ось.
Сводная таблица Классическая двухмерная сводная таблица с возможностью подсчёта итогов по строкам, столбцам и линейной тепловой картой ячеек.

Распакуйте содержимое zip-файла после загрузки.

Загрузка плагина в Glarus BI через графический интерфейс

Чтобы плагин отображался в выборе визуализаций, администратор должен загрузить его в подразделе «Пользовательские графики». Потребуются 2 файла:

  • файл пакета pluigin.js;
  • файл манифеста manifest.json.

Порядок действий:

  1. Открыть Управление > Пользовательские графики.
  2. Загрузить файл пакета plugin.js и файл манифеста manifest.json.
  3. Нажать кнопку «Загрузить плагин».

Плагин должен появиться в реестре – таблице под элементами загрузки, в блоке «Установленные плагины».

Проверка работоспособности плагина

Чтобы проверить работоспособность плагина после загрузки:

  1. Открыть любой сохранённый запрос.
  2. На правой панели выбрать тип визуализации «Свой график».
  3. На вкладке «Плагин» убедиться в появлении новой строки.
  4. Попытаться воспользоваться плагином как обычной визуализацией, изменив запрос, чтобы соответствовать требованиям плагина к данным.

Удаление плагина

Для удаления плагина:

  1. Открыть Управление > Пользовательские графики.
  2. В реестре «Установленные плагины» найти плагин по названию.
  3. Убедиться, что плагин не используется в запросах и на дашбордах. Информация об использовании выводится в реестре плагинов.
  4. Нажать кнопку «Удалить».

Плагины, которые уже выбраны в запросах, система не позволит удалить. В таких записях кнопка удаления будет неактивна.

Генерация плагинов с использованием ИИ

Для работы ИИ-функционала требуется настроить интеграцию с большой языковой моделью DeepSeek.

В разделе администрирования доступна функция «Сгенерировать с ИИ»:

  1. Пользователь вводит текстовый запрос («Диаграмма Ганта», «Sankey с настраиваемыми цветами», «Радар с легендой справа» и т. п.).

  2. Серверная часть передаёт запрос языковой модели (DeepSeek) через потоковое соединение (SSE).

  3. На клиентской стороне отображается интерфейс с постепенным появлением текста по мере генерации.

  4. Серверная часть в фоновом режиме проверяет полученный ответ: парсинг JSON, валидацию схемы манифеста, попытку выполнения пакета. При неудаче запрос к модели повторяется (до четырёх попыток).

  5. После успешной проверки плагин автоматически сохраняется в реестр и становится доступен в списке.

Аналогичная функция реализована для доработки существующего плагина: команда «измени цвет на синий» или «добавь подсказку с процентами» приводит к повторной генерации с использованием текущего манифеста и пакета.

В таблице приведены настройки генерации плагина с помощью DeepSeek:

Настройка Назначение
glarus-deepseek-api-key Ключ API DeepSeek
glarus-deepseek-model Идентификатор модели (по умолчанию deepseek-chat)
glarus-deepseek-max-tokens Ограничение длины ответа модели в токенах
glarus-deepseek-max-prompt-chars Ограничение длины пользовательского запроса в символах
glarus-deepseek-max-bundle-chars Ограничение длины пакета при доработке
glarus-deepseek-system-prompt Системный запрос (по умолчанию загружается из начальных данных)

Метаданные генерации (исходный запрос, число попыток, время генерации, идентификатор модели) отображаются в списке плагинов.

Дополнительная информация