JS Агент
Об агенте
«JS Агент» – это один из компонентов модуля Visiology Cortex, который позволяет настраивать виджеты на дашборде с помощью естественного языка. Пользователь описывает желаемые изменения, а агент автоматически генерирует и сразу применяет JavaScript-код к выбранному виджету. Важно отметить, что агент работает полностью локально и не требует доступа в интернет.
Данная функциональность даёт возможность быстро вносить сложные изменения в визуализацию данных без глубоких технических знаний, а также позволяет экономить время разработчиков дашбордов.
С помощью агента вы сможете:
быстро адаптировать виджеты под конкретные бизнес-задачи: добавлять подписи, изменять визуальные настройки, модифицировать элементы диаграмм и графиков и многое другое.
автоматизировать рутинные операции по настройке визуализаций;
повышать качество представления данных без привлечения разработчиков;
экономить время на создание кастомных виджетов;
создавать виджеты с нуля на основе добавленных данных;
анализировать существующий код и находить ошибки.
Поддерживаемые библиотеки и версии
При формировании ответов и примеров кода JS-агент использует официальную документацию следующих библиотек визуализации и компонентов пользовательского интерфейса:
ECharts 5.6.0
Highcharts 10.3.3
DevExtreme 21.1.7
Все рекомендации, синтаксис и примеры, предоставляемые агентом, соответствуют указанным версиям библиотек.
Работа с агентом
Для того, чтобы воспользоваться агентом, необходимо выполнить следующие шаги:
Откройте дашборд и выберите на нем виджет, который хотите изменить.
В боковой панели платформы нажмите нажмите Cortex:
Откроется окно агента. В поле ввода напишите, что именно нужно сделать. Например: «Добавь подписи над столбцами диаграммы. Подписи должны быть с зелёным фоном, шрифт – курсивный.»
Агент проанализирует запрос, сгенерирует соответствующий JavaScript-код и сразу применит изменения к виджету. В окне агента отобразится код, а на дашборде вы увидите обновлённый виджет:
После получения результата вы можете:
Отменить изменения, нажав на кнопку Отменить. В этом случае виджет вернётся в исходное состояние.
Повторить отменённое действие, нажав на кнопку Повторить.
Скопировать код для использования в других местах.
Уточнить запрос и отправить его снова.
Агент знает и понимает JavaScript API платформы (visApi) и использует его при генерации кода.
Агент понимает контекст виджета: его тип, данные, текущие настройки, поэтому код всегда адаптируется под конкретный объект.
Все изменения применяются только к текущему виджету и не влияют на исходные данные.
Вы всегда можете просмотреть сгенерированный код, чтобы разобраться в логике изменений или доработать его вручную.
Создание виджета с нуля
Чтобы создать на дашборде новый виджет на основе ваших данных необходимо сделать следующее:
Добавьте на дашборд виджет “Текст”, нажав соответствующую кнопку на вкладке Виджеты.
В поле Столбцы добавьте столбцы, данные которых вы планируете визуализировать в новом виджете. Например:
В боковой панели нажмите Cortex. В открывшемся окне перейдите на вкладку Код виджета, напишите запрос на создание виджета и нажмите Отправить.
Например: «Создай таблицу со встроенными фильтрами по бренду и категории»:Агент обработает ваш запрос и через некоторое время отобразит в своем окне сгенерированный код виджета, а на дашборде сразу появится визуализация выбранных данных – в нашем примере таблица со встроенными фильтрами:
Ограничения и особенности
При создании JavaScript-кода для конкретного виджета агент использует механизм поиска релевантной информации. Чтобы обеспечить точность и релевантность результата, поиск выполняется не по всей базе знаний, а только по тем источникам, которые соответствуют типу разрабатываемого виджета. Исключение составляют текстовый и пользовательский виджеты – они имеют доступ ко всей документации, поскольку служат универсальной платформой для реализации произвольной логики и кастомизации.
Для большинства типов виджетов определен собственный набор допустимых источников:
Если виджет базируется на внешней библиотеке (например, ECharts, Highcharts, DevExtreme), агент обращается только к документации этой библиотеки и к соответствующим внутренним разделам.
Для виджетов, которые не используют графические библиотеки (например, фильтры, кнопки, индикаторы), доступна исключительно внутренняя документация.
Существует также общая документация, которая доступна всем типам виджетов и содержит универсальные сведения.
Таким образом, для большинства виджетов агент не может привлекать информацию, предназначенную для других типов. Например, при генерации круговой диаграммы он будет использовать документацию ECharts, внутренние материалы по круговым диаграммам и общие разделы. А при создании фильтра обратится только к внутренней документации по фильтрам и общим разделам — библиотеки графиков в этом случае не учитываются.
Однако текстовый и пользовательский виджеты являются исключением: поскольку они предназначены для размещения произвольного контента и кода, им требуется доступ ко всем доступным источникам – как внешним библиотекам, так и любой внутренней документации, чтобы позволить разработчикам создавать уникальные кастомные решения.
Смотрите также
На этой странице
Время чтения: 1 мин.
Нужна дополнительная помощь?