SES. UPS руководство по работе с интерфейсом

SES (Script Engine Service) Сценарная машина

Рис. 1 Главный экран UPS

В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

1. SMC Классификатор,
2. SEE Сущности,
3. SPR Распознавание,
4. SBS Биометрия,
5. TTS Синтез,
6. QAS ЧаВО,
7. SES Сценарная машина,
8. Выход.

Переключаться между продуктами можно двумя способами:

1. Воспользоваться кнопкой на панели управления «На главную» .
2. Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2, стрелка).

Рис. 2 Рабочая область SES

Рабочая область SES включает в себя (рис. 2):

• список роботов,
• расположенный на левой панели,
• панель управления,
• облако элементов данных и конечные точки,
• кроме того, есть вкладки: «Скрипты», «Календарь», «Настройки», «Интервалы» и информационная вкладка «Серверы», которая отображает информацию о серверах и процессах. Они все находятся справой стороны рабочей области.

Добавление и настройка робота

Чтобы добавить нового робота, нажмите кнопку «Добавить робота». В появившемся диалоговом окне введите название и нажмите «Добавить». В нижнем правом углу экрана появится сообщение «Робот успешно добавлен!». Робот может быть 3 версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.

Табл. 1 Версии робота.

Иконка версии	Наименование версии модели	Описание
	Черновик	это не примененный робот. Можно добавлять новые элементы данных, конечные точки, менять настройки, применять эти настройки и тестировать робота. После применения робота (см. табл.2 «Применение») становится «Рабочей версией».
	Рабочая	это робот, который уже используется в прод (англ. production – производство). Применённого робота нельзя установить заново или менять. Можно провести ручное тестирование (см. раздел «Тестирование робота») . Можно менять настройки робота и применять эти настройки, они применяются в фоновом режиме незаметно для пользователя, то есть пользователю ничего не нужно обновлять со своей стороны. Если была применена черновая версия робота - «Рабочий» робот переходит в архивную версию.
	Архивная	это рабочий робот, которая переводится в архив (резервную копию) после применения черновика. Можно вернуть архивную модель в рабочую версию, нажав на кнопку «Восстановить» (см. Панель управления SES). При этом рабочая версия также становится архивной, то есть рабочая и архивная версии меняются местами.

Настройка робота

Рис. 3 Интерфейс вкладки Скрипты

Рис. 4. Интерфейс вкладки «Настройки»

С правой стороны экрана расположены вкладки «Скрипты», «Календарь», «Интервалы» и «Настройки».

Вкладка «Скрипты» предоставляет вам возможность работать с кодом в системе напрямую. Вы можете вносить изменения в код, используя выпадающий список «Скрипт». В этом списке вы найдете все доступные скрипты и сможете выбрать нужный. После выбора скрипта вы сможете отредактировать его название и непосредственно область для внесения изменений.

Вкладка «Календарь» представляет собой классический календарь, который показывает текущий и следующий год. Это настройка конкретных интервалов времени, которые потом могут использоваться в качестве условий в действиях

Вкладка «Интервалы» предлагает вам возможность заранее задать временные промежутки (утро, день, вечер), которые будут определять реакцию робота в зависимости от времени суток. Например, вы можете настроить приветствия, такие как «Доброе утро!» или «Добрый день!» и бот будет выбирать нужное в соответствии с текущем временем. А так же периоды, например, настроить рабочее время до перерыва или после.

Вкладка «Настройки», изображённая на рисунке 4, содержит следующие поля:

• название робота,
• описание
• голос

А так же меню с настройками:

• события
• исключения
• данные
• модели
• сессия

События есть 5-ти типов и прописываются для каждого канала связи отдельно:

1. Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
2. Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
3. Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
4. Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя, то есть настройка действий если это событие произошло.. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
5. Запрос повтора — если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.

Исключения есть двух типов Тишина и Не найдено. При Тишине, когда пользователь молчит, можно выставить одно или несколько исключений подряд (параметр Макс. кол-во исключений подряд) и если были выполнены эти исключения подряд, то можно выполнить определенные действия: Сказать или Завершить диалог.

Действие Сказать тоже разделяется на 3 типа:

- последовательно — это означает, что робот будет задавать вопросы и выдавать информацию по порядку, в соответствии с тем, что будет записано в полях «Фразы»,

- случайную фразу — робот выберет случайную фразу из предложенных вариантов для ответа на обращение пользователя,

- из внешнего источника — в этом случае можно подключить скрипты для выполнения необходимых действий, если они есть,

Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.

Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.

При исключении типа Не найдено выставляется параметр Макс. кол-во исключений подряд, то есть сколько раз бот может не найти информацию (сколько раз допускается это событие), после чего происходит переключение на оператора, либо выполнить действия Сказать или Завершить диалог.

Вкладка Данные позволяет настроить процесс обработки сервисных данных, таких как согласие, отрицание, повторение и так далее. Для каждого элемента сервисных данных указывается его Тип (Класс или Сущность), Модель, из которой берутся данные, а также конкретный Класс.

На вкладке Модели можно настроить порог доверия для каждой модели, используемой в работе робота, для более точной работы.

На вкладке Сессия можно установить время жизни сессии в секундах. Это означает, что по истечении заданного периода сессия будет завершена.

Добавление и настройка элементов данных

Рис. 5 Бланк настройки элемента данных

После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку «Добавить элемент». В появившемся диалоговом окне обязательно заполните поле «Название элемента данных», выберите тип элемента в выпадающем списке («Класс» или «Сущность») и нажмите на кнопку «Добавить». Все созданные элементы данных формируют облако данных и находятся на левой части рабочей области.

Настройка элемента данных

На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (как показано на рисунке 5). В этом окне есть два поля: «Название элемента данных» и «Тип», которые вы заполнили при создании элемента данных. Однако, если вы передумаете, вы сможете изменить только название элемента данных. Далее необходимо заполнить поле «Модель», а в поле «Класс» выбрать класс этой модели (SMC), соответствующий типу элемента данных. Если получили класс от SMC, следовательно, получен и элемент данных, ему соответствующий. И нажать на кнопку «Добавить элемент».

В настройках есть флажок «Получать только для запуска конечной точки». Он предназначен для элементов данных, которые следует извлекать только тогда, когда мы находимся в конечной точке, где они необходимы.

Например, пользователь хочет оформить загранпаспорт, но не уточняет, какой именно ему нужен: старого или нового образца. У нас есть элемент данных «Тип загранпаспорта» (в примере тип «Сущность»), который запрашивает эту информацию у пользователя. Этот флаг у него будет активным, так как необходимость уточнения возникает только в том случае, если мы получили класс «Загранпаспорт» от SMC-модели и достигли конечной точки «Загранпаспорт». За более подробной информацией о конечных точках обратитесь к разделу «Добавление и настройка конечной точки».

События

Так же можно настроить События. Это действия которые будут происходить при получении этого элемента данных (если пришел класс от SMC). События есть двух типов:

1. если найден только текущий,
2. недостающий элемент.

Тип события «Если найден только текущий» позволяет настроить реакцию на получение только одного этого класса.

Например, у нас есть такой элемент данных, как Дата. Если абонент называет или пишет: «25 января», мы получили класс от SMC, а значит получили и элемент данных. Но поскольку ответить на такое сообщение не возможно, то в этом типе события можно указать уточнение, например: «Что вы имеете в виду?»

Можно настроить разные события для разных каналов. Чтобы переключиться между каналами связи, просто откройте выпадающий список «Канал». По умолчанию выбран канал «default».

Действия могут быть двух видов:

- сказать,

- завершить диалог.

Действие Сказать тоже разделяется на 3 типа:

- последовательно — это означает, что робот будет задавать вопросы и выдавать информацию по порядку, в соответствии с тем, что будет записано в полях «Фразы»,

- случайную фразу — робот выберет случайную фразу из предложенных вариантов для ответа на обращение пользователя,

- из внешнего источника — в этом случае можно подключить скрипты для выполнения необходимых действий, если они есть,

Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.

Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.

Тип события «Недостающий элемент» предоставляет возможность создать сценарий на случай, если для активации конечной точки не хватает именно этого конкретного элемента данных.

Например, пользователь обращается с вопросом о замене паспорта, но не уточняет, какой паспорт ему нужно заменить — заграничный или внутренний. Для этого случая есть два элемента данных «Тип паспорта — РФ» и «Тип паспорта — Загран», которые являются сущностями в примере. У этих двух элементов данных будет стоять событие типа «Недостающий элемент» с уточнением: «Какой паспорт нужен — заграничный или внутренний?». То есть мы запрашиваем у пользователя информацию, для того чтобы получить этот элемент данных и перейти либо в конечную точку «Паспорт РФ» (при получении тега от SEE «РФ»), либо в конечную точку «Загранпаспорт» (при получении тега от SEE «Загран»).

Действия для этого типа события могут быть двух видов:

- сказать,

- завершить диалог.

Действие Сказать тоже разделяется на 3 типа:

- последовательно — это означает, что робот будет задавать вопросы и выдавать информацию по порядку, в соответствии с тем, что будет записано в полях «Фразы»,

- случайную фразу — робот выберет случайную фразу из предложенных вариантов для ответа на обращение пользователя,

- из внешнего источника — в этом случае можно подключить скрипты для выполнения необходимых действий, если они есть,

Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.

Рис. 6 Окно с настройкой элемента данных

Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.

Окно с полностью заполненными настройками выглядит так, как показано на рисунке 6. Так же на рисунке 6 показана возможность фильтрации и поиска по заданному значению. Все Элементы данных с совпадением - будут подсвечены.

Рис. 7 Рабочая область SES

Добавление и настройка конечных точек

Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В нижней правой части рабочей области расположена кнопка «Добавить конечную точку» (рис. 7). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки объединяются в «облако конечных точек», по которому можно осуществлять поиск, как по элементам данных.

Настройка конечной точки

После того как вы ввели название конечной точки и нажали кнопку «Добавить», слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается название конечной точки, при желании его можно сменить. Далее есть три вкладки:

- условия входа,

- условия срабатывания,

- действия.

Рис. 8 Настройка условий входа в конечную точку

На вкладках «Условия входа» и «Условия срабатывания» вы можете использовать фильтрацию по элементу данных (рис. 8). Для этого просто выберите нужный элемент из предложенного списка. Например, можно просмотреть все возможные сочетания с ним в «Условиях входа». Условия вода. Для того чтобы попасть в конечную точку и выполнить определенные действия нужно выполнить условия входа. Их может быть несколько групп (см. рис. 8).

Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: «Загранпаспорт» (получена метка от SMC, соответствующая этому элементу данных). А также сочетание элементов данных: «Паспорт» (получаем, если тип паспорта не указан сразу) и «Тип паспорта-загран» (тег «Загран» получили после уточнения типа паспорта).

Условия срабатывания. В этом разделе необходимо указать данные, которые требуются для запуска конечной точки. То есть те элементы данных, которые запрашивают у пользователя дополнительную (недостающую) информацию, для выполнения действия, находясь в текущей конечной точки, в первую очередь. Если пользователь попросит, например, оператора, система перейдёт к конечной точке — «Перевод на оператора». Возвращаясь к примеру с загранпаспортом, этот элемент данных будет называться «Тип загранпаспорта» и позволит уточнить, требуется ли загранпаспорт старого или нового образца.

Действия. В этом разделе настраиваются действия, которые будет выполняться при условии, что все данные получены. А так же условия присвоения категорий из QAS для выполнения консультаций. Напоминаем, что действия могут быть двух видов:

- сказать,

- завершить диалог.

Действие Сказать тоже разделяется на 3 типа:

- последовательно — это означает, что робот будет задавать вопросы и выдавать информацию по порядку, в соответствии с тем, что будет записано в полях «Фразы»,

Рис. 9 Условия присвоения категорий

- случайную фразу — робот выберет случайную фразу из предложенных вариантов для ответа на обращение пользователя,

- из внутреннего источника — в этом случае выполняется консультация из QAS (системы ответов на вопросы) после настройки условий присвоения категорий. Так же требуется настроить условия вывода ответа: использование кэша ответов, генерация, творческий режим и требуется ли кэширование формулировки (подробнее об этих настройках см. инструкцию по QAS.Поиск ответа)

- из внешнего источника — в этом случае можно подключить скрипты-интеграций для выполнения необходимых действий, если они есть,

Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.

Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.

Рис. 10.1 Пример работы с отладчиком

Условия присвоения категорий. По клику на эту кнопку раскрывается меню (рис. 9), в котором есть выпадающий список со всеми категориями из QAS, а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ».

Рис. 10.2 Работа с отладчиком. Просмотр параметра data

На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ».

Рис. 11 Просмотр параметра reply

Тестирование робота

В интерфейсе SES есть чат с отладчиком, где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка «Перезапустить сессию». , которая сбрасывает всю переписку и данные отладчика. А слева — кнопка «Данные сессии» , предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS. А так же параметр data, раскрыв который можно увидеть все классы (рис. 10.1 и 10.2), которые пришли от модели SMC и/или модели SEE и их достоверность, раскрыв в data параметр reply (рис. 11).

Панель управления SES

Панель управления SES включает в себя 5 кнопок: обнулить черновик рабочей версией, применить, восстановить, применить настройки робота и меню пользователя.

Табл. 2 Описание функционала панели управления.

Иконка кнопки	Название иконки	Описание
	Обнулить черновик рабочей версией	Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений.
	Применить	По нажатию на эту кнопку черновая версия робота становится рабочей.
	Восстановить	С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной.
	Применить настройки робота	Эта кнопка позволяет применять изменения к роботу в фоновом режиме. Это означает, что если во время диалога между пользователем и ботом были внесены изменения в настройки, то после нажатия на эту кнопку пользователь сможет продолжить общение с ботом, но уже с обновлёнными параметрами.
	Меню пользователя	отображает меню пользователя (имя, смена пароля, выход из системы, убрать/показать фон)

Совместное использование

В Сценарной машине может работать несколько пользователей одновременно, но только если они работают с разными элементами данных и конечными точками. В противном случае будут сохранены только последние изменения, внесённые одним из пользователей.