13 | Документация

ИИ-ассистенты (function calling)

В виджет картографического приложения вы можете добавить блок Вызов ИИ-агента (см. п. 6.22 ), в котором пользователь интерактивной карты может отправлять запросы виртуальному помощнику.
Виртуальный помощник использует определенный набор функций, которые ему позволяют решать проблему пользователя. Функциям при этом могут быть переданы параметры, полученные из запроса пользователя, рассчитанные другими функциями или заданные по умолчанию.
Чтобы настроить виртуального помощника, необходимо задать параметры ИИ-ассистента (виртуального помощника) в Настройках CoGIS Portal (см. п. 11.1 ). И затем настроить блок Вызов ИИ-агента в виджете (см. п. 6.22 ).
По умолчанию виртуальному помощнику доступны следующие функции:
  • получение списка доступных слоев;
  • получение подробной информации о выбранном слое;
  • геокодирование по заданному адресу;
    В картографическое приложение во вкладке Сервисы должен быть добавлен сервис геокодирования (см. п. 4.10 ).
  • приближение к заданным координатам;
  • установка пушпина;
  • построение маршрутов по заданному набору местоположений и с выбранным видом передвижения (например, на машине, грузовике, велосипеде, пешком);
    В картографическое приложение во вкладке Сервисы должен быть добавлен сервис сетевого анализа (см. п. 4.12 ).
  • построение зоны доступности для заданного местоположения, указанного размера с выбранным видом передвижения (например, на машине, грузовике, велосипеде, пешком);
    В картографическое приложение во вкладке Сервисы должен быть добавлен сервис сетевого анализа (см. п. 4.12 ).
  • наложение заданного атрибутивного фильтра (задается имя поля, оператор сравнения, значение или значения для сравнения) на выбранный слой;
  • наложение пространственного фильтра (по заданному размеру буфера) на заданное местоположение в выбранном слое;
  • экспорт выбранного слоя в указанный формат файла;
    В картографическое приложение должно быть добавлено расширение SOE для картографического сервиса с выбранным слоем (см. п. 4.2 ), и в Правилах SOE добавлен и настроен плагин Загрузка и выгрузка данных (см. п. 14.9 ), где для выбранного слоя должна быть разрешена выгрузка данных. Помимо этого, для выгружаемого слоя должно быть настроено отображение его атрибутивной таблицы.
  • получение текущей GPS позиции;
  • поиск объекта в выбранном слое: по содержанию текста в атрибутах, по уникальному идентификатору объекта, по местоположению с учетом заданного допуска;
  • получение объекта, открытого в Карточке объекта ;
  • открытие Карточки заданного объекта ;
  • получение атрибутов заданного объекта;
  • получение центроида заданного объекта;
  • создание и сохранение объекта в выбранном слое, заполнение атрибутов нового объекта;
    Обратите внимание, что редактирование и удаление существующего объекта не поддерживается.
  • получение списка виджетов и их блоков;
  • включение/отключение видимости слоев сервиса в целом, определенного слоя или выбранного виджета;
  • получение списка доступных инструментов геообработки;
    В картографическое приложение во вкладке Сервисы должны быть добавлены сервисы геообработки (см. п. 4.4 ) с нужными инструментами геообработки.
  • получение информации о выбранном инструменте геообработки;
    В картографическое приложение во вкладке Сервисы должны быть добавлены сервисы геообработки (см. п. 4.4 ) с нужными инструментами геообработки.
  • запуск инструмента геообработки с заданными параметрами;
    В картографическое приложение во вкладке Сервисы должны быть добавлены сервисы геообработки (см. п. 4.4 ) с нужными инструментами геообработки.
  • установка диапазона на временно́й шкале.
    В картографическом приложении в горизонтальной вкладке Данные вкладки Инструменты и настройка карты должна быть настроена временна́я шкала (см. п. 8.2.1 ).
При этом в запросе в отношении определенного слоя пользователь может указывать имя слоя или его идентификатор (номер).
Если по какой-либо причине указанного списка функций недостаточно, вы можете запрограммировать свои функции и настроить их использование виртуальным помощником (см. п. 11.2 ).
Запросы пользователей к виртуальному помощнику могут сохраняться в отдельную таблицу в базе данных. Для этого создайте таблицу запросов пользователей и опубликуйте картографический сервис, содержащий эту таблицу (см. п. 11.3 ). Обратите внимание, что в Правилах SOE для картографического сервиса с таблицей запросов должен быть настроен плагин Редактирование (см. п. 14.6 ).