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

=== SES (Script Engine Service) Сценарная машина ===
[[Файл:UPS SES.png|мини|''<small>Рис. 1 Главный экран UPS</small>'']]


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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# SES Сценарная машина,
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]].
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2, стрелка).
[[Файл:2024-11-18 12-00-28.png|мини|''<small>Рис. 2 Рабочая область SES</small>'']]



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

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


==== Добавление и настройка робота ====
Чтобы добавить нового робота, нажмите кнопку '''«Добавить робота»'''. В появившемся диалоговом окне введите название и нажмите '''«Добавить»'''. В нижнем правом углу экрана появится сообщение «Робот успешно добавлен!».  Робот может быть 3 версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
{| class="wikitable"
|+''<small>Табл. 1 Версии робота.</small>''
!'''Иконка версии'''
!'''Наименование версии робота'''
!'''Описание'''
|-
|[[Файл:Черновик.png|центр|безрамки|40x40пкс]]
|Черновик
|это не примененный робот. Можно добавлять новые элементы данных, конечные точки, менять настройки, применять эти настройки и тестировать робота. После применения робота (см. [https://wiki.connect2ai.net/index.php?title=SES._UPS_руководство_по_работе_с_интерфейсом&veaction=edit&section=2#Панель_управления_SES табл.2] «Применение») становится «Рабочей версией».
|-
|[[Файл:Рабочая_нов.png|центр|безрамки|40x40пкс]]
|Рабочая
|это робот, который уже используется в прод (англ. ''production –'' производство'')''. Применённого робота нельзя установить заново или менять. Можно провести ручное тестирование (см. раздел «[[SES. UPS руководство по работе с интерфейсом#Тестирование робота|Тестирование робота]]») . Можно менять настройки робота и применять эти настройки, они применяются в фоновом режиме незаметно для пользователя, то есть пользователю ничего не нужно обновлять со своей стороны. Если была применена черновая версия робота ''–'' «Рабочий» робот переходит в архивную версию.
|-
|[[Файл:Архив_нов.png|центр|безрамки|40x40пкс]]
|Архивная
|это рабочий робот, которая переводится в архив (резервную копию) после применения черновика. Можно вернуть архивную модель в рабочую версию, нажав на кнопку «Восстановить» (см. [https://wiki.connect2ai.net/index.php?title=SES._UPS_руководство_по_работе_с_интерфейсом&veaction=edit&section=2#Панель_управления_SES Панель управления SES]). При этом рабочая версия также становится архивной, то есть рабочая и архивная версии меняются местами.
|}

===== Настройка робота =====
Прежде чем приступить к настройке робота, необходимо упомянуть о сервисах, которые потребуются для его функционирования:

- Все требуемые модели [[SMC. UPS руководство по работе с интерфейсом|SMC]];

- Все требуемые модели [[SEE. UPS руководство по работе с интерфейсом|SEE]];

- База вопросно-ответных пар в [[QAS. UPS руководство по работе с интерфейсом|QAS]], если вы планируете предоставлять консультации.

Здесь представлен общий перечень необходимых сервисов. В зависимости от специфики проекта некоторые из них могут отсутствовать.

[[Файл:Скрипты.png|мини|''<small>Рис. 3 Интерфейс вкладки Скрипты</small>'']]
С правой стороны экрана расположены вкладки «Скрипты», «Календарь», «Интервалы» и «Настройки».    

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

====== Вкладка «Календарь» ======
представляет собой классический календарь, который показывает текущий и следующий год. Это настройка конкретных интервалов времени, которые потом могут использоваться в качестве условий в действиях.  
  
[[Файл:Интервалы.png|мини|<small>''Рис. 4 Интерфейс вкладки «Интервалы»''</small>]]

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

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

* события — это настройка действий робота, при наступлении этого события, например «Не найдено» (см. раздел «События» ниже);
* исключения — это то, сколько раз допускается событие (см. раздел «Исключения» ниже);
* данные;
* модели — это совокупность всех необходимых для работы робота моделей, например, сущностей и классификации;
* сессия — указывается длительность сессии в секундах, по умолчанию 600 сек.[[Файл:Настройки.png|мини|''<small>Рис. 5 Интерфейс вкладки «Настройки»</small>'']]
'''''События''''' есть 5-ти типов и прописываются для каждого канала связи отдельно: 

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


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

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

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

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

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

Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.<blockquote>
''Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.''</blockquote>При исключении типа «Не найдено», то есть в запросе абонента обнаружилась неизвестная тематика или отсутствие ответа. Выставляется параметр «Макс. кол-во исключений подряд», то есть сколько раз бот может не найти информацию (сколько раз допускается это событие), после чего происходит переключение на оператора, либо выполнить действия «Сказать», «Завершить диалог» или «Передать диалог».

При исключении типа '''«Нет данных»''' также выставляется параметр «Макс. кол-во исключений подряд», то есть сколько раз бот может не найти информацию (сколько раз допускается это событие), после чего происходит переключение на оператора либо выполнить действия «Сказать», «Завершить диалог» или «Передать диалог».<blockquote>Важно: Если элемент отсутствует в начале, счётчик увеличивается на единицу. То есть учитывается самое первое сообщение абонента, в котором не было нужной информации. </blockquote>Вкладка '''''Данные''''' позволяет настроить процесс обработки сервисных данных, таких как согласие, отрицание, повторение и так далее. Для каждого элемента сервисных данных указывается его ''Тип'' (Класс или Сущность), ''Модель'', из которой берутся данные, а также конкретный ''Класс''.

На вкладке '''''Модели''''' нужно добавить все модели, которые нужны для работы робота, например, модели SMC, SEE и голоса. Для каждой модели можно задать порог доверия, который определяет, какие данные от этой модели будут использоваться в сценарии, а какие — нет. Данные (метки), которые не достигают этого уровня, будут исключены из сценария, и в нём останутся только те, что превышают или равны этому уровню. Для моделей SMC можно включить флаг «Коррекция». Он поможет исправить ошибки в одной букве.    

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

==== Добавление и настройка элементов данных ====
[[Файл:2025-02-26 12-51-08.png|мини|''<small>Рис. 6 Бланк настройки элемента данных</small>'']]
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку '''«Добавить элемент»'''. В появившемся диалоговом окне обязательно заполните поле '''«Название элемента данных»''', выберите тип элемента в выпадающем списке («Класс», «Сущность» или «Внешние») и нажмите на кнопку '''«Добавить»'''. Все созданные элементы данных формируют ''облако данных'' и находятся на левой части рабочей области.

'''Класс''' — данные, полученные из моделей SMC.

'''Сущность''' — информация из моделей SEE.

'''Внешние''' — данные из любой внешней базы данных, например, по API или скрипты интеграции.

===== Настройка элемента данных =====
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (как показано на рис. 6). В этом окне есть два поля: «'''Название элемента данных»''' и '''«Тип»''', которые вы заполнили при создании элемента данных. Однако, если вы передумаете, вы сможете изменить только название элемента данных. Далее необходимо заполнить поле '''«Модель»''', а в поле '''«Класс»''' выбрать класс этой модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]]), соответствующий типу элемента данных. ''Если получили класс от SMC, следовательно, получен и элемент данных, ему соответствующий.'' '''«Вес»''' — это параметр, который определяет приоритет этого элемент данных в спорных ситуациях. По умолчанию установлено значение 3. <blockquote>Совет по работе с весом ЭД.

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

* Предварительная запись, отмена записи, уточнение записи и её перенос.
* Проверка статуса,
* Запрос оператора,
* а так же данные (тематики), которые должны отрабатываться иным способом, например, ЭД Выплаты и пособия, Опека и др. должны уходить на оператора, по ним нет консультации в ЧаВО.

Рассмотрим пример. ЭД «Предварительная запись» имеет вес 4 и приоритет в случае, если одновременно с ней от модели пришла метка СНИЛС (вес по умолчанию 3). В таком случае сочетание этих меток должно привести к КТ «Запись на прием».

Однако существуют некоторые '''исключения'''. Например, если метка «Предварительная запись» (вес 4) появляется вместе с меткой «Детский сад» (вес 3), то их комбинация должна привести в КТ «Консультация ЧаВО», а не в КТ «Запись на приём». Чтобы избежать такой ситуации, можно ''добавить это сочетание меток для входа в раздел «Консультация ЧаВО»''. Тогда при поступлении такого запроса от модели сценарная машина отправит его в QAS.

'''То есть в случае однозначного приоритета можно повысить вес у конкретного элемента данных, а все исключения из этого правила отрабатывать добавлением сочетания меток на вход нужной КТ.'''</blockquote>В выпадающем списке '''«Подтип»''' можно выбрать один из двух вариантов:

«Сервисный» — этот элемент данных не нужно включать в отчет.

«Отчетный» — такой элемент должен быть отображен в отчетах. 

Есть возможность '''оставлять комментарии''' по нажатию на кнопку [[Файл:Комментарий.png|безрамки|20x20пкс]]. Это удобно, например, если нужно сделать заметку для себя или коллег. Например, если было изменено значение веса ЭД, можно указать причину в комментарии. Как только будет оставлен комментарий, иконка поменяется на [[Файл:Комментарий полный.png|безрамки|20x20пкс]] — это означает, что комментарий не пустой. 

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

Если в карточку ЭД были внесены изменения, закрыть её можно только после того, как вы сохраните эти изменения и кликните на любую область за пределами карточки, или принудительно закрыть её, нажав на кнопку «Закрыть» <u>(без сохранения внесенных изменений)</u>. Если открыли карточку просто для просмотра, то закрывается по клику вне карточки или по кнопке «Закрыть».

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

За более подробной информацией о конечных точках обратитесь к разделу «Добавление и настройка конечной точки».</blockquote>

===== События =====

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

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


'''Тип события «Если найден только текущий»''' позволяет настроить реакцию на получение <u>только одного</u> этого класса. <blockquote>
Например, у нас есть такой элемент данных, как Дата. Если абонент называет или пишет: «25 января», мы получили класс от SSE, а значит получили и элемент данных. Но поскольку ответить на такое сообщение не возможно, то в этом типе события можно указать уточнение, например: «Что вы имеете в виду?»</blockquote>
Можно настроить разные события для разных каналов. Чтобы переключиться между каналами связи, просто откройте выпадающий список «Канал». По умолчанию выбран канал «default».

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

- сказать,

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

- передача диалога.

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

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

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

- из внешнего источника — в этом случае можно подключить скрипты для выполнения необходимых действий, если они есть,<blockquote>
'''Удалить''' лишнюю фразу можно, кликнув на поле с этой фразой правой клавишей мыши и в появившемся меню выбрать «Удалить фразу».</blockquote>
Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.<blockquote>''Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.''</blockquote>


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

# Создаем элемент данных (класс или сущность). <blockquote>Например, пользователь обращается с вопросом о замене паспорта, но не уточняет, какой паспорт ему нужно заменить — заграничный или внутренний. Для этого случая есть элемент данных «Тип паспорта», который является сущностью. У этого элемента данных будет стоять событие типа «Недостающий элемент» с уточнением: «Какой паспорт нужен — заграничный или внутренний?». То есть мы запрашиваем у пользователя информацию, для того чтобы получить этот элемент данных и перейти либо в конечную точку «Паспорт РФ» (при получении тега от [[SEE. UPS руководство по работе с интерфейсом|SEE]] «РФ»), либо в конечную точку «Загранпаспорт» (при получении тега от [[SEE. UPS руководство по работе с интерфейсом|SEE]] «Загран»).</blockquote>[[Файл:Фильтрация и настройка кон.точки.png|мини|''<small>Рис. 7 Окно с настройкой элемента данных</small>'']]2. Выбираем тип события «Недостающий элемент» и настраиваем действие. И сохраняем настройки.

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

- сказать,

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

- передача диалога.

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

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

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

- из внешнего источника — в этом случае можно подключить скрипты для выполнения необходимых действий, если они есть,<blockquote>
'''Удалить''' лишнюю фразу можно, кликнув на поле с этой фразой правой клавишей мыши и в появившемся меню выбрать «Удалить фразу».</blockquote>
Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.<blockquote>''Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.''</blockquote>Окно с полностью заполненными настройками выглядит так, как показано на рисунке 7. Так же на рисунке 7 показана возможность фильтрации и поиска по заданному значению. Все Элементы данных с совпадением - будут подсвечены синим.
[[Файл:2025-03-18 15-50-25.png|мини|''<small>Рис. 8 Добавление кнопок</small>'']]


==== Добавление кнопок в действия ====


В сценарной машине предусмотрена возможность добавления кнопок. Для этого нужно кликнуть правой клавишей мыши (ПКМ) на поле «Фраза» в блоке действий и в появившемся меню выбрать «Добавить кнопку» (рис. 8). После этого раскроется блок с настройками, где требуется ввести:

# [[Файл:2025-03-18 15-50-48.png|мини|''<small>Рис. 9 Редактирование кнопки</small>'']]название кнопки;
# текст для отправки — это тот текст, который отправится на модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]], [[SEE. UPS руководство по работе с интерфейсом|SEE]]).

Чтобы внести изменения в созданную кнопку, кликните по ней левой клавишей мыши (ЛКМ) и в открывшемся меню можно редактировать (рис. 9).<blockquote>Есть возможность выполнить настройки кнопок для разных каналов. Для этого переключите канал в меню напротив «Типа» события, по умолчанию все настройки производятся в канале default.</blockquote>
[[Файл:2024-11-18 12-00-28.png|мини|''<small>Рис. 10 Рабочая область SES</small>'']]

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

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

'''«Отчетный»''' — эта та, которая участвует в статистике, т.е. несет какую-то полезную для анализа информационную нагрузку.

'''«Сервисный»''' — это такие конечные точки, как «приветствие» и другие, которые служат для поддержания диалога.

'''«Передача диалога»''' — точки, отвечающие за переключение звонка или передачу разговора операторам.

'''«Завершение диалога»''' — конечная точка, которая ставит точку в общении с пользователем.


Также можно выбрать еще '''Тип входа в КТ''' может быть двух видов: 

'''- по условию''', когда попадаем в КТ при условии получения определенных данных, например, класс от SMC. 

- '''по бездействию''', когда КТ отрабатывает по таймауту, указанному в поле Время, если абонент приостановил взаимодействие с роботом, но сессия еще не завершилась. <blockquote>Пример.

Абонент обратился за консультацией. Робот предоставил ответ. После консультации абонент бездействует, а сессия еще не закрыта. Можно настроить КТ Оценка качества обслуживания, которая по истечению указанного времени запросит оценку, после ответа абонента, завершит сессию.</blockquote>Есть возможность '''оставлять комментарии''' по нажатию на кнопку [[Файл:Комментарий.png|безрамки|20x20пкс]]. Это удобно, например, если нужно сделать заметку для себя или коллег. Как только будет оставлен комментарий, иконка поменяется на [[Файл:Комментарий полный.png|безрамки|20x20пкс]] — это означает, что комментарий не пустой.

Далее есть три вкладки:

- Вход,

- Сбор информации,

- Действия.
[[Файл:2025-02-26 13-03-07.png|мини|''<small>Рис. 11 Настройка условий входа в конечную точку</small>'']]
На вкладках «Вход» доступна ''фильтрация по элементу данных'' (рис. 11), а на вкладке «Сбор информации» ''фильтрация по элементам данных или их сочетанию на входе''.    

# '''Вход'''. Для того чтобы попасть в конечную точку и выполнить определенные действия, нужно выполнить условия входа. Их может быть как один элемент данных, так и их сочетание(см. рис. 11). Доступна фильтрация по элементу данных.<blockquote>Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: ''«Загранпаспорт»'' (получена метка от [[SMC. UPS руководство по работе с интерфейсом|SMC]], соответствующая этому элементу данных). А также сочетание элементов данных: ''«Паспорт»'' (получаем, если тип паспорта не указан сразу) и ''«Тип паспорта-загран»'' (тег «Загран» получили после уточнения типа паспорта).</blockquote>'''2. Сбор информации.''' В этом разделе необходимо указать '''''все''''' случаи (данные и их комбинации), '''''при которых точка сработает'''''. Обязательно должен присутствовать элемент данных (или комбинация) с входа. Если вы установите флажок «Включить сбор информации», то активируете функцию дублирования данных с входа. Эти данные (сочетания) будут автоматически скопированы во вкладку «Сбор информации» [[Файл:2024-11-18 13-00-42.png|мини|''<small>Рис. 12 Вкладка Сбор информации</small>'']]<blockquote>Обратите внимание, что условия сбора информации, добавленные с помощью галочки «Включить сбор информации», '''нельзя удалить''', их можно только дополнить условием «И», если это необходимо (то есть если требуется донабор) </blockquote>По умолчанию для вновь создаваемых конечных точек эта функция отключена. Если вы попытаетесь отключить её, когда она активна, появится предупреждение: «Все условия запуска конечной точки будут удалены, Вы уверены?». Если вы согласны, то условия скрываются, но не удаляются. При повторном включении функции условия становятся видимыми. '''При сохранении точки с выключенной галочкой «Включить сбор информации» условия <u>необратимо</u> удаляются.''' Есть возможность фильтрации по условиям входа.      

Во вкладке «Сбор информации» элементы данных разделяются логическим оператором «ИЛИ». В случае с комбинациями условий ЭД отделяются друг от друга логическим «И». Условия, добавленные вручную, можно редактировать: добавлять и удалять.      <blockquote>Например, конечная точка «Консультация» активируется, если будут получены метки «Апостиль» ИЛИ «Банкротство» ИЛИ «Загранпаспорт» и «Тип паспорта — загран».      </blockquote>У условий есть параметр «Тип», принимающий два значения: данные или переменная. Параметр «Глубина» (по умолчанию «Глубина» равна 5) — это глубина поиска нужных данных в истории, устанавливается в диапазоне [1, 20].       <blockquote>К примеру, абонент написал всего 10 сообщений, при параметре 5 будет отматывать 5 сообщений назад для поиска данных. Если указать 1, то робот будет ориентироваться только на свежее сообщение.       </blockquote>Далее идет поле «Название», где из выпадающего списка требуется выбрать нужный элемент данных. Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:      

* [[Файл:2024-11-19 10-51-24.png|мини|''<small>Рис. 13 Условия присвоения категорий</small>'']]Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* != — не равно,
* = — равно,
* < —  меньше,
* > —  больше,
* <= — меньше или равно,
* => — больше или равно,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».
[[Файл:2024-11-19 10-52-01.png|мини|''<small>Рис. 14 Условия запуска</small>'']]


Если в карточку КТ были внесены изменения, закрыть её можно только после того, как вы сохраните эти изменения и кликните на любую область за пределами карточки, или принудительно закрыть её, нажав на кнопку «Закрыть» <u>(без сохранения внесенных изменений)</u>. Если открыли карточку просто для просмотра, то закрывается по клику вне карточки или по кнопке «Закрыть».

'''3. Действия.''' В этом разделе настраиваются действия, которые будет выполняться при условии, что все данные получены. А так же условия присвоения категорий из [[QAS. UPS руководство по работе с интерфейсом|QAS]] для выполнения консультаций. Напоминаем, что 

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

- сказать,

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

- передача диалога.

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

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

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

- из внешнего источника — в этом случае можно подключить скрипты-интеграций для выполнения необходимых действий, если они есть,<blockquote>
'''Удалить''' лишнюю фразу можно, кликнув на поле с этой фразой правой клавишей мыши и в появившемся меню выбрать «Удалить фразу».</blockquote>
Затем в параметре «Дополнительно» можно настроить интервал времени, когда это действие выполнять.<blockquote>''Примечание: допускается запись фраз шаблоном - [Уточните|Подскажите] что вас интересует по...? - и бот случайным образом будет выбирать слова из скобок и строить фразу.''</blockquote>[[Файл:Тест-чат.png|мини|''<small>Рис. 15 Окно чата для тестирования робота</small>'']]


''Условия присвоения категорий.'' По клику на эту кнопку раскрывается меню (рис. 13), в котором есть выпадающий список со всеми категориями из [[QAS. UPS руководство по работе с интерфейсом|QAS]], а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ».<blockquote>На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ». </blockquote>

''Условия запуска.'' Для каждого действия есть возможность настроить свои условия. Если нажать на кнопку «Условия запуска» (рис. 14), откроется меню, в котором можно задать условия для выполнения действия. Этих условий может не быть, либо они могут быть представлены одним элементом данных, либо сочетанием нескольких элементов, связанных логическим оператором «И». Также можно указать несколько условий, объединённых логическим оператором «ИЛИ». Каждый элемент условия имеет один из типов:

''Интервал'' — можно задать интервал времени, в который будет отрабатываться действие, например: утро, день, вечер, ночь.[[Файл:2024-09-20 18-12-04.png|мини|''<small>Рис. 16.1 Пример работы с отладчиком</small>'']]''Переменные'' — служат для хранения данных, полученных из API или по каналам, запущенным извне. Например, это может быть ID пользователя в Telegram или CID из телефонного канала, то есть определившийся номер телефона.

''Данные'' — элемент данных, полученный от моделей SMC или SEE.<blockquote>
Ситуация 1.

Например, если абонент хочет узнать статус своего заявления, робот может спросить: «Назовите код вашего заявления?». В ответ абонент может сказать, что не знает, где найти этот код.[[Файл:2024-09-20 18-12-24.png|мини|''<small>Рис. 16.2 Работа с отладчиком. Просмотр параметра data</small>'']]Чтобы отработать такую ситуацию, в раздел «Действия» необходимо добавить справочную информацию о том, где можно найти код (рис. 14). Также следует добавить элемент данных, например «Не знаю код» (модель SEE). В таком случае, если получаем от модели «Не знаю код» тег, абоненту будет отдана информация о том, где он может посмотреть код и назвать его.

Ситуация 2.

Код для проверки статуса должен состоять из семи символов. Если абонент вводит или произносит меньшее или большее количество символов, можно настроить систему так, чтобы она выдавала ему соответствующее сообщение, например: «Обратите внимание, код должен включать семь цифр». Для этого необходимо настроить следующее условие (рис. 16.1):

1. Определить элемент данных, который отвечает за отслеживание цифр (код). В нашем случае это модель SEE number и элемент данных «Код заявления».[[Файл:2024-09-20 18-15-40.png|мини|''<small>Рис. 17 Просмотр параметра reply</small>'']][[Файл:Photo 2025-03-07 15-40-52.jpg|мини|''<small>Рис. 18 Тестирование робота с помощью микрофона.</small>'']]2. Настроить условие, согласно которому при ответе пользователя будет сравниваться длина ответа с заданными параметрами: больше или меньше 7.

В этом случае, если абонент введёт код, содержащий меньше или больше 7 символов, ему будет выдано сообщение о том, что код заявления введён неправильно.</blockquote>

'''При необходимости вы можете менять порядок действий, просто удерживая левую кнопку мыши и перемещая их в нужное место.'''

=== Тестирование робота ===
В интерфейсе SES есть чат с отладчиком (рис. 15), где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок [[Файл:Чат.png|безрамки|20x20px]] в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка '''«Перезапустить сессию»''' [[Файл:Обновить данные вопроса.png|безрамки|20x20px]], которая сбрасывает всю переписку и данные отладчика. А слева — кнопка '''«Данные сессии»''' [[Файл:Кнопка отладчик без полей.png|безрамки|20x20px]], предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS. А так же параметр ''data'', раскрыв который можно увидеть все классы (рис. 16.1 и 16.2), которые пришли от модели [[SMC. UPS руководство по работе с интерфейсом|SMC]] и/или модели [[SEE. UPS руководство по работе с интерфейсом|SEE]] и их достоверность, раскрыв в ''data'' параметр ''reply'' (рис. 17).

Робота можно протестировать, задавая вопросы голосом и/или вводя переменные. Например, можно проверить, как робот отправляет в разные  конечные точки, получая одинаковые метки от SMC и номера телефонов различных ведомств. Например, метка «Мобилизация» от SMC в сочетании с номером телефона МФЦ приводит в КТ Консультация ЧаВО, а «Мобилизация» и номер единого контактного центра (ЕКЦ) — в КТ Перевод на оператора. Чтобы провести тестирование робота с переменными раскройте меню, кликнув на стрелочку над полем «Напишите вопрос» (рис. 16) и заполните поля:

- Переменная: введите название переменной.

- Значение: укажите значение этой переменной.
[[Файл:Photo 2025-03-07 15-40-57.jpg|мини|''<small>Рис. 19 Иллюстрация тестирования канала voice.</small>'']]
В этом же меню вы можете настроить параметры аудиоответов и автовоспроизведения. 

Если вы активируете опцию «Аудиоответы», то будете получать от робота голосовые ответы. В противном случае ответы будут в текстовом формате.

Отметка «Автовоспроизведение» позволит автоматически воспроизводить голосовой ответ робота.

Чтобы протестировать робота с помощью голоса, нужно нажать и удерживать кнопку [[Файл:Микрофон 1.png|безрамки|20x20пкс]]. Для работы этой кнопки необходим доступ к UPS через протокол HTTPS. Вы можете настроить такой доступ, используя любой веб-сервер, например, nginx или apache. В случае, если нет галочки «Аудиоответы», то бот будет отвечать текстом (рис. 18).  

В дебаггере есть функция, позволяющая протестировать голосовой канал (рис. 19), то есть имитировать звонок. Чтобы запустить процесс, достаточно нажать на кнопку «Начать разговор» [[Файл:Начать разговор.png|безрамки|20x20пкс]] . Пока разговор активен, кнопка изменится на «Закончить разговор» [[Файл:Закончить разговор.png|безрамки|20x20пкс]] . 
=== Панель управления SES ===
Панель управления SES включает в себя 5 кнопок: обнулить черновик рабочей версией, применить, восстановить, применить настройки робота и меню пользователя.

{| class="wikitable"
|+''<small>Табл. 2 Описание функционала панели управления.</small>''
!'''Иконка кнопки'''
!'''Название иконки'''
!'''Описание'''
|-
|[[Файл:Стрелка.png|безрамки|40x40px|центр]]
|Обнулить черновик рабочей версией
|Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений.
|-
|[[Файл:Применить.png|безрамки|40x40px|центр]]
|Применить
|По нажатию на эту кнопку черновая версия робота становится рабочей. 
|-
|[[Файл:Откат.png|центр|безрамки|40x40px]]
|Восстановить
|С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной.
|-
|[[Файл:Разетка.png|центр|безрамки|40x40px]]
|Применить настройки робота
|Эта кнопка позволяет применять изменения к роботу в фоновом режиме. Это означает, что если во время диалога между пользователем и ботом были внесены изменения в настройки, то после нажатия на эту кнопку пользователь сможет продолжить общение с ботом, но уже с обновлёнными параметрами.
|-
|[[Файл:Меню пользователя new.png|безрамки|40x40px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы, убрать/показать фон). А так же переключить отображение рабочей области с табличного на облачный и наоборот.
|}

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