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

Дополнительные функции ИИ-ассистента

Виртуальный помощник по умолчанию использует доступные функции, указанные в п. 11 .
Если по какой-то причине доступных функций недостаточно, вы можете запрограммировать свои функции.
JavaScript-код своих функций добавьте во вкладку HTML-кастомизация картографического приложения (как JavaScript-код - см. п. 10 ) или в виде JS-файлов положите в папку Customer/openProject (см. меню Администрирование > Управление файлами - п. 1.2.2 ).
Обратите внимание, чтобы виртуальный помощник использовать новые написанные вами функции, размещенные во вкладке HTML-кастомизация , необходимо в настройках ИИ-ассистента отметить опцию Разрешить использование кастомных функций из конструктора (см. п. 11.1 ).
Пример функции describeSchoolLayer ( Короткая справка по слою школ ):
cogissdk.ai.functionCalling.registerFunction({
definition: {
name: "describeSchoolLayer", // название js функции
description: "Короткая справка по слою школ", // описание для агента
parameters: [ // параметры
{ name: "note", description: "Примечание от пользователя", value_type: "string", required: false }
]
},
callback: function ({ note, agentProject }) { // реализация функции
return { ok: true, data: { message: "Кастомная функция слоя школ сработала", note: note ?? null } };
}
});
При этом возвращать нужно объект.
{
ok: true, // true -- функция успешно выполнена, false -- не успешно
data?: "ответ" // Ответ для агента, может быть как строкой, так и объектом,
error?: "ошибка" // в случае ошибки здесь можно указать на ошибку для агента
}