SES. UPS руководство по работе с интерфейсом
Материал из Флора AI
SES (Script Engine Service) Сценарная машина
Рабочая область SES включает в себя (рисунок 1):
- список роботов,
- расположенный на левой панели,
- панель управления,
- облако элементов данных и конечные точки,
- кроме того, есть вкладки: «Скрипты», «Календарь», «Настройки», «Интервалы» и информационная вкладка «Серверы», которая отображает информацию о серверах и процессах. Они все находятся справой стороны рабочей области.
Добавление и настройка робота
Чтобы добавить нового робота, нажмите кнопку «Добавить робота». В появившемся диалоговом окне введите название и нажмите «Добавить». В нижнем правом углу экрана появится сообщение «Робот успешно добавлен!». Робот может быть 3 версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
| Иконка версии | Наименование версии модели | Описание |
|---|---|---|
 |
Черновик | это не примененный робот. Можно добавлять новые элементы данных, конечные точки, менять настройки, применять эти настройки и тестировать робота. После применения (установки) робот (см. табл.2 «Установка») становится «Рабочей версией». |
 |
Рабочая | это робот, который уже используется в прод (англ. production – производство). Применённого робота нельзя установить заново или менять. Можно провести ручное тестирование (см. раздел «Тестирование робота») . Можно менять настройки робота и применять эти настройки, они применяются в фоновом режиме незаметно для пользователя, то есть пользователю ничего не нужно обновлять со своей стороны. Если была применена черновая версия робота - «Рабочий» робот переходит в архивную версию. |
 |
Архивная | это рабочий робот, которая переводится в архив (резервную копию) после применения черновика. Можно вернуть архивную модель в рабочую версию, нажав на кнопку «Восстановить» (см. панель правления SES). При этом рабочая версия также становится архивной, то есть рабочая и архивная версии меняются местами. |
Настройка робота
С правой стороны экрана расположены вкладки «Скрипты», «Календарь», «Интервалы» и «Настройки».
Вкладка «Скрипты» предоставляет вам возможность работать с кодом в системе напрямую. Вы можете вносить изменения в код, используя выпадающий список «Скрипт». В этом списке вы найдете все доступные скрипты и сможете выбрать нужный. После выбора скрипта вы сможете отредактировать его название и непосредственно область для внесения изменений.
Вкладка «Календарь» представляет собой классический календарь, который показывает текущий и следующий год.
Вкладка «Интервалы» предлагает вам возможность заранее задать временные промежутки (утро, день, вечер), которые будут определять реакцию робота в зависимости от времени суток. Например, вы можете настроить приветствия, такие как «Доброе утро!» или «Добрый день!» и бот будет выбирать нужное в соответствии с текущем временем. А так же периоды, например, настроить рабочее время до перерыва или после.
Вкладка «Настройки», изображённая на рисунке 3, содержит следующие поля:
- название робота,
- описание
- голос
А так же меню с настройками:
- события
- исключения
- данные
- модели
- сессия
События есть 5-ти типов и прописываются для каждого канала связи отдельно:
- Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
- Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
- Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
- Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
- Запрос повтора — если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.
Исключения есть двух типов Тишина и Не найдено. При Тишине, когда пользователь молчит, можно выставить одно или несколько исключений подряд (параметр Макс. кол-во исключений подряд) и если были выполнены эти исключения подряд, то можно выполнить определенные действия: Сказать или Завершить диалог.
Действие Сказать тоже разделяется на 3 типа:
- последовательно — это означает, что робот будет задавать вопросы и выдавать информацию по порядку, в соответствии с тем, что будет записано в полях «Фразы»,
- случайную фразу — робот выберет случайную фразу из предложенных вариантов для ответа на обращение пользователя,
- из внешнего источника — в этом случае можно подключить скрипты для выполнения необходимых действий, если они есть,
Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.
Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.
При исключении типа Не найдено выставляется параметр Макс. кол-во исключений подряд, то есть сколько раз бот может не найти информацию, после чего происходит переключение на оператора, либо выполнить действия Сказать или Завершить диалог.
Вкладка Данные позволяет настроить процесс обработки сервисных данных, таких как согласие, отрицание, повторение и так далее. Для каждого элемента сервисных данных указывается его Тип (Класс или Сущность), Модель, из которой берутся данные, а также конкретный Класс.
На вкладке Модели можно настроить порог доверия для каждой модели, используемой в работе робота, для более точной работы.
На вкладке Сессия можно установить время жизни сессии в секундах. Это означает, что по истечении заданного периода сессия будет завершена.
Добавление и настройка элементов данных
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку «Добавить элемент». В появившемся диалоговом окне обязательно заполните поле «Название элемента данных», выберите тип элемента в выпадающем списке («Класс» или «Сущность») и нажмите на кнопку «Добавить». Все созданные элементы данных формируют облако данных и находятся на левой части рабочей области.
Настройка элемента данных
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (как показано на рисунке 4). В этом окне есть два поля: «Название элемента данных» и «Тип», которые вы заполнили при создании элемента данных. Однако, если вы передумаете, вы сможете изменить только название элемента данных. Далее необходимо заполнить поле «Модель», а в поле «Класс» выбрать класс этой модели (SMC), соответствующий типу элемента данных. Если получили класс от SMC, следовательно, получен и элемент данных, ему соответствующий. И нажать на кнопку «Добавить элемент».
В настройках есть флажок «Получать только для запуска конечной точки». Он предназначен для элементов данных, которые следует извлекать только тогда, когда мы находимся в конечной точке, где они необходимы.
Например, пользователь хочет оформить загранпаспорт, но не уточняет, какой именно ему нужен: старого или нового образца. У нас есть элемент данных «Тип загранпаспорта» (в примере тип «Сущность»), который запрашивает эту информацию у пользователя. Этот флаг у него будет активным, так как необходимость уточнения возникает только в том случае, если мы получили класс «Загранпаспорт» от SMC-модели и достигли конечной точки «Загранпаспорт». За более подробной информацией о конечных точках обратитесь к разделу «Добавление и настройка конечной точки».
События
Так же можно настроить События. Это действия которые будут происходить при получении этого элемента данных (если пришел класс от SMC). События есть двух типов:
- если найден только текущий,
- недостающий элемент.
Тип события «Если найден только текущий» позволяет настроить реакцию на получение только одного этого класса.
Например, у нас есть такой элемент данных, как Дата. Если абонент называет или пишет: «25 января», мы получили класс от SMC, а значит получили и элемент данных. Но поскольку ответить на такое сообщение не возможно, то в этом типе события можно указать уточнение, например: «Что вы имеете в виду?»
Можно настроить разные события для разных каналов. Чтобы переключиться между каналами связи, просто откройте выпадающий список «Канал». По умолчанию выбран канал «default».
Действия могут быть двух видов:
- сказать,
- завершить диалог.
Действие Сказать тоже разделяется на 3 типа:
- последовательно — это означает, что робот будет задавать вопросы и выдавать информацию по порядку, в соответствии с тем, что будет записано в полях «Фразы»,
- случайную фразу — робот выберет случайную фразу из предложенных вариантов для ответа на обращение пользователя,
- из внешнего источника — в этом случае можно подключить скрипты для выполнения необходимых действий, если они есть,
Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.
Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.
Тип события «Недостающий элемент» предоставляет возможность создать сценарий на случай, если для активации конечной точки не хватает именно этого конкретного элемента данных.
Например, пользователь обращается с вопросом о замене паспорта, но не уточняет, какой паспорт ему нужно заменить — заграничный или внутренний. Для этого случая есть два элемента данных «Тип паспорта — РФ» и «Тип паспорта — Загран», которые являются сущностями в примере. У этих двух элементов данных будет стоять событие типа «Недостающий элемент» с уточнением: «Какой паспорт нужен — заграничный или внутренний?». То есть мы запрашиваем у пользователя информацию, для того чтобы получить этот элемент данных и перейти либо в конечную точку «Паспорт РФ» (при получении тега от SEE «РФ»), либо в конечную точку «Загранпаспорт» (при получении тега от SEE «Загран»).
Действия для этого типа события могут быть двух видов:
- сказать,
- завершить диалог.
Действие Сказать тоже разделяется на 3 типа:
- последовательно — это означает, что робот будет задавать вопросы и выдавать информацию по порядку, в соответствии с тем, что будет записано в полях «Фразы»,
- случайную фразу — робот выберет случайную фразу из предложенных вариантов для ответа на обращение пользователя,
- из внешнего источника — в этом случае можно подключить скрипты для выполнения необходимых действий, если они есть,
Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.
Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.
Окно с полностью заполненными настройками выглядит так, как показано на рисунке 5. Так же на рисунке 5 показана возможность фильтрации и поиска по заданному значению. Все Элементы данных с совпадением - будут подсвечены.
Добавление и настройка конечных точек
Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В нижней правой части рабочей области расположена кнопка «Добавить конечную точку» (рисунок 6). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки объединяются в «облако конечных точек», по которому можно осуществлять поиск, как по элементам данных.
Настройка конечной точки
После того как вы ввели название конечной точки и нажали кнопку «Добавить», слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается название конечной точки, при желании его можно сменить. Далее есть три вкладки:
- условия входа,
- условия срабатывания,
- действия.
Условия вода. Для того чтобы попасть в конечную точку и выполнить определенные действия нужно выполнить условия входа. Их может быть несколько групп (см. рисунок 7).
Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: «Загранпаспорт» (получена метка от SMC, соответствующая этому элементу данных). А также сочетание элементов данных: «Паспорт» (получаем, если тип паспорта не указан сразу) и «Тип паспорта-загран» (тег «Загран» получили после уточнения типа паспорта).
Условия срабатывания. В этом разделе необходимо указать данные, которые требуются для запуска конечной точки. То есть те элементы данных, которые запрашивают у пользователя дополнительную (недостающую) информацию, для выполнения действия, находясь в текущей конечной точки, в первую очередь. Если пользователь попросит, например, оператора, система перейдёт к конечной точке — «Перевод на оператора». Возвращаясь к примеру с загранпаспортом, этот элемент данных будет называться «Тип загранпаспорта» и позволит уточнить, требуется ли загранпаспорт старого или нового образца.
Действия. В этом разделе настраиваются действия, которые будет выполняться при условии, что все данные получены. А так же условия присвоения категорий из QAS для выполнения консультаций. Напоминаем, что действия могут быть двух видов:
- сказать,
- завершить диалог.
Действие Сказать тоже разделяется на 3 типа:
- последовательно — это означает, что робот будет задавать вопросы и выдавать информацию по порядку, в соответствии с тем, что будет записано в полях «Фразы»,
- случайную фразу — робот выберет случайную фразу из предложенных вариантов для ответа на обращение пользователя,
- из внутреннего источника — в этом случае выполняется консультация из QAS (системы ответов на вопросы) после настройки условий присвоения категорий. Так же требуется настроить условия вывода ответа: использование кэша ответов, генерация, творческий режим и требуется ли кэширование формулировки (подробнее об этих настройках см. инструкцию по QAS.Поиск ответа)
- из внешнего источника — в этом случае можно подключить скрипты-интеграций для выполнения необходимых действий, если они есть,
Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.
Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.
Условия присвоения категорий. По клику на эту кнопку раскрывается меню (рисунок 8), в котором есть выпадающий список со всеми категориями из QAS, а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ».
На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ».
Тестирование бота
В интерфейсе SES есть чат с отладчиком, где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок 
в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка - кнопка для сброса сессии, а слева - кнопка для открытия отладчика. В окне отладчика есть параметр data, раскрыв который можно увидеть все классы, которые пришли от модели SMC и/или модели SEE (рисунок 9).
Панель управления SES
| Иконка | Название иконки | Описание |
|---|---|---|
 |
||
 |
Применить | |
|
Восстановить | |
|
Применить настройки | |
 |
Меню пользователя |
Совместное использование
В Сценарной машине может работать несколько пользователей одновременно, но только если они работают с разными элементами данных и конечными точками. В противном случае будут сохранены только последние изменения, внесённые одним из пользователей.