Флора AI - Вклад [ru]

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

2026-03-30T09:03:40Z

E.Elagina: /* Панель управления вкладки «Данные» сервиса SMC */

=='''Классификатор (SMC)'''==

[[Файл:Главный экран.png|мини|''Рис. 1. Иконки начального экран UPS.''|граница]]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# SMC Классификатор,
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#Работа с сервисом исходящих обзвонов «Информатор»|CLS Информатор]],
# Выход.
[[Файл:Раб экран классификатора.png|мини|''Рис. 2. Рабочая область «SMC»'']]

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20пкс]] (см. табл. 2).
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).
Рабочая область '''«SMC»''' включает в себя (рис. 2):
*панель управления,
*кнопки переключения между версиями моделей,
* блоки для работы с моделями и данными,
*информация о текущей модели,
*информацию об обучении и тестировании, для обученных и протестированных моделей,
*информационные вкладки.
[[Файл:Model info smc.png|мини|''Рис. 3 Информационный блок о модели.'']]
В блоке интерфейса '''«Классификатор»''' есть 3 вкладки:

1. '''«Модели»''' – содержит все созданные модели SMC списком в алфавитном порядке. Модели с постобработкой помечены значком [[Файл:Подсказка.jpg|безрамки|20x20пкс]].

2. '''«Данные»''' – содержит все корпуса данных SMC списком в алфавитном порядке.

3. '''«Метки»''' – содержит все словари меток SMC.
===Функционал вкладки «Модели» ===
Во вкладке '''«Модели»''' доступен просмотр информации о модели, а именно:
*название модели,
*версия модели: ''черновик'', ''рабочая'', ''архив'' (табл. 1),
*статус модели.
{| class="wikitable"
|+''Табл. 1. Версии модели.''
!'''Иконка версии'''
!'''Наименование версии модели'''
!'''Описание'''
|-
|[[Файл:Черновик.png|безрамки|40x40px|центр]]
|Черновик

|это не примененная модель. Можно обучать, переобучать, тестировать, устанавливать и применять. Можно экспортировать и импортировать. Цвет акцента версии модели - серый. После применения (установки) модель (см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Модели» SMC|табл.2]] «Установка») становится «Рабочей версией».
|-
|[[Файл:Рабочая нов.png|безрамки|40x40px|центр]]
|Рабочая

|это модель, которая уже используется в прод (англ. ''production –'' производство'')''. Применённую модель нельзя установить заново или обучить. Можно провести ручное тестирование и проверить конкретные фразы (см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Модели» SMC|табл.2]] «Ручная проверка»). Можно экспортировать модель. Цвет акцента версии модели - зелёный. По нажатию кнопки «Архив»- «Рабочая» модель переходит в архивную версию.
|-
|[[Файл:Архив нов.png|безрамки|40x40px|центр]]
|Архивная

|это рабочая модель, которая переводится в архив (резервную копию) после применения черновика. Можно вернуть архивную модель в рабочую версию, нажав на кнопку «Откат». При этом рабочая версия также становится архивной, то есть рабочая и архивная версии меняются местами. Цвет акцента версии модели - синий.
|}[[Файл:Model status.png|мини|''Рис. 4. Примеры статусов модели.'']]Модель SMC имеет свойство '''«Статус»''' (рис. 4), которые принимает следующие значения:
*''Обучение''. Это модель, которая в данный момент обучается.
* ''Обучена''. Доступен просмотр информации о точности обучения, параметрах модели и матрица ошибок.
*''Тестирование.'' Это модель, которая в данный момент тестируется.
*''Протестирована''. Появляются доп. кнопки '''«Обучение»''' и '''«Тест»''' (под матрицей ошибок), нажав на которые можно посмотреть матрицу обучения и тестирования соответственно.
*''Установлена.'' В этот статус модель переходит при нажатии кнопки «'''Установка»'''. В этом статусе возможны ''Импорт'', ''Экспорт'', ''Обучение'', ''Ручная'' ''проверка'', ''Применение'' модели – по соответствующим кнопкам на панели управления.
*''Применена.'' В статус ''Применена'' модель переходит при нажатии кнопки «'''Применение»'''. Для модели в статусе ''Применена'' возможны только – ''Ручная проверка'' конкретной фразой по кнопке «'''Ручная проверка»''' и ''экспорт'' (выгрузка) по кнопке «'''Экспорт»''' (см. [[SMC. UPS руководство по работе с интерфейсом|табл. 2]]).
*''Ошибка''. Информирует о сбое процессов импорта, обучения, тестирования, остановки обучения. <blockquote>'''''Пустые модели больше не отображаются в интерфейсе.'''''</blockquote>

Возможны ''манипуляции'' с моделями SMC:
*удаление модели, удаляется текущая версия модели,
*добавление новой модели SMC, нажмите кнопку '''«Добавить новую модель»'''. Далее доступны два способа:
*# Из файла: загрузите архив с готовой моделью.
*# Обучить модель: создайте модель с нуля, выбрав для обучения либо корпус текстов, либо словарь меток.
====Панель управления вкладки «Модели» SMC====
В правом верхнем углу экрана располагается панель управления для вкладки '''«Модели»'''. На ней располагаются кнопки из таблицы 2. Цвет кнопок указывает на доступность действия для данной модели: синий означает, что кнопка активна, а голубой - что она неактивна.

{| class="wikitable"
|+''Табл. 2. Описание функционала панели управления на вкладке «Модели».''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать(выгрузить) модель SMC.
|-
|[[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|позволяет импортировать (добавить) модель SMC.
|-
|[[Файл:Обучение.png|безрамки|40x40px|центр]]
|Обучение
|позволяет обучить модель SMC, выбрав данные для обучения из выпадающего списка. И затем следует выбрать метод обучения — по корпусу или по меткам (подробнее см. разд. [[SMC. UPS руководство по работе с интерфейсом|Функционал вкладки Метки]]). Обучение на словаре меток имеет преимущества перед корпусом в том, что обучение модели происходит в разы быстрее.
|-
|[[Файл:Обновление групп.png|безрамки|40x40px|центр]]
|Обновление групп в модели
|позволяет обновить группы в модели SMC. При нажатии на кнопку – открывается форма для указания корпуса.
|-
|[[Файл:Тестирование.png|безрамки|40x40px|центр]]
|Тестирование
|позволяет протестировать модель SMC корпусом данных. При нажатии на кнопку – открывается форма для указания корпуса, с помощью которого нужно протестировать модель.
|-
|[[Файл:Ручная проверка.png|безрамки|40x40px|центр]]
|Ручная проверка1
|позволяет протестировать модель SMC конкретной фразой, увидеть величину достоверности каждого класса, определенного системой.
|-
|[[Файл:Установка обработчика в рабочую версию модели.png|безрамки|40x40px|центр]]
|Установка обработчика в рабочую версию модели
|позволяет перезаписать обработчик на применяемой модели без перевода из тестового режима, если изменился только обработчик, а корпус остался прежним.
|-
|[[Файл:Установка.png|безрамки|40x40px|центр]]
|Установка
|переводит модель SMC в статус ''установлена''. После чего кнопка меняется на кнопку «Применение»[[Файл:Primenenie.png|безрамки|20x20px]] . Пока модель не применена (не используется), можно ее ''обучить'', ''протестировать'', ''экспортировать'' или ''импортировать'' данные. После того как модель начинает использоваться, возможность ее обучения или изменения исчезает. Остается возможность ''экспорта'' и ''ручной проверки'' модели.
|-
|[[Файл:Откат.png|безрамки|40x40px|центр]]
|Откат
|позволяет перевести архивную версию модели SMC обратно в рабочую.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:2025-04-15 14-31-32.png|мини|''Рис. 5. Диалоговое окно режима «Ручная проверка».'']]
1 Режим '''«Ручная проверка».'''

Как описано в таблице 2 этот режим позволяет протестировать модель SMC конкретной фразой. При нажатии на кнопку открывается диалоговое окно со следующими вкладками:
*классификация,
*прочее.

Вкладка '''классификация''' содержит поля:
*''текст'' - в это поле записывается фраза для проверки;
*''порог доверия -'' показатель, отражающий степень уверенности в принадлежности новой фразы к конкретному классу (рис. 6). Другими словами, пороговое значение указывает, при какой минимальной вероятности полагаем, что фраза относится к определённому классу.
*Функция ''коррекции'' предназначена для исправления опечаток в тексте. Существует три режима работы этой функции, каждый из которых определяет допустимое количество ошибок в слове:
**'''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)[[Файл:2025-04-15 14-35-46.png|мини|''Рис. 6. Функционал вкладки Классификация.'']]
**'''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
**'''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
**либо коррекция может '''Отсутствовать'''.
<blockquote>'''Важно:''' Эти режимы действуют только при коррекции по словарю модели. Поскольку идет сравнение слова с опечаткой со словом из словаря без ошибок.</blockquote>Есть галочка '''расширенный режим -''' позволяет обратиться сразу к нескольким моделям SMC. После нажатия на кнопку '''классифицировать''', выводится результат - метки классов, которые модель смогла распознать.

Классификатор (SMC) также выводит следующую информацию:

1. '''Классы''': здесь отображается название класса, к которому был отнесен текст, и вероятность его принадлежности к этому классу.

2. '''Группы''': отображается название группы и число совпавших классов. Если метки совпадают с несколькими группами, они отображаются в порядке убывания числа совпавших классов (т.е. чем полнее группа, тем выше ее позиция в списке).

3. '''Ближайшие группы''': отображаются группы, до которых не хватает всего одной метки, с указанием процента заполненности и сортировкой по убыванию этого процента.

Вкладка '''прочее''' SMC Классификатора включает в себя несколько опций: ''анализ на эмоциональность'', ''пунктуация, анализ токсичности'' и ''коррекция ошибок, обратная нормализация, сжатие'''''.'''

[[Файл:Информационные вкладки тест.jpg|мини|''Рис. 7. Интерфейс раздела «Классификатор»: Информационные вкладки для протестированной модели.'']]
====Информационные вкладки SMC: Сервер, Ошибки, Логи, Постобработка====
Справа на экране располагаются информационные вкладки (рис. 7)
*'''«Серверы»''' – отображает информацию о серверах и процессах,
*'''«Ошибки разметки»''' – в этот раздел попадают фразы и метки, предположительно с ошибкой разметки, то есть те, что вызвали сложности у модели. Это может быть связано с недостаточным количеством данных с этими метками в корпусе (так называемые «слабые данные»), либо наиболее часто встречающаяся - с действительной проблемой в процессе разметки данных (то есть, недостающая метка или избыточная),
*'''«Ошибки обучения»''' – отображает информацию об ошибках обучения для модели в состоянии «Обучена», те фразы, которыми модель так и не обучилась. Также можно, находясь на вкладке '''«Ошибки обучения»''' использовать метод '''«Ручная проверка»''',
*'''«Ошибки тестирования»''' – доступны для модели в состоянии ''Протестирована'' – отображает информацию об ошибках тестирования. Можно выгрузить ошибки в файл с помощью кнопки '''«Экспорт»'''. Есть возможность преобразовать ошибки в данные корпуса,
* '''«Логи»''' – отображают логи процессов обучения, тестирования, точности обучения на разных этапах обучения,
*'''«Постобработка»''' – редактор для написания кода handler.py.
[[Файл:Data screen new.png|мини|''Рис. 8. Интерфейс вкладки данные с родительскими и дочерними вкладками'']]
[[Файл:2025-12-11 10-52-07.png|мини|''Рис. 9 Интерфейс вкладки данные'']]
[[Файл:Data corpus info.jpg|мини|''Рис. 10. Информация о корпусе данных.'']]
===Функционал вкладки «Данные» SMC ===
Вкладка '''«Данные» SMC''' (рис. 8) содержит список всех доступных корпусов данных. При выборе различных корпусов данных можно просмотреть информацию о них (рис. 10):

• '''Название корпуса''': можно изменить с помощью иконки '''«Карандаш».''' Можно удалить корпус с помощью иконки '''«Корзина»''' (см. рис. 10).

• '''Количество строк''' – общее количество фраз в корпусе.

• '''Количество классов''' – общее количество классов в корпусе.

• '''Количество групп''' – отображает общее количества групп в корпусе данных (подробнее см. раздел ''[[SMC. UPS руководство по работе с интерфейсом#Описание подготовки и этапов разметки корпуса данных SMC|«Описание подготовки и этапов разметки корпуса данных SMC»]]'').[[Файл:Род класс.png|мини|''Рис. 11. Создание родительского класса.'']]Под информационным блоком о корпусе данных SMC есть '''список классов''', в котором содержатся названия классов и информация о количестве фраз в каждом классе. Можно удалять и добавлять классы. В самом низу списка есть меню для '''''Экспорт списка классов''''' в формате csv. Есть возможность ''скрыть'' блок с корпусами данных, нажав на стрелочку между блоком корпусов и информационным блоком корпуса. Существует три вида (ранга) классов (меток):
#Обычный класс — это класс, который не относится ни к одному из родительских классов.
#Родительский класс — это класс, который включает в себя другие классы. Например, родительский класс «Паспорт» включает в себя два класса-потомка: «паспорт рф_о» и «загранпаспорт_о».
#Класс-потомок — это класс, который относится к какому-либо родительскому классу.

Чтобы преобразовать обычный класс в родительский, нужно выбрать его в списке классов и нажать на самую правую иконку в виде папки (рис. 11), которая говорит '''«Сделать класс родительским»'''. Чтобы добавить метку в родительский класс, нужно нажать правой кнопкой мыши на метку и выбрать нужный родительский класс из появившегося списка. После этого появится диалоговое окно, подтверждающее действие, и изменения вступят в силу (см. рис. 12). Метка станет классом-потомком.[[Файл:Перемещение метки в род.класс.png|мини|''Рис. 12. Перемещение метки в родительский класс.'']]

Удалить родительскую метку, в отличие от обычной, просто так нельзя. Сначала ее нужно вернуть в статус обычной, нажав на иконку '''«Сделать класс обычным»''' напротив нужного класса (рис. 13). После этого она будет расформирована и ее можно будет удалить.

==== Добавление нового корпуса ====
[[Файл:Сделать класс обчным.png|мини|''Рис. 13. Сделать родительский класс обычным.'']]Для создания нового корпуса данных SMC выполните следующие шаги:

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

После создания корпуса вы можете заполнить его данными одним из следующих способов:

'''1. Ручное добавление'''

* В нижней части экрана находится форма для ввода текста.
* Добавляйте фразы вручную и сразу выполняйте их разметку в интерфейсе.

'''2. Импорт данных'''

Нажмите кнопку «Импорт» и выберите подходящий источник:

* Логи из модели. Создаёт корпус на основе логов рабочей версии и черновых моделей.
* Из ЧаВО. Позволяет загрузить все вопросы из базы знаний QAS. Как использовать:
*# Введите название корпуса.
*# Нажмите кнопку «Добавить». В результате будет создан корпус, где вопросам из QAS соответствуют метки их категорий.
* Из файла. Загрузите данные из CSV-файла, подготовленного по шаблону системы.
* Из корпуса. Скопируйте данные из существующего в системе корпуса в новый.

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

При включении флага '''«Показать определившиеся группы»''' слева появится третий столбец «Группа». В нём будет отображаться название группы, назначенной для данной фразы. Это работает, если у вас создан список групп и заданы комбинации классов, которые в них входят.

Вы можете редактировать группы меток непосредственно в таблице данных:

* Создание или изменение групп
** Введите название новой группы или выберите существующую для одной или нескольких (предварительно выделив галочками) строк таблицы.
** Изменения автоматически синхронизируются с таблицей групп.
* Массовое присвоение групп для выбранных строк
** Выделите нужные строки в таблице.
** Присвойте им группу, внизу появится форма с функцией «Изменить группу»:
*** Для строк '''без группы''' — будет '''установлена''' выбранная группа.
*** Для строк с уже '''назначенной''' группой — группа будет '''переопределена''' на новую.

[[Файл:2024-05-21 12-03-29.png|мини|''Рис. 14. Возможности фильтрации.'']]

Можно ''фильтровать'' (рис. 14):

1. по названию класса,

2. по фразе или слову,

3. для более точной фильтрации можно использовать переключатель «и», «или», «кроме» и «только».

Есть возможность ''редактировать фразу'' в корпусе: вносить изменения в поле с фразой и ''сохранять'' изменения (кнопка '''«Дискета»''' на панели управления). Можно ''дополнять'' корпус данных по кнопке '''«Импорт»''' на панели управления (подробнее см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Данные» сервиса SMC|описание функций панели управления]]). '''После дополнения не забудьте сохранить изменения.''' ''Удаление'' фраз из корпуса возможно как по одной, так и сразу несколько, для этого нужно выделить необходимые для удаления фразы и нажать на красную иконку '''«Корзина»''' в правом нижнем углу блока работы с данными.[[Файл:Разм данных новая.png|мини|''Рис. 15. Добавление и разметка фраз.'']]

Можно вручную ''добавлять'' фразы в корпус по одной или сразу несколько (каждая фраза с новой строки, enter в конце каждой фразы)(рис. 15), записав их в поле '''«Фразы»''' в нижней части блока для работы с данными. Можно ''назначить'' или ''изменить'' классы (метки) для фразы, указав новый в поле '''«Класс»''' или выбрав существующий класс из выпадающего списка. Метки классов могут быть больше чем одна на одну фразу (мультиклассовая классификация). <blockquote>Рассмотрим пример разметки новой фразы. Допустим мы хотим добавить вручную две фразы:
#''«Здравствуйте, у меня возникли неполадки, возникающие во время установки SBS. Помогите решить проблему. Заранее спасибо.»''
#''«Добрый день, у меня появляется ошибка при установке биометрии. Заранее благодарю за ответ.»''
Разметка производится исходя из того '''«о чем эта фраза?»''', задача разметки в том, чтобы помочь модели понять суть фразы. Например, во фразах выше говорится об ''ошибках во время установки сервиса биометрии'', так же присутствует ''благодарность'' и ''приветствие,'' соответственно метки будут: ''SBS, ошибка, установка_ПО, благодарность, приветствие.''

'''ВАЖНО''': соблюдать однозначность в корпусе.</blockquote>[[Файл:Добавить общий класс.png|мини|''Рис. 16(а). Добавление общего класса.'']]Имеется функция '''«Добавить общий класс»'''. С ее помощью можно присвоить одну или несколько общих меток сразу нескольким выбранным из списка фразам (рис. 16 (а)), если была допущена ошибка при разметке фраз. Для изменения набора меток у одной фразы нужно всего лишь один раз щелкнуть на список классов и добавить нужную метку из выпадающего списка или навести курсор на лишнюю метку и, также щелкнув, удалить ее. Если необходимо удалить сразу несколько меток с фразы или нескольких фраз, под кнопкой '''«Добавить общий класс»''' есть кнопка '''«Удалить классы»''' (рис. 16 (б)). Сначала выделите нужные фразы, а затем выберите класс (классы), которые вы хотите удалить из выпадающего списка, и кликните по кнопке «Удалить классы».

[[Файл:Удаление нескольких классов 1.jpg|мини|''Рис. 16(б). Удаление нескольких классов.'']][[Файл:Объединение меток разных род.классов.png|мини|''Рис. 17. Объединение меток разных родительских классов.'']]Кроме того, существует еще одна полезная функция для работы в корпусе данных SMC — '''«объединить метки»'''. Для лучшего понимания рассмотрим пример. Предположим, у вас есть две метки с одинаковым названием — «версия» и «версия», но в одном случае название содержит английскую «е», а в другом — русскую (классы отображаются в алфавитном порядке, метка с английскими буквами будет нарушать его). И этими метками уже помечены некоторые фразы. Чтобы решить эту проблему, можно воспользоваться функцией '''«объединения»'''. Необходимо скопировать название правильной метки из списка меток («карандаш» — выделить название), затем нажать на «карандаш» напротив неправильной метки и заменить ее названием корректной метки. После этого метки объединятся и останется только корректная метка. Если эти метки принадлежат какой-либо группе, то замена произойдет и в ней. Возможность объединения групп также предусмотрена и осуществляется по такому же алгоритму.

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

==== Работа с группами классов ====
Интерфейс вкладки «Группы» аналогичен вкладке «Данные». Панель управления описана в таблице 3.

'''Основные функции вкладки:'''

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

'''Фильтрация и поиск:'''

* Фильтруйте данные по группам и классам.
* Для точной настройки фильтра используйте правую панель с операторами: «И», «ИЛИ», «Кроме», «Только».
* Для отображения повторяющихся строк включите флажок '''«Показать дубликаты»''' и выбрав одну из опций: полные (будут отображены полные дубли) и классов (отобразятся дубли по комбинации классов).

'''Массовые операции с группами:'''

# Выделите нужные группы с помощью флажков.
# В нижней части окна появится меню для массовых действий:
#* Добавить класс: выбранный класс будет добавлен ко всем выделенным группам.
#* Удалить класс: выбранный класс будет удален из всех выделенных групп.
#* Копировать: создание копий выделенных групп в одном из трёх режимов:
#** Простое копирование.
#** Копирование с добавлением выбранного класса.
#** Копирование с удалением выбранного класса.

'''Обновление модели после изменения групп'''

Если вы внесли изменения в состав или названия групп, необходимо применить эти изменения к работающей модели.

# Нажмите кнопку '''«Обновление групп в модели»''' на панели управления.
# Модель классификатора будет дообучена с учётом внесённых правок без необходимости полного повторного обучения.

<blockquote>'''Важно''': Эта операция необходима после переименования групп, массового добавления/удаления классов или изменения состава групп, чтобы модель начала учитывать новые правила.</blockquote>

==== Описание подготовки и этапов разметки корпуса данных ====
Классификатор SMC использует '''мультиклассовый подход''': одна текстовая фраза может быть отнесена одновременно к нескольким классам (меткам).

Процесс подготовки данных состоит из двух ключевых этапов (вы можете выполнить оба или только один из них):

'''Разметка фраз классами'''

При добавлении новой фразы необходимо назначить ей один или несколько классов.

* Выбор существующего класса: укажите нужные классы из выпадающего списка «Классы».
* Создание нового класса: введите название нового класса в поле «Класс» и нажмите кнопку «Добавить новый класс».

<blockquote>Подробное описание функционала вкладки «Данные» и пример разметки новой фразы представлены в соответствующем разделе инструкции.</blockquote>'''Группировка классов'''

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

* Назначение: Группировка помогает модели без дообучения определять, к какой группе классов принадлежит новая, ранее не встречавшаяся фраза.
* Результат: Формируются группы, которые агрегируют несколько отдельных классов (меток) и используются для конечного ответа.

====Панель управления вкладки «Данные» сервиса SMC====
Панель управления на вкладке '''«Данные»''' отличается своими функциями. В таблице 3 представлен список кнопок.

{| class="wikitable"
|+''Табл. 3 Описание функционала панели инструментов вкладки «Данные»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
! '''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать (выгрузить) корпус данных.
|-
| [[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|позволяет импортировать данные из внешнего файла, логов обращений к модели, уже существующего в системе корпуса или базы знаний ЧаВО.
Если выбран вариант «Из файла», нужно выбрать файл для загрузки. Поддерживаемые форматы файлов: csv, txt. Кодировка — UTF-8.

Затем можно выбрать действие: дополнить или заменить. Если выбрано «дополнить», данные текущего корпуса будут дополнены данными из файла или корпуса.

Если выбрано «заменить», данные текущего корпуса будут полностью заменены данными из файла или корпуса.
|-
|[[Файл:Копировать.png|безрамки|40x40px|центр]]
|Копировать
|позволяет скопировать корпус данных.
|-
|[[Файл:Сохранить.png|безрамки|40x40px|центр]]
|Сохранить
|сохранение изменений.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Функционал вкладки «Метки» ===
[[Файл:2024-10-15 11-23-22.png|мини|''Рис. 19. Интерфейс вкладки Метки.'']]Интерфейс вкладки «Метки» представлен на рисунке 19. Слева вы увидите список всех доступных словарей. Чтобы открыть один из них, просто нажмите на его название — и в центральной части экрана появится сам словарь.

Процесс добавления нового словаря состоит из двух простых шагов:

1. Нажмите на кнопку «Добавить словарь меток», расположенную в нижней левой части экрана. В появившемся диалоговом окне введите название нового словаря.

2. Затем добавьте данные в словарь: укажите название метки и пороговое значение коэффициента достоверности в левой части таблицы и её определяющие фразы в правой части таблицы. Более подробную информацию вы найдёте в разделе [[SMC. UPS руководство по работе с интерфейсом#Подготовка словаря меток|«Подготовка словаря меток»]]. Если у вас уже есть файл с описанием меток, вы можете воспользоваться кнопкой Импорт на панели управления (см. раздел [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Метки»|Панель управления вкладки «Метки»]]).

==== Подготовка словаря меток ====

Подготовка словаря меток включает в себя определение набора требуемых меток под конкретную задачу. После этого нужно в описание каждой метки добавить все возможные определяющие фразы, которые однозначно определяют эту метку, каждое слово (фраза) с новой строки. Не нужно добавлять целые фразы, как это делается при разметке SMC. Принцип описания больше похож на разметку SEE корпуса: просто укажите ключевые слова или словосочетания, которые определяют данную метку, а также все, что хотите отнести к этой метке. <blockquote>Например, мы создаем метку «Документация» и в определяющих фразах указываем все возможные варианты, которые однозначно описывают эту метку с новой строки: «дока», «инструкция», «документация», «мануал».</blockquote>Подготовленный для импорта документ должен быть в формате csv. И иметь следующую структуру:<blockquote>Метка<TAB>Описание 1, Описание 2, ..., Описание N<TAB>Порог</blockquote>Пороговое значение в файле указывается в диапазоне [0,1]. Далее при необходимости это значение можно будет поменять в интерфейсе.

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

Чтобы ''удалить'' лишнюю фразу или метку - наведите курсор на выбранную строку и нажмите на появившуюся иконку корзинки в конце строки [[Файл:Delete icon.png|безрамки|18x18пкс]]. Не забудьте сохранить изменения.

Также сверху таблицы словаря меток располагается поле ввода "Поиск по фразе". При ее заполнении будут отфильтровываться метки, содержащие введенную фразу (левая таблица), и совпадения по фразе в выбранной метке (правая таблица).

==== Панель управления вкладки «Метки» ====

Описание функционала панели управления на вкладке '''«Метки»''' представлено в таблице 4.
{| class="wikitable"
|+''Табл. 4 Описание функционала панели инструментов вкладки «Метки»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
! '''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать (выгрузить) словарь меток.
|-
| [[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|Позволяет импортировать (добавлять) данные из файла. По нажатию на кнопку появится диалоговое окно, в котором требуется выбрать файл с компьютера в формате csv.
|-
|[[Файл:Сохранить.png|безрамки|40x40px|центр]]
|Сохранить
|сохранение изменений.
|-
|[[Файл:Удаление_документа.png|центр|безрамки|40x40пкс]]
|Удалить
|позволяет удалить выбранный словарь меток.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

===Работа с ошибками SMC===
[[Файл:Ошиб тест тип 1.png|мини|''Рис. 20. Иллюстрация ошибки тестирования первого типа.'']][[Файл:Ошибка тест тип 1 3.png|мини|''Рис. 21. Обогащение корпуса данных.'']]Во время работы с классификатором, вы можете столкнуться с 3-мя видами ошибок:
*ошибки разметки;
*ошибки обучения;
*ошибки тестирования.

Как описано выше в разделе «''Информационные вкладки: Сервер, Ошибки, Логи, Постобработка» -'' '''«ошибки разметки»''' – раздел куда попадают фразы и метки, предположительно с ошибкой разметки, то есть те, что вызвали сложности у модели. Это может быть связано с недостаточным количеством данных с этими метками в корпусе (так называемые «слабые данные»), либо наиболее часто встречающаяся - с действительной проблемой в процессе разметки данных (то есть, недостающая метка или избыточная). Вкладка '''«ошибки обучения»''' – отображает информацию об ошибках обучения для модели в состоянии '''«Обучена»''', те фразы, которыми модель так и не обучилась.

'''«Ошибки тестирования»''' являются наиболее сложными и делятся на два основных типа:
# нехватка данных, тогда необходимо обогатить корпус данных фразами и разметкой;
#нехватка комбинаций меток для группы.
[[Файл:Ошибка тест тип 2.png|мини|''Рис. 22. Иллюстрация ошибки тестирования второго типа.'']]

'''Пример ошибки типа 1. Нехватка данных.'''

Есть фраза «Директор МФЦ иркутской области» - модель классифицирует ее неправильно, на скриншоте (см. рис. 20) этой фразе присвоены метки: ''Иркутская область_о, как_в, губернатор_о'' Это происходит из-за того, что ''директор'' и ''губернатор'' - имеют семантическое сходство, так как являются руководителями. Но в связке с Иркутской областью - упоминания директора в корпусе не было. Поэтому модель исходя из имеющихся у нее данных - определила для этой фразы - метку губернатор_о. Группа: ''кто является губернатором иркутской области района.''

Если мы отфильтруем корпус данных по слову ''директор,'' то увидим, что в корпусе отсутствуют фразы где и ''директор'' и ''иркутская область'' упоминались бы одновременно, а так же не была определена метка ''мфц_о,'' следовательно фразы ''директор мфц'' (дополнительно добавленная выделенная фраза) тоже не хватало (см. рис. 21). Нужно добавить эти фразы в корпус, сохранить изменения, переобучить модель, так как вносились изменения в данные, и ошибка будет устранена.[[Файл:Ошибка тест тип 2 нов.png|мини|''Рис. 23. Добавление новой комбинации меток для группы.'']]'''Пример ошибки типа 2. Нехватка комбинаций меток для группы.'''

Имеется фраза ''«а какие документы нужно подать для оформления путевки инвалиду»''. Проводим тестирование в ручном режиме и видим, что этой фразе не присвоена ни одна группа, а значит нет конечной точки, которой бы соответствовал полученный от модели набор меток. (см. рис. 22).

Переходим во вкладку '''Данные''', выбираем нужный корпус данных, идем во вкладку '''Группы'''. Далее фильтруем группы по '''Классам''': инвалидность_о, путевка в санаторий_о переводим '''переключатель''' справа в положение ''«и»'' (см. рис. 23) и смотрим, что у нас отсутствует комбинация меток: с подачей документов. Добавляем еще одну комбинацию (см. рис. 23), сохраняем изменения, переходим во вкладку Модели, кликаем на кнопку [[Файл:Обновление групп.png|безрамки|20x20px]] «Обновление групп», в диалоговом окне выбираем модель и нажимаем кнопку обновить - ошибка устранена. Переобучать модель не нужно, кнопка «Обновление групп» позволяет внести изменения без переобучения.

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

2026-03-27T06:15:12Z

E.Elagina: /* Панель управления вкладки «Модели» SMC */

=='''Классификатор (SMC)'''==

[[Файл:Главный экран.png|мини|''Рис. 1. Иконки начального экран UPS.''|граница]]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# SMC Классификатор,
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#Работа с сервисом исходящих обзвонов «Информатор»|CLS Информатор]],
# Выход.
[[Файл:Раб экран классификатора.png|мини|''Рис. 2. Рабочая область «SMC»'']]

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20пкс]] (см. табл. 2).
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).
Рабочая область '''«SMC»''' включает в себя (рис. 2):
*панель управления,
*кнопки переключения между версиями моделей,
* блоки для работы с моделями и данными,
*информация о текущей модели,
*информацию об обучении и тестировании, для обученных и протестированных моделей,
*информационные вкладки.
[[Файл:Model info smc.png|мини|''Рис. 3 Информационный блок о модели.'']]
В блоке интерфейса '''«Классификатор»''' есть 3 вкладки:

1. '''«Модели»''' – содержит все созданные модели SMC списком в алфавитном порядке. Модели с постобработкой помечены значком [[Файл:Подсказка.jpg|безрамки|20x20пкс]].

2. '''«Данные»''' – содержит все корпуса данных SMC списком в алфавитном порядке.

3. '''«Метки»''' – содержит все словари меток SMC.
===Функционал вкладки «Модели» ===
Во вкладке '''«Модели»''' доступен просмотр информации о модели, а именно:
*название модели,
*версия модели: ''черновик'', ''рабочая'', ''архив'' (табл. 1),
*статус модели.
{| class="wikitable"
|+''Табл. 1. Версии модели.''
!'''Иконка версии'''
!'''Наименование версии модели'''
!'''Описание'''
|-
|[[Файл:Черновик.png|безрамки|40x40px|центр]]
|Черновик

|это не примененная модель. Можно обучать, переобучать, тестировать, устанавливать и применять. Можно экспортировать и импортировать. Цвет акцента версии модели - серый. После применения (установки) модель (см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Модели» SMC|табл.2]] «Установка») становится «Рабочей версией».
|-
|[[Файл:Рабочая нов.png|безрамки|40x40px|центр]]
|Рабочая

|это модель, которая уже используется в прод (англ. ''production –'' производство'')''. Применённую модель нельзя установить заново или обучить. Можно провести ручное тестирование и проверить конкретные фразы (см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Модели» SMC|табл.2]] «Ручная проверка»). Можно экспортировать модель. Цвет акцента версии модели - зелёный. По нажатию кнопки «Архив»- «Рабочая» модель переходит в архивную версию.
|-
|[[Файл:Архив нов.png|безрамки|40x40px|центр]]
|Архивная

|это рабочая модель, которая переводится в архив (резервную копию) после применения черновика. Можно вернуть архивную модель в рабочую версию, нажав на кнопку «Откат». При этом рабочая версия также становится архивной, то есть рабочая и архивная версии меняются местами. Цвет акцента версии модели - синий.
|}[[Файл:Model status.png|мини|''Рис. 4. Примеры статусов модели.'']]Модель SMC имеет свойство '''«Статус»''' (рис. 4), которые принимает следующие значения:
*''Обучение''. Это модель, которая в данный момент обучается.
* ''Обучена''. Доступен просмотр информации о точности обучения, параметрах модели и матрица ошибок.
*''Тестирование.'' Это модель, которая в данный момент тестируется.
*''Протестирована''. Появляются доп. кнопки '''«Обучение»''' и '''«Тест»''' (под матрицей ошибок), нажав на которые можно посмотреть матрицу обучения и тестирования соответственно.
*''Установлена.'' В этот статус модель переходит при нажатии кнопки «'''Установка»'''. В этом статусе возможны ''Импорт'', ''Экспорт'', ''Обучение'', ''Ручная'' ''проверка'', ''Применение'' модели – по соответствующим кнопкам на панели управления.
*''Применена.'' В статус ''Применена'' модель переходит при нажатии кнопки «'''Применение»'''. Для модели в статусе ''Применена'' возможны только – ''Ручная проверка'' конкретной фразой по кнопке «'''Ручная проверка»''' и ''экспорт'' (выгрузка) по кнопке «'''Экспорт»''' (см. [[SMC. UPS руководство по работе с интерфейсом|табл. 2]]).
*''Ошибка''. Информирует о сбое процессов импорта, обучения, тестирования, остановки обучения. <blockquote>'''''Пустые модели больше не отображаются в интерфейсе.'''''</blockquote>

Возможны ''манипуляции'' с моделями SMC:
*удаление модели, удаляется текущая версия модели,
*добавление новой модели SMC, нажмите кнопку '''«Добавить новую модель»'''. Далее доступны два способа:
*# Из файла: загрузите архив с готовой моделью.
*# Обучить модель: создайте модель с нуля, выбрав для обучения либо корпус текстов, либо словарь меток.
====Панель управления вкладки «Модели» SMC====
В правом верхнем углу экрана располагается панель управления для вкладки '''«Модели»'''. На ней располагаются кнопки из таблицы 2. Цвет кнопок указывает на доступность действия для данной модели: синий означает, что кнопка активна, а голубой - что она неактивна.

{| class="wikitable"
|+''Табл. 2. Описание функционала панели управления на вкладке «Модели».''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать(выгрузить) модель SMC.
|-
|[[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|позволяет импортировать (добавить) модель SMC.
|-
|[[Файл:Обучение.png|безрамки|40x40px|центр]]
|Обучение
|позволяет обучить модель SMC, выбрав данные для обучения из выпадающего списка. И затем следует выбрать метод обучения — по корпусу или по меткам (подробнее см. разд. [[SMC. UPS руководство по работе с интерфейсом|Функционал вкладки Метки]]). Обучение на словаре меток имеет преимущества перед корпусом в том, что обучение модели происходит в разы быстрее.
|-
|[[Файл:Обновление групп.png|безрамки|40x40px|центр]]
|Обновление групп в модели
|позволяет обновить группы в модели SMC. При нажатии на кнопку – открывается форма для указания корпуса.
|-
|[[Файл:Тестирование.png|безрамки|40x40px|центр]]
|Тестирование
|позволяет протестировать модель SMC корпусом данных. При нажатии на кнопку – открывается форма для указания корпуса, с помощью которого нужно протестировать модель.
|-
|[[Файл:Ручная проверка.png|безрамки|40x40px|центр]]
|Ручная проверка1
|позволяет протестировать модель SMC конкретной фразой, увидеть величину достоверности каждого класса, определенного системой.
|-
|[[Файл:Установка обработчика в рабочую версию модели.png|безрамки|40x40px|центр]]
|Установка обработчика в рабочую версию модели
|позволяет перезаписать обработчик на применяемой модели без перевода из тестового режима, если изменился только обработчик, а корпус остался прежним.
|-
|[[Файл:Установка.png|безрамки|40x40px|центр]]
|Установка
|переводит модель SMC в статус ''установлена''. После чего кнопка меняется на кнопку «Применение»[[Файл:Primenenie.png|безрамки|20x20px]] . Пока модель не применена (не используется), можно ее ''обучить'', ''протестировать'', ''экспортировать'' или ''импортировать'' данные. После того как модель начинает использоваться, возможность ее обучения или изменения исчезает. Остается возможность ''экспорта'' и ''ручной проверки'' модели.
|-
|[[Файл:Откат.png|безрамки|40x40px|центр]]
|Откат
|позволяет перевести архивную версию модели SMC обратно в рабочую.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:2025-04-15 14-31-32.png|мини|''Рис. 5. Диалоговое окно режима «Ручная проверка».'']]
1 Режим '''«Ручная проверка».'''

Как описано в таблице 2 этот режим позволяет протестировать модель SMC конкретной фразой. При нажатии на кнопку открывается диалоговое окно со следующими вкладками:
*классификация,
*прочее.

Вкладка '''классификация''' содержит поля:
*''текст'' - в это поле записывается фраза для проверки;
*''порог доверия -'' показатель, отражающий степень уверенности в принадлежности новой фразы к конкретному классу (рис. 6). Другими словами, пороговое значение указывает, при какой минимальной вероятности полагаем, что фраза относится к определённому классу.
*Функция ''коррекции'' предназначена для исправления опечаток в тексте. Существует три режима работы этой функции, каждый из которых определяет допустимое количество ошибок в слове:
**'''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)[[Файл:2025-04-15 14-35-46.png|мини|''Рис. 6. Функционал вкладки Классификация.'']]
**'''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
**'''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
**либо коррекция может '''Отсутствовать'''.
<blockquote>'''Важно:''' Эти режимы действуют только при коррекции по словарю модели. Поскольку идет сравнение слова с опечаткой со словом из словаря без ошибок.</blockquote>Есть галочка '''расширенный режим -''' позволяет обратиться сразу к нескольким моделям SMC. После нажатия на кнопку '''классифицировать''', выводится результат - метки классов, которые модель смогла распознать.

Классификатор (SMC) также выводит следующую информацию:

1. '''Классы''': здесь отображается название класса, к которому был отнесен текст, и вероятность его принадлежности к этому классу.

2. '''Группы''': отображается название группы и число совпавших классов. Если метки совпадают с несколькими группами, они отображаются в порядке убывания числа совпавших классов (т.е. чем полнее группа, тем выше ее позиция в списке).

3. '''Ближайшие группы''': отображаются группы, до которых не хватает всего одной метки, с указанием процента заполненности и сортировкой по убыванию этого процента.

Вкладка '''прочее''' SMC Классификатора включает в себя несколько опций: ''анализ на эмоциональность'', ''пунктуация, анализ токсичности'' и ''коррекция ошибок, обратная нормализация, сжатие'''''.'''

[[Файл:Информационные вкладки тест.jpg|мини|''Рис. 7. Интерфейс раздела «Классификатор»: Информационные вкладки для протестированной модели.'']]
====Информационные вкладки SMC: Сервер, Ошибки, Логи, Постобработка====
Справа на экране располагаются информационные вкладки (рис. 7)
*'''«Серверы»''' – отображает информацию о серверах и процессах,
*'''«Ошибки разметки»''' – в этот раздел попадают фразы и метки, предположительно с ошибкой разметки, то есть те, что вызвали сложности у модели. Это может быть связано с недостаточным количеством данных с этими метками в корпусе (так называемые «слабые данные»), либо наиболее часто встречающаяся - с действительной проблемой в процессе разметки данных (то есть, недостающая метка или избыточная),
*'''«Ошибки обучения»''' – отображает информацию об ошибках обучения для модели в состоянии «Обучена», те фразы, которыми модель так и не обучилась. Также можно, находясь на вкладке '''«Ошибки обучения»''' использовать метод '''«Ручная проверка»''',
*'''«Ошибки тестирования»''' – доступны для модели в состоянии ''Протестирована'' – отображает информацию об ошибках тестирования. Можно выгрузить ошибки в файл с помощью кнопки '''«Экспорт»'''. Есть возможность преобразовать ошибки в данные корпуса,
* '''«Логи»''' – отображают логи процессов обучения, тестирования, точности обучения на разных этапах обучения,
*'''«Постобработка»''' – редактор для написания кода handler.py.
[[Файл:Data screen new.png|мини|''Рис. 8. Интерфейс вкладки данные с родительскими и дочерними вкладками'']]
[[Файл:2025-12-11 10-52-07.png|мини|''Рис. 9 Интерфейс вкладки данные'']]
[[Файл:Data corpus info.jpg|мини|''Рис. 10. Информация о корпусе данных.'']]
===Функционал вкладки «Данные» SMC ===
Вкладка '''«Данные» SMC''' (рис. 8) содержит список всех доступных корпусов данных. При выборе различных корпусов данных можно просмотреть информацию о них (рис. 10):

• '''Название корпуса''': можно изменить с помощью иконки '''«Карандаш».''' Можно удалить корпус с помощью иконки '''«Корзина»''' (см. рис. 10).

• '''Количество строк''' – общее количество фраз в корпусе.

• '''Количество классов''' – общее количество классов в корпусе.

• '''Количество групп''' – отображает общее количества групп в корпусе данных (подробнее см. раздел ''[[SMC. UPS руководство по работе с интерфейсом#Описание подготовки и этапов разметки корпуса данных SMC|«Описание подготовки и этапов разметки корпуса данных SMC»]]'').[[Файл:Род класс.png|мини|''Рис. 11. Создание родительского класса.'']]Под информационным блоком о корпусе данных SMC есть '''список классов''', в котором содержатся названия классов и информация о количестве фраз в каждом классе. Можно удалять и добавлять классы. В самом низу списка есть меню для '''''Экспорт списка классов''''' в формате csv. Есть возможность ''скрыть'' блок с корпусами данных, нажав на стрелочку между блоком корпусов и информационным блоком корпуса. Существует три вида (ранга) классов (меток):
#Обычный класс — это класс, который не относится ни к одному из родительских классов.
#Родительский класс — это класс, который включает в себя другие классы. Например, родительский класс «Паспорт» включает в себя два класса-потомка: «паспорт рф_о» и «загранпаспорт_о».
#Класс-потомок — это класс, который относится к какому-либо родительскому классу.

Чтобы преобразовать обычный класс в родительский, нужно выбрать его в списке классов и нажать на самую правую иконку в виде папки (рис. 11), которая говорит '''«Сделать класс родительским»'''. Чтобы добавить метку в родительский класс, нужно нажать правой кнопкой мыши на метку и выбрать нужный родительский класс из появившегося списка. После этого появится диалоговое окно, подтверждающее действие, и изменения вступят в силу (см. рис. 12). Метка станет классом-потомком.[[Файл:Перемещение метки в род.класс.png|мини|''Рис. 12. Перемещение метки в родительский класс.'']]

Удалить родительскую метку, в отличие от обычной, просто так нельзя. Сначала ее нужно вернуть в статус обычной, нажав на иконку '''«Сделать класс обычным»''' напротив нужного класса (рис. 13). После этого она будет расформирована и ее можно будет удалить.

==== Добавление нового корпуса ====
[[Файл:Сделать класс обчным.png|мини|''Рис. 13. Сделать родительский класс обычным.'']]Для создания нового корпуса данных SMC выполните следующие шаги:

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

После создания корпуса вы можете заполнить его данными одним из следующих способов:

'''1. Ручное добавление'''

* В нижней части экрана находится форма для ввода текста.
* Добавляйте фразы вручную и сразу выполняйте их разметку в интерфейсе.

'''2. Импорт данных'''

Нажмите кнопку «Импорт» и выберите подходящий источник:

* Логи из модели. Создаёт корпус на основе логов рабочей версии и черновых моделей.
* Из ЧаВО. Позволяет загрузить все вопросы из базы знаний QAS. Как использовать:
*# Введите название корпуса.
*# Нажмите кнопку «Добавить». В результате будет создан корпус, где вопросам из QAS соответствуют метки их категорий.
* Из файла. Загрузите данные из CSV-файла, подготовленного по шаблону системы.
* Из корпуса. Скопируйте данные из существующего в системе корпуса в новый.

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

При включении флага '''«Показать определившиеся группы»''' слева появится третий столбец «Группа». В нём будет отображаться название группы, назначенной для данной фразы. Это работает, если у вас создан список групп и заданы комбинации классов, которые в них входят.

Вы можете редактировать группы меток непосредственно в таблице данных:

* Создание или изменение групп
** Введите название новой группы или выберите существующую для одной или нескольких (предварительно выделив галочками) строк таблицы.
** Изменения автоматически синхронизируются с таблицей групп.
* Массовое присвоение групп для выбранных строк
** Выделите нужные строки в таблице.
** Присвойте им группу, внизу появится форма с функцией «Изменить группу»:
*** Для строк '''без группы''' — будет '''установлена''' выбранная группа.
*** Для строк с уже '''назначенной''' группой — группа будет '''переопределена''' на новую.

[[Файл:2024-05-21 12-03-29.png|мини|''Рис. 14. Возможности фильтрации.'']]

Можно ''фильтровать'' (рис. 14):

1. по названию класса,

2. по фразе или слову,

3. для более точной фильтрации можно использовать переключатель «и», «или», «кроме» и «только».

Есть возможность ''редактировать фразу'' в корпусе: вносить изменения в поле с фразой и ''сохранять'' изменения (кнопка '''«Дискета»''' на панели управления). Можно ''дополнять'' корпус данных по кнопке '''«Импорт»''' на панели управления (подробнее см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Данные» сервиса SMC|описание функций панели управления]]). '''После дополнения не забудьте сохранить изменения.''' ''Удаление'' фраз из корпуса возможно как по одной, так и сразу несколько, для этого нужно выделить необходимые для удаления фразы и нажать на красную иконку '''«Корзина»''' в правом нижнем углу блока работы с данными.[[Файл:Разм данных новая.png|мини|''Рис. 15. Добавление и разметка фраз.'']]

Можно вручную ''добавлять'' фразы в корпус по одной или сразу несколько (каждая фраза с новой строки, enter в конце каждой фразы)(рис. 15), записав их в поле '''«Фразы»''' в нижней части блока для работы с данными. Можно ''назначить'' или ''изменить'' классы (метки) для фразы, указав новый в поле '''«Класс»''' или выбрав существующий класс из выпадающего списка. Метки классов могут быть больше чем одна на одну фразу (мультиклассовая классификация). <blockquote>Рассмотрим пример разметки новой фразы. Допустим мы хотим добавить вручную две фразы:
#''«Здравствуйте, у меня возникли неполадки, возникающие во время установки SBS. Помогите решить проблему. Заранее спасибо.»''
#''«Добрый день, у меня появляется ошибка при установке биометрии. Заранее благодарю за ответ.»''
Разметка производится исходя из того '''«о чем эта фраза?»''', задача разметки в том, чтобы помочь модели понять суть фразы. Например, во фразах выше говорится об ''ошибках во время установки сервиса биометрии'', так же присутствует ''благодарность'' и ''приветствие,'' соответственно метки будут: ''SBS, ошибка, установка_ПО, благодарность, приветствие.''

'''ВАЖНО''': соблюдать однозначность в корпусе.</blockquote>[[Файл:Добавить общий класс.png|мини|''Рис. 16(а). Добавление общего класса.'']]Имеется функция '''«Добавить общий класс»'''. С ее помощью можно присвоить одну или несколько общих меток сразу нескольким выбранным из списка фразам (рис. 16 (а)), если была допущена ошибка при разметке фраз. Для изменения набора меток у одной фразы нужно всего лишь один раз щелкнуть на список классов и добавить нужную метку из выпадающего списка или навести курсор на лишнюю метку и, также щелкнув, удалить ее. Если необходимо удалить сразу несколько меток с фразы или нескольких фраз, под кнопкой '''«Добавить общий класс»''' есть кнопка '''«Удалить классы»''' (рис. 16 (б)). Сначала выделите нужные фразы, а затем выберите класс (классы), которые вы хотите удалить из выпадающего списка, и кликните по кнопке «Удалить классы».

[[Файл:Удаление нескольких классов 1.jpg|мини|''Рис. 16(б). Удаление нескольких классов.'']][[Файл:Объединение меток разных род.классов.png|мини|''Рис. 17. Объединение меток разных родительских классов.'']]Кроме того, существует еще одна полезная функция для работы в корпусе данных SMC — '''«объединить метки»'''. Для лучшего понимания рассмотрим пример. Предположим, у вас есть две метки с одинаковым названием — «версия» и «версия», но в одном случае название содержит английскую «е», а в другом — русскую (классы отображаются в алфавитном порядке, метка с английскими буквами будет нарушать его). И этими метками уже помечены некоторые фразы. Чтобы решить эту проблему, можно воспользоваться функцией '''«объединения»'''. Необходимо скопировать название правильной метки из списка меток («карандаш» — выделить название), затем нажать на «карандаш» напротив неправильной метки и заменить ее названием корректной метки. После этого метки объединятся и останется только корректная метка. Если эти метки принадлежат какой-либо группе, то замена произойдет и в ней. Возможность объединения групп также предусмотрена и осуществляется по такому же алгоритму.

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

==== Работа с группами классов ====
Интерфейс вкладки «Группы» аналогичен вкладке «Данные». Панель управления описана в таблице 3.

'''Основные функции вкладки:'''

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

'''Фильтрация и поиск:'''

* Фильтруйте данные по группам и классам.
* Для точной настройки фильтра используйте правую панель с операторами: «И», «ИЛИ», «Кроме», «Только».
* Для отображения повторяющихся строк включите флажок '''«Показать дубликаты»''' и выбрав одну из опций: полные (будут отображены полные дубли) и классов (отобразятся дубли по комбинации классов).

'''Массовые операции с группами:'''

# Выделите нужные группы с помощью флажков.
# В нижней части окна появится меню для массовых действий:
#* Добавить класс: выбранный класс будет добавлен ко всем выделенным группам.
#* Удалить класс: выбранный класс будет удален из всех выделенных групп.
#* Копировать: создание копий выделенных групп в одном из трёх режимов:
#** Простое копирование.
#** Копирование с добавлением выбранного класса.
#** Копирование с удалением выбранного класса.

'''Обновление модели после изменения групп'''

Если вы внесли изменения в состав или названия групп, необходимо применить эти изменения к работающей модели.

# Нажмите кнопку '''«Обновление групп в модели»''' на панели управления.
# Модель классификатора будет дообучена с учётом внесённых правок без необходимости полного повторного обучения.

<blockquote>'''Важно''': Эта операция необходима после переименования групп, массового добавления/удаления классов или изменения состава групп, чтобы модель начала учитывать новые правила.</blockquote>

==== Описание подготовки и этапов разметки корпуса данных ====
Классификатор SMC использует '''мультиклассовый подход''': одна текстовая фраза может быть отнесена одновременно к нескольким классам (меткам).

Процесс подготовки данных состоит из двух ключевых этапов (вы можете выполнить оба или только один из них):

'''Разметка фраз классами'''

При добавлении новой фразы необходимо назначить ей один или несколько классов.

* Выбор существующего класса: укажите нужные классы из выпадающего списка «Классы».
* Создание нового класса: введите название нового класса в поле «Класс» и нажмите кнопку «Добавить новый класс».

<blockquote>Подробное описание функционала вкладки «Данные» и пример разметки новой фразы представлены в соответствующем разделе инструкции.</blockquote>'''Группировка классов'''

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

* Назначение: Группировка помогает модели без дообучения определять, к какой группе классов принадлежит новая, ранее не встречавшаяся фраза.
* Результат: Формируются группы, которые агрегируют несколько отдельных классов (меток) и используются для конечного ответа.

====Панель управления вкладки «Данные» сервиса SMC====
Панель управления на вкладке '''«Данные»''' отличается своими функциями. В таблице 3 представлен список кнопок.

{| class="wikitable"
|+''Табл. 3 Описание функционала панели инструментов вкладки «Данные»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
! '''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать (выгрузить) корпус данных.
|-
| [[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|позволяет импортировать данные из внешнего файла, логов обращений к модели, уже существующего в системе корпуса или базы знаний ЧаВО.
Если выбран вариант «Из файла», нужно выбрать файл для загрузки. Поддерживаемые форматы файлов: csv, txt. Кодировка — UTF-8.

Затем можно выбрать действие: дополнить или заменить. Если выбрано «дополнить», данные текущего корпуса будут дополнены данными из файла или корпуса.

Если выбрано «заменить», данные текущего корпуса будут полностью заменены данными из файла или корпуса.
|-
|[[Файл:Авторазметка_(2).png|центр|безрамки|40x40пкс]]
|Авторазметка
|позволяет автоматически разметить корпус по словарю меток (подробнее см. [[SMC. UPS руководство по работе с интерфейсом|разд Функционал вкладки Метки]]). В диалоговом окне необходимо заполнить поля с названием задачи, выбрать из списка нужный словарь меток. Из выпадающего списка «Метки» выбрать либо замену меток, либо дополнение. И запустить авторазметку.
После этого автоматически размеченный корпус будет доступен для обычного редактирования разметки.
|-
|[[Файл:Копировать.png|безрамки|40x40px|центр]]
|Копировать
|позволяет скопировать корпус данных.
|-
|[[Файл:Сохранить.png|безрамки|40x40px|центр]]
|Сохранить
|сохранение изменений.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Функционал вкладки «Метки» ===
[[Файл:2024-10-15 11-23-22.png|мини|''Рис. 19. Интерфейс вкладки Метки.'']]Интерфейс вкладки «Метки» представлен на рисунке 19. Слева вы увидите список всех доступных словарей. Чтобы открыть один из них, просто нажмите на его название — и в центральной части экрана появится сам словарь.

Процесс добавления нового словаря состоит из двух простых шагов:

1. Нажмите на кнопку «Добавить словарь меток», расположенную в нижней левой части экрана. В появившемся диалоговом окне введите название нового словаря.

2. Затем добавьте данные в словарь: укажите название метки и пороговое значение коэффициента достоверности в левой части таблицы и её определяющие фразы в правой части таблицы. Более подробную информацию вы найдёте в разделе [[SMC. UPS руководство по работе с интерфейсом#Подготовка словаря меток|«Подготовка словаря меток»]]. Если у вас уже есть файл с описанием меток, вы можете воспользоваться кнопкой Импорт на панели управления (см. раздел [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Метки»|Панель управления вкладки «Метки»]]).

==== Подготовка словаря меток ====

Подготовка словаря меток включает в себя определение набора требуемых меток под конкретную задачу. После этого нужно в описание каждой метки добавить все возможные определяющие фразы, которые однозначно определяют эту метку, каждое слово (фраза) с новой строки. Не нужно добавлять целые фразы, как это делается при разметке SMC. Принцип описания больше похож на разметку SEE корпуса: просто укажите ключевые слова или словосочетания, которые определяют данную метку, а также все, что хотите отнести к этой метке. <blockquote>Например, мы создаем метку «Документация» и в определяющих фразах указываем все возможные варианты, которые однозначно описывают эту метку с новой строки: «дока», «инструкция», «документация», «мануал».</blockquote>Подготовленный для импорта документ должен быть в формате csv. И иметь следующую структуру:<blockquote>Метка<TAB>Описание 1, Описание 2, ..., Описание N<TAB>Порог</blockquote>Пороговое значение в файле указывается в диапазоне [0,1]. Далее при необходимости это значение можно будет поменять в интерфейсе.

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

Чтобы ''удалить'' лишнюю фразу или метку - наведите курсор на выбранную строку и нажмите на появившуюся иконку корзинки в конце строки [[Файл:Delete icon.png|безрамки|18x18пкс]]. Не забудьте сохранить изменения.

Также сверху таблицы словаря меток располагается поле ввода "Поиск по фразе". При ее заполнении будут отфильтровываться метки, содержащие введенную фразу (левая таблица), и совпадения по фразе в выбранной метке (правая таблица).

==== Панель управления вкладки «Метки» ====

Описание функционала панели управления на вкладке '''«Метки»''' представлено в таблице 4.
{| class="wikitable"
|+''Табл. 4 Описание функционала панели инструментов вкладки «Метки»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
! '''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать (выгрузить) словарь меток.
|-
| [[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|Позволяет импортировать (добавлять) данные из файла. По нажатию на кнопку появится диалоговое окно, в котором требуется выбрать файл с компьютера в формате csv.
|-
|[[Файл:Сохранить.png|безрамки|40x40px|центр]]
|Сохранить
|сохранение изменений.
|-
|[[Файл:Удаление_документа.png|центр|безрамки|40x40пкс]]
|Удалить
|позволяет удалить выбранный словарь меток.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

===Работа с ошибками SMC===
[[Файл:Ошиб тест тип 1.png|мини|''Рис. 20. Иллюстрация ошибки тестирования первого типа.'']][[Файл:Ошибка тест тип 1 3.png|мини|''Рис. 21. Обогащение корпуса данных.'']]Во время работы с классификатором, вы можете столкнуться с 3-мя видами ошибок:
*ошибки разметки;
*ошибки обучения;
*ошибки тестирования.

Как описано выше в разделе «''Информационные вкладки: Сервер, Ошибки, Логи, Постобработка» -'' '''«ошибки разметки»''' – раздел куда попадают фразы и метки, предположительно с ошибкой разметки, то есть те, что вызвали сложности у модели. Это может быть связано с недостаточным количеством данных с этими метками в корпусе (так называемые «слабые данные»), либо наиболее часто встречающаяся - с действительной проблемой в процессе разметки данных (то есть, недостающая метка или избыточная). Вкладка '''«ошибки обучения»''' – отображает информацию об ошибках обучения для модели в состоянии '''«Обучена»''', те фразы, которыми модель так и не обучилась.

'''«Ошибки тестирования»''' являются наиболее сложными и делятся на два основных типа:
# нехватка данных, тогда необходимо обогатить корпус данных фразами и разметкой;
#нехватка комбинаций меток для группы.
[[Файл:Ошибка тест тип 2.png|мини|''Рис. 22. Иллюстрация ошибки тестирования второго типа.'']]

'''Пример ошибки типа 1. Нехватка данных.'''

Есть фраза «Директор МФЦ иркутской области» - модель классифицирует ее неправильно, на скриншоте (см. рис. 20) этой фразе присвоены метки: ''Иркутская область_о, как_в, губернатор_о'' Это происходит из-за того, что ''директор'' и ''губернатор'' - имеют семантическое сходство, так как являются руководителями. Но в связке с Иркутской областью - упоминания директора в корпусе не было. Поэтому модель исходя из имеющихся у нее данных - определила для этой фразы - метку губернатор_о. Группа: ''кто является губернатором иркутской области района.''

Если мы отфильтруем корпус данных по слову ''директор,'' то увидим, что в корпусе отсутствуют фразы где и ''директор'' и ''иркутская область'' упоминались бы одновременно, а так же не была определена метка ''мфц_о,'' следовательно фразы ''директор мфц'' (дополнительно добавленная выделенная фраза) тоже не хватало (см. рис. 21). Нужно добавить эти фразы в корпус, сохранить изменения, переобучить модель, так как вносились изменения в данные, и ошибка будет устранена.[[Файл:Ошибка тест тип 2 нов.png|мини|''Рис. 23. Добавление новой комбинации меток для группы.'']]'''Пример ошибки типа 2. Нехватка комбинаций меток для группы.'''

Имеется фраза ''«а какие документы нужно подать для оформления путевки инвалиду»''. Проводим тестирование в ручном режиме и видим, что этой фразе не присвоена ни одна группа, а значит нет конечной точки, которой бы соответствовал полученный от модели набор меток. (см. рис. 22).

Переходим во вкладку '''Данные''', выбираем нужный корпус данных, идем во вкладку '''Группы'''. Далее фильтруем группы по '''Классам''': инвалидность_о, путевка в санаторий_о переводим '''переключатель''' справа в положение ''«и»'' (см. рис. 23) и смотрим, что у нас отсутствует комбинация меток: с подачей документов. Добавляем еще одну комбинацию (см. рис. 23), сохраняем изменения, переходим во вкладку Модели, кликаем на кнопку [[Файл:Обновление групп.png|безрамки|20x20px]] «Обновление групп», в диалоговом окне выбираем модель и нажимаем кнопку обновить - ошибка устранена. Переобучать модель не нужно, кнопка «Обновление групп» позволяет внести изменения без переобучения.

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

2026-02-05T14:47:54Z

E.Elagina: /* SES (Script Engine Service) Сценарная машина */

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

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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# SES Сценарная машина,
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]],
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]].
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2).
[[Файл:2025-06-09 14-33-48.png|мини|''Рис. 2 Рабочая область SES'']]

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

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

==== Добавление и настройка робота ====
Чтобы добавить нового робота, нажмите кнопку '''«Добавить робота»'''. В появившемся диалоговом окне введите название и нажмите '''«Добавить»'''. В нижнем правом углу экрана появится сообщение «Добавлено!». По умолчанию робот создается с предварительными настройками. В нем сразу есть текстовки для исключений и событий, ознакомиться и поправить их можно, перейдя на вкладку [[SES. UPS руководство по работе с интерфейсом|«Настройки»]]. Робот может быть 3х версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
{| class="wikitable"
|+''Табл. 1 Версии робота.''
!'''Иконка версии'''
!'''Наименование версии робота'''
!'''Описание'''
|-
|[[Файл:Черновик.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]], если вы планируете предоставлять консультации.

Здесь представлен общий перечень необходимых сервисов. В зависимости от специфики проекта некоторые из них могут отсутствовать.
[[Файл:2025-07-04 17-15-25.png|мини|''Рис. 3 Интерфейс вкладки Скрипты'']]

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

У скриптов есть параметр '''''«Область действия»''''', в котором есть 5 опций:

- ''конечные точки'', позволяет подключать скрипт в действиях конечных точек;

- ''элементы данных'', позволяет подключать скрипт в действиях элементов данных и контейнеров;

Скриптов на ЭД и КТ может быть несколько. Остальные скрипты общие и доступны только по одному на каждый тип:

- ''завершение сессии'' — скрипты, которые могут выполняться после завершения диалога, если скрипт указать в настройках в действиях на событии «Завершение диалога»;

- ''перед каждым вопросом'' — для случаев, когда нужно актуализировать какую-то информацию постоянно и использовать ее в условиях.<blockquote>

Скриптом «перед каждым вопросом» можно выставить, например, сегодняшнюю дату - ${custom.today}, а потом ее в сравнении дат использовать в условиях получения данных. Для случаев записи на прием проверять, '''что дата точно больше сегодняшней.'''

'''Скрипт проверки пишется админом.''' </blockquote>

- ''после каждого ответа'' — для случаев, где требуется пошагово после каждого ответа передавать информацию во внешнюю систему.

- ''передача диалога,'' скрипты для передачи диалогов.

- ''старт диалога.''

====== Дефолтные скрипты ======
В системе реализованы шаблоны скриптов по умолчанию:

Назначение:

* Автоматическое создание базовой функции при создании нового скрипта
* Возможность последующего редактирования

Расположение и настройка:

* Файлы находятся в переводчике по пути: <code>lang\ru.json</code>
* Реализовано для гибкости - администратор может изменять настройки
* Не зашито в код системы

Типы дефолтных скриптов:

* <code>_defaultScriptContainer</code> - для ЭД типа "Контейнер" (скрипты обработки)
* <code>_defaultScriptData</code> - для ЭД (скрипты постобработки)
* <code>_defaultScriptAction</code> - для действий в ЭД/КТ

[[Файл:Scrirts.png|мини|''Рис. 4 Отладка скриптов интеграции'']]
Есть '''режим отладки скриптов интеграций''' с функцией извлечения данных из сессии (рис. 4). То есть можно [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|тестировать робота в чате отладчика]] и, в случае если отработка некорректна или нужно проверить внесенные изменения в скрипт, то можно открыть вкладку «Скрипты» -> выбрать нужный скрипт -> кликнуть на закладку «Проверка» (слева откроется дополнительное окно) и нажать на кнопку «Вставить данные сессии». Тогда в открывшемся окне появятся все данные из текущей сессии из чата отладчика. По нажатию на кнопку «Тест», появится окно с результатом отработки скрипта.

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

[[Файл:2025-11-01 09-55-26.png|мини|''Рис. 5 Интерфейс вкладки «Интервалы»'']]

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

====== Группировка интервалов рабочего времени ======
Для удобства настройки сложных и переменных графиков работы в системе предусмотрена возможность объединять интервалы времени в группы. Это позволяет избежать создания громоздких условий в Контрольных Точках (КТ), когда рабочие часы оператора меняются каждый день или разбиты на несколько промежутков.

Для того, чтобы создать группу интервалов кликните на '''+''' справа от вкладки под номером '''1'''. Группа разделена на вкладки (табы), что позволяет удобно структурировать разные периоды.

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

* На одной вкладке настроить график для будних дней. Или для каждого дня отдельно.
* На другой вкладке — график для выходных.
* На третьей — особый график для праздников.

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

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

* '''события''' — действия, которые выполнит робот при наступлении определенного условия в диалоге, например «Не найдено» (см. раздел «События» ниже);
* '''исключения''' — это действия, которые выполняются, если событие повторяется указанное число раз подряд (см. раздел «Исключения» ниже);
* '''данные''';
* '''модели''' — настройка моделей, если требуется использовать параметры, отличные от параметров по умолчанию;
* '''коннекторы'''.

'''События''' есть 10-ти типов и прописываются для каждого канала связи отдельно:
[[Файл:2025-10-06 16-01-17.png|мини|''Рис. 6 Интерфейс вкладки «Настройки»'']]
# Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
# Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
# Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
# Запрос повтора — действия на случай, если абонент запросил повтор информации. Если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.
# Тишина — добавляем действие в моменты, когда от человека нет ответа, то есть тишина.
# Перебивание — событие доступно ''только для голосовых каналов (например, voice)''. Она позволяет настроить реакцию на прерывание речи.
# Задержка ответа — событие доступно ''для каналов web'' и ''voice)''. Это действия, которые появляются, когда идет генерация. Например, можно написать: «Секундочку, выясняю». Это нужно, чтобы человек понимал, что робот не просто молчит.
# Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя, то есть настройка действий если это событие произошло. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
# Нет данных — это событие происходит, когда система пытается получить конкретный недостающий элемент данных, например название филиала, и ей это не удалось.
# Ошибка.

'''При наступлении события система выполнит указанное в канале действие. Если действие для этого события в канале не задано, то выполнится действие указанное для канала default.'''

Вы можете настроить реакции робота на определённые события. Более подробную информацию о них вы найдёте в разделе «Исключения».

'''Исключения''' есть трех типов '''Тишина''', '''Не найдено''' и '''Нет данных'''.

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

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

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

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

На вкладке можно настроить параметры голосового канала. Вот что там можно сделать:

* Выбрать голос, которым будет говорить робот.

* Установить основную модель распознавания (рекомендуем оставлять common).

* Определить фоновую модель распознавания (рекомендуем background).

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

* '''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)
* '''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
* '''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
* либо коррекция может '''Отсутствовать'''.

[[Файл:2025-10-06 16-47-09.png|мини|''Рис.7 Вкладка настроек коннектора telegram'']]

===== Вкладка «Коннекторы» =====
Позволяет настроить связь робота по одному из каналов: ''freeswitch'', ''max'', ''telegram'', ''vk'', ''web, nats.''

Для мессенджеров, таких как '''max''', '''telegram''', '''vk''', характерны следующие настройки:

* ''токен'',
* ''группа'' ''(для vk),''
* ''название бота'',
* ''обслуживающий сервер'' - имя сервера SES, который обслуживает данный коннектор,
* ''периодичность обновления'' - время периодичности запроса в api для получения новых сообщений,
* ''фразы-активаторы'' - список фраз, на которые будет реагировать робот в общих чатах, и считать, что сообщение адресовано ему,
* ''переменные,''
* ''фраза сброса сессии,''
* ''доступы'' - список пользователей, которые могут писать роботу. Если пустой, то могут все.

Для канала '''web,''' в частности, для встраивания чат-виджетов ''(рис 7.1).'' Данный коннектор предназначен для встраивания интерактивного виджета на ваш сайт. Доступно два типа виджета: '''Чат и Ассистент (Суфлер)'''.
[[Файл:2025-11-14 11-16-35.png|мини|''Рис. 7.1 Вкладка настроек коннектора web'']]
'''Общие параметры (для обоих типов)'''

Следующие настройки являются общими независимо от выбранного типа виджета.

* Домен: Укажите домен вашего сайта, на который будет встраиваться виджет. Это необходимо для безопасности, чтобы виджет мог работать только на указанном сайте.
* Токен: Уникальный идентификатор, который указан в теге <code>[[SES. Руководство администратора#Настройка виджета для сайта|<script>]]</code> для встраивания виджета на сайт.
* Акцентный цвет: Основной цвет интерфейса виджета (кнопки, заголовки, выделение). Используется для согласования с фирменным стилем вашего сайта.
* Заголовок виджета: Текст, который отображается в шапке открытого окна чата.
* Приветственное сообщение: Первое сообщение, которое видит пользователь при открытии чата.
* WebSocket-серверы: Технический параметр для установки соединения. Обычно заполняется автоматически и изменяется только по указанию технической поддержки.
* Язык: можно указать язык для виджета. Если не указывать, то будет дефолтный из конфига UPS.
<blockquote>Мультиязычность настраивается в настройках пользователя.</blockquote>'''Функциональные возможности'''

Эти опции позволяют включить или отключить определенные функции виджета.

* Голосовые ответы: Пользователь может прослушивать ответы от робота в аудиоформате.
* Отправка аудиосообщений: Пользователь может записывать и отправлять голосовые сообщения.
* Отправка файлов: Пользователь имеет возможность прикреплять и отправлять файлы.
* Аудиозвонок: Пользователь может инициировать голосовой звонок.
[[Файл:Ассистент.jpg|мини|''Рис. 7.2 Настройка переменных для режима "Ассистент"'']]
'''Выбор типа виджета'''

Перед сохранением конфигурации необходимо выбрать тип виджета, так как это влияет на доступность дополнительных параметров.

''Тип: "Чат"''

Стандартный режим для интерактивного общения с пользователем. Все "Функциональные возможности" и "Общие параметры" доступны для настройки. Также доступен блок "Переменные".

''Тип: "Ассистент" (Суфлер)''

Режим, предназначенный для подсказок оператору во время разговора с абонентом. Все переменные, необходимые для работы ассистента, настраиваются и передаются отдельно в личном кабинете пользователя. Сначала нужно авторизоваться в системе UPS ''(рис. 7.2)'', и дальше суфлер подключится сразу ко внутреннему номеру, который указан в настройках пользователя, там же можно переопределить цветовую схему под каждого пользователя.

Для канала '''freeswitch''' (телефонная линия):

* ''название коннектора,''
* ''режим обслуживания:''
** Режим «Как робот»
*** <code>Внутренний номер</code>: Указывается внутренний номер этого робота.
*** Опция ассистента: Дополнительно настраивается параметр, который определяет, будет ли ассистент (суфлер) работать после перевода звонка на оператора.
*** <code>Конечная точка</code>
** Режим «Как ассистент»
*** <code>Внутренний номер</code>: Указывается внутренний номер робота-ассистента (суфлера).
*** <code>Номер для перевода звонка</code>: Указывается номер, на который будет переключаться звонок (номер колл-центра или конкретного оператора).
Работа ''суфлера после перевода звонка'' на оператора возможна ''в двух режимах'':

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

Флаг '''"Автостарт ассистента"''' при активации этой опции, ассистент запускается автоматически.

Настройки канала '''''nats''''':

* название коннектора,
* адрес серверов,
* канал входящих сообщений,
* канал исходящих,
* обработчик.

Принцип работы:

* Отправитель (канал исходящих сообщений) отправляет сообщение в определенный subject.
* Получатели (канал входящих сообщений), которые проявили интерес к этому subject, получают сообщение.
* Subject выступает в роли классификатора, позволяя разделять различные потоки сообщений для разных задач и сервисов.

Для работы коннектора необходимо указать адрес сервера NATS и топики (Subjects) для отправки и получения сообщений.

[[Файл:Функционал действий.png|мини|''Рис. 8 Функционал Действий'']]

==== Виды действий в роботе и работа с ними ====
'''1. Основные действия'''

Доступны следующие типы действий:

* '''Сказать'''

Настройте текстовые ответы робота. Это может быть простая фраза-заглушка, ответ, сгенерированный AI (LLM), или ответ из базы знаний (QAS). Типы ответов «Сказать» подробно описаны в разделе 2.

<blockquote>При наведении мыши на поле «Фраза» появляется кнопки-иконки [[Файл:Управление фразой действия.png|безрамки|64x64пкс]], где можно выбрать одно из действий:
# Добавить кнопку (подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Добавление кнопок в действия|«Добавление кнопок в действия»]]). Доступно пользовательское расположение кнопок, которые регулируются переносами на новые строки.
# Перефразировать. Если нужно добавить вариации фразы (рис. 8). Предложенные фразы можно отредактировать или удалить, кликнув по иконке корзинки напротив нужной фразы и добавить в список фраз.
# Удалить лишнюю фразу можно, если она не единственная.
</blockquote>

* '''Подтвердить'''

Настраивается фраза для подтверждения.

* '''Отправить файл'''

Позволяет отправить файл в ответ на запрос пользователя.

* '''Остановить выполнение действий'''

Немедленно прекращает выполнение всех последующих действий в текущем сценарии и сбрасывает точку выполнения диалога.

* '''Передача диалога'''

Переводит разговор, например, на оператора или в другой отдел. Для настройки необходимо указать ''Назначение'' передачи.

* '''Забыть данные'''

Позволяет стереть определенные данные, введенные пользователем, чтобы запросить их заново. При активации опции ''Перезапросить'' система автоматически сформирует запрос на ввод недостающих данных.

* '''Завершить диалог'''

Завершает текущий разговор с пользователем и закрывает сессию.

У некоторых действий есть опции:
* ''Считать действие успешным прохождением точки'' — этот флаг устанавливается на действия, которые означают, что сервис выполнился. В основном для отчетности.
* ''Прерываемое'' — этот флаг активируется для голосового канала и говорит о том, что допускается прерывание (перебивание) робота в момент синтеза ответа. Если он активен, робот будет реагировать на стоп-слова, в противном случае — нет.
* '''Установка переменной'''
позволяет задать или изменить значение переменной после выполнения определенного события в сценарии. Это мощный инструмент для создания сложной логики, например, для подсчета количества попыток входа в сервис и последующих действий в зависимости от этого значения.

* '''Принудительно перейти в КТ'''

позволяет принудительно отправить диалог в выбранную конечную точку.

'''2. Типы ответов для действия «Сказать»'''

При использовании действия «Сказать» вы можете выбрать один из четырех типов ответа:

1. ''Последовательно''

Робот будет выдавать вопросы и информацию по порядку, строго следуя списку, указанному в поле «Фразы».

2. ''Случайная фраза''

Робот выберет и произнесет одну случайную фразу из заданного списка.

3. ''Из внутреннего источника (недоступно для действий в элементах данных)''

Ответ формируется из Системы ответов на вопросы (QAS) для ответа из ''QAS документация'' нужно настроить'':''

* Условия присвоения категорий: Определяет правила, при которых система может направить запрос в эту категорию QAS для поиска ответа.

* Условия вывода ответа: Настройте параметры, такие как использование кеша ответов, генерация ответа и кеширование формулировок и [[QAS. UPS руководство по работе с интерфейсом#%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%20%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B8%20%C2%AB%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D1%8B%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2%C2%BB|выбрать шаблон запроса]]. Подробности [[QAS. UPS руководство по работе с интерфейсом|тут]].<blockquote>'''Обратите внимание:''' если вам нужно изменить шаблон запроса для определенной категории, это делается путем добавления отдельного действия. Настройка этого действия аналогична основному, но с выбором нужного шаблона. В Условиях запуска указываете данные, которые запустят это действие с шаблоном-исключением. </blockquote>

''QAS-чат'': Ответы генерируются AI-моделью (LLM) по умолчанию или другой моделью, добавленной администратором.

4. ''Из внешнего источника''

Позволяет подключить скрипты интеграций для выполнения специальных действий, если таковые имеются. Для действия «Сказать» с типом «Из внешнего источника» нажмите на специальную кнопку, расположенную рядом с полем выбора скрипта [[Файл:Postprocessing.png|безрамки]]. Откроется вкладка с выбранным скриптом, где вы можете:

* Просматривать код текущего скрипта,
* Редактировать существующий скрипт,
* Создавать новый скрипт.

<blockquote>Редактирование и создание скриптов не влияют на сохранение ЭД/КТ, т.к. они ссылаются только на id скрипта. Если вы выбираете другой скрипт для действия, обязательно сохраните изменения.</blockquote>'''3. Управление действиями'''

Для каждого действия доступны три опции управления (обычно отображаются в виде значков [[Файл:Для действий.png|безрамки|72x72пкс]]):

1. ''Копировать''

Чтобы скопировать действие в другой канал, нажмите эту кнопку и в открывшемся окне выберите целевой канал из списка.

2. ''Переместить''

Чтобы переместить действие в другой канал, выполните те же шаги, что и для копирования. <blockquote>'''Внимание:''' При перемещении действие будет удалено из исходного канала.</blockquote>3. ''Удалить действие''

Чтобы удалить действие, нажмите на кнопку в виде корзины.

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

===== Добавление кнопок в действия =====
В сценарной машине предусмотрена возможность добавления кнопок.

При наведении мыши на поле «Фраза» появляется кнопки-иконки , где по иконке с плюсом можно добавить кнопку:

# название кнопки;
# текст для отправки — это тот текст, который отправится на модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]], [[SEE. UPS руководство по работе с интерфейсом|SEE]]).

Чтобы внести изменения в созданную кнопку, кликните по ней левой клавишей мыши (ЛКМ) и в открывшемся меню можно редактировать или удалить эту кнопку.

Интерфейс позволяет гибко управлять расположением кнопок с помощью переносов на новую строку.

Чтобы настроить порядок кнопок:

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

Этот инструмент позволяет визуально сгруппировать кнопки и организовать интерфейс максимально удобно для пользователя.

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

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

''Переменные'' — служат для хранения данных, полученных из API или по каналам, запущенным извне. Например, это может быть ID пользователя в Telegram или CID из телефонного канала, то есть определившийся номер телефона.<blockquote>'''Переменные, как и данные, можно выбирать из выпадающего списка.''' Доступны все названия и значения, которые использовались ранее. Если вам нужно создать новую переменную и значение, просто введите их с клавиатуры. После этого они также будут предлагаться вам в дальнейшем.</blockquote>''Данные'' — элемент данных, полученный от моделей SMC или SEE.

''Интервал'' — период времени, в который запускается это действие. У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.
''Подтвердить'' — запуск действия в зависимости от наличия подтверждения от абонента.
[[Файл:Уведомление дублей.png|мини|''Рис. 9. Уведомление об одинаковых блоках ИЛИ в условиях запуска действий'']]
В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»'' (рис. 9)''.''<blockquote>'''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.</blockquote>

Также при сохранении настроек в окне "Условий запуска" если были обнаружены одинаковые блоки условий "ИЛИ", то будет соответствующее оповещение с выделением повторяющихся блоков ''(Рис. 9''.)

Пример использования условий запуска действий в конечной точке ''«Проверка статуса»:''<blockquote>
'''Ситуация 1.'''

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

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

'''Ситуация 2.'''

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

1. Определить элемент данных, который отвечает за отслеживание цифр (код). В нашем случае это модель SEE number и элемент данных «Код заявления».

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

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

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

==== Добавление и настройка элементов данных ====
[[Файл:Снимок экрана 2025-07-16 154838.png|мини|''Рис. 10. Массовое добавление элементов данных'']]
[[Файл:2025-12-11 11-15-27.png|мини|''Рис. 10.1. Бланк настройки элемента данных'']]
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку '''«Добавить элемент»'''. В появившемся диалоговом окне возможны два варианта добавления: '''"Одиночное"''' и '''"Массовое"'''.

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

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

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

'''Контейнер''' — составной элемент данных, который собирает необходимые данные, чтобы отправить их во внешнюю БД по API с помощью скриптов интеграции.

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

===== Настройка элемента данных =====
[[Файл:2025-04-23 14-43-07.png|мини|''Рис. 11 Проверка модели в ЭД'']]
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (''Рис. 10.1'').

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

'''«Вес»''' — это параметр, который определяет приоритет этого элемент данных в спорных ситуациях. По умолчанию установлено значение 3. Также вес ЭД отображается в [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчике]] и, если у вас активировано [[SES. UPS руководство по работе с интерфейсом#Панель управления SES|табличное представление сценария]], то и в самой таблице. <blockquote>Совет по работе с весом ЭД.

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

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

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

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

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

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

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

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

Рядом с комментарием находится кнопка '''Исключения''' [[Файл:Исключения .png|безрамки|20x20пкс]]. По нажатию на эту кнопку можно для определенных элементов данных настроить нестандартные исключения, то есть исключения, отличные от общих настроек (рис.12). <blockquote>
Например, для ЭД «Название филиала». [[SES. UPS руководство по работе с интерфейсом#Вкладка «Настройки»|В общих настройках]] робота МФЦ указано, что количество исключений для события «Нет данных» равно 3 (в счетчик входит и первое обращение к роботу, если там не было нужной информации). Однако мы хотим, чтобы, если с первого раза филиал не был найден, робот больше не запрашивал у абонента его название. Вместо этого робот должен показать заглушку с предложением поискать нужный филиал на сайте. Для таких случаев можно настроить '''нестандартное исключение.''' </blockquote>Настройка нестандартного исключения:

# выберете нужный элемент данных,
# кликните на значок исключения [[Файл:Исключения .png|безрамки|20x20пкс]],
# в появившемся окне активируйте флаг «включить нестандартные исключения»,
# заполните тип исключения Нет данных,
# установите максимальное кол-во исключений подряд (если хотите уточнять один раз, то макс.кол-во устанавливайте равным 2),
# установите канал связи при необходимости,
# и выберете действие на случай, если исключение наступило.
[[Файл:Постобработка ЭД.png|мини|''Рис. 12.1. Постобработка данных'']]
Далее находится кнопка '''«Постобработка»''' [[Файл:Postprocessing.png|безрамки]]'''.''' При нажатии на нее появится всплывающее окно с редактором кода, где можно написать функцию, которая будет срабатывать после того как ЭД был получен (Рис. 12.1). Установите галочку '''«Включить постобработку»''' и в редакторе отобразится функция-обработчик, которая принимает на вход три параметра: ''значение ЭД, текст последнего сообщения, канал'', и возвращает значение ЭД и опционально текст сообщения.<blockquote>'''Пример:'''

<code>def handler(value, message, channel):</code>

<code> if value == 'старый' and message == 'старый' and channel == 'voice':</code>

<code> return 'новый', {'text':'новый'}</code>

<code> elif value == 'новый' and message == 'новый' and channel == 'voice':</code>

<code> return 'старый', {'text':'старый'}</code>

<code> return value, {'text': 'не тот канал'}</code></blockquote>

'''Тестирование скриптов в ЭД'''

Процесс тестирования скриптов в ЭД аналогичен тестированию скриптов во вкладке "Скрипты", с учетом того, что скрипты находятся непосредственно в самих ЭД.

Важное отличие:

* Для ЭД типа «Класс» или «Сущность» - поле «Значение» обязательно для заполнения.
* Для ЭД типа [[SES. UPS руководство по работе с интерфейсом#Произвольный элемент данных|«Произвольный»]] - поле «Значение» заполняется по необходимости (опционально).

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

'''Работает только в условиях запуска. Если ЭД с этим флагом стоит на входе в КТ, то фраг игнорируется.'''</blockquote><blockquote>'''Пример: Запись на прием'''

1. Процесс взаимодействия с пользователем

Пользователь хочет записаться на прием. Для этого необходимо собрать следующие данные:

* Намерение (цель обращения).
* Адрес (куда хочет попасть пользователь).
* ФИО.
* Номер телефона.

2. Работа моделей в КТ "Запись на прием"

* Все модели, отвечающие за обработку запроса, работают в фоновом режиме.
* На любом этапе диалога они могут «выхватывать» сущности (например, извлекать ФИО, адрес и т. д.).

3. Проблема ложного срабатывания

Модель может ошибочно извлечь данные, если:

* Пользователь вводит информацию, которая частично совпадает с искомой сущностью (например, город ''"Владимир"'' может быть ошибочно принят за имя).
* Это приводит к некорректной обработке данных до завершения сценария.

4. Решение: ограничение работы модели

Чтобы избежать ложных срабатываний:

* Активируйте галочку '''«Получать только прямым запросом»''' в настройках ЭД.
* Если галочка активна, модель (например, извлечение ФИО) сработает только когда:
** Сценарий диалога дошел до запроса ФИО.
** Пользователь явно отвечает на вопрос о недостающих данных по ФИО.

Таким образом, '''система не будет обрабатывать случайные упоминания имен или других сущностей вне контекста запроса.'''</blockquote>Флажок '''«Подставлять ответ модели в запрос к ЧаВО»''' предназначен для работы с типами ЭД «Сущность». Его основная функция — подставлять в запросы пользователей ответ от модели (название тэга) SEE вместо исходного текста абонента, на который среагировала модель.<blockquote>'''Пример использования'''

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

# Создаем модель SEE с тегами:
#* <code>до 14 лет</code>
#* <code>с 14 лет до 18 лет</code>
#* <code>с 18 лет</code> ''(Теги формируются на основе предоставленной документации.)''
# Добавляем ЭД в качестве недостающего элемента в настройки КТ.
# Когда сценарий доходит до дозапроса этого ЭД или абонент сам предоставляет данные, система отправляет запрос в QAS. Например, абонент отвечает, что ему 44 года, но в документах нет такого варианта. В них информация сгруппирована <code>до 14 лет</code>, <code>с 14 лет до 18 лет</code> и <code>с 18 лет.</code> Соответственно система не найдет похожую информацию.
# Решение:
#* Если флажок активирован, система подставит ближайший подходящий тег (в данном случае — <code>с 18 лет</code>).
#* Это поможет QAS корректно находить информацию в документации.
'''Важно:''' если ваша модель SEE '''не отдаст ответ''', то настройка '''не сработает'''. Проверьте и при необходимости дообучите модель.</blockquote>

Флаг '''«Удалять сущность из запроса к ЧаВО»''' предназначен для типов «ЭД Сущность» и работает наоборот: он удаляет из запроса пользователя слова или фразы, которые распознала модель.

Флажок '''«Режим долгого ожидания»''' Открывает дополнительное меню с триггерами окончания ожидания. Это данные, при получении которых мы прекращаем ждать именно этот элемент данных (ЭД). Например, если получили его же или другие данные, например, просьбу позвать оператора.<blockquote>'''Обратите внимание:''' чтобы этот режим работал правильно, создайте нестандартное исключение для ЭД (описание выше). Иначе система будет ориентироваться на общие настройки количества исключений.</blockquote>

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

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

===== События элемента данных =====

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

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

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

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

'''Тип события''' '''«Элемент получен».''' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).

'''Тип события''' '''«Тишина»''' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек молчит.[[Файл:Уведомление об отсутствующем классе.png|мини|''Рис. 14. Уведомление об отсутствующем классе'']]<blockquote>
Например, если робот спрашивает у абонента, какой паспорт ему нужен, а человек молчит, можно через некоторое время повторить вопрос или сказать: «Говорите громче, не слышно».</blockquote>

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

В таблице элементов данных предусмотрено уведомление ''(Рис. 14)'' об отсутствующей модели на сервере, которую использует элемент данных, а также об отсутствующем классе/группе в выбранной модели. При таких случаях слева от элемента данных расположен значок [[Файл:Warning.png|безрамки]], при наведении курсора мыши на который появляется соответствующее сообщение.

===== Произвольный элемент данных =====
Элемент данных типа «Произвольный» предназначен для обработки произвольных текстовых данных от пользователя, таких как:

- Нажатия кнопок (текста на кнопках),

- Точные текстовые фразы,

- Данные, присваиваемые через скрипты.

''Простая настройка:''

- Текст: текст от пользователя (например, текст на кнопке или точная фраза), который нужно «отловить».

- Значение элемента данных: присваиваемое значение этому элементу данных (param).

''Универсальное применение:''

- Обработка различных кнопок в одном элементе данных.

- Возможность скриптового присвоения любых значений.

- Замена использования элемента-заглушки со скриптами.

- Пользоваться таким ЭД можно точно так же как и другими элементами. Вести в разные действия и категории исходя из значения произвольного ЭД.<blockquote>''Пример использования''

Сценарий: Обработка различных текстов с кнопок БЕЗ обработки моделями, то есть модель может «не знать» этих фраз:

- Текст: "Поддержка участников СВО" → Значение ЭД: «Поддержка СВО»

- Текст: "Льготы для пенсионеров" → Значение ЭД: «Социальные услуги»

Таким образом, один произвольный элемент данных может обрабатывать множество различных вариантов ввода.</blockquote>[[SES. UPS руководство по работе с интерфейсом#События элемента данных|События]] на этом элементе аналогичные как и на обычных ЭД.

[[Файл:2025-10-06 13-10-56.png|мини|''Рис. 15 Интерфейс контейнерного ЭД'' ]]

===== Элемент данных типа «Контейнер» =====
Контейнер — это составной элемент данных, который объединяет несколько дочерних элементов для последующей обработки. Его основная функция — сбор необходимых данных и их отправка во внешнюю базу данных через API с использованием скриптов интеграции.

Доступ к редактору скриптов:

# Перейдите в карточку элемента данных «Контейнер»
# Нажмите на кнопку вызова редактора скриптов [[Файл:Postprocessing.png|безрамки]]
# ''Важно:'' Если скрипт не заполнен, кнопка будет подсвечиваться красным цветом

Создание функции обработки:

* При нажатии на кнопку открывается всплывающее окно с редактором кода
* Функция выполняется после получения всех данных элемента
* Для активации установите галочку «Включить скрипт обработки»

Функция принимает три входных параметра:

# <code>value</code> — значение текущего элемента данных
# <code>message</code> — текст последнего сообщения от пользователя
# <code>chanel</code> — идентификатор канала взаимодействия

Функция возвращает:

* Обязательно: обработанное значение элемента данных (value и записывает его в значение ЭД param)
* Опционально: текст сообщения для пользователя

События контейнерного ЭД:

* ''«Элемент получен».'' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).
* ''«Нет данных»'' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек говорит что-то, но не ответ на вопрос.

==== Добавление и настройка конечных точек ====
[[Файл:2024-11-18 12-00-28.png|мини|''Рис. 16 Рабочая область SES'']]Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В верхней правой части рабочей области расположена кнопка '''«Добавить конечную точку»''' (рис. 16). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки образуют «облако конечных точек».

===== Настройка конечной точки =====
После того как вы ввели название конечной точки и нажали кнопку '''«Добавить»''', слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается ''название конечной точки'', при желании его можно сменить. Также доступен выпадающий список «Тип». Здесь можно выбрать один из четырёх вариантов:[[Файл:2025-03-28 14-57-55.png|мини|''Рис. 17 Типы входа в конечные точки'']]'''«Отчетный»''' — эта та, которая участвует в статистике, т.е. несет какую-то полезную для анализа информационную нагрузку.

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

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

'''«Завершение диалога»''' — конечная точка, которая ставит точку в общении с пользователем.[[Файл:2025-05-28 16-23-27.png|мини|''Рис. 18 Вход в КТ по условиям'']]

Также можно выбрать еще '''Тип входа в КТ''' может быть трех видов (рис. 17):

'''- по условиям''', когда попадаем в КТ при условии получения определенных данных, например, класс от SMC (рис. 18). На вкладках «Условия» доступна ''фильтрация по элементу данных.''

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

Абонент обратился за консультацией. Робот предоставил ответ. После консультации абонент бездействует, а сессия еще не закрыта. Можно настроить КТ Оценка качества обслуживания, которая по истечению указанного времени запросит оценку, после ответа абонента, завершит сессию.</blockquote>- '''по ручному запуску''', когда КТ нужно принудительного запустить, например для рассылки. Чтобы настроить вход в конечную точку нужно выбрать в меню Вход опцию «По ручному запуску». Интерфейс КТ по ручному запуску идентичен КТ со входом «По бездействию», за исключением поля «Время».

Такой вариант входа в КТ подходит для исходящих сообщений (обзвонов), например, чтобы отправить абоненту напоминание-подтверждение о предстоящей записи: «Уточните, пожалуйста, вы придете на прием?»

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

'''Настройка исключений для конечных точек'''

Вы можете настроить автоматическое реагирование на сбои в работе конечных точек. Исключения [[Файл:Исключения .png|безрамки|20x20пкс]] - это специальные действия, которые выполняются при нескольких последовательных неудачных запусках конечной точки.

Система отслеживает статус запусков. Когда количество неудачных попыток подряд достигает заданного вами значения (например, 3), автоматически выполняется указанное вами действие.

Пример настройки:

* Условие: 3 неуспешных запуска подряд.
* Действие: Перевести звонок оператору ''или'' Завершить диалог.

===== Условия входа и запуска конечных точек. Сбор информации =====
'''Типы условий для входа'''

Для настройки условий '''входа''' в системе доступны три основных типа:

1. ''Данные''. Проверка значений элементов данных.

2. ''Переменные''. Работа с системными и пользовательскими переменными.

3. ''Подтверждение''. Проверка статуса подтверждения от пользователя. Возможные значения:

* Получено (пользователь подтвердил действие)
* Не получено (пользователь отклонил действие)

Для '''условий запуска''' есть дополнительно 4-ое условие, помимо вышеперечисленных:

4. ''Интервалы.'' У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.

Для '''сбора информации''' есть только 2 варианта условий: данные и переменные.<blockquote>Применение: Эти типы условий позволяют гибко управлять логикой диалога, направляя пользователя по различным сценариям в зависимости от текущего контекста.</blockquote>

'''Условия входа (Вход).''' Для того чтобы попасть в конечную точку и выполнить определенные действия, нужно выполнить условия входа. Их может быть как один элемент данных, так и их сочетание.<blockquote>Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: ''«Загранпаспорт»'' (получена метка от [[SMC. UPS руководство по работе с интерфейсом|SMC]], соответствующая этому элементу данных). А также сочетание элементов данных: ''«Паспорт»'' (получаем, если тип паспорта не указан сразу) и ''«Тип паспорта-загран»'' (тег «Загран» получили после уточнения типа паспорта).</blockquote>Условия входа объединены в блоки, которые имеют логическое условие «И». Чтобы добавить новое условие, необходимо нажать на кнопку «Добавить условие» [[Файл:Добавить условие.png|безрамки|20x20пкс]]. Блоки с условиями «И» разделены логическим «ИЛИ».
Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:
* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* + (Прибавить) — для увеличения счетчика,
* - (Вычесть) — для уменьшения счетчика,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

[[Файл:Рис. 17 Условия запуска.png|мини|''Рис. 19 Условия запуска'']]
'''''Условия запуска и Сбор информации''.''' Вкладка ''Сбор информации'' и меню ''Условия запуска'' идентичны по своему назначению'''.'''

По нажатию на эту кнопку открывается окно, где нужно указать '''''все''''' случаи (данные и их комбинации), '''''при которых точка сработает''''' (см.рис. 19). В окне «Условия запуска» элементы данных разделяются логическим оператором «ИЛИ». В случае с комбинациями условий ЭД отделяются друг от друга логическим «И». Как в случае с элементами, разделёнными операторами «ИЛИ», так и с элементами, разделёнными «И», порядок элементов можно менять. Аналогично для вкладки Сбор информации.

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

Условия можно редактировать: добавлять и удалять. Окно можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.<blockquote>Например, конечная точка «Консультация» активируется, если будут получены метки «Апостиль» ИЛИ «Банкротство» ИЛИ «Загранпаспорт» и «Тип паспорта — загран».</blockquote>В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»''. '''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.

У условий есть параметр ''«Тип»'', принимающий два значения: данные или переменная. Параметр ''«Искать»'' имеет три варианта:

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

Далее идет поле «Название», где из выпадающего списка требуется выбрать нужный элемент данных. <blockquote>Если в выбранном элементе данных не заполнено событие «Недостающий элемент», то в правом верхнем углу будет расположен значок [[Файл:Warning.png|безрамки]] со всплывающим уведомлением при наведении на него.</blockquote>Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:

* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

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

===== Условия присвоения категорий =====
[[Файл:2025-07-07 12-42-57.png|мини|''Рис. 20 Вкладка Действия и Условия присвоения категорий'']]
'''''Условия присвоения категорий'''.'' По клику на эту кнопку раскрывается меню (рис. 20), в котором есть выпадающий список со всеми категориями из [[QAS. UPS руководство по работе с интерфейсом|QAS]], а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ». ''Окно с условиями категорий или условиями запуска можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.''<blockquote>На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ». </blockquote>Флажок '''«Запрос в QAS с учетом прошлого контекста»''' указывает системе, что перед отправкой запроса в QAS необходимо проанализировать предыдущие сообщения пользователя. Это позволяет сохранять логику диалога и избегать необоснованной смены тематики.<blockquote>'''Пример работы'''

# Без включенной функции
#* Пользователь спрашивает: ''"Какие документы нужны для оформления СНИЛС?"'' → система направляет запрос в категорию СНИЛС.
#* Затем пользователь уточняет: ''"А сколько это стоит?"'' → система определяет метку Госпошлина и перенаправляет запрос в соответствующую категорию, теряя контекст СНИЛС.
# С включенной функцией
#* Если флажок активен (например, для категории ''Госпошлина''), система:
#** Проверяет предыдущие сообщения.
#** Если диалог начался в другой категории (например, СНИЛС), запросы объединяются (''"склеиваются"'').
#** Если контекст отсутствует, тематика меняется, но поиск ответа ведется сразу по обеим категориям (СНИЛС + Госпошлина).

'''Когда использовать'''

Активируйте эту настройку для категорий, которые могут:

* Быть частью более широкого запроса (например, ''Госпошлина'' как дополнение к ''СНИЛС'').
* Требовать сохранения контекста диалога.

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

===== Индикация удаленных категорий =====
Система визуально выделяет удаленные категории для привлечения вашего внимания:

# Конечные точки с недействительными категориями в табличном представлении: помечаются специальным значком и выделяются красным цветом. При наведении на значок сообщение: ''«Используются несуществующие категории в канала: [название_канала](кол-во)»''
# В облаке конечных точек: КТ с недействительными категориями также отображаются красным цветом, но без значка.
# В условиях присвоения категорий: Если используется удалённая категория, система отобразит предупреждающее уведомление ''«Используются несуществующие категории: [кол-во]»''.

Это позволяет быстро находить и корректировать объекты, которые зависят от неактуальных данных. А так же это важно для экспорта и импорта роботов (см. разд. Панель управления).

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

==== Связанная фильтрация ЭД и КТ ====
В интерфейсе реализована связанная фильтрация между таблицами Элементов Данных (ЭД) и Контрольных Точках (КТ). Это позволяет автоматически находить взаимосвязанные объекты.

'''Принцип работы:'''

* Фильтрация по ЭД: При вводе названия в фильтр таблицы Элементов Данных:
** В таблице ЭД отображаются только те элементы, названия которых соответствуют фильтру.
** Одновременно в таблице КТ автоматически отображаются только те Контрольные Точки, в которых используются отфильтрованные ЭД.

* Фильтрация по КТ: При вводе названия в фильтр таблицы Контрольных Точек:
** В таблице КТ отображаются только те точки, названия которых соответствуют фильтру,
** Одновременно в таблице ЭД автоматически отображаются только те Элементы Данных, которые используются в отфильтрованных КТ.

<blockquote>'''Важно''':

Система учитывает использование Элементов Данных во всех типах Контрольных Точек:

1. Входные данные (вход).

2. Собираемая информация (условия запуска/сбор информации).

3. Условия запуска действий.</blockquote>

==== Тестирование робота ====
[[Файл:2025-10-06 11-49-26.png|мини|307x307пкс|''Рис. 21 Окно чата для тестирования робота'']]
В интерфейсе SES есть чат с отладчиком (рис. 21), где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок [[Файл:Чат.png|безрамки|20x20px]] в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка '''«Перезапустить сессию»''' [[Файл:Обновить данные вопроса.png|безрамки|20x20px]], которая сбрасывает всю переписку и данные отладчика. А слева — кнопка '''«Данные сессии»''' [[Файл:Кнопка отладчик без полей.png|безрамки|20x20px]], предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS и не только, подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Данные сессии|Данные сессии]]. И кнопка '''«Тестирование скрипта»''' [[Файл:Пробирки.png|безрамки|20x20пкс]], подробнее [[SES. UPS руководство по работе с интерфейсом#Тестирование скриптом|тут]]. Есть возможность отправлять в чат файлы нажав на [[Файл:Скрепка.png|безрамки|20x20пкс]] и выбрав файл (в любом формате).

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

Режим отладки (дебаг):

* В режиме отладки появилась панель логов.
* Логи автоматически обновляются после каждого ответа от робота.
* Вместе с логами также обновляются данные текущей сессии.

Настройки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] чата позволяют выбрать настройки аудиоответов, а так же установить переменные, например, номер телефона.

Еще в меню настроек можно выбрать КТ по ручному запуску, чтобы протестировать работу КТ и сценария (рис. 22).
[[Файл:2025-10-20 10-56-18.png|мини|300x300пкс|''Рис. 22 Выбор конечной точки для тестирования.'']]

===== Тестирование в текстовых каналах =====

===== Данные сессии =====
Раскрыв данные сессии можете увидеть, все данные о текущем диалоге с роботом. Разберем по порядку, ниже представлены некоторые данные из ключа root, они нужны не все, разберем только нужные:<blockquote>
"started":"2025-06-10 09:46:05" — ''время начала сессии''

"modified":"2025-06-10 09:49:08" — ''когда произошли изменения последние (пришел запрос/изменилась тематика)''
"robot":"ffeaa99a-13d2-4bff-b458-1231c884f8ee" — ''id робота, у продовой версии будет приписка _prod''

"session":"beefb6a2-dc08-47d4-9e02-2495329173ec" — ''id сессии''

"channel":"default" — ''активный канал, в котором происходит тестирование''

"connector":"web"

"unknown":false.
</blockquote>
[[Файл:2025-10-06 12-45-38.png|мини|''Рис. 23 Пример работы с отладчиком'']]
Далее идет самая интересная для аналитиков часть - <code>"current"</code> . Раскрыв этот ключ можно посмотреть в какую конечную точку привёл сценарий, и была ли запросу присвоена какая-либо категория. А так же параметр ''data'', раскрыв который можно увидеть все классы (рис. 23 и 23.1), которые пришли от модели [[SMC. UPS руководство по работе с интерфейсом|SMC]] и/или модели [[SEE. UPS руководство по работе с интерфейсом|SEE]] и их достоверность и вес. Раскрыв в ''data'' параметр ''reply -'' увидеть данные ответа от робота. Имея все эти данные можно отладить работу сценария.
[[Файл:2025-10-06 12-47-26.png|мини|''Рис. 23.1 Работа с отладчиком. Просмотр параметра data и логов'' ]]
<blockquote>"current":{

"id":"Консультация ЧаВО" — конечная точка, в которую привел сценарий,

"qas":"оформить снилс" — запрос, который отправился в QAS.

}<blockquote>'''Обратите внимание:''' если параметр QAS в отладчике пустой, это значит, что ваш запрос не был передан в QAS. Если же в этом параметре отображается ваш запрос, но робот просит вас перефразировать его, то, вероятно, в базе данных не хватает формулировки с ответом или на ответе отсутствует пометка «проверено». Это может происходить, когда в настройках КТ, отвечающей за консультирование из базы данных QAS, установлен параметр «Использовать кэш ответов» в режиме «Только проверенные ответы». </blockquote>'''Отработка склеек и удержания контекста''': в QAS летит вообще вся история сообщений в рамках одного контекста общения '''через разделитель «|»'''. Модель генерации будет отвечать на последний вопрос в цепочке с учетом ранее написанных сообщений в этом контексте.

"answered":true — был ли ответ true/false
"category":[0:"МФЦ НСО СНИЛС"] — отображается список категорий, в которые попал вопрос (их может быть больше одной).

"nearest":NULL

''Следующий кусок ключа current проще объяснить на примере запроса "оформить паспорт":''

"entry":"entry":[0:"Паспорт, вес 3" ] — зашли в КТ по метке «Паспорт», запросили тип паспорта (загран), старый/новый образец и дошли до возраста получателя:

"missingRunData":[

0:"Возраст заявителя для заграна, вес 3"] — тут отображаются ЭД, которые нужны для «пропуска» дальше в действия.

"passedRunData":[ ] — список условий AND, который выполнился.

"waitingRunData":

"Возраст заявителя для заграна, вес 3" — отображается ЭД, который запросили и ждем получения.

"border":0 — отражает границу, от которой система смотрит на данные. Например, при border:1 - система будет смотреть от 2-го ЭД в списке data и ниже. При border:0 - с первого.

"preborder":0

}</blockquote><blockquote>"models":[...] — раскрыв список, можно посмотреть все модели, которые отработали за сессию.

"scripts":[] — отображает список скриптов, которые отработали за сессию.

"data":[...] — раскрыв data, можно увидеть параметр "message" — фраза-сообщение пользователя. И под каждым message, есть своя data, где находятся все метки и все тэги, пришедшие от моделей SMC и SEE на эту фразу.

"timers":[...]

"variables":{} — тут отображаются пришедшие переменные, если есть.

"error":"" — выводит ошибку при отработке скрипта.

"events":{ — параметр отображает счетчики событий за сессию (не найдено/нет данных/тишина).

"not found":{...}

"no data":{...}

"silence":{...}

}</blockquote>

[[Файл:2025-06-10 16-15-43.png|мини|''Рис. 24 Окно автотестирования скриптов'']]

===== Тестирование скриптом =====
[[Файл:2025-06-10 16-22-59.png|мини|''Рис. 25 Добавление скрипта для тестирования'']]
[[Файл:Тестирование скриптов.png|мини|''Рис. 26 Интерфейс окна «Тестирование скриптов»'']]
Теперь вы можете автоматически тестировать робота с помощью скриптов. Например, если у вас возникли сложности с маршрутизацией и нет желания каждый раз вручную воспроизводить весь диалог при отладке сценария, вы можете сохранить его для последующего тестирования. Для этого кликните на кнопку [[Файл:Пробирки.png|безрамки|20x20пкс]] справа от чата появится окно. Добавить скрипт можно путем '''''импорта из файла''''' [[Файл:Импорт нов.png|безрамки|20x20пкс]], если есть данные '''в формате txt''' или '''''импортировать диалог''''' из текущей сессии. Нажмите на иконку импорта или выберите ''«Скрипт»'' в выпадающем меню и нажмите '''''«Добавить скрипт»''''' (рис. 24). Появится диалоговое окно «''Добавление скрипта»''. Введите название скрипта, выберите файл и нажмите ''«Добавить»''. Если у вас уже открыта сессия, отметьте в окне добавления скрипта опцию '''''«Импорт из чата»'''.'' Если у вас несколько скриптов, переключаться между ними можно через выпадающий список ''«Скрипт».''

Правее него находятся иконки ''импорт'' [[Файл:Импорт нов.png|безрамки|20x20пкс]], ''экспорт'' [[Файл:Экспорт нов.png|безрамки|20x20пкс]] и ''удалить'' [[Файл:Удаление документа.png|безрамки|20x20пкс]]. Импорт был описан ранее. '''''Экспорт''''' позволяет выгрузить скрипт в формате txt. Кнопка '''''удалить''''' - удаляет весь скрипт.

Файл для импорта и экспорта - это простой текстовый файл, в котором все запросы к роботу, каждый с новой строки.

Галочки обозначают точки останова (рис. 25). Когда они стоят, автотест останавливается и ждет, пока вы нажмете кнопку «Дальше». параллельно можно открыть отладчик и смотреть, что происходит на каждом этапе теста.

У тестирования есть два основных режима:

# Полный тест:
#* Все галочки сняты
#* Тест выполняется автоматически от начала до конца, без остановок
# Пошаговый режим:
#* Тест останавливается на каждом шаге
#* Для продолжения нужно нажимать "Дальше"

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

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

Последняя отправленная фраза будет выделена голубым цветом.

===== Просмотр данных сессии =====
Эта функция позволяет вам в реальном времени отслеживать диалоги и данные сессии у другого пользователя в '''рамках одного бота'''.

'''Подключение к отслеживанию'''

# Нажмите на иконку «Просмотр сессии» [[Файл:2025-10-22 12-54-24 (1).png|безрамки|20x20пкс]] . Введите название переменной, за которой хотите следить и ее значение (если требуется, например, номер телефона абонента) в соответствующие поля.
# Нажмите кнопку «Подключиться».
# Меню закроется, и вы увидите всплывающее уведомление с подтверждением успешного подключения.
# В основном интерфейсе индикатор отслеживания (иконка «Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]) изменит свой вид: он будет зачеркнут и периодически мигать. Это сигнализирует о том, что соединение активно и система ожидает данные.
Как поступают данные:

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

'''Отключение от отслеживания'''

Чтобы прекратить отслеживание, выполните одно из следующих действий:

* Нажмите на индикатор отслеживания («Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]), который активен в режиме подключения.
* Выполните команду «Сброс сессии» [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]].

Любое из этих действий разорвет соединение для отслеживания, и индикатор вернется в обычное состояние.

'''Пример настройки просмотра сессии'''

Пользователь, за чьим диалогом будет наблюдение, должен создать у себя переменную (любую) и ее значение:

* <code>variable = за мной следят</code>

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

Пользователь, который хочет подключиться для просмотра, должен в своем разделе ''просмотра сессии'' создать точно такую же переменную:

* <code>variable = за мной следят</code>

И после того, как начнется диалог, в режиме реального времени наблюдатель будет видеть все данные сессии того, кто ведет диалог с роботом.<blockquote>'''Функция для пользователей UPS'''

Для более удобного отслеживания вы можете использовать уникальный <code>id пользователя UPS</code> , который передается в переменные сессии.

* Вместо того чтобы указывать одинаковые переменные у обоих пользователей, вы можете напрямую указать <code>id пользователя</code>, за которым хотите следить.
* Это позволяет вам следить за конкретным пользователем, при этом ему не обязательно вручную задавать у себя переменную.
</blockquote>

===== Тестирование голосовыми сообщениями и в голосовом канале =====
[[Файл:2025-06-10 12-44-58.png|мини|''Рис. 27 Тестирование робота с помощью микрофона.'']]
Робота можно протестировать, задавая вопросы голосом и/или вводя переменные. Например, можно проверить, как робот отправляет в разные конечные точки, получая одинаковые метки от SMC и номера телефонов различных ведомств. Например, метка «Мобилизация» от SMC в сочетании с номером телефона МФЦ приводит в КТ Консультация ЧаВО, а «Мобилизация» и номер единого контактного центра (ЕКЦ) — в КТ Перевод на оператора. Чтобы провести тестирование робота с переменными раскройте меню, кликнув на иконку шестеренки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] и заполните поля:

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

- Значение: укажите значение этой переменной..
[[Файл:2025-10-06 11-51-58.png|мини|''Рис. 28 Иллюстрация тестирования канала voice.'']]
В этом же меню вы можете настроить параметры аудиоответов и автовоспроизведения.

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

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

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

В дебаггере есть функция, позволяющая протестировать '''голосовой канал - voice''' (рис. 28), то есть ''имитировать звонок''. Чтобы запустить процесс, достаточно нажать на кнопку «Начать разговор» [[Файл:Начать разговор.png|безрамки|20x20пкс]] . Пока разговор активен, кнопка изменится на «Закончить разговор» [[Файл:Закончить разговор.png|безрамки|20x20пкс]] . Переменные задаются в меню, как и в текстовом канале. Для этого нажмите на иконку шестерёнки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] (рис. 21).

=== Архив диалогов ===
[[Файл:Архив диалогов нов.png|мини|''Рис. 29 Интерфейс архива диалогов'']]
После тестирования робота в любом канале можно заглянуть в Архив диалогов (рис. 29), чтобы изучить данные сессии. Для этого необходимо кликнуть на одноименную кнопку на панели инструментов рядом с кнопками версий робота [[Файл:Архив диалогов.png|безрамки|20x20пкс]]. Интерфейс архива содержит:

* Список доступных роботов слева на экране.
* Блок с фильтрацией диалогов.
* До момента пока вы не выберете диалог из списка справа будет пустой блок с текстом «Выберете диалог». После того как диалог выбран вы увидите отображение аналогичное рисунку 29.
* Информационные вкладки (см. в разделе [[SES. UPS руководство по работе с интерфейсом#Настройка робота|«Настройка робота»]]).

==== Работа с архивом диалога ====
Архив диалогов поддерживает версионность робота, то есть можно просмотреть диалоги одной из трех версий: черновик, прод или архивной. Для этого кликните по кнопке с нужной версией находясь уже в Архиве либо предварительно выбрав ее и перейдя в архив. Диалоги в архиве фильтруются по дате и времени, для этого кликните на иконку календаря [[Файл:Календарик с фоном.jpg|безрамки|20x20пкс]] в поле «Начало» и «Конец», чтобы выбрать дату. И время, кликнув на иконку часов ''(по умолчанию дата и время выставляются за текущие сутки)''. Выберите нужную дату и время, добавьте необходимые фильтры. Также можно отфильтровать звонки по:

# каналам связи:
* default,
* telegram,
* web,
* voice,
* vkontakte.
2. элементам данных — при нажатии на это поле открывается перечень всех элементов данных из сценария текущего робота.

3. номеру телефона,

4. ID диалога берется из отладчика — это значение атрибута <code>session</code>. В архиве диалогов предусмотрено копирование ID: при нажатии на иконку копирования она загорается зеленым, что означает успешное копирование в буфер обмена.

5. по названию и значению переменной,

3. либо тексту, либо ключевым словам, которые могут быть в искомом диалоге.

После настройки система, по нажатию кнопки «Поиск», отобразит все диалоги с роботом, учитывая выбранные фильтры (рис. 27). На самом верху над диалогом можно просмотреть его ID. В архиве диалоги сгруппированы по принципу «запрос от пользователя — ответ робота». При выборе каждой пары открывается отладчик, где можно увидеть метки и теги, полученные от моделей, копия [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчика]] из тестирования робота. Этот отладчик аналогичен тому, что используется в сценарной машине. Для голосового канала есть возможность прослушивания аудио диалога помимо текстового просмотра. Также есть возможность импортировать запросы диалога в скрипт тестирования в чат-отладчик по кнопке '''«Добавить в скрипт тестирования»''' снизу диалога и в появившемся окне введите название скрипта тестирования. После чего он появится в списке скриптов тестирования сценария.

Для вашего удобства во время ''активного'' диалога в архиве доступна кнопка '''«Следить за диалогом»'''. Нажмите кнопку «Следить за диалогом» во время просмотра архива ''активного'' диалога. Система начнёт автоматически обновлять список реплик, подгружая новые сообщения. Обновление происходит каждые 5 секунд, обеспечивая актуальный вид беседы без необходимости обновлять страницу вручную. Позволяет в реальном времени следить за развитием ещё не завершённого диалога, например, во время тестирования или активного общения с роботом.

===== Синхронизация текста и аудио в архиве диалогов =====
В архиве диалогов реализована условная синхронизация текстовой расшифровки с аудиозаписью на основе временных меток (datetime).

* При воспроизведении аудио: В текстовой расшифровке автоматически подсвечивается реплика (вопрос/ответ), которая звучит в данный момент.
* При клике на текст реплики: Воспроизведение аудио автоматически перематывается на тот момент записи, когда эта реплика абонента была произнесена.

Результат: Вы можете быстро находить нужные фрагменты разговора и удобно анализировать диалоги.

Чтобы '''выйти из Архива диалогов''' в сценарий нужно снова кликнуть на иконку [[Файл:Архив диалогов.png|безрамки|20x20пкс]].

=== Пользовательские справочники ===
[[Файл:Photo 2025-05-14 17-30-31.jpg|мини|''Рис. 30 Добавление пользовательского справочника'']]

Для доступа к справочнику нажмите на значок «Пользовательский справочник» [[Файл:Справочник (1).png|безрамки|20x20пкс]] на панели инструментов справа от архива диалогов. Чтобы создать новый справочник, нажмите кнопку '''«Добавить справочник»''' (рис. 30). В открывшемся окне заполните обязательные поля: название справочника и его структуру — наименования колонок. При необходимости задайте значения по умолчанию для каждой колонки. Эти значения будут автоматически заполнять новые строки. Затем нажмите '''«Добавить»'''.

Если значения по умолчанию не указаны, справочник будет пустым. Заполнять таблицу можно вручную.

Справочники можно переименовывать и удалять. Чтобы переименовать или удалить справочник, наведите курсор на его название. Появится две иконки: карандаш для переименования и корзинка для удаления. <blockquote>'''Перед переименованием справочника ''обязательно'' сохраните внесенные изменения, иначе они будут удалены.'''</blockquote>[[Файл:2025-05-20 14-45-35.png|мини|''Рис. 31 Удаление записей из пользовательского словаря'']]
При нажатии на карандаш откроется окно '''«Редактирование структуры».''' Важно помнить: изменения можно внести только в название справочника или в значения по умолчанию (если предыдущие значения были, они будут автоматически обновлены). ''Переименовать столбцы нельзя.'' После сохранения изменений нажмите кнопку '''«Сохранить»''', расположенную внизу под таблицей (рис. 31). <blockquote>'''Внимание! Справочники зависят от версии робота.''' Если вы вносите изменения в структуру справочника в черновой версии [[Файл:Черновик.png|безрамки|20x20пкс]], то для применения этих изменений в продовой версии нужно применить робота в прод.

'''Важно:''' переносится '''только структура справочника'''. Данные не дублируются. Их можно перенести вручную, экспортировав [[Файл:Экспорт нов.png|безрамки|20x20пкс]] из черновика и импортировав [[Файл:Импорт нов.png|безрамки|20x20пкс]] в прод. </blockquote>Вы можете фильтровать записи по содержанию любой колонки. Выделите галочками несколько записей сразу и удалите их. В правом нижнем углу появится иконка корзины, как только вы выберете хотя бы одну запись (рис. 31).

Справочники можно ''экспортировать'' и ''импортировать''. Экспорт и импорт осуществляются в формате JSON.
[[Файл:Снимок экрана 2025-07-16 175752.png|мини|''Рис. 32 Импорт пользовательского словаря'']]

''При импорте структуры импортируемого файла и справочника в интерфейсе должны совпадать''. Если они не совпадают, то заполнятся только совпадающие поля. Есть возможность ''импорта'' с дополнением новых данных, либо полной заменой (''Рис. 32''). Структура экспорта:<blockquote>
[

{"колонка1":"значение 1","колонка2":"значение 2","колонка3":"значение 3","id":"58845671-1150-4ae2-9c46-e8aeb2553c57"},

{"колонка1":"значение 2","колонка2":"значение 2","колонка3":"значение 3","id":"2e0a7f8e-6d64-4df9-a3ce-5862f8eb441c"}

]
</blockquote>Структура json-файла для импорта:<blockquote>[

{"колонка1":"значение 4","колонка2":"значение 5","колонка3":"значение 6"},

{"колонка1":"значение 2","колонка2":"значение 3","колонка3":""}

]

При импорте не обязательно указывать id.</blockquote>Чтобы '''выйти из Пользовательских справочников''' в сценарий нужно снова кликнуть на иконку [[Файл:Справочник (1).png|безрамки|20x20пкс]].

=== Панель управления SES ===
Панель управления SES включает в себя 8 кнопок: импорт, экспорт, обнуление черновика рабочей версией, применение робота, восстановление робота, применение настроек робота, массовая замена моделей в элементах данных и меню пользователя.

{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления''
!'''Иконка кнопки'''
!'''Название иконки'''
!'''Описание'''
|-
|[[Файл:Export.png|центр|безрамки|40x40пкс]]
|Экспорт
|Для создания резервной копии или переноса робота выполните его экспорт в ZIP-архив. В архив будут включены все настройки робота: элементы данных, конечные точки, скрипты, структуры пользовательских справочников (''но не включая сами данные''), а также связанные модели и базы данных QAS.<blockquote>'''Внимание!''' Перед экспортом убедитесь, что категории и модели актуальны. В противном случае экспорт может завершиться ошибкой, и робот не будет экспортирован.</blockquote>
|-
|[[Файл:ImportRobot.png|центр|безрамки|40x40пкс]]
|Импорт
|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''.|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''. Аналогично экспорту, доступен и импорт робота с моделями SMC, SEE и QAS в различные наборы данных.
<blockquote>'''Как работает импорт:'''

* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.
'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>
|-
|[[Файл:Стрелка.png|безрамки|40x40px|центр]]
|Обнулить черновик рабочей версией
|Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Применить.png|безрамки|40x40px|центр]]
|Применить
|По нажатию на эту кнопку черновая версия робота становится рабочей ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Откат.png|центр|безрамки|40x40px]]
|Восстановить
|С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной ''(кнопка активна только в архивной версии)''.
|-
|[[Файл:Разетка.png|центр|безрамки|40x40px]]
|Применить настройки робота
|Применяет сохранённые настройки робота и начинает работать в соответствии с ними, что аналогично перезагрузке программного обеспечения, но без необходимости самой перезагрузки.
После нажатия на кнопку система переносит эти настройки в настройки прода, но НЕ ПРИМЕНЯЕТ, на случай, если ошиблись.

Робот в любой версии начинает работать с новыми настройками только после нажатия на кнопку. Если вы нажали на кнопку, находясь в черновике, будут применены настройки черновика. Если же вы нажали на кнопку, работая в рабочей версии, то будут применены настройки рабочей версии, которые вы только что перенесли из черновика. <blockquote>Обратите внимание: после внесения каких-либо изменений кнопка будет красной [[Файл:Красная вилка (1).png|безрамки|20x20пкс]] и пульсировать, напоминая о необходимости применить настройки. </blockquote>
|-
|[[Файл:Смена моделей.png|центр|безрамки|40x40пкс]]
|Массовая замена моделей в элементах данных
|[[Файл:Замена моделей в ЭД.png|мини|''Рис. 33. Массовая замена моделей в элементах данных'']]Эта функция позволяет массово менять модели в элементах данных. После нажатия на кнопку появляется форма ''(Рис. 33)'', в которой необходимо указать тип элемента данных ''(Класс / Сущность)''. Затем в поле '''"Заменяемая модель"''' выбрать модель из списка моделей, используемых в уже существующих элементах данных ''(снизу будет указано количество элементов данных, использующих выбранную модель)'', и в поле '''"Заменяющая модель"''' выбрать доступную модель для замены. После нажатия на кнопку '''"Заменить"''' будет произведена замена выбранной модели в тех элементах данных, в которых она используется.
|-
|[[Файл:Меню пользователя new.png|безрамки|40x40px|центр]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, убрать/показать фон, выход из системы), а также возможность переключить ''отображение рабочей области с табличного на облачный вид и наоборот''.
В меню пользователя добавлена функция ''выбора набора данных*.''

При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

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

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

2025-12-29T13:20:45Z

E.Elagina: /* Вкладка «Настройки» */

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

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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# SES Сценарная машина,
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]],
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]].
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2).
[[Файл:2025-06-09 14-33-48.png|мини|''Рис. 2 Рабочая область SES'']]

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

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

==== Добавление и настройка робота ====
Чтобы добавить нового робота, нажмите кнопку '''«Добавить робота»'''. В появившемся диалоговом окне введите название и нажмите '''«Добавить»'''. В нижнем правом углу экрана появится сообщение «Добавлено!». По умолчанию робот создается с предварительными настройками. В нем сразу есть текстовки для исключений и событий, ознакомиться и поправить их можно, перейдя на вкладку [[SES. UPS руководство по работе с интерфейсом|«Настройки»]]. Робот может быть 3х версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
{| class="wikitable"
|+''Табл. 1 Версии робота.''
!'''Иконка версии'''
!'''Наименование версии робота'''
!'''Описание'''
|-
|[[Файл:Черновик.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]], если вы планируете предоставлять консультации.

Здесь представлен общий перечень необходимых сервисов. В зависимости от специфики проекта некоторые из них могут отсутствовать.
[[Файл:2025-07-04 17-15-25.png|мини|''Рис. 3 Интерфейс вкладки Скрипты'']]

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

У скриптов есть параметр '''''«Область действия»''''', в котором есть 5 опций:

- ''конечные точки'', позволяет подключать скрипт в действиях конечных точек;

- ''элементы данных'', позволяет подключать скрипт в действиях элементов данных и контейнеров;

Скриптов на ЭД и КТ может быть несколько. Остальные скрипты общие и доступны только по одному на каждый тип:

- ''завершение сессии'' — скрипты, которые могут выполняться после завершения диалога, если скрипт указать в настройках в действиях на событии «Завершение диалога»;

- ''перед каждым вопросом'' — для случаев, когда нужно актуализировать какую-то информацию постоянно и использовать ее в условиях.<blockquote>

Скриптом «перед каждым вопросом» можно выставить, например, сегодняшнюю дату - ${custom.today}, а потом ее в сравнении дат использовать в условиях получения данных. Для случаев записи на прием проверять, '''что дата точно больше сегодняшней.'''

'''Скрипт проверки пишется админом.''' </blockquote>

- ''после каждого ответа'' — для случаев, где требуется пошагово после каждого ответа передавать информацию во внешнюю систему.

- ''передача диалога,'' скрипты для передачи диалогов.

- ''старт диалога.''

====== Дефолтные скрипты ======
В системе реализованы шаблоны скриптов по умолчанию:

Назначение:

* Автоматическое создание базовой функции при создании нового скрипта
* Возможность последующего редактирования

Расположение и настройка:

* Файлы находятся в переводчике по пути: <code>lang\ru.json</code>
* Реализовано для гибкости - администратор может изменять настройки
* Не зашито в код системы

Типы дефолтных скриптов:

* <code>_defaultScriptContainer</code> - для ЭД типа "Контейнер" (скрипты обработки)
* <code>_defaultScriptData</code> - для ЭД (скрипты постобработки)
* <code>_defaultScriptAction</code> - для действий в ЭД/КТ

[[Файл:Scrirts.png|мини|''Рис. 4 Отладка скриптов интеграции'']]
Есть '''режим отладки скриптов интеграций''' с функцией извлечения данных из сессии (рис. 4). То есть можно [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|тестировать робота в чате отладчика]] и, в случае если отработка некорректна или нужно проверить внесенные изменения в скрипт, то можно открыть вкладку «Скрипты» -> выбрать нужный скрипт -> кликнуть на закладку «Проверка» (слева откроется дополнительное окно) и нажать на кнопку «Вставить данные сессии». Тогда в открывшемся окне появятся все данные из текущей сессии из чата отладчика. По нажатию на кнопку «Тест», появится окно с результатом отработки скрипта.

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

[[Файл:2025-11-01 09-55-26.png|мини|''Рис. 5 Интерфейс вкладки «Интервалы»'']]

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

====== Группировка интервалов рабочего времени ======
Для удобства настройки сложных и переменных графиков работы в системе предусмотрена возможность объединять интервалы времени в группы. Это позволяет избежать создания громоздких условий в Контрольных Точках (КТ), когда рабочие часы оператора меняются каждый день или разбиты на несколько промежутков.

Для того, чтобы создать группу интервалов кликните на '''+''' справа от вкладки под номером '''1'''. Группа разделена на вкладки (табы), что позволяет удобно структурировать разные периоды.

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

* На одной вкладке настроить график для будних дней. Или для каждого дня отдельно.
* На другой вкладке — график для выходных.
* На третьей — особый график для праздников.

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

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

* '''события''' — действия, которые выполнит робот при наступлении определенного условия в диалоге, например «Не найдено» (см. раздел «События» ниже);
* '''исключения''' — это действия, которые выполняются, если событие повторяется указанное число раз подряд (см. раздел «Исключения» ниже);
* '''данные''';
* '''модели''' — настройка моделей, если требуется использовать параметры, отличные от параметров по умолчанию;
* '''коннекторы'''.

'''События''' есть 10-ти типов и прописываются для каждого канала связи отдельно:
[[Файл:2025-10-06 16-01-17.png|мини|''Рис. 6 Интерфейс вкладки «Настройки»'']]
# Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
# Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
# Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
# Запрос повтора — действия на случай, если абонент запросил повтор информации. Если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.
# Тишина — добавляем действие в моменты, когда от человека нет ответа, то есть тишина.
# Перебивание — событие доступно ''только для голосовых каналов (например, voice)''. Она позволяет настроить реакцию на прерывание речи.
# Задержка ответа — событие доступно ''для каналов web'' и ''voice)''. Это действия, которые появляются, когда идет генерация. Например, можно написать: «Секундочку, выясняю». Это нужно, чтобы человек понимал, что робот не просто молчит.
# Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя, то есть настройка действий если это событие произошло. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
# Нет данных — это событие происходит, когда система пытается получить конкретный недостающий элемент данных, например название филиала, и ей это не удалось.
# Ошибка.

'''При наступлении события система выполнит указанное в канале действие. Если действие для этого события в канале не задано, то ничего не произойдет.'''

Вы можете настроить реакции робота на определённые события. Более подробную информацию о них вы найдёте в разделе «Исключения».

'''Исключения''' есть трех типов '''Тишина''', '''Не найдено''' и '''Нет данных'''.

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

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

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

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

На вкладке можно настроить параметры голосового канала. Вот что там можно сделать:

* Выбрать голос, которым будет говорить робот.

* Установить основную модель распознавания (рекомендуем оставлять common).

* Определить фоновую модель распознавания (рекомендуем background).

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

* '''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)
* '''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
* '''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
* либо коррекция может '''Отсутствовать'''.

[[Файл:2025-10-06 16-47-09.png|мини|''Рис.7 Вкладка настроек коннектора telegram'']]

===== Вкладка «Коннекторы» =====
Позволяет настроить связь робота по одному из каналов: ''freeswitch'', ''max'', ''telegram'', ''vk'', ''web, nats.''

Для мессенджеров, таких как '''max''', '''telegram''', '''vk''', характерны следующие настройки:

* ''токен'',
* ''группа'' ''(для vk),''
* ''название бота'',
* ''обслуживающий сервер'' - имя сервера SES, который обслуживает данный коннектор,
* ''периодичность обновления'' - время периодичности запроса в api для получения новых сообщений,
* ''фразы-активаторы'' - список фраз, на которые будет реагировать робот в общих чатах, и считать, что сообщение адресовано ему,
* ''переменные,''
* ''фраза сброса сессии,''
* ''доступы'' - список пользователей, которые могут писать роботу. Если пустой, то могут все.

Для канала '''web,''' в частности, для встраивания чат-виджетов ''(рис 7.1).'' Данный коннектор предназначен для встраивания интерактивного виджета на ваш сайт. Доступно два типа виджета: '''Чат и Ассистент (Суфлер)'''.
[[Файл:2025-11-14 11-16-35.png|мини|''Рис. 7.1 Вкладка настроек коннектора web'']]
'''Общие параметры (для обоих типов)'''

Следующие настройки являются общими независимо от выбранного типа виджета.

* Домен: Укажите домен вашего сайта, на который будет встраиваться виджет. Это необходимо для безопасности, чтобы виджет мог работать только на указанном сайте.
* Токен: Уникальный идентификатор, который указан в теге <code>[[SES. Руководство администратора#Настройка виджета для сайта|<script>]]</code> для встраивания виджета на сайт.
* Акцентный цвет: Основной цвет интерфейса виджета (кнопки, заголовки, выделение). Используется для согласования с фирменным стилем вашего сайта.
* Заголовок виджета: Текст, который отображается в шапке открытого окна чата.
* Приветственное сообщение: Первое сообщение, которое видит пользователь при открытии чата.
* WebSocket-серверы: Технический параметр для установки соединения. Обычно заполняется автоматически и изменяется только по указанию технической поддержки.
* Язык: можно указать язык для виджета. Если не указывать, то будет дефолтный из конфига UPS.
<blockquote>Мультиязычность настраивается в настройках пользователя.</blockquote>'''Функциональные возможности'''

Эти опции позволяют включить или отключить определенные функции виджета.

* Голосовые ответы: Пользователь может прослушивать ответы от робота в аудиоформате.
* Отправка аудиосообщений: Пользователь может записывать и отправлять голосовые сообщения.
* Отправка файлов: Пользователь имеет возможность прикреплять и отправлять файлы.
* Аудиозвонок: Пользователь может инициировать голосовой звонок.
[[Файл:Ассистент.jpg|мини|''Рис. 7.2 Настройка переменных для режима "Ассистент"'']]
'''Выбор типа виджета'''

Перед сохранением конфигурации необходимо выбрать тип виджета, так как это влияет на доступность дополнительных параметров.

''Тип: "Чат"''

Стандартный режим для интерактивного общения с пользователем. Все "Функциональные возможности" и "Общие параметры" доступны для настройки. Также доступен блок "Переменные".

''Тип: "Ассистент" (Суфлер)''

Режим, предназначенный для подсказок оператору во время разговора с абонентом. Все переменные, необходимые для работы ассистента, настраиваются и передаются отдельно в личном кабинете пользователя. Сначала нужно авторизоваться в системе UPS ''(рис. 7.2)'', и дальше суфлер подключится сразу ко внутреннему номеру, который указан в настройках пользователя, там же можно переопределить цветовую схему под каждого пользователя.

Для канала '''freeswitch''' (телефонная линия):

* ''название коннектора,''
* ''режим обслуживания:''
** Режим «Как робот»
*** <code>Внутренний номер</code>: Указывается внутренний номер этого робота.
*** Опция ассистента: Дополнительно настраивается параметр, который определяет, будет ли ассистент (суфлер) работать после перевода звонка на оператора.
*** <code>Конечная точка</code>
** Режим «Как ассистент»
*** <code>Внутренний номер</code>: Указывается внутренний номер робота-ассистента (суфлера).
*** <code>Номер для перевода звонка</code>: Указывается номер, на который будет переключаться звонок (номер колл-центра или конкретного оператора).
Работа ''суфлера после перевода звонка'' на оператора возможна ''в двух режимах'':

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

Флаг '''"Автостарт ассистента"''' при активации этой опции, ассистент запускается автоматически.

Настройки канала '''''nats''''':

* название коннектора,
* адрес серверов,
* канал входящих сообщений,
* канал исходящих,
* обработчик.

Принцип работы:

* Отправитель (канал исходящих сообщений) отправляет сообщение в определенный subject.
* Получатели (канал входящих сообщений), которые проявили интерес к этому subject, получают сообщение.
* Subject выступает в роли классификатора, позволяя разделять различные потоки сообщений для разных задач и сервисов.

Для работы коннектора необходимо указать адрес сервера NATS и топики (Subjects) для отправки и получения сообщений.

[[Файл:Функционал действий.png|мини|''Рис. 8 Функционал Действий'']]

==== Виды действий в роботе и работа с ними ====
'''1. Основные действия'''

Доступны следующие типы действий:

* '''Сказать'''

Настройте текстовые ответы робота. Это может быть простая фраза-заглушка, ответ, сгенерированный AI (LLM), или ответ из базы знаний (QAS). Типы ответов «Сказать» подробно описаны в разделе 2.

<blockquote>При наведении мыши на поле «Фраза» появляется кнопки-иконки [[Файл:Управление фразой действия.png|безрамки|64x64пкс]], где можно выбрать одно из действий:
# Добавить кнопку (подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Добавление кнопок в действия|«Добавление кнопок в действия»]]). Доступно пользовательское расположение кнопок, которые регулируются переносами на новые строки.
# Перефразировать. Если нужно добавить вариации фразы (рис. 8). Предложенные фразы можно отредактировать или удалить, кликнув по иконке корзинки напротив нужной фразы и добавить в список фраз.
# Удалить лишнюю фразу можно, если она не единственная.
</blockquote>

* '''Подтвердить'''

Настраивается фраза для подтверждения.

* '''Отправить файл'''

Позволяет отправить файл в ответ на запрос пользователя.

* '''Остановить выполнение действий'''

Немедленно прекращает выполнение всех последующих действий в текущем сценарии и сбрасывает точку выполнения диалога.

* '''Передача диалога'''

Переводит разговор, например, на оператора или в другой отдел. Для настройки необходимо указать ''Назначение'' передачи.

* '''Забыть данные'''

Позволяет стереть определенные данные, введенные пользователем, чтобы запросить их заново. При активации опции ''Перезапросить'' система автоматически сформирует запрос на ввод недостающих данных.

* '''Завершить диалог'''

Завершает текущий разговор с пользователем и закрывает сессию.

У некоторых действий есть опции:
* ''Считать действие успешным прохождением точки'' — этот флаг устанавливается на действия, которые означают, что сервис выполнился. В основном для отчетности.
* ''Прерываемое'' — этот флаг активируется для голосового канала и говорит о том, что допускается прерывание (перебивание) робота в момент синтеза ответа. Если он активен, робот будет реагировать на стоп-слова, в противном случае — нет.
* '''Установка переменной'''
позволяет задать или изменить значение переменной после выполнения определенного события в сценарии. Это мощный инструмент для создания сложной логики, например, для подсчета количества попыток входа в сервис и последующих действий в зависимости от этого значения.

* '''Принудительно перейти в КТ'''

позволяет принудительно отправить диалог в выбранную конечную точку.

'''2. Типы ответов для действия «Сказать»'''

При использовании действия «Сказать» вы можете выбрать один из четырех типов ответа:

1. ''Последовательно''

Робот будет выдавать вопросы и информацию по порядку, строго следуя списку, указанному в поле «Фразы».

2. ''Случайная фраза''

Робот выберет и произнесет одну случайную фразу из заданного списка.

3. ''Из внутреннего источника (недоступно для действий в элементах данных)''

Ответ формируется из Системы ответов на вопросы (QAS) для ответа из ''QAS документация'' нужно настроить'':''

* Условия присвоения категорий: Определяет правила, при которых система может направить запрос в эту категорию QAS для поиска ответа.

* Условия вывода ответа: Настройте параметры, такие как использование кеша ответов, генерация ответа и кеширование формулировок и [[QAS. UPS руководство по работе с интерфейсом#%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%20%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B8%20%C2%AB%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D1%8B%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2%C2%BB|выбрать шаблон запроса]]. Подробности [[QAS. UPS руководство по работе с интерфейсом|тут]].<blockquote>'''Обратите внимание:''' если вам нужно изменить шаблон запроса для определенной категории, это делается путем добавления отдельного действия. Настройка этого действия аналогична основному, но с выбором нужного шаблона. В Условиях запуска указываете данные, которые запустят это действие с шаблоном-исключением. </blockquote>

''QAS-чат'': Ответы генерируются AI-моделью (LLM) по умолчанию или другой моделью, добавленной администратором.

4. ''Из внешнего источника''

Позволяет подключить скрипты интеграций для выполнения специальных действий, если таковые имеются. Для действия «Сказать» с типом «Из внешнего источника» нажмите на специальную кнопку, расположенную рядом с полем выбора скрипта [[Файл:Postprocessing.png|безрамки]]. Откроется вкладка с выбранным скриптом, где вы можете:

* Просматривать код текущего скрипта,
* Редактировать существующий скрипт,
* Создавать новый скрипт.

<blockquote>Редактирование и создание скриптов не влияют на сохранение ЭД/КТ, т.к. они ссылаются только на id скрипта. Если вы выбираете другой скрипт для действия, обязательно сохраните изменения.</blockquote>'''3. Управление действиями'''

Для каждого действия доступны три опции управления (обычно отображаются в виде значков [[Файл:Для действий.png|безрамки|72x72пкс]]):

1. ''Копировать''

Чтобы скопировать действие в другой канал, нажмите эту кнопку и в открывшемся окне выберите целевой канал из списка.

2. ''Переместить''

Чтобы переместить действие в другой канал, выполните те же шаги, что и для копирования. <blockquote>'''Внимание:''' При перемещении действие будет удалено из исходного канала.</blockquote>3. ''Удалить действие''

Чтобы удалить действие, нажмите на кнопку в виде корзины.

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

===== Добавление кнопок в действия =====
В сценарной машине предусмотрена возможность добавления кнопок.

При наведении мыши на поле «Фраза» появляется кнопки-иконки , где по иконке с плюсом можно добавить кнопку:

# название кнопки;
# текст для отправки — это тот текст, который отправится на модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]], [[SEE. UPS руководство по работе с интерфейсом|SEE]]).

Чтобы внести изменения в созданную кнопку, кликните по ней левой клавишей мыши (ЛКМ) и в открывшемся меню можно редактировать или удалить эту кнопку.

Интерфейс позволяет гибко управлять расположением кнопок с помощью переносов на новую строку.

Чтобы настроить порядок кнопок:

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

Этот инструмент позволяет визуально сгруппировать кнопки и организовать интерфейс максимально удобно для пользователя.

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

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

''Переменные'' — служат для хранения данных, полученных из API или по каналам, запущенным извне. Например, это может быть ID пользователя в Telegram или CID из телефонного канала, то есть определившийся номер телефона.<blockquote>'''Переменные, как и данные, можно выбирать из выпадающего списка.''' Доступны все названия и значения, которые использовались ранее. Если вам нужно создать новую переменную и значение, просто введите их с клавиатуры. После этого они также будут предлагаться вам в дальнейшем.</blockquote>''Данные'' — элемент данных, полученный от моделей SMC или SEE.

''Интервал'' — период времени, в который запускается это действие. У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.
''Подтвердить'' — запуск действия в зависимости от наличия подтверждения от абонента.
[[Файл:Уведомление дублей.png|мини|''Рис. 9. Уведомление об одинаковых блоках ИЛИ в условиях запуска действий'']]
В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»'' (рис. 9)''.''<blockquote>'''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.</blockquote>

Также при сохранении настроек в окне "Условий запуска" если были обнаружены одинаковые блоки условий "ИЛИ", то будет соответствующее оповещение с выделением повторяющихся блоков ''(Рис. 9''.)

Пример использования условий запуска действий в конечной точке ''«Проверка статуса»:''<blockquote>
'''Ситуация 1.'''

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

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

'''Ситуация 2.'''

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

1. Определить элемент данных, который отвечает за отслеживание цифр (код). В нашем случае это модель SEE number и элемент данных «Код заявления».

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

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

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

==== Добавление и настройка элементов данных ====
[[Файл:Снимок экрана 2025-07-16 154838.png|мини|''Рис. 10. Массовое добавление элементов данных'']]
[[Файл:2025-12-11 11-15-27.png|мини|''Рис. 10.1. Бланк настройки элемента данных'']]
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку '''«Добавить элемент»'''. В появившемся диалоговом окне возможны два варианта добавления: '''"Одиночное"''' и '''"Массовое"'''.

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

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

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

'''Контейнер''' — составной элемент данных, который собирает необходимые данные, чтобы отправить их во внешнюю БД по API с помощью скриптов интеграции.

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

===== Настройка элемента данных =====
[[Файл:2025-04-23 14-43-07.png|мини|''Рис. 11 Проверка модели в ЭД'']]
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (''Рис. 10.1'').

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

'''«Вес»''' — это параметр, который определяет приоритет этого элемент данных в спорных ситуациях. По умолчанию установлено значение 3. Также вес ЭД отображается в [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчике]] и, если у вас активировано [[SES. UPS руководство по работе с интерфейсом#Панель управления SES|табличное представление сценария]], то и в самой таблице. <blockquote>Совет по работе с весом ЭД.

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

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

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

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

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

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

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

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

Рядом с комментарием находится кнопка '''Исключения''' [[Файл:Исключения .png|безрамки|20x20пкс]]. По нажатию на эту кнопку можно для определенных элементов данных настроить нестандартные исключения, то есть исключения, отличные от общих настроек (рис.12). <blockquote>
Например, для ЭД «Название филиала». [[SES. UPS руководство по работе с интерфейсом#Вкладка «Настройки»|В общих настройках]] робота МФЦ указано, что количество исключений для события «Нет данных» равно 3 (в счетчик входит и первое обращение к роботу, если там не было нужной информации). Однако мы хотим, чтобы, если с первого раза филиал не был найден, робот больше не запрашивал у абонента его название. Вместо этого робот должен показать заглушку с предложением поискать нужный филиал на сайте. Для таких случаев можно настроить '''нестандартное исключение.''' </blockquote>Настройка нестандартного исключения:

# выберете нужный элемент данных,
# кликните на значок исключения [[Файл:Исключения .png|безрамки|20x20пкс]],
# в появившемся окне активируйте флаг «включить нестандартные исключения»,
# заполните тип исключения Нет данных,
# установите максимальное кол-во исключений подряд (если хотите уточнять один раз, то макс.кол-во устанавливайте равным 2),
# установите канал связи при необходимости,
# и выберете действие на случай, если исключение наступило.
[[Файл:Постобработка ЭД.png|мини|''Рис. 12.1. Постобработка данных'']]
Далее находится кнопка '''«Постобработка»''' [[Файл:Postprocessing.png|безрамки]]'''.''' При нажатии на нее появится всплывающее окно с редактором кода, где можно написать функцию, которая будет срабатывать после того как ЭД был получен (Рис. 12.1). Установите галочку '''«Включить постобработку»''' и в редакторе отобразится функция-обработчик, которая принимает на вход три параметра: ''значение ЭД, текст последнего сообщения, канал'', и возвращает значение ЭД и опционально текст сообщения.<blockquote>'''Пример:'''

<code>def handler(value, message, channel):</code>

<code> if value == 'старый' and message == 'старый' and channel == 'voice':</code>

<code> return 'новый', {'text':'новый'}</code>

<code> elif value == 'новый' and message == 'новый' and channel == 'voice':</code>

<code> return 'старый', {'text':'старый'}</code>

<code> return value, {'text': 'не тот канал'}</code></blockquote>

'''Тестирование скриптов в ЭД'''

Процесс тестирования скриптов в ЭД аналогичен тестированию скриптов во вкладке "Скрипты", с учетом того, что скрипты находятся непосредственно в самих ЭД.

Важное отличие:

* Для ЭД типа «Класс» или «Сущность» - поле «Значение» обязательно для заполнения.
* Для ЭД типа [[SES. UPS руководство по работе с интерфейсом#Произвольный элемент данных|«Произвольный»]] - поле «Значение» заполняется по необходимости (опционально).

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

'''Работает только в условиях запуска. Если ЭД с этим флагом стоит на входе в КТ, то фраг игнорируется.'''</blockquote><blockquote>'''Пример: Запись на прием'''

1. Процесс взаимодействия с пользователем

Пользователь хочет записаться на прием. Для этого необходимо собрать следующие данные:

* Намерение (цель обращения).
* Адрес (куда хочет попасть пользователь).
* ФИО.
* Номер телефона.

2. Работа моделей в КТ "Запись на прием"

* Все модели, отвечающие за обработку запроса, работают в фоновом режиме.
* На любом этапе диалога они могут «выхватывать» сущности (например, извлекать ФИО, адрес и т. д.).

3. Проблема ложного срабатывания

Модель может ошибочно извлечь данные, если:

* Пользователь вводит информацию, которая частично совпадает с искомой сущностью (например, город ''"Владимир"'' может быть ошибочно принят за имя).
* Это приводит к некорректной обработке данных до завершения сценария.

4. Решение: ограничение работы модели

Чтобы избежать ложных срабатываний:

* Активируйте галочку '''«Получать только прямым запросом»''' в настройках ЭД.
* Если галочка активна, модель (например, извлечение ФИО) сработает только когда:
** Сценарий диалога дошел до запроса ФИО.
** Пользователь явно отвечает на вопрос о недостающих данных по ФИО.

Таким образом, '''система не будет обрабатывать случайные упоминания имен или других сущностей вне контекста запроса.'''</blockquote>Флажок '''«Подставлять ответ модели в запрос к ЧаВО»''' предназначен для работы с типами ЭД «Сущность». Его основная функция — подставлять в запросы пользователей ответ от модели (название тэга) SEE вместо исходного текста абонента, на который среагировала модель.<blockquote>'''Пример использования'''

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

# Создаем модель SEE с тегами:
#* <code>до 14 лет</code>
#* <code>с 14 лет до 18 лет</code>
#* <code>с 18 лет</code> ''(Теги формируются на основе предоставленной документации.)''
# Добавляем ЭД в качестве недостающего элемента в настройки КТ.
# Когда сценарий доходит до дозапроса этого ЭД или абонент сам предоставляет данные, система отправляет запрос в QAS. Например, абонент отвечает, что ему 44 года, но в документах нет такого варианта. В них информация сгруппирована <code>до 14 лет</code>, <code>с 14 лет до 18 лет</code> и <code>с 18 лет.</code> Соответственно система не найдет похожую информацию.
# Решение:
#* Если флажок активирован, система подставит ближайший подходящий тег (в данном случае — <code>с 18 лет</code>).
#* Это поможет QAS корректно находить информацию в документации.
'''Важно:''' если ваша модель SEE '''не отдаст ответ''', то настройка '''не сработает'''. Проверьте и при необходимости дообучите модель.</blockquote>

Флаг '''«Удалять сущность из запроса к ЧаВО»''' предназначен для типов «ЭД Сущность» и работает наоборот: он удаляет из запроса пользователя слова или фразы, которые распознала модель.

Флажок '''«Режим долгого ожидания»''' Открывает дополнительное меню с триггерами окончания ожидания. Это данные, при получении которых мы прекращаем ждать именно этот элемент данных (ЭД). Например, если получили его же или другие данные, например, просьбу позвать оператора.<blockquote>'''Обратите внимание:''' чтобы этот режим работал правильно, создайте нестандартное исключение для ЭД (описание выше). Иначе система будет ориентироваться на общие настройки количества исключений.</blockquote>

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

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

===== События элемента данных =====

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

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

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

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

'''Тип события''' '''«Элемент получен».''' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).

'''Тип события''' '''«Тишина»''' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек молчит.[[Файл:Уведомление об отсутствующем классе.png|мини|''Рис. 14. Уведомление об отсутствующем классе'']]<blockquote>
Например, если робот спрашивает у абонента, какой паспорт ему нужен, а человек молчит, можно через некоторое время повторить вопрос или сказать: «Говорите громче, не слышно».</blockquote>

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

В таблице элементов данных предусмотрено уведомление ''(Рис. 14)'' об отсутствующей модели на сервере, которую использует элемент данных, а также об отсутствующем классе/группе в выбранной модели. При таких случаях слева от элемента данных расположен значок [[Файл:Warning.png|безрамки]], при наведении курсора мыши на который появляется соответствующее сообщение.

===== Произвольный элемент данных =====
Элемент данных типа «Произвольный» предназначен для обработки произвольных текстовых данных от пользователя, таких как:

- Нажатия кнопок (текста на кнопках),

- Точные текстовые фразы,

- Данные, присваиваемые через скрипты.

''Простая настройка:''

- Текст: текст от пользователя (например, текст на кнопке или точная фраза), который нужно «отловить».

- Значение элемента данных: присваиваемое значение этому элементу данных (param).

''Универсальное применение:''

- Обработка различных кнопок в одном элементе данных.

- Возможность скриптового присвоения любых значений.

- Замена использования элемента-заглушки со скриптами.

- Пользоваться таким ЭД можно точно так же как и другими элементами. Вести в разные действия и категории исходя из значения произвольного ЭД.<blockquote>''Пример использования''

Сценарий: Обработка различных текстов с кнопок БЕЗ обработки моделями, то есть модель может «не знать» этих фраз:

- Текст: "Поддержка участников СВО" → Значение ЭД: «Поддержка СВО»

- Текст: "Льготы для пенсионеров" → Значение ЭД: «Социальные услуги»

Таким образом, один произвольный элемент данных может обрабатывать множество различных вариантов ввода.</blockquote>[[SES. UPS руководство по работе с интерфейсом#События элемента данных|События]] на этом элементе аналогичные как и на обычных ЭД.

[[Файл:2025-10-06 13-10-56.png|мини|''Рис. 15 Интерфейс контейнерного ЭД'' ]]

===== Элемент данных типа «Контейнер» =====
Контейнер — это составной элемент данных, который объединяет несколько дочерних элементов для последующей обработки. Его основная функция — сбор необходимых данных и их отправка во внешнюю базу данных через API с использованием скриптов интеграции.

Доступ к редактору скриптов:

# Перейдите в карточку элемента данных «Контейнер»
# Нажмите на кнопку вызова редактора скриптов [[Файл:Postprocessing.png|безрамки]]
# ''Важно:'' Если скрипт не заполнен, кнопка будет подсвечиваться красным цветом

Создание функции обработки:

* При нажатии на кнопку открывается всплывающее окно с редактором кода
* Функция выполняется после получения всех данных элемента
* Для активации установите галочку «Включить скрипт обработки»

Функция принимает три входных параметра:

# <code>value</code> — значение текущего элемента данных
# <code>message</code> — текст последнего сообщения от пользователя
# <code>chanel</code> — идентификатор канала взаимодействия

Функция возвращает:

* Обязательно: обработанное значение элемента данных (value и записывает его в значение ЭД param)
* Опционально: текст сообщения для пользователя

События контейнерного ЭД:

* ''«Элемент получен».'' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).
* ''«Нет данных»'' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек говорит что-то, но не ответ на вопрос.

==== Добавление и настройка конечных точек ====
[[Файл:2024-11-18 12-00-28.png|мини|''Рис. 16 Рабочая область SES'']]Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В верхней правой части рабочей области расположена кнопка '''«Добавить конечную точку»''' (рис. 16). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки образуют «облако конечных точек».

===== Настройка конечной точки =====
После того как вы ввели название конечной точки и нажали кнопку '''«Добавить»''', слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается ''название конечной точки'', при желании его можно сменить. Также доступен выпадающий список «Тип». Здесь можно выбрать один из четырёх вариантов:[[Файл:2025-03-28 14-57-55.png|мини|''Рис. 17 Типы входа в конечные точки'']]'''«Отчетный»''' — эта та, которая участвует в статистике, т.е. несет какую-то полезную для анализа информационную нагрузку.

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

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

'''«Завершение диалога»''' — конечная точка, которая ставит точку в общении с пользователем.[[Файл:2025-05-28 16-23-27.png|мини|''Рис. 18 Вход в КТ по условиям'']]

Также можно выбрать еще '''Тип входа в КТ''' может быть трех видов (рис. 17):

'''- по условиям''', когда попадаем в КТ при условии получения определенных данных, например, класс от SMC (рис. 18). На вкладках «Условия» доступна ''фильтрация по элементу данных.''

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

Абонент обратился за консультацией. Робот предоставил ответ. После консультации абонент бездействует, а сессия еще не закрыта. Можно настроить КТ Оценка качества обслуживания, которая по истечению указанного времени запросит оценку, после ответа абонента, завершит сессию.</blockquote>- '''по ручному запуску''', когда КТ нужно принудительного запустить, например для рассылки. Чтобы настроить вход в конечную точку нужно выбрать в меню Вход опцию «По ручному запуску». Интерфейс КТ по ручному запуску идентичен КТ со входом «По бездействию», за исключением поля «Время».

Такой вариант входа в КТ подходит для исходящих сообщений (обзвонов), например, чтобы отправить абоненту напоминание-подтверждение о предстоящей записи: «Уточните, пожалуйста, вы придете на прием?»

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

'''Настройка исключений для конечных точек'''

Вы можете настроить автоматическое реагирование на сбои в работе конечных точек. Исключения [[Файл:Исключения .png|безрамки|20x20пкс]] - это специальные действия, которые выполняются при нескольких последовательных неудачных запусках конечной точки.

Система отслеживает статус запусков. Когда количество неудачных попыток подряд достигает заданного вами значения (например, 3), автоматически выполняется указанное вами действие.

Пример настройки:

* Условие: 3 неуспешных запуска подряд.
* Действие: Перевести звонок оператору ''или'' Завершить диалог.

===== Условия входа и запуска конечных точек. Сбор информации =====
'''Типы условий для входа'''

Для настройки условий '''входа''' в системе доступны три основных типа:

1. ''Данные''. Проверка значений элементов данных.

2. ''Переменные''. Работа с системными и пользовательскими переменными.

3. ''Подтверждение''. Проверка статуса подтверждения от пользователя. Возможные значения:

* Получено (пользователь подтвердил действие)
* Не получено (пользователь отклонил действие)

Для '''условий запуска''' есть дополнительно 4-ое условие, помимо вышеперечисленных:

4. ''Интервалы.'' У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.

Для '''сбора информации''' есть только 2 варианта условий: данные и переменные.<blockquote>Применение: Эти типы условий позволяют гибко управлять логикой диалога, направляя пользователя по различным сценариям в зависимости от текущего контекста.</blockquote>

'''Условия входа (Вход).''' Для того чтобы попасть в конечную точку и выполнить определенные действия, нужно выполнить условия входа. Их может быть как один элемент данных, так и их сочетание.<blockquote>Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: ''«Загранпаспорт»'' (получена метка от [[SMC. UPS руководство по работе с интерфейсом|SMC]], соответствующая этому элементу данных). А также сочетание элементов данных: ''«Паспорт»'' (получаем, если тип паспорта не указан сразу) и ''«Тип паспорта-загран»'' (тег «Загран» получили после уточнения типа паспорта).</blockquote>Условия входа объединены в блоки, которые имеют логическое условие «И». Чтобы добавить новое условие, необходимо нажать на кнопку «Добавить условие» [[Файл:Добавить условие.png|безрамки|20x20пкс]]. Блоки с условиями «И» разделены логическим «ИЛИ».
Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:
* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* + (Прибавить) — для увеличения счетчика,
* - (Вычесть) — для уменьшения счетчика,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

[[Файл:Рис. 17 Условия запуска.png|мини|''Рис. 19 Условия запуска'']]
'''''Условия запуска и Сбор информации''.''' Вкладка ''Сбор информации'' и меню ''Условия запуска'' идентичны по своему назначению'''.'''

По нажатию на эту кнопку открывается окно, где нужно указать '''''все''''' случаи (данные и их комбинации), '''''при которых точка сработает''''' (см.рис. 19). В окне «Условия запуска» элементы данных разделяются логическим оператором «ИЛИ». В случае с комбинациями условий ЭД отделяются друг от друга логическим «И». Как в случае с элементами, разделёнными операторами «ИЛИ», так и с элементами, разделёнными «И», порядок элементов можно менять. Аналогично для вкладки Сбор информации.

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

Условия можно редактировать: добавлять и удалять. Окно можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.<blockquote>Например, конечная точка «Консультация» активируется, если будут получены метки «Апостиль» ИЛИ «Банкротство» ИЛИ «Загранпаспорт» и «Тип паспорта — загран».</blockquote>В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»''. '''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.

У условий есть параметр ''«Тип»'', принимающий два значения: данные или переменная. Параметр ''«Искать»'' имеет три варианта:

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

Далее идет поле «Название», где из выпадающего списка требуется выбрать нужный элемент данных. <blockquote>Если в выбранном элементе данных не заполнено событие «Недостающий элемент», то в правом верхнем углу будет расположен значок [[Файл:Warning.png|безрамки]] со всплывающим уведомлением при наведении на него.</blockquote>Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:

* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

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

===== Условия присвоения категорий =====
[[Файл:2025-07-07 12-42-57.png|мини|''Рис. 20 Вкладка Действия и Условия присвоения категорий'']]
'''''Условия присвоения категорий'''.'' По клику на эту кнопку раскрывается меню (рис. 20), в котором есть выпадающий список со всеми категориями из [[QAS. UPS руководство по работе с интерфейсом|QAS]], а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ». ''Окно с условиями категорий или условиями запуска можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.''<blockquote>На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ». </blockquote>Флажок '''«Запрос в QAS с учетом прошлого контекста»''' указывает системе, что перед отправкой запроса в QAS необходимо проанализировать предыдущие сообщения пользователя. Это позволяет сохранять логику диалога и избегать необоснованной смены тематики.<blockquote>'''Пример работы'''

# Без включенной функции
#* Пользователь спрашивает: ''"Какие документы нужны для оформления СНИЛС?"'' → система направляет запрос в категорию СНИЛС.
#* Затем пользователь уточняет: ''"А сколько это стоит?"'' → система определяет метку Госпошлина и перенаправляет запрос в соответствующую категорию, теряя контекст СНИЛС.
# С включенной функцией
#* Если флажок активен (например, для категории ''Госпошлина''), система:
#** Проверяет предыдущие сообщения.
#** Если диалог начался в другой категории (например, СНИЛС), запросы объединяются (''"склеиваются"'').
#** Если контекст отсутствует, тематика меняется, но поиск ответа ведется сразу по обеим категориям (СНИЛС + Госпошлина).

'''Когда использовать'''

Активируйте эту настройку для категорий, которые могут:

* Быть частью более широкого запроса (например, ''Госпошлина'' как дополнение к ''СНИЛС'').
* Требовать сохранения контекста диалога.

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

===== Индикация удаленных категорий =====
Система визуально выделяет удаленные категории для привлечения вашего внимания:

# Конечные точки с недействительными категориями в табличном представлении: помечаются специальным значком и выделяются красным цветом. При наведении на значок сообщение: ''«Используются несуществующие категории в канала: [название_канала](кол-во)»''
# В облаке конечных точек: КТ с недействительными категориями также отображаются красным цветом, но без значка.
# В условиях присвоения категорий: Если используется удалённая категория, система отобразит предупреждающее уведомление ''«Используются несуществующие категории: [кол-во]»''.

Это позволяет быстро находить и корректировать объекты, которые зависят от неактуальных данных. А так же это важно для экспорта и импорта роботов (см. разд. Панель управления).

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

==== Связанная фильтрация ЭД и КТ ====
В интерфейсе реализована связанная фильтрация между таблицами Элементов Данных (ЭД) и Контрольных Точках (КТ). Это позволяет автоматически находить взаимосвязанные объекты.

'''Принцип работы:'''

* Фильтрация по ЭД: При вводе названия в фильтр таблицы Элементов Данных:
** В таблице ЭД отображаются только те элементы, названия которых соответствуют фильтру.
** Одновременно в таблице КТ автоматически отображаются только те Контрольные Точки, в которых используются отфильтрованные ЭД.

* Фильтрация по КТ: При вводе названия в фильтр таблицы Контрольных Точек:
** В таблице КТ отображаются только те точки, названия которых соответствуют фильтру,
** Одновременно в таблице ЭД автоматически отображаются только те Элементы Данных, которые используются в отфильтрованных КТ.

<blockquote>'''Важно''':

Система учитывает использование Элементов Данных во всех типах Контрольных Точек:

1. Входные данные (вход).

2. Собираемая информация (условия запуска/сбор информации).

3. Условия запуска действий.</blockquote>

==== Тестирование робота ====
[[Файл:2025-10-06 11-49-26.png|мини|307x307пкс|''Рис. 21 Окно чата для тестирования робота'']]
В интерфейсе SES есть чат с отладчиком (рис. 21), где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок [[Файл:Чат.png|безрамки|20x20px]] в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка '''«Перезапустить сессию»''' [[Файл:Обновить данные вопроса.png|безрамки|20x20px]], которая сбрасывает всю переписку и данные отладчика. А слева — кнопка '''«Данные сессии»''' [[Файл:Кнопка отладчик без полей.png|безрамки|20x20px]], предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS и не только, подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Данные сессии|Данные сессии]]. И кнопка '''«Тестирование скрипта»''' [[Файл:Пробирки.png|безрамки|20x20пкс]], подробнее [[SES. UPS руководство по работе с интерфейсом#Тестирование скриптом|тут]]. Есть возможность отправлять в чат файлы нажав на [[Файл:Скрепка.png|безрамки|20x20пкс]] и выбрав файл (в любом формате).

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

Режим отладки (дебаг):

* В режиме отладки появилась панель логов.
* Логи автоматически обновляются после каждого ответа от робота.
* Вместе с логами также обновляются данные текущей сессии.

Настройки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] чата позволяют выбрать настройки аудиоответов, а так же установить переменные, например, номер телефона.

Еще в меню настроек можно выбрать КТ по ручному запуску, чтобы протестировать работу КТ и сценария (рис. 22).
[[Файл:2025-10-20 10-56-18.png|мини|300x300пкс|''Рис. 22 Выбор конечной точки для тестирования.'']]

===== Тестирование в текстовых каналах =====

===== Данные сессии =====
Раскрыв данные сессии можете увидеть, все данные о текущем диалоге с роботом. Разберем по порядку, ниже представлены некоторые данные из ключа root, они нужны не все, разберем только нужные:<blockquote>
"started":"2025-06-10 09:46:05" — ''время начала сессии''

"modified":"2025-06-10 09:49:08" — ''когда произошли изменения последние (пришел запрос/изменилась тематика)''
"robot":"ffeaa99a-13d2-4bff-b458-1231c884f8ee" — ''id робота, у продовой версии будет приписка _prod''

"session":"beefb6a2-dc08-47d4-9e02-2495329173ec" — ''id сессии''

"channel":"default" — ''активный канал, в котором происходит тестирование''

"connector":"web"

"unknown":false.
</blockquote>
[[Файл:2025-10-06 12-45-38.png|мини|''Рис. 23 Пример работы с отладчиком'']]
Далее идет самая интересная для аналитиков часть - <code>"current"</code> . Раскрыв этот ключ можно посмотреть в какую конечную точку привёл сценарий, и была ли запросу присвоена какая-либо категория. А так же параметр ''data'', раскрыв который можно увидеть все классы (рис. 23 и 23.1), которые пришли от модели [[SMC. UPS руководство по работе с интерфейсом|SMC]] и/или модели [[SEE. UPS руководство по работе с интерфейсом|SEE]] и их достоверность и вес. Раскрыв в ''data'' параметр ''reply -'' увидеть данные ответа от робота. Имея все эти данные можно отладить работу сценария.
[[Файл:2025-10-06 12-47-26.png|мини|''Рис. 23.1 Работа с отладчиком. Просмотр параметра data и логов'' ]]
<blockquote>"current":{

"id":"Консультация ЧаВО" — конечная точка, в которую привел сценарий,

"qas":"оформить снилс" — запрос, который отправился в QAS.

}<blockquote>'''Обратите внимание:''' если параметр QAS в отладчике пустой, это значит, что ваш запрос не был передан в QAS. Если же в этом параметре отображается ваш запрос, но робот просит вас перефразировать его, то, вероятно, в базе данных не хватает формулировки с ответом или на ответе отсутствует пометка «проверено». Это может происходить, когда в настройках КТ, отвечающей за консультирование из базы данных QAS, установлен параметр «Использовать кэш ответов» в режиме «Только проверенные ответы». </blockquote>'''Отработка склеек и удержания контекста''': в QAS летит вообще вся история сообщений в рамках одного контекста общения '''через разделитель «|»'''. Модель генерации будет отвечать на последний вопрос в цепочке с учетом ранее написанных сообщений в этом контексте.

"answered":true — был ли ответ true/false
"category":[0:"МФЦ НСО СНИЛС"] — отображается список категорий, в которые попал вопрос (их может быть больше одной).

"nearest":NULL

''Следующий кусок ключа current проще объяснить на примере запроса "оформить паспорт":''

"entry":"entry":[0:"Паспорт, вес 3" ] — зашли в КТ по метке «Паспорт», запросили тип паспорта (загран), старый/новый образец и дошли до возраста получателя:

"missingRunData":[

0:"Возраст заявителя для заграна, вес 3"] — тут отображаются ЭД, которые нужны для «пропуска» дальше в действия.

"passedRunData":[ ] — список условий AND, который выполнился.

"waitingRunData":

"Возраст заявителя для заграна, вес 3" — отображается ЭД, который запросили и ждем получения.

"border":0 — отражает границу, от которой система смотрит на данные. Например, при border:1 - система будет смотреть от 2-го ЭД в списке data и ниже. При border:0 - с первого.

"preborder":0

}</blockquote><blockquote>"models":[...] — раскрыв список, можно посмотреть все модели, которые отработали за сессию.

"scripts":[] — отображает список скриптов, которые отработали за сессию.

"data":[...] — раскрыв data, можно увидеть параметр "message" — фраза-сообщение пользователя. И под каждым message, есть своя data, где находятся все метки и все тэги, пришедшие от моделей SMC и SEE на эту фразу.

"timers":[...]

"variables":{} — тут отображаются пришедшие переменные, если есть.

"error":"" — выводит ошибку при отработке скрипта.

"events":{ — параметр отображает счетчики событий за сессию (не найдено/нет данных/тишина).

"not found":{...}

"no data":{...}

"silence":{...}

}</blockquote>

[[Файл:2025-06-10 16-15-43.png|мини|''Рис. 24 Окно автотестирования скриптов'']]

===== Тестирование скриптом =====
[[Файл:2025-06-10 16-22-59.png|мини|''Рис. 25 Добавление скрипта для тестирования'']]
[[Файл:Тестирование скриптов.png|мини|''Рис. 26 Интерфейс окна «Тестирование скриптов»'']]
Теперь вы можете автоматически тестировать робота с помощью скриптов. Например, если у вас возникли сложности с маршрутизацией и нет желания каждый раз вручную воспроизводить весь диалог при отладке сценария, вы можете сохранить его для последующего тестирования. Для этого кликните на кнопку [[Файл:Пробирки.png|безрамки|20x20пкс]] справа от чата появится окно. Добавить скрипт можно путем '''''импорта из файла''''' [[Файл:Импорт нов.png|безрамки|20x20пкс]], если есть данные '''в формате txt''' или '''''импортировать диалог''''' из текущей сессии. Нажмите на иконку импорта или выберите ''«Скрипт»'' в выпадающем меню и нажмите '''''«Добавить скрипт»''''' (рис. 24). Появится диалоговое окно «''Добавление скрипта»''. Введите название скрипта, выберите файл и нажмите ''«Добавить»''. Если у вас уже открыта сессия, отметьте в окне добавления скрипта опцию '''''«Импорт из чата»'''.'' Если у вас несколько скриптов, переключаться между ними можно через выпадающий список ''«Скрипт».''

Правее него находятся иконки ''импорт'' [[Файл:Импорт нов.png|безрамки|20x20пкс]], ''экспорт'' [[Файл:Экспорт нов.png|безрамки|20x20пкс]] и ''удалить'' [[Файл:Удаление документа.png|безрамки|20x20пкс]]. Импорт был описан ранее. '''''Экспорт''''' позволяет выгрузить скрипт в формате txt. Кнопка '''''удалить''''' - удаляет весь скрипт.

Файл для импорта и экспорта - это простой текстовый файл, в котором все запросы к роботу, каждый с новой строки.

Галочки обозначают точки останова (рис. 25). Когда они стоят, автотест останавливается и ждет, пока вы нажмете кнопку «Дальше». параллельно можно открыть отладчик и смотреть, что происходит на каждом этапе теста.

У тестирования есть два основных режима:

# Полный тест:
#* Все галочки сняты
#* Тест выполняется автоматически от начала до конца, без остановок
# Пошаговый режим:
#* Тест останавливается на каждом шаге
#* Для продолжения нужно нажимать "Дальше"

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

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

Последняя отправленная фраза будет выделена голубым цветом.

===== Просмотр данных сессии =====
Эта функция позволяет вам в реальном времени отслеживать диалоги и данные сессии у другого пользователя в '''рамках одного бота'''.

'''Подключение к отслеживанию'''

# Нажмите на иконку «Просмотр сессии» [[Файл:2025-10-22 12-54-24 (1).png|безрамки|20x20пкс]] . Введите название переменной, за которой хотите следить и ее значение (если требуется, например, номер телефона абонента) в соответствующие поля.
# Нажмите кнопку «Подключиться».
# Меню закроется, и вы увидите всплывающее уведомление с подтверждением успешного подключения.
# В основном интерфейсе индикатор отслеживания (иконка «Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]) изменит свой вид: он будет зачеркнут и периодически мигать. Это сигнализирует о том, что соединение активно и система ожидает данные.
Как поступают данные:

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

'''Отключение от отслеживания'''

Чтобы прекратить отслеживание, выполните одно из следующих действий:

* Нажмите на индикатор отслеживания («Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]), который активен в режиме подключения.
* Выполните команду «Сброс сессии» [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]].

Любое из этих действий разорвет соединение для отслеживания, и индикатор вернется в обычное состояние.

'''Пример настройки просмотра сессии'''

Пользователь, за чьим диалогом будет наблюдение, должен создать у себя переменную (любую) и ее значение:

* <code>variable = за мной следят</code>

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

Пользователь, который хочет подключиться для просмотра, должен в своем разделе ''просмотра сессии'' создать точно такую же переменную:

* <code>variable = за мной следят</code>

И после того, как начнется диалог, в режиме реального времени наблюдатель будет видеть все данные сессии того, кто ведет диалог с роботом.<blockquote>'''Функция для пользователей UPS'''

Для более удобного отслеживания вы можете использовать уникальный <code>id пользователя UPS</code> , который передается в переменные сессии.

* Вместо того чтобы указывать одинаковые переменные у обоих пользователей, вы можете напрямую указать <code>id пользователя</code>, за которым хотите следить.
* Это позволяет вам следить за конкретным пользователем, при этом ему не обязательно вручную задавать у себя переменную.
</blockquote>

===== Тестирование голосовыми сообщениями и в голосовом канале =====
[[Файл:2025-06-10 12-44-58.png|мини|''Рис. 27 Тестирование робота с помощью микрофона.'']]
Робота можно протестировать, задавая вопросы голосом и/или вводя переменные. Например, можно проверить, как робот отправляет в разные конечные точки, получая одинаковые метки от SMC и номера телефонов различных ведомств. Например, метка «Мобилизация» от SMC в сочетании с номером телефона МФЦ приводит в КТ Консультация ЧаВО, а «Мобилизация» и номер единого контактного центра (ЕКЦ) — в КТ Перевод на оператора. Чтобы провести тестирование робота с переменными раскройте меню, кликнув на иконку шестеренки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] и заполните поля:

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

- Значение: укажите значение этой переменной..
[[Файл:2025-10-06 11-51-58.png|мини|''Рис. 28 Иллюстрация тестирования канала voice.'']]
В этом же меню вы можете настроить параметры аудиоответов и автовоспроизведения.

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

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

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

В дебаггере есть функция, позволяющая протестировать '''голосовой канал - voice''' (рис. 28), то есть ''имитировать звонок''. Чтобы запустить процесс, достаточно нажать на кнопку «Начать разговор» [[Файл:Начать разговор.png|безрамки|20x20пкс]] . Пока разговор активен, кнопка изменится на «Закончить разговор» [[Файл:Закончить разговор.png|безрамки|20x20пкс]] . Переменные задаются в меню, как и в текстовом канале. Для этого нажмите на иконку шестерёнки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] (рис. 21).

=== Архив диалогов ===
[[Файл:Архив диалогов нов.png|мини|''Рис. 29 Интерфейс архива диалогов'']]
После тестирования робота в любом канале можно заглянуть в Архив диалогов (рис. 29), чтобы изучить данные сессии. Для этого необходимо кликнуть на одноименную кнопку на панели инструментов рядом с кнопками версий робота [[Файл:Архив диалогов.png|безрамки|20x20пкс]]. Интерфейс архива содержит:

* Список доступных роботов слева на экране.
* Блок с фильтрацией диалогов.
* До момента пока вы не выберете диалог из списка справа будет пустой блок с текстом «Выберете диалог». После того как диалог выбран вы увидите отображение аналогичное рисунку 29.
* Информационные вкладки (см. в разделе [[SES. UPS руководство по работе с интерфейсом#Настройка робота|«Настройка робота»]]).

==== Работа с архивом диалога ====
Архив диалогов поддерживает версионность робота, то есть можно просмотреть диалоги одной из трех версий: черновик, прод или архивной. Для этого кликните по кнопке с нужной версией находясь уже в Архиве либо предварительно выбрав ее и перейдя в архив. Диалоги в архиве фильтруются по дате и времени, для этого кликните на иконку календаря [[Файл:Календарик с фоном.jpg|безрамки|20x20пкс]] в поле «Начало» и «Конец», чтобы выбрать дату. И время, кликнув на иконку часов ''(по умолчанию дата и время выставляются за текущие сутки)''. Выберите нужную дату и время, добавьте необходимые фильтры. Также можно отфильтровать звонки по:

# каналам связи:
* default,
* telegram,
* web,
* voice,
* vkontakte.
2. элементам данных — при нажатии на это поле открывается перечень всех элементов данных из сценария текущего робота.

3. номеру телефона,

4. ID диалога берется из отладчика — это значение атрибута <code>session</code>. В архиве диалогов предусмотрено копирование ID: при нажатии на иконку копирования она загорается зеленым, что означает успешное копирование в буфер обмена.

5. по названию и значению переменной,

3. либо тексту, либо ключевым словам, которые могут быть в искомом диалоге.

После настройки система, по нажатию кнопки «Поиск», отобразит все диалоги с роботом, учитывая выбранные фильтры (рис. 27). На самом верху над диалогом можно просмотреть его ID. В архиве диалоги сгруппированы по принципу «запрос от пользователя — ответ робота». При выборе каждой пары открывается отладчик, где можно увидеть метки и теги, полученные от моделей, копия [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчика]] из тестирования робота. Этот отладчик аналогичен тому, что используется в сценарной машине. Для голосового канала есть возможность прослушивания аудио диалога помимо текстового просмотра. Также есть возможность импортировать запросы диалога в скрипт тестирования в чат-отладчик по кнопке '''«Добавить в скрипт тестирования»''' снизу диалога и в появившемся окне введите название скрипта тестирования. После чего он появится в списке скриптов тестирования сценария.

Для вашего удобства во время ''активного'' диалога в архиве доступна кнопка '''«Следить за диалогом»'''. Нажмите кнопку «Следить за диалогом» во время просмотра архива ''активного'' диалога. Система начнёт автоматически обновлять список реплик, подгружая новые сообщения. Обновление происходит каждые 5 секунд, обеспечивая актуальный вид беседы без необходимости обновлять страницу вручную. Позволяет в реальном времени следить за развитием ещё не завершённого диалога, например, во время тестирования или активного общения с роботом.

===== Синхронизация текста и аудио в архиве диалогов =====
В архиве диалогов реализована условная синхронизация текстовой расшифровки с аудиозаписью на основе временных меток (datetime).

* При воспроизведении аудио: В текстовой расшифровке автоматически подсвечивается реплика (вопрос/ответ), которая звучит в данный момент.
* При клике на текст реплики: Воспроизведение аудио автоматически перематывается на тот момент записи, когда эта реплика абонента была произнесена.

Результат: Вы можете быстро находить нужные фрагменты разговора и удобно анализировать диалоги.

Чтобы '''выйти из Архива диалогов''' в сценарий нужно снова кликнуть на иконку [[Файл:Архив диалогов.png|безрамки|20x20пкс]].

=== Пользовательские справочники ===
[[Файл:Photo 2025-05-14 17-30-31.jpg|мини|''Рис. 30 Добавление пользовательского справочника'']]

Для доступа к справочнику нажмите на значок «Пользовательский справочник» [[Файл:Справочник (1).png|безрамки|20x20пкс]] на панели инструментов справа от архива диалогов. Чтобы создать новый справочник, нажмите кнопку '''«Добавить справочник»''' (рис. 30). В открывшемся окне заполните обязательные поля: название справочника и его структуру — наименования колонок. При необходимости задайте значения по умолчанию для каждой колонки. Эти значения будут автоматически заполнять новые строки. Затем нажмите '''«Добавить»'''.

Если значения по умолчанию не указаны, справочник будет пустым. Заполнять таблицу можно вручную.

Справочники можно переименовывать и удалять. Чтобы переименовать или удалить справочник, наведите курсор на его название. Появится две иконки: карандаш для переименования и корзинка для удаления. <blockquote>'''Перед переименованием справочника ''обязательно'' сохраните внесенные изменения, иначе они будут удалены.'''</blockquote>[[Файл:2025-05-20 14-45-35.png|мини|''Рис. 31 Удаление записей из пользовательского словаря'']]
При нажатии на карандаш откроется окно '''«Редактирование структуры».''' Важно помнить: изменения можно внести только в название справочника или в значения по умолчанию (если предыдущие значения были, они будут автоматически обновлены). ''Переименовать столбцы нельзя.'' После сохранения изменений нажмите кнопку '''«Сохранить»''', расположенную внизу под таблицей (рис. 31). <blockquote>'''Внимание! Справочники зависят от версии робота.''' Если вы вносите изменения в структуру справочника в черновой версии [[Файл:Черновик.png|безрамки|20x20пкс]], то для применения этих изменений в продовой версии нужно применить робота в прод.

'''Важно:''' переносится '''только структура справочника'''. Данные не дублируются. Их можно перенести вручную, экспортировав [[Файл:Экспорт нов.png|безрамки|20x20пкс]] из черновика и импортировав [[Файл:Импорт нов.png|безрамки|20x20пкс]] в прод. </blockquote>Вы можете фильтровать записи по содержанию любой колонки. Выделите галочками несколько записей сразу и удалите их. В правом нижнем углу появится иконка корзины, как только вы выберете хотя бы одну запись (рис. 31).

Справочники можно ''экспортировать'' и ''импортировать''. Экспорт и импорт осуществляются в формате JSON.
[[Файл:Снимок экрана 2025-07-16 175752.png|мини|''Рис. 32 Импорт пользовательского словаря'']]

''При импорте структуры импортируемого файла и справочника в интерфейсе должны совпадать''. Если они не совпадают, то заполнятся только совпадающие поля. Есть возможность ''импорта'' с дополнением новых данных, либо полной заменой (''Рис. 32''). Структура экспорта:<blockquote>
[

{"колонка1":"значение 1","колонка2":"значение 2","колонка3":"значение 3","id":"58845671-1150-4ae2-9c46-e8aeb2553c57"},

{"колонка1":"значение 2","колонка2":"значение 2","колонка3":"значение 3","id":"2e0a7f8e-6d64-4df9-a3ce-5862f8eb441c"}

]
</blockquote>Структура json-файла для импорта:<blockquote>[

{"колонка1":"значение 4","колонка2":"значение 5","колонка3":"значение 6"},

{"колонка1":"значение 2","колонка2":"значение 3","колонка3":""}

]

При импорте не обязательно указывать id.</blockquote>Чтобы '''выйти из Пользовательских справочников''' в сценарий нужно снова кликнуть на иконку [[Файл:Справочник (1).png|безрамки|20x20пкс]].

=== Панель управления SES ===
Панель управления SES включает в себя 8 кнопок: импорт, экспорт, обнуление черновика рабочей версией, применение робота, восстановление робота, применение настроек робота, массовая замена моделей в элементах данных и меню пользователя.

{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления''
!'''Иконка кнопки'''
!'''Название иконки'''
!'''Описание'''
|-
|[[Файл:Export.png|центр|безрамки|40x40пкс]]
|Экспорт
|Для создания резервной копии или переноса робота выполните его экспорт в ZIP-архив. В архив будут включены все настройки робота: элементы данных, конечные точки, скрипты, структуры пользовательских справочников (''но не включая сами данные''), а также связанные модели и базы данных QAS.<blockquote>'''Внимание!''' Перед экспортом убедитесь, что категории и модели актуальны. В противном случае экспорт может завершиться ошибкой, и робот не будет экспортирован.</blockquote>
|-
|[[Файл:ImportRobot.png|центр|безрамки|40x40пкс]]
|Импорт
|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''.|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''. Аналогично экспорту, доступен и импорт робота с моделями SMC, SEE и QAS в различные наборы данных.
<blockquote>'''Как работает импорт:'''

* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.
'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>
|-
|[[Файл:Стрелка.png|безрамки|40x40px|центр]]
|Обнулить черновик рабочей версией
|Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Применить.png|безрамки|40x40px|центр]]
|Применить
|По нажатию на эту кнопку черновая версия робота становится рабочей ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Откат.png|центр|безрамки|40x40px]]
|Восстановить
|С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной ''(кнопка активна только в архивной версии)''.
|-
|[[Файл:Разетка.png|центр|безрамки|40x40px]]
|Применить настройки робота
|Применяет сохранённые настройки робота и начинает работать в соответствии с ними, что аналогично перезагрузке программного обеспечения, но без необходимости самой перезагрузки.
После нажатия на кнопку система переносит эти настройки в настройки прода, но НЕ ПРИМЕНЯЕТ, на случай, если ошиблись.

Робот в любой версии начинает работать с новыми настройками только после нажатия на кнопку. Если вы нажали на кнопку, находясь в черновике, будут применены настройки черновика. Если же вы нажали на кнопку, работая в рабочей версии, то будут применены настройки рабочей версии, которые вы только что перенесли из черновика. <blockquote>Обратите внимание: после внесения каких-либо изменений кнопка будет красной [[Файл:Красная вилка (1).png|безрамки|20x20пкс]] и пульсировать, напоминая о необходимости применить настройки. </blockquote>
|-
|[[Файл:Смена моделей.png|центр|безрамки|40x40пкс]]
|Массовая замена моделей в элементах данных
|[[Файл:Замена моделей в ЭД.png|мини|''Рис. 33. Массовая замена моделей в элементах данных'']]Эта функция позволяет массово менять модели в элементах данных. После нажатия на кнопку появляется форма ''(Рис. 33)'', в которой необходимо указать тип элемента данных ''(Класс / Сущность)''. Затем в поле '''"Заменяемая модель"''' выбрать модель из списка моделей, используемых в уже существующих элементах данных ''(снизу будет указано количество элементов данных, использующих выбранную модель)'', и в поле '''"Заменяющая модель"''' выбрать доступную модель для замены. После нажатия на кнопку '''"Заменить"''' будет произведена замена выбранной модели в тех элементах данных, в которых она используется.
|-
|[[Файл:Меню пользователя new.png|безрамки|40x40px|центр]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, убрать/показать фон, выход из системы), а также возможность переключить ''отображение рабочей области с табличного на облачный вид и наоборот''.
В меню пользователя добавлена функция ''выбора набора данных*.''

При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

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

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

2025-12-29T13:16:52Z

E.Elagina: /* Функционал вкладки «Шаблоны запросов» */

=== Главное меню ===
[[Файл:QAS.png|мини|''Рис. 1 Главный экран UPS'']]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# QAS ЧаВО,
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]]
# Выход.
Переключаться между продуктами можно двумя способами:

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]] .
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).

Перейти в раздел '''«ЧаВО»''' (QAS) можно кликнув по соответствующей кнопке на главном экране UPS (см.рис. 1).

=== Описание интерфейса сервиса «ЧаВО» (QAS) ===
Рабочая область сервиса «ЧаВО» (QAS) (сервиса ответов на вопросы) включает в себя следующие блоки:
*панель управления;
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Документы»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Кэш»|«Кэш»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Интерактив»|«Интерактив»]];'''
*вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области;
*вкладка '''«Категории»''' содержит список всех созданных категорий, можно как редактировать уже существующие, так и добавлять новые. Есть фильтрация по названию. Доступен ''экспорт''[[Файл:2025-12-10 11-22-58 (1).png|безрамки|28x28пкс]] и ''импорт'' [[Файл:2025-12-10 11-23-23 (1).png|безрамки|30x30пкс]] категории, для переноса на другой сервер; А так же ''удаление'' категории.
<blockquote>'''ВНИМАНИЕ: удаление категории''' происходит '''со всеми документами и вопросами,''' система сообщит об этом.</blockquote><blockquote>'''Как работает импорт:'''
* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.

'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>

==== Вкладка «Документы» ====
[[Файл:Photo 2025-05-21 12-43-54.jpg|мини|''Рис. 2 Рабочая область сервиса «ЧаВО»'']]Во вкладке «Документы» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 2):

* панель управления;
* блок со списком документов содержит поиск по названию и фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Спрятать боковую панель''' между списком документов и блоком для редактирования (появляется при наведении мыши на середину между блоками);
* добавление нового документа в базу;
[[Файл:Photo 2025-05-21 12-43-54 (2).jpg|мини|''Рис. 3 Пример отработки кнопки «Очистить текст»'']]
*блок '''«Редактирование документа»''' с полями: «Название», «Дополнительно» и текстом выбранного файла, который можно редактировать. Можно переименовывать файл, после чего нужно сохранить изменения. Кнопка сохранения становится активной как только будут внесены изменения. Чтобы сделать текст более читабельным, его можно очистить от лишнего. Для этого нажмите кнопку '''«Очистить текст»''', которая находится под основным блоком слева от '''«Сохранить»''', предварительно выбрав шаблон запроса, если требуется. Или воспользуйтесь кнопкой на [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|панели управления]] [[Файл:2025-10-08 15-19-11 (1).png|безрамки|20x20пкс]].
<blockquote>'''Важно:''' при уже запущенном процессе очистки кнопка остановит текущий процесс отчистки.</blockquote>После завершения очистки справа появится окно с изменениями. Кнопка, открывающая данные по очистке позволяет просмотреть так же:

* Прогресс выполнения (%)
* Позицию в очереди (правило '''«один аккаунт — одна операция очистки»''')
* Результаты обработки. Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''

Вы сможете сравнить исходный и очищенный текст. Если нужно внести правки, их можно сделать прямо в блоке с очищенным документом. После проверки и внесения правок, если все устраивает, нажмите '''«Заменить в документе»''' под блоком с очищенным текстом. Изменения вступят в силу. ''Не забудьте сохранить документ.'' Рядом с этой кнопкой есть '''«Закрыть»'''. Она закрывает окно с очищенным текстом без сохранения изменений.
<blockquote>Для очистки текста, ''который не загружен в базу данных'' QAS, используйте режим «Очистка текста» на вкладке «Интерактивный режим».</blockquote>
*блок поиска фрагментов по базе.

[[Файл:2025-12-29 15-35-16.png|мини|''Рис.4. Добавление нового файла'']]

===== Добавление файла в список =====
В нижней части блока со списком файлов есть кнопка '''«Добавить файл»'''. Если нажать на нее, то появится диалоговое окно, как показано на рисунке 4. Чтобы добавить файл, нужно заполнить все необходимые поля и выбрать нужный файл с компьютера, в кодировке '''Unicode UTF-8'''.

Поддерживаемые '''форматы''':

* .odt
* .docx
* .doc
* .rtf
* .ods
* .xlsx
* .xls
* .pdf
* .txt.

Максимальный размер файла неограничен. Если вы хотите ''добавить новую категорию'' при загрузке документа, вам нужно ввести название новой категории в соответствующее поле и нажать кнопку '''«Добавить новую категорию…».''' После этого загружаемый документ будет отнесён к новой категории, и файл успешно добавится в базу. Также, при установленной галочке «'''Дополнительно запустить очистку текста»''' можно выбрать шаблон запроса, при необходимости, и после загрузки документа будет открыта дополнительно вкладка справа с результатом очищенного документа, который можно отредактировать и заменить в загруженном документе.

'''Блок «Параметры поиска документа»'''

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

Доступные опции:

* Использовать начало документа — в поиск будет включен первый фрагмент текста.
* Использовать аннотацию — при поиске система будет учитывать подготовленное краткое описание (аннотацию) документа. Аннотация генерируется автоматически на этапе векторизации при активном флаге.
* Использовать заголовок документа — в поисковые данные добавляется название файла, которое указано в интерфейсе. Поэтому важно указывать название отражающее содержание документа.
* Использовать якоря по содержимому — для индексации будут выделены ключевые смысловые блоки (якоря), автоматически определенные внутри документа.

Затем нажмите на кнопку '''«Добавить».'''

===== Функционал меню «Дополнительно» =====
[[Файл:2025-05-23 17-11-07.png|мини|''Рис. 5 Иллюстрация функций кнопки Дополнительно'']]
На вкладке дополнительно вы можете посмотреть:

* категорию к которой относиться документ,
* параметры поиска документа,
* аннотация и опция перегенерации аннотации,
* глоссарий, в котором укажите название объекта из документа (рис. 5), а также его синоним в соответствующих полях внизу страницы. Это поможет модели лучше понимать, о чём её спрашивают. Например, научить ее тому, что «госпошлина = пошлина», «загранник = загранпаспорту», «загранпаспорт = заграничному паспорту», а «загранпаспорт нового образца = загранпаспорту на 10 лет» и нажмите кнопку добавить.
<blockquote>Поиск в базе работает '''на основе векторного анализа текста'''. Чтобы система точнее находила нужные документы, важно выделить ключевые термины и создать глоссарий.

Как это сделать:

# Внимательно изучите документ.
# Выпишите основные термины и их возможные синонимы.
# Внесите их в глоссарий в формате: ''основной термин = синоним''.

Пример:

Если в документе слово ''«апостиль»'' иногда называют «''услугой»,'' укажите в глоссарий:

<code>апостиль = услуга</code>.</blockquote>Предусмотрено массовое удаление синонимов, для этого выделите нужное галочками. Кликнув на поле с фразами вы можете отредактировать формулировку. После внесения изменений нажмите кнопку '''«Сохранить»'''. Она станет активной сразу же после того, как вы внесете какие-либо изменения в документ. Эта кнопка является дубликатом кнопки '''«Сохранить»''' в блоке редактирования документа.
* есть кнопка для экспорта глоссария, если это необходимо в формате .csv.
* а так же доступен импорт с тремя опциями: дополнить, заменить и отменить импорт.
* здесь же находится кнопка для удаления документа.
[[Файл:Параметры поиска документа.jpg|мини|''Рис. 6 Параметры поиска документа'']]
'''Блок «Параметры поиска документа»'''

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

Доступные опции:

* Использовать начало документа — в поиск будет включен первый фрагмент текста.
* Использовать аннотацию — при поиске система будет учитывать подготовленное краткое описание (аннотацию) документа. Аннотация генерируется автоматически на этапе векторизации при активном флаге.
* Использовать заголовок документа — в поисковые данные добавляется название файла, которое указано в интерфейсе. Поэтому важно указывать название отражающее содержание документа.
* Использовать якоря по содержимому — для индексации будут выделены ключевые смысловые блоки (якоря), автоматически определенные внутри документа.

Ниже есть блок с текстом сгенерированной аннотации, ее можно отредактировать при необходимости вручную или запустить перегенерацию по кнопке '''«Генерация аннотации»'''. Появится дополнительное окно, где можно выбрать шаблон и промпт, если не подходит тот, что по умолчанию. Генерацию можно остановить по кнопке '''«Остановить»''', а после генерации можно '''«Заменить в документе»'''.

===== Поиск фрагментов в документах =====
Поиск фрагментов — это первый этап для ответа на вопрос. Система сначала ищет фрагмент (фрагменты) в документах, после отправляет их вместе с промптом на модель генерации.

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

===== Панель управления вкладки «Документы» =====
В верхней части экрана располагается панель управления, на которой находятся кнопки: ''генерация ответов, экспорт документов, очистка документа, массовая обработка вопросов, задать вопрос'' и ''меню пользователя.''
{| class="wikitable"
|+''Табл. 1 Описание функционала панели управления.''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать документ
|Позволяет экспортировать документ в одном из форматов .docx или .txt
|-
|[[Файл:2025-10-08 15-19-11 (1).png|центр|безрамки|40x40пкс]]
|Очистка документа
|При нажатии на кнопку открывается диалоговое окно, в котором необходимо:

# Выбрать модель генерации — укажите модель ИИ для обработки текста
# Выбрать шаблон очистки — определите параметры форматирования текста

<blockquote>'''Важно!''' Очистка будет применена к текущему активному документу.

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

Действует правило '''«один аккаунт — одна операция очистки».'''</blockquote>После запуска кнопка меняется на ''«Остановить очистку документа»,'' по нажатию на нее запущенная вами очистка завершается.

Посмотреть прогресс очистки можно нажав на кнопку ''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Очистка текста»]]'' под документом.

Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация вопросов
|эта кнопка предназначена для генерации вопросов. По нажатию на кнопку появляется диалоговое окно, в котором требуется выбрать:

* категорию вопросов для генерации;
* если не нужно генерировать вопросы для всех документов, выберите нужный,
* выберите канал,
* выберете модель генерации (по умолчанию используется default), другие модели будут отображаться в списке только после того, как администратор добавит их,
* выберите шаблон запроса к LLM (по умолчанию используется шаблон "из коробки" типа "Генератор вопросов по тексту"),
* запустите генерацию.
Генерация вопросов запускается ''для каждой'' категории ''отдельно''.
<blockquote>'''''Совет''': генерацию лучше запускать в нерабочее время, так как она может занять много времени.'' Для удобства отслеживания на иконке отображается прогресс генерации.</blockquote>Есть возможность включить или отключить опцию ''генерации ответов'' сразу для документа. Для случаев, когда добавился новый документ в категорию и нет под него ВОП из «живых» фраз.

<blockquote>'''''Совет''''': если есть возможность использовать «живые» фразы людей, то всегда лучше брать их, а не генерировать синтетические вопросы.</blockquote>
|-
|[[Файл:2024-07-08 22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка документов
|позволяет сделать массовую замену текста в документах. В диалоговом окне нужно выбрать категорию, искомый текст и текст замены.
|-
|[[Файл:Задать_вопрос_нов.png|центр|безрамки|40x40пкс]]
|Задать вопрос1
|генерирует ответ на вопрос на основе информации, содержащейся в одном или нескольких документах.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы, шаблоны)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:Ask.png|мини|Рис. 7 Блок «Задать вопрос»|589x589пкс]]
1 По нажатию на кнопку '''«Задать вопрос»''' (рис. 7), появляется диалоговое окно с полями:

'''«Вопрос»''' — это область для ввода вопроса.

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

'''«Канал»''' - список созданных каналов связей.

'''«Модель генерации»''' - список доступных моделей

'''«Шаблон запроса к LLM»''' - шаблон запроса (промпт) к модели генерации.

'''«Использовать кэш ответов»''' - в этом меню можно выбрать, использовать ли только проверенные ответы или любые.

Также в блоке есть флажки '''«Использовать генерацию»''' и '''«Кэширование формулировки»'''. Если вы ставите активный флажок '''«Кэширование формулировки»''', то вопрос, который вы задали, будет направлен в кэш вопросов вместе с найденным ответом и будет доступен для редактирования на вкладке «Вопросы». <blockquote>'''Внимание:''' склейки не оседают в QAS, даже если флаг активен.</blockquote>Результат отработки метода отобразится после нажатия на кнопку '''«Получить ответ»''' внизу. Показатель ''«достоверность»'' отражает процент достоверности ответа, основываясь на всех найденных фрагментах. Вопросы, которые вы создаёте с помощью кнопки «Задать вопрос» (при активной галочке «Использовать генерацию»), отображаются в списке на вкладке '''«Вопросы»''' и становятся доступными для редактирования.
==== Вкладка «Кэш» ====
Во вкладке «Кэш» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 8):[[Файл:Рис. 7 Рабочая область вкладки «Кэш».png|мини|Рис. 8 Рабочая область вкладки «Кэш»]]
* панель управления;
* блок со списком вопросов содержит поиск по вопросам и ответам, а так же фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Скрыть боковую панель''' между списком вопросов и блоком для редактирования (появляется при наведении курсора);
* добавление нового вопроса;
* блок для работы с вопросами и ответами на них;
* блок поиска ответов;
* список доступных для работы режимов, которые включают в себя:
** '''[[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|«Подробный»]]''';
** '''[[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Проверка новых вопросов»|«Проверка новых вопросов»]]''';
** '''[[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|«Утверждение кандидатов»]]''';
** '''[[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Поиск несоответствий»|«Поиск несоответствий»]]''';
** '''[[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Векторный поиск»|«Векторный поиск»]]''';
* вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|«Шаблоны запросов»]]''';
* вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*вкладка '''«Категории»''' содержит список всех созданных каналов, можно как редактировать или удалять уже существующие, так и добавлять новые;
*вкладка '''«Логи обработки»''' — это меню для просмотра результата (ошибок) после и во время массовой обработки вопросов (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|разд. ''Панель управления вкладки «Кэш»'']]). При желании их можно экспортировать кликнув на кнопку ''Экспорт'' в правом нижнем углу меню.
*Информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.

===== Добавление новых и редактирование вопросов =====

''Вопросы в QAS могут быть трех видов:''

'''Кандидаты''' — это новые запросы к системе, которые, по мнению самой системы, являются семантически близкими к основному вопросу и его формулировкам. Чтобы перевести кандидата в формулировки, нужно ''утвердить'' их (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|разд. Режим работы "Утверждение кандидатов"]])

'''Формулировки (алиасы)''' — это различные варианты одного и того же вопроса. Этот список станет основой для системы при поступлении новых запросов. Она будет использовать его, чтобы определить, в кандидаты к какому основному вопросу стоит отнести новый.

'''Основной вопрос''' — это новый вопрос, который ранее не существовал в базе данных QAS, а также не имел семантически близких аналогов. Каждому основному вопросу присваивается категория. Он может включать дополнительные формулировки и кандидатов.

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

* категорию вопроса;

* текст вопроса.

Чтобы ''отредактировать'' уже существующий вопрос, нужно выбрать его из списка. После этого его текст и ответы появятся в блоке для редактирования, который находится в середине страницы. Если вопрос слишком длинный и не помещается в одну строку, просто нажмите на него, и он будет развёрнут. [[Файл:2024-10-14 15-55-53.png|мини|''Рис. 9 Интерфейс вкладки «Дополнительно»'']]

Меню '''«Дополнительно»''' включает в себя следующие опции:

- изменение формулировки основного вопроса,

- изменение категории вопроса (перенос в другую категорию) осуществляется путём выбора из списка доступных категорий, расположенного в верхней части окна (рис. 9). Вопрос будет перенесен без потерь со всеми ответами, кандидатами и формулировками.

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

Поэтому мы создаём короткие вопросы, помечаем их как «неполные» и добавляем уточняющие вопросы в ответ. Например: «Уточните, пожалуйста, что именно вы хотите узнать по поводу детского сада?» Получив такой вопрос, абонент должен будет уточнить свои потребности, а затем робот объединит оба запроса и выдаст ответ, если он есть в базе данных QAS.</blockquote>- добавление, удаление или перенос. Чтобы удалить формулировку, необходимо навести курсор на нужную фразу. После этого справа появятся две кнопки (см. рис. 8). Одна из них в виде ''стрелочки'' предназначена для того, чтобы сделать эту формулировку ''основным вопросом''. А кнопка в виде ''корзинки'' позволяет удалить выбранную фразу. Есть возможность удалять несколько формулировок, для этого нужно выбрать формулировки для удаления и нажать на кнопку ''Удалить,'' рядом с кнопкой ''Переместить.'' <blockquote>При удалении основного вопроса на вкладке ''Дополнительно'', сначала нужно переназначить основным вопросом другую формулировку и после этого удалить. </blockquote>- есть возможность переместить формулировки и/или кандидатов в другой вопрос. Для этого поставьте галочку напротив нужной фразы и нажмите кнопку «Переместить». В появившемся диалоговом окне выберите нужный вопрос (вы можете предварительно отфильтровать вопросы по категориям). Выберите, из выпадающего списка куда следует переместить выбранные вопросы: в формулировки или в список кандидатов, — и нажмите кнопку «Переместить». После этого '''обязательно''' сохраните изменения в текущем вопросе. <blockquote>'''Обращаем ваше внимание,''' что если вы указываете, что перемещение должно быть выполнено в кандидаты, то вам необходимо будет затем перейти и ''утвердить'' кандидата.</blockquote>- так же вы можете ознакомиться со списком ''кандидатов'', который включает формулировки, близкие по смыслу к основному вопросу. Если среди них есть подходящие варианты, отметьте их галочкой и нажмите кнопку «Утвердить». После этого выбранные формулировки появятся в общем списке «Формулировки». ''Добавление большого количества разных формулировок необходимо, чтобы модель могла понимать суть вопроса, независимо от того, как его сформулирует человек, и выдавать один и тот же ответ на разные варианты этого вопроса.''

- ''удаление'' вопроса из базы на вкладке «Дополнительно» внизу будет кнопка ''Удалить вопрос полностью''.

'''Внимание:''' ''Нажимая на кнопку '''Удалить вопрос полностью''' в меню Дополнительно, вы удаляете весь вопрос, включая формулировки, ответы на него из всех каналов и всех кандидатов.''

- после того как вы внесете изменения, кнопка «Сохранить» станет активной в меню «Дополнительно» и на панели для редактирования ответов.

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

Каждый вопрос сопровождается флажком '''«Проверено»''', который отмечает ответы, проверенные пользователем. При наведении курсора мыши на ответ, вместо канала к которому принадлежит вопрос, появляются кнопки:

* копировать в канал, с ее помощью можно продублировать ответ для любого доступного канала;
* переместить в канал, перемещает ответ с текущего канала на другой выбранный пользователем канал;
* удалить ответ.
Также вы можете добавить новый вопрос в список, воспользовавшись функцией поиска ответа на вкладке '''«Кэш»''' с включенным флажком '''«Использовать генерацию»''' или задав новый вопрос по документам на вкладке '''«Документы»,''' так же выбрав опцию '''«Использовать генерацию»'''. Если похожего вопроса раньше не было, то он появится в списке на вкладке «Вопросы». Вы сможете редактировать и изменять его по своему усмотрению. В случае, если похожий вопрос уже встречался, система предложит его как кандидата к похожему вопросу. Это значит, что его нужно будет перенести в формулировки (утвердить) и сохранить изменения.

===== Поиск по вопросам и ответам. Фильтрация =====
[[Файл:2024-08-06 16-23-15.png|мини|''Рис. 10 Иллюстрация поиска по вопросам'']]
В разделе '''«Кэш»''' есть три вида поиска:

# поиск по вопросам и их формулировкам, в том числе и кандидатам;
# поиск по ответам.
# поиск по категории

А так же два вида фильтрации:

# по содержанию ответов: ''Все'', ''Проверенные'', ''Непроверенные'', ''Пустые.''
# по полноте вопроса: ''Все, Полный, Неполный.'' К полным вопросам относятся вопросы с конкретикой. К неполным - короткие вопросы без конкретики.

[[Файл:2024-08-06 16-38-29.png|мини|''Рис. 11 Иллюстрация поиска по ответам'']]С помощью '''поиска по вопросам и их формулировкам''' можно найти все вопросы или вопросы в определённой категории, которые содержат определённое слово или фразу в своей формулировке. Поиск работает как для основного вопроса, так и для дополнительных формулировок. <blockquote>Например, на рисунке 9 в категории «Водительские права» мы ищем все вопросы, в которых есть сочетание букв «''замена''». Если открыть меню, внизу экрана, ''«Дополнительно»'', то можно увидеть, что это сочетание используется в альтернативных формулировках вопроса, найденные сочетания подсвечиваются. </blockquote>Обращаем внимание, что если в основном вопросе нет искомого слова или сочетания букв, то система все равно выведет вопрос, если найдет совпадения в альтернативных формулировках. [[Файл:2024-08-06 16-24-00.png|мини|''Рис. 12 Результат работы двух видов поиска одновременно'']]
Предусмотрен ''поиск по ответам'', в поле '''«Ответ»''' можно ввести слово или фразу и система подсветит поля ответов, где искомое сочетание было найдено (рис. 11). По умолчанию канал связи стоит в положении «не выбран» и выводятся ''все'' ответы ''из всех каналов'', где найдено слово или фраза. Можно принудительно выбрать канал из списка, тогда отобразятся ответы выбранного канала и будут подсвечены те ответы, где найден искомый текст. Область ответа с искомым текстом будет подсвечена бледно-голубым (рис. 12). Можно одновременно использовать два вида поиска. В результате будут отображены вопросы, в которых присутствует искомое значение – как в вопросах, так и в ответах (рис. 11).

===== Поиск ответа =====
[[Файл:2025-07-04 15-31-58.png|мини|''Рис. 13 Интерфейс блока «Поиск ответов»'']]
Блок '''«Поиск ответа»''' (рис. 13) работает так же, как кнопка '''«Задать вопрос»''' на вкладке '''«Документы»'''. <blockquote>Важно отметить, что поиск ответа происходит в два этапа:

# поиск нужных фрагментов из документов в категории,
# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.
</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов. <blockquote>Для запуска поиска есть горячие клавиши Ctrl+Enter или по кнопке Получить ответ. </blockquote>В выпадающем списке '''«Модель генерации»''' вы можете выбрать модель, которая будет создавать итоговый ответ. Чтобы в списке появились дополнительные модели, кроме стандартной, администратор должен их добавить. После этого они появятся в списке, и вы сможете использовать их вместо стандартной модели.

'''«Шаблон запроса к LLM»:''' здесь вы можете выбрать, какой промпт отправить на генеративную модель вместе с найденными фрагментами и вопросом. Если промпт не выбран, LLM будет использовать стандартный запрос. Подробнее о шаблонах запросов [[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|тут]]. <blockquote>'''Для чего это нужно?'''

Если стандартный промпт не работает так, как нужно для конкретной категории, или требуется что-то особенное, можно создать новый шаблон. Это делается без изменения стандартного промпта. </blockquote>Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Меню '''«Использовать кэш»'''. В этом меню можно выбрать, использовать ли только проверенные ответы или любые. Кэш-память позволяет сервису быстрее отвечать на запросы пользователей. А опция '''«Только проверенные ответы»''' гарантирует, что ответы, которые получает пользователь, были отредактированы и проверены оператором.

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

Аналогично вкладке «Документы», вы можете настроить '''количество документов''', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.

===== Функционал режима «Проверка новых вопросов» =====
Режим «Проверка новых вопросов» содержит перечень всех новых вопросов. В рабочей области находится таблица, в которой представлен список новых вопросов, ответы на них, категория, присвоенная этим вопросам, а также дата создания вопроса. Есть возможность фильтрации по каждой из колонок (рис. 14).
[[Файл:New questions mode.png|мини|''Рис.14 Интерфейс режима утверждения новых вопросов'']]
При наведении на любую строку слева появляются иконка и чекбокс:
# [[Файл:Circle-check-solid.png|безрамки|22x22пкс]] Утвердить — позволяет утвердить ответ на текущий вопрос. Это означает, что ответ и категория соответствует вопросу. После утверждения вопрос пропадет из таблицы и получит статус '''«Проверено».'''
# [[Файл:Checkbox.png|безрамки|25x25пкс]] Чекбокс — позволяет выбрать несколько позиций таблицы для утверждения или удаления. Утверждение означает, что у всех выбранных позиций ответ и категория соответствует вопросу. Для утверждения всех выбранных позиций необходимо нажать кнопку «Утвердить», внизу таблицы, в правом нижнем углу. Для удаления — на значок ''корзинки'' (п. 5 списка ниже), так же в нижнем углу.
В «подвале» таблицы расположены следующие функциональные элементы:

# [[Файл:Expand.png|безрамки|20x20пкс]] Развернуть — разворачивает таблицу и входит в полноэкранный режим.
# [[Файл:Compress.png|безрамки|23x23пкс]] Свернуть — выходит из полноэкранного режима и возвращает таблицу в исходное состояние.
# [[Файл:Approve changes mode.png|безрамки|187x187пкс]] — позволяет переключаться между состояниями режима '''«Подтверждения изменений».''' При включенном режиме при каждом массовом утверждении ответов на вопросы будет появляться диалоговое окно, которое будет запрашивать подтверждение текущих изменений.
# Кнопка '''«Утвердить»''' — позволяет утвердить все выбранные на данный момент ответы на вопросы. Кнопка не активна, пока не выбрана ни одна позиция в таблице.
# [[Файл:Delete icon.png|безрамки|22x22пкс]] — позволяет удалить все выбранные на данный момент ответы на вопросы. При включенном режиме '''«Подтверждения изменений»''' при удалении запросит подтверждение в диалоговом окне.
[[Файл:New questions mode changed.png|мини|''Рис.14.1. Работа в режиме утверждения новых вопросов'']]Данный режим позволяет как точено, так и массово проверять ответы и категорию на соответствие вопросу.
В таблице реализована возможность самостоятельной правки вопросов/ответов/категорий. Для этого надо кликнуть на интересующую вас ячейку и внести правки. Сразу после изменений в верхней правой части ячейки появится иконка для отката изменений [[Файл:Undo.png|безрамки|24x24пкс]] на '''начальное''' состояние. Если в строке произошли какие-то изменения, то ''строка автоматически переходит в состояние выбранной'' (рис. 14.1).

В таблице реализована клавиатурная доступность, которая позволяет перемещаться между ячейками и утверждать выбранные позиции в таблице. Для этого используются следующие комбинации клавиш: Ctrl + ⬆/⬇/⬅/➡/Enter.

===== Функционал режима «Утверждение кандидатов» =====
[[Файл:Рис. 13 Интерфейс режима Утверждения кандидатов.png|мини|''Рис. 15. Интерфейс режима Утверждения кандидатов'']]
Режим «Утверждение кандидатов» содержит перечень всех кандидатов. В рабочей области находится таблица, в которой представлен список кандидатов, перечень основных вопросов, где эти кандидаты находятся, а также категория, присвоенная этим вопросам (рис. 15).

При наведении на любую строку слева появляются две иконки:
# [[Файл:Сделать основным без фона.png|безрамки|26x26px]] Сделать основным — позволяет сделать кандидата основным вопросом. По нажатию на эту кнопку появляется диалоговое окно, где требуется подтвердить намерение сделать кандидата основным вопросом. В форме подтверждения нужно выбрать категорию, в которую хотели бы добавить вопрос и аналогично функционалу добавить новый вопрос (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|Добавление новых и редактирование вопросов]]).
# [[Файл:Утвердить.png|безрамки|26x26px]] Утвердить — позволяет утвердить кандидата, в текущем вопросе, включая её в формулировку вопроса. Это означает, что кандидат подходит по смыслу к основному вопросу и его формулировкам.[[Файл:Рис 14. Работа в режиме Утверждение кандидатов.jpg|мини|''Рис.15.1. Работа в режиме Утверждение кандидатов'']]

Чтобы утвердить сразу несколько кандидатов, отметьте их галочками. После этого внизу появится строка с выпадающим списком всех основных вопросов из базы данных QAS.

По умолчанию система предлагает утвердить выбранного кандидата или кандидатов в текущем вопросе. Однако если вы хотите перенести его в другой вопрос, просто начните вводить его название в поле поиска. Затем нажмите кнопку «Утвердить», расположенную в правом нижнем углу (рис. 15.1).

Если вы хотите ''удалить'' кандидата или кандидатов, выделите их и нажмите на иконку «Корзинка», которая находится над кнопкой «Утвердить».

===== Функционал режима «Поиск несоответствий» =====

Режим "Поиска несоответствий кэша ответов и документов" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Несоответствия"''''' и '''''"Ошибки"''.''' Чтобы запустить поиск несоответствий, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

[[Файл:Поиск несоответствий 1.png|мини|''Рис.16. Работа в режиме Поиска несоответствий. Вкладка несоответствий'']]
При активном табе '''"Несоответствия"''' показана таблица результатов поиска для работы с найденными ответами из кэша, которые не соответствуют фрагменту документа (рис.16). Таблица разделена на 4 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''фрагмент из документа'', по которому был дан текущий ответ,
* ''исправленный ответ'', на который предлагается заменить текущий.

Проанализировав предложенные ответы в столбце ''"Исправленный ответ"'', можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены предложенных ответов на ответы из кэша необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

[[Файл:Поиск несоответствий 2.png|мини|''Рис.16.1. Работа в режиме Поиска несоответствий. Вкладка Ошибок'']]
При активном табе '''"Ошибки"''' показана таблица результатов поиска для работы с найденными ответами из кэша, по которым были выявлены ошибки, например, отсутствие информации (рис.16.1). Таблица разделена на 3 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''ошибка'' поиска''.''

Здесь можно скорректировать ответ из кэша, при необходимости (в ячейке таблицы), или удалить запись (строку). Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены исправленных ответов необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

===== Функционал режима «Векторный поиск» =====
[[Файл:Векторный поиск.png|мини|''Рис.17. Работа в режиме Векторного поиска'']]
Режим "Векторного поиска" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Документы"''''' и '''''"Ответы"''''' (рис.17). Он предназначен для поиска и замены ответов и фраз в документах, векторно похожих на текст запроса. Чтобы запустить векторный поиск, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

После окончания поиска будет отображена таблица, которая разделена на 3 столбца:
* ''документ / вопрос'' (в зависимости от выбранного таба),
* ''фраза / ответ'' (в зависимости от выбранного таба),
* ''сходство'', в процентах.
Проанализировав найденные фразы/ответы, можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].
[[Файл:Векторный поиск 2.png|мини|''Рис.17.1. Замена информации в режиме векторного поиска'']]

Затем слева от таблицы заполняем форму для того, чтобы модель генерации предложила варианты замены информации (фразы или ответа). Для этого заполняем недостающие поля: ''Текст замены'' и опционально ''Модель генерации'' (по умолчанию default) и ''Шаблон запроса к LLM'' типа "Векторная замена информации". После нажатия на кнопку ''"Показать варианты замены"'' запустится процесс подготовки предложений по замене информации: появится четвертый столбец ''"Измененная фраза" / "Измененный ответ"'' и в ней по очереди построчно будут заполнятся фразы/ответы (рис. 17.1).

После окончания обработки можно отредактировать или удалить предложенные варианты замены, выделить нужные и нажать внизу таблицы кнопку ''"Заменить фразы"'' / ''"Заменить ответы"'' для замены фраз в документе/ответов соответственно.

===== Панель управления вкладки «Кэш» =====
{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления вкладки «Кэш»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:2024-07-08_22-41-00_(1).png|центр|безрамки|40x40пкс]]
|Выбрать вопросы
|При нажатии на эту кнопку активируется режим, в котором можно выбрать несколько вопросов из списка для последующего перемещения или удаления. Сама кнопка подсвечивается красным контуром, показывая, что она активна. Нажав на неё повторно, можно выключить режим и сбросить выбор. После того как вы отметили галочками вопросы, справа от кнопки появляется опции «Переместить вопросы» [[Файл:Копировать.png|безрамки|20x20px]] и «Удалить выбранные вопросы»[[Файл:2024-07-08 22-55-51-no-bg-preview (carve.photos).png|безрамки|20x20px]].
Если вы собираетесь переместить вопросы, но в них уже есть проверенные ответы или кандидаты, в диалоговом окне появится соответствующее предупреждение. При этом перемещаться они не будут. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-35.png|центр|безрамки|40x40пкс]]
|Экспорт вопросов
|Эта кнопка позволяет экспортировать вопросы в формате CSV для классификатора или для отчета.
Структура файла для классификатора выглядит следующим образом: ''Категория'' ⇥ ''Вопрос.''
Структура файла отчетности: ''Категория⇥ Вопрос⇥ Обозначение вопроса(основной/алиас/кандидат).'' Эта кнопка доступна только в режиме '''«Подробный».'''
|-
|[[Файл:Автосохранение_(1).png|центр|безрамки|40x40пкс]]
|Автосохранение
|Позволяет включить автосохранение. При включенном (вокруг кнопки появляется красный контур) режиме будет сохраняться через 10 секунд после изменения данных. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Обновить_данные_вопроса.png|центр|безрамки|40x40пкс]]
|Обновить данные вопроса
|С помощью этой кнопки можно обновить данные текущего вопроса, например, после генерации ответов. По нажатию на кнопку обновятся все ответы, которые система сгенерировала на этот вопрос. Генерация ответов происходит для разных каналов связи. Вы можете просмотреть их, выбрав нужный канал в меню рядом с основным вопросом. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация ответов
|эта кнопка предназначена для генерации ответов. По нажатию на кнопку появляется диалоговое окно, в котором требуется:

* ввести желаемое количество ''ответов'',
* выбрать ''категорию'', для которой требуется генерация,
* выбрать ''канал'',
* выбрать ''режим генерации'': по документам или перефразирование проверенных,
* указать, для каких вопросов нужно сгенерировать ответы: для всех или только для пустых,
* далее выбрать, следует ли заменить существующие ответы. Если «да», то ответы будут заменены на новые. Если «нет», то они будут дополнены новыми вариантами,
* указать модель генерации (по умолчанию используется default). Другие модели будут отображаться в списке только после того, как администратор добавит их,
* и наконец, указать ''количество документов [1,10]'', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.
* и нажать на кнопку «Запуск».

Генерация может занимать достаточно продолжительное время. Помимо канала по умолчанию, ответы генерируются и для других каналов, после окончания обновите данные вопроса и просмотрите все существующие каналы.<blockquote>'''''Совет:''''' ''лучше использовать сначала режим генерации ответов по документам, после чего проверить их правильность и запускать генерацию в режиме перефразирования ответов. Также перед тем, как сгенерировать ответы, обновите страницу.'' </blockquote>Убедитесь, что предыдущая генерация ответов закончена, иначе кнопка не сработает, и вам нужно будет либо остановить предыдущую генерацию, либо подождать, пока она завершится. Для удобства отслеживания на иконке отображается прогресс генерации. Иконка выглядит так [[Файл:Иконка генерации.png|безрамки|20x20px]], если генерация запущена. При наведении на нее она меняется на ''Остановить генерацию ответов'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить генерацию. Все ответы, которые успели сгенерироваться, останутся. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка вопросов
|Нажав на кнопку, появится меню с двумя разделами: '''«Загрузка»''' и '''«Замена».'''
''Функционал раздела '''«Замена».'''''

Этот раздел позволяет заменить определенный текст в ответах на вопросы. Для этого необходимо заполнить следующие поля:

* категория
* искомый текст в ответах
* замена
* и нажать запуск.
''Функционал раздела '''«Загрузка».'''''Этот раздел предназначен для обработки множества вопросов (в режиме '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]) или пар вопрос-ответ (в '''JSON'''-режиме [[Файл:JSON.png|безрамки|80x80пкс]]).

Режим '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]'''.'''

Для массовой обработки вопросов в режиме Текст требуется выбрать:

* файл с вопросами в формате .csv,
* выбрать категорию, к которой относятся вопросы из файла,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Любые ответы'',
* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и если не активирован флаг «Использовать генерацию», функция работать не будет). Другие модели будут отображаться в списке только после того, как администратор добавит их.
* а также активировать только флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]''). Можно активировать остальные флаги для случаев, когда нужно помимо обработки нужно ''еще и сгенерировать ответы.''
* а так же активировать опцию «Установить порог похожести,%». Если вы активируете её, то сможете выбрать значение по умолчанию — 90% или задать своё собственное.<blockquote>'''Важно:''' в файле могут быть вопросы '''только''' по одной тематике.</blockquote>Обработка вопросов осуществляется по следующей схеме: каждый новый вопрос сравнивается с предыдущими (и формулировками). Если обнаруживается вопрос, который кажется схожим по смыслу, то новый вопрос включается в список его возможных кандидатов. Если же не находится вопроса, который имеет семантическую близость с новым, то новый становится основным.<blockquote>'''''Совет:''' д''ля массовой обработки вопросов без генерации ответов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Любые ответы».</blockquote>Режим '''JSON'''[[Файл:JSON.png|безрамки|80x80пкс]].

Чтобы массово обрабатывать пары вопрос-ответ, переключитесь в режим JSON и заполните следующие поля:

* файл с вопросами в формате .json.

<blockquote>Формат json-файла для загрузки в интерфейс:

[

[ "вопрос2", "ответ 2" ],

[ "вопрос1", "ответ 1" ]

]</blockquote>

* выбрать категорию, к которой относятся пары вопрос-ответ в файле,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Не использовать'',
* оставьте параметр «Количество документов» в значении по умолчанию — 1.
* автоматически ставится флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]'').
* порог схожести и устанавливается на 98% без возможности редактирования.

Этот функционал позволяет создать основную базу. После того как пары вопросов и ответов будут добавлены, можно будет [https://wiki.connect2ai.net/index.php#Добавление_новых_и_редактирование_вопросов добавлять формулировки в вопросы]. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Лупа.png|центр|безрамки|50x50пкс]]
|Поиск несоответствий кэша ответов и документов / Векторный поиск
|Позволяет запустить поиск разного вида в зависимости от выбранного режима: '''«Поиск несоответствий»''' или '''«Векторный поиск»'''.

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

''1. "Вопрос по документации",''

''2.'' "Поиск несоответствий информации".

Поиск может занимать достаточно продолжительное время. Для удобства отслеживания на иконке отображается прогресс поиска. При наведении на нее она меняется на ''"Остановить поиск несоответствий кэша ответов и документов"'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить поиск.

В режиме '''«Векторный поиск»''' при нажатии на кнопку появляется форма для поиска фрагментов, векторно похожих на фразу запроса. Для запуска в ней нужно указать ''Текст'' запроса, ''Категорию'' поиска и ''Порог схожести''. Далее будет выведена таблица с данными поиска с разделением на документы и ответы.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

[[Файл:Шаблоны запросов.png|мини|''Рис. 18. Интерфейс вкладки Шаблоны запросов'']]

===== Функционал вкладки «Шаблоны запросов» =====

Данный раздел позволяет управлять шаблонами промптов: создавать, редактировать, удалять и настраивать их использование ''(Рис. 18)''.

'''1. Интерфейс вкладки'''

'''- ''Фильтрация по типу'''''

В верхней части окна слева расположен выпадающий список '''«Тип»''', позволяющий отфильтровать шаблоны по категориям:

- Чат

- Запрос к документу

- Очистка документа

- Генератор синонимичных фраз

- Перефразировка фрагмента текста

- Суммаризация текста

- Генератор вопросов по тексту

- Векторная замена информации

- Поиск несоответствий информации

- Генерация якорей по документу

- Аннотация документа

Напротив каждого типа в скобках указано количество доступных шаблонов.

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

'''''- Список шаблонов'''''

Справа от списка типов отображаются шаблоны выбранной категории. При выборе шаблона из списка его содержимое отображается в области просмотра.

'''''- Редактирование шаблона'''''

- ''Название шаблона'' – можно изменить в соответствующем поле.
[[Файл:Сведение в единый.png|мини|''Рис. 19. Шаблон сведения ответа в единый'']]
- ''Текст шаблона'' – поддерживает параметры в квадратных скобках <code>[###Сопроводительный текст, если нужен{Параметр}]</code>, которые являются необязательными. Квадратные скобки обозначают необязательный параметр, то есть его может не быть и система все равно отработает.

- ''Шаблон сведения ответа в единый'' (опционально) – используется в суммаризации для объединения нескольких частей в один результат. <blockquote>Например, разбили совещание на куски, сделали по кускам суммаризации, а потом нужно в один результат все свести ''(Рис. 19)''.</blockquote> - ''Параметры генерации:''

* max_tokens - ограничение максимального количества токенов, возвращаемых моделью в ответ на заданный запрос (prompt);
* top_k - параметр, определяющий количество наиболее вероятных токенов, которые модель учитывает при генерации текста. Чем ниже значение, тем более предсказуемым и повторяющимся будет ответ модели;
* top_p - параметр отвечает за динамический выбор словаря модели и является альтернативой настройке «температуры» ответа. Используется для уменьшения вероятности генерации неожиданных или нежелательных ответов;
* temperature - параметр влияет на детерминированность или случайность генерируемых ответов. При более низких значениях алгоритм предпочитает наиболее вероятные токены, что обеспечивает точность и краткость, идеально подходящие для фактических ответов. При повышении температуры выбор становится более случайным, что способствует разнообразию и творческим идеям, например, при создании стихов;
* repeat_penalty - количество повторений слов в ответе.

- ''Использовать данный шаблон по умолчанию'' – если активировать эту опцию, шаблон будет применяться автоматически в зависимости от типа (например, в QAS для запросов к документам или в SPR для суммаризации).

'''2. Добавление нового шаблона'''

1. Нажмите кнопку '''«Добавить»''' внизу вкладки.

2. Заполните поля:

- ''Название шаблона''

- ''Тип шаблона'' (выберите из выпадающего списка)

- ''Текст шаблона'' (обязательное поле)

- ''Параметры генерации''

3. Нажмите '''«Добавить»''' для сохранения.

'''3. Редактирование и удаление шаблонов'''

- Чтобы изменить шаблон, откройте его, внесите правки и нажмите '''«Сохранить».'''

- Для удаления выберите шаблон и нажмите '''«Удалить»'''. <blockquote>'''Примечание:''' Не забывайте сохранять изменения после редактирования шаблонов.</blockquote>
[[Файл:2025-07-04 17-05-52.png|мини|''Рис. 20 Рабочая область вкладки «Интерактив».'']]

==== Вкладка «Интерактив» ====

Вкладка '''«Интерактив»''' включает в себя три режима:

# режим протоколирования,
# чат,
# очистка текста.
[[Файл:Шаблон.png|мини|''Рис.21. Блок редактирования и просмотра шаблона'']]Чтобы '''переключиться между режимами''', просто нажмите на соответствующие иконки на панели управления. Активный режим выделяется красным контуром вокруг иконки.

'''Режим протоколирования''' [[Файл:Remove-bg.ai 1741353006272.png|безрамки|20x20пкс]] служит для создания протоколов — кратких резюме — на основе стенограмм. Она обладает двумя ключевыми функциями: позволяет создавать шаблоны для протоколов и создавать протоколы.
[[Файл:2025-07-04 17-06-57.png|мини|''Рис. 22. Форма для загрузки файла для протоколирования.'']]
[[Файл:2025-05-21 15-23-39.png|мини|''Рис. 23. Интерфейс вкладки Интерактив в режиме Чат'']]
Слева располагается список всех шаблонов, где вы можете найти подходящий или создать новый. Для добавления нового шаблона необходимо нажать на кнопку '''«Добавить шаблон»''' и заполнить все необходимые поля в появившемся окне: '''указать название шаблона''', а также '''наименования разделов''' и '''описать их содержание'''.
В центральной части экрана, вы можете редактировать шаблон. Здесь вы можете внести изменения и сохранить их, либо удалить, нажав соответствующие кнопки внизу блока (см. рис. 21).

В нижней части экрана вы найдете форму для отправки файла на протоколирование (см. рис. 22). Для загрузки файла воспользуйтесь кнопкой '''«Выберите файл»'''. Справа от поля выбора файла располагается значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении на которую всплывает подсказка с поддерживаемыми типами файлов.

'''[[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|Шаблон запроса к LLM]]''' стоит по умолчанию, в выпадающем списке для этого функционала доступны только шаблоны типа "Суммаризация текста". Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Затем выберите одну из опций использования '''Шаблона протокола''': '''"Использовать"''' или с '''"Не использовать"'''. Справа будет отображаться сгенерированный протокол, его можно будет выгрузить в формате docx или txt (см. раздел. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Интерактив»|Панель управления вкладки «Интерактив»]]). В рабочей области так же есть информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.

'''В режиме «Чат»''' [[Файл:Чат (1).png|безрамки|20x20пкс]] можно в свободной форме пообщаться с LLM-моделью. Есть возможность обращаться к нескольким моделям. Рабочая область показана на рисунке 23. Слева на рисунке есть блок с выбором LLM-модели, "Шаблон запроса к LLM" типа "Чат" и опция «Глубина истории сообщений», которая варьируется в диапазоне [3, 10]. История сообщений в чате сохраняется с ориентиром на глубину.

Функция '''«Размышление*»''' модели

Помимо основного ответа, большая языковая модель предоставляет возможность просмотреть логику своих рассуждений. Эта информация отображается в раскрывающемся блоке «Размышление».

* Назначение: Позволяет понять ход мыслей модели, который привел к конечному ответу.
* Практическое применение: Анализ «Размышления» помогает при необходимости скорректировать исходный запрос (промпт) для получения более точного результата.

*доступна только для больших «думающих» моделей.<blockquote>Внимание: варианты моделей появляются в интерфейсе после того, как администраторы их добавят. </blockquote>
В центре экрана расположен сам чат. Внизу области расположено окно, в которое можно ввести свой запрос и отправить его по клику на кнопку «Отправить» [[Файл:Отправить.png|безрамки|20x20пкс]] . Очистить историю можно воспользовавшись одноименной кнопкой [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]]. Справа от чата блок с «Поиском ответов», подробнее о нем и его параметрах можно прочитать [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].
[[Файл:2025-05-28 16-48-05.png|мини|''Рис. 24 Интерфейс вкладки Интерактив в режиме Очистка чата'']]

'''Режим «Очистка текста»''' [[Файл:Photo 2025-05-21 12-43-53.jpg|безрамки|20x20пкс]] этот инструмент помогает убрать из текста лишнее и сделать его более читабельным. Чтобы воспользоваться функцией, вставьте текст в поле «Чистка текста» (в центре рабочей области) и нажмите кнопку «Очистить». После завершения процесса справа от исходного текста появится очищенный вариант (рис. 24). В него нельзя вносить изменения, но можно скопировать с помощью клавиш Ctrl+C или экспортировать в виде документа [[Файл:Сохранить doc (1).png|безрамки|20x20пкс]] docx или txt на выбор.

===== Панель управления вкладки «Интерактив» =====
{| class="wikitable"
|+
!'''Иконка кнопки'''
!'''Название кнопки'''
!'''Описание'''
|-
|[[Файл:Remove-bg.ai 1741353006272.png|центр|безрамки|40x40пкс]]
|Протоколирование
|Режим протоколирования позволяет создавать протокол на основе стенограмм. Когда режим активен, вокруг появляется красный фон.
|-
|[[Файл:Чат (1).png|центр|безрамки|40x40пкс]]
|Чат
|Режим чата позволяет свободно общаться с LLM-моделью на любые темы. Когда вокруг кнопки появляется красный фон, режим активируется.
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать как документ
|Позволяет экспортировать документ протокола в одном из форматов docx или txt для режимов: протоколирование и очистка текста.
|-
|[[Файл:Меню пользователя new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Совместная работа ===

В QAS допускается работать нескольким пользователям, если они работают в разных категориях.

=== Методика работы с QAS ===

Чтобы начать пользоваться сервисом ответов на вопросы, вам нужно загрузить документацию, ответы на которую вы будете давать пользователям. Определить категорию этих документов. Напоминаем, что файл должен быть максимально ёмким, подробным и кратким подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Добавление файла в список|раздел Добавление файла в список]]. Если в документе используются аббревиатуры или слова с неофициальными ("народными") вариантами написания/произношения, например, «материнский капитал» (маткапитал, маткап и так далее), их следует включить в глоссарий. Глоссарий можно найти в разделе [[QAS. UPS руководство по работе с интерфейсом#Функционал меню «Дополнительно»|«Дополнительно»]] на вкладке «Документы» под текстом документа.

===== <big>Добавление вопросов</big> =====
Если у вас нет готовых вопросов по документации есть два варианта:

# добавлять вопросы и их формулировки вручную,
# запустить генерацию вопросов по документации (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|Панель управления вкладки Документы]]).

После того, как генерация вопросов завершится, необходимо пройти на вкладку Вопросы и проверить вопросы на соответствие документации и адекватность.

Если у вас есть csv файл с фразами-вопросами, то есть возможность загрузить их массово, воспользовавшись кнопкой «Массовая обработка вопросов» на панели управления вкладки Вопросы (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После этого нужно скомпоновать по смыслу вопросы и почистить ненужные.

===== <big>Добавление ответов</big> =====
После того как вопросы будут загружены в базу вопросов QAS. Можно запустить генерацию ответов (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После ее завершения нужно проверить правильность и соответствие ответов вопросу, если ответ вас устраивает — поставьте галочку «Проверено». Либо отредактируйте ответ и так же отметьте его проверенным. Так же можно самостоятельно добавить ответы на вопроса из документации. А так же есть возможность запустить перефразирование уже проверенных ответов, что поможет немного расширить вариации ответов.

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

''Пример корректного ответа и нет:''
{| class="wikitable"
|+
!'''Вопрос'''
!'''Ответ, который потенциально приведет к ошибке'''
!'''Ответ, который НЕ приведет к ошибке'''
|-
|Реабилитационный сертификат
|'''По данному вопросу''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|По вопросу '''оформления реабилитационного сертификата''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|}

===== <big>Работа с кэшем вопросов</big> =====
После того как вы создадите базу вопросов и ответов, можно приступить к проверке работы кэша. В разделе «Кэш» вы найдёте блок для поиска ответа. В поле «Текст» введите свой вопрос, который может быть похож на уже существующие и на которые может ответить ваша загруженная документация. Установите необходимые настройки поиска, подробности можно найти [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].

Далее возможны различные варианты развития событий:

* Если ''вопрос не похож'' ни на один из уже имеющихся в базе данных, и активирован флаг «Использовать генерацию», система сгенерирует ответ на основе документации (если в ней есть ответ на этот вопрос). А сам вопрос будет добавлен в список основных (при условии, что активна галка «кэширование формулировки»). Если функция генерации отключена, в ответ на вопрос будет указано «Информация не найдена». Сам вопрос будет отображаться в общем списке вопросов как основной, для работы с ним и с подобными нужно отфильтровать по «Пустым ответам».
* Если система ''обнаружит сходство с каким-либо вопросом из базы данных'', новый вопрос будет добавлен в список кандидатов к этому вопросу. Если кандидат попадет в верный вопрос его нужно будет утвердить (перенести в формулировки). Вы сможете найти его местоположение, перейдя в режим «Утверждение кандидатов» и отфильтровав одноименную колонку с помощью формулировки вашего запроса в поле «вопрос». Подробности о работе с кандидатами [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|тут]]'''<big>.</big>'''
* Если в базе данных уже ''есть похожий запрос'', но ''система не может найти его'' и генерирует новый ответ на ваш запрос, то решить эту проблему можно, добавив ваш новый вопрос как основной запрос. Поскольку, если система не считает похожим ни на один вопрос, то лучше добавить его как отдельный вопрос со своим ответом.
* Склейки (несколько вопросов разделенные «|») попадают в QAS, но не оседают там, даже если включена галочка «кэширование формулировок».

===== <big>Запуск в прод</big> =====
При массовом обращении к системе, например, на проде удобнее всего с новыми запросами работать через отчет по [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|кандидатам]]. С его помощью можно увидеть, в какие категории и в какие вопросы поступают новые запросы, и сразу же внести изменения — поменять категорию или утвердить кандидатов. А также увидеть, каким запросам не присвоилась категория вообще.

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

2025-12-29T13:14:10Z

E.Elagina: /* Функционал меню «Дополнительно» */

=== Главное меню ===
[[Файл:QAS.png|мини|''Рис. 1 Главный экран UPS'']]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# QAS ЧаВО,
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]]
# Выход.
Переключаться между продуктами можно двумя способами:

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]] .
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).

Перейти в раздел '''«ЧаВО»''' (QAS) можно кликнув по соответствующей кнопке на главном экране UPS (см.рис. 1).

=== Описание интерфейса сервиса «ЧаВО» (QAS) ===
Рабочая область сервиса «ЧаВО» (QAS) (сервиса ответов на вопросы) включает в себя следующие блоки:
*панель управления;
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Документы»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Кэш»|«Кэш»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Интерактив»|«Интерактив»]];'''
*вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области;
*вкладка '''«Категории»''' содержит список всех созданных категорий, можно как редактировать уже существующие, так и добавлять новые. Есть фильтрация по названию. Доступен ''экспорт''[[Файл:2025-12-10 11-22-58 (1).png|безрамки|28x28пкс]] и ''импорт'' [[Файл:2025-12-10 11-23-23 (1).png|безрамки|30x30пкс]] категории, для переноса на другой сервер; А так же ''удаление'' категории.
<blockquote>'''ВНИМАНИЕ: удаление категории''' происходит '''со всеми документами и вопросами,''' система сообщит об этом.</blockquote><blockquote>'''Как работает импорт:'''
* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.

'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>

==== Вкладка «Документы» ====
[[Файл:Photo 2025-05-21 12-43-54.jpg|мини|''Рис. 2 Рабочая область сервиса «ЧаВО»'']]Во вкладке «Документы» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 2):

* панель управления;
* блок со списком документов содержит поиск по названию и фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Спрятать боковую панель''' между списком документов и блоком для редактирования (появляется при наведении мыши на середину между блоками);
* добавление нового документа в базу;
[[Файл:Photo 2025-05-21 12-43-54 (2).jpg|мини|''Рис. 3 Пример отработки кнопки «Очистить текст»'']]
*блок '''«Редактирование документа»''' с полями: «Название», «Дополнительно» и текстом выбранного файла, который можно редактировать. Можно переименовывать файл, после чего нужно сохранить изменения. Кнопка сохранения становится активной как только будут внесены изменения. Чтобы сделать текст более читабельным, его можно очистить от лишнего. Для этого нажмите кнопку '''«Очистить текст»''', которая находится под основным блоком слева от '''«Сохранить»''', предварительно выбрав шаблон запроса, если требуется. Или воспользуйтесь кнопкой на [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|панели управления]] [[Файл:2025-10-08 15-19-11 (1).png|безрамки|20x20пкс]].
<blockquote>'''Важно:''' при уже запущенном процессе очистки кнопка остановит текущий процесс отчистки.</blockquote>После завершения очистки справа появится окно с изменениями. Кнопка, открывающая данные по очистке позволяет просмотреть так же:

* Прогресс выполнения (%)
* Позицию в очереди (правило '''«один аккаунт — одна операция очистки»''')
* Результаты обработки. Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''

Вы сможете сравнить исходный и очищенный текст. Если нужно внести правки, их можно сделать прямо в блоке с очищенным документом. После проверки и внесения правок, если все устраивает, нажмите '''«Заменить в документе»''' под блоком с очищенным текстом. Изменения вступят в силу. ''Не забудьте сохранить документ.'' Рядом с этой кнопкой есть '''«Закрыть»'''. Она закрывает окно с очищенным текстом без сохранения изменений.
<blockquote>Для очистки текста, ''который не загружен в базу данных'' QAS, используйте режим «Очистка текста» на вкладке «Интерактивный режим».</blockquote>
*блок поиска фрагментов по базе.

[[Файл:2025-12-29 15-35-16.png|мини|''Рис.4. Добавление нового файла'']]

===== Добавление файла в список =====
В нижней части блока со списком файлов есть кнопка '''«Добавить файл»'''. Если нажать на нее, то появится диалоговое окно, как показано на рисунке 4. Чтобы добавить файл, нужно заполнить все необходимые поля и выбрать нужный файл с компьютера, в кодировке '''Unicode UTF-8'''.

Поддерживаемые '''форматы''':

* .odt
* .docx
* .doc
* .rtf
* .ods
* .xlsx
* .xls
* .pdf
* .txt.

Максимальный размер файла неограничен. Если вы хотите ''добавить новую категорию'' при загрузке документа, вам нужно ввести название новой категории в соответствующее поле и нажать кнопку '''«Добавить новую категорию…».''' После этого загружаемый документ будет отнесён к новой категории, и файл успешно добавится в базу. Также, при установленной галочке «'''Дополнительно запустить очистку текста»''' можно выбрать шаблон запроса, при необходимости, и после загрузки документа будет открыта дополнительно вкладка справа с результатом очищенного документа, который можно отредактировать и заменить в загруженном документе.

'''Блок «Параметры поиска документа»'''

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

Доступные опции:

* Использовать начало документа — в поиск будет включен первый фрагмент текста.
* Использовать аннотацию — при поиске система будет учитывать подготовленное краткое описание (аннотацию) документа. Аннотация генерируется автоматически на этапе векторизации при активном флаге.
* Использовать заголовок документа — в поисковые данные добавляется название файла, которое указано в интерфейсе. Поэтому важно указывать название отражающее содержание документа.
* Использовать якоря по содержимому — для индексации будут выделены ключевые смысловые блоки (якоря), автоматически определенные внутри документа.

Затем нажмите на кнопку '''«Добавить».'''

===== Функционал меню «Дополнительно» =====
[[Файл:2025-05-23 17-11-07.png|мини|''Рис. 5 Иллюстрация функций кнопки Дополнительно'']]
На вкладке дополнительно вы можете посмотреть:

* категорию к которой относиться документ,
* параметры поиска документа,
* аннотация и опция перегенерации аннотации,
* глоссарий, в котором укажите название объекта из документа (рис. 5), а также его синоним в соответствующих полях внизу страницы. Это поможет модели лучше понимать, о чём её спрашивают. Например, научить ее тому, что «госпошлина = пошлина», «загранник = загранпаспорту», «загранпаспорт = заграничному паспорту», а «загранпаспорт нового образца = загранпаспорту на 10 лет» и нажмите кнопку добавить.
<blockquote>Поиск в базе работает '''на основе векторного анализа текста'''. Чтобы система точнее находила нужные документы, важно выделить ключевые термины и создать глоссарий.

Как это сделать:

# Внимательно изучите документ.
# Выпишите основные термины и их возможные синонимы.
# Внесите их в глоссарий в формате: ''основной термин = синоним''.

Пример:

Если в документе слово ''«апостиль»'' иногда называют «''услугой»,'' укажите в глоссарий:

<code>апостиль = услуга</code>.</blockquote>Предусмотрено массовое удаление синонимов, для этого выделите нужное галочками. Кликнув на поле с фразами вы можете отредактировать формулировку. После внесения изменений нажмите кнопку '''«Сохранить»'''. Она станет активной сразу же после того, как вы внесете какие-либо изменения в документ. Эта кнопка является дубликатом кнопки '''«Сохранить»''' в блоке редактирования документа.
* есть кнопка для экспорта глоссария, если это необходимо в формате .csv.
* а так же доступен импорт с тремя опциями: дополнить, заменить и отменить импорт.
* здесь же находится кнопка для удаления документа.
[[Файл:Параметры поиска документа.jpg|мини|''Рис. 6 Параметры поиска документа'']]
'''Блок «Параметры поиска документа»'''

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

Доступные опции:

* Использовать начало документа — в поиск будет включен первый фрагмент текста.
* Использовать аннотацию — при поиске система будет учитывать подготовленное краткое описание (аннотацию) документа. Аннотация генерируется автоматически на этапе векторизации при активном флаге.
* Использовать заголовок документа — в поисковые данные добавляется название файла, которое указано в интерфейсе. Поэтому важно указывать название отражающее содержание документа.
* Использовать якоря по содержимому — для индексации будут выделены ключевые смысловые блоки (якоря), автоматически определенные внутри документа.

Ниже есть блок с текстом сгенерированной аннотации, ее можно отредактировать при необходимости вручную или запустить перегенерацию по кнопке '''«Генерация аннотации»'''. Появится дополнительное окно, где можно выбрать шаблон и промпт, если не подходит тот, что по умолчанию. Генерацию можно остановить по кнопке '''«Остановить»''', а после генерации можно '''«Заменить в документе»'''.

===== Поиск фрагментов в документах =====
Поиск фрагментов — это первый этап для ответа на вопрос. Система сначала ищет фрагмент (фрагменты) в документах, после отправляет их вместе с промптом на модель генерации.

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

===== Панель управления вкладки «Документы» =====
В верхней части экрана располагается панель управления, на которой находятся кнопки: ''генерация ответов, экспорт документов, очистка документа, массовая обработка вопросов, задать вопрос'' и ''меню пользователя.''
{| class="wikitable"
|+''Табл. 1 Описание функционала панели управления.''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать документ
|Позволяет экспортировать документ в одном из форматов .docx или .txt
|-
|[[Файл:2025-10-08 15-19-11 (1).png|центр|безрамки|40x40пкс]]
|Очистка документа
|При нажатии на кнопку открывается диалоговое окно, в котором необходимо:

# Выбрать модель генерации — укажите модель ИИ для обработки текста
# Выбрать шаблон очистки — определите параметры форматирования текста

<blockquote>'''Важно!''' Очистка будет применена к текущему активному документу.

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

Действует правило '''«один аккаунт — одна операция очистки».'''</blockquote>После запуска кнопка меняется на ''«Остановить очистку документа»,'' по нажатию на нее запущенная вами очистка завершается.

Посмотреть прогресс очистки можно нажав на кнопку ''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Очистка текста»]]'' под документом.

Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация вопросов
|эта кнопка предназначена для генерации вопросов. По нажатию на кнопку появляется диалоговое окно, в котором требуется выбрать:

* категорию вопросов для генерации;
* если не нужно генерировать вопросы для всех документов, выберите нужный,
* выберите канал,
* выберете модель генерации (по умолчанию используется default), другие модели будут отображаться в списке только после того, как администратор добавит их,
* выберите шаблон запроса к LLM (по умолчанию используется шаблон "из коробки" типа "Генератор вопросов по тексту"),
* запустите генерацию.
Генерация вопросов запускается ''для каждой'' категории ''отдельно''.
<blockquote>'''''Совет''': генерацию лучше запускать в нерабочее время, так как она может занять много времени.'' Для удобства отслеживания на иконке отображается прогресс генерации.</blockquote>Есть возможность включить или отключить опцию ''генерации ответов'' сразу для документа. Для случаев, когда добавился новый документ в категорию и нет под него ВОП из «живых» фраз.

<blockquote>'''''Совет''''': если есть возможность использовать «живые» фразы людей, то всегда лучше брать их, а не генерировать синтетические вопросы.</blockquote>
|-
|[[Файл:2024-07-08 22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка документов
|позволяет сделать массовую замену текста в документах. В диалоговом окне нужно выбрать категорию, искомый текст и текст замены.
|-
|[[Файл:Задать_вопрос_нов.png|центр|безрамки|40x40пкс]]
|Задать вопрос1
|генерирует ответ на вопрос на основе информации, содержащейся в одном или нескольких документах.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы, шаблоны)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:Ask.png|мини|Рис. 7 Блок «Задать вопрос»|589x589пкс]]
1 По нажатию на кнопку '''«Задать вопрос»''' (рис. 7), появляется диалоговое окно с полями:

'''«Вопрос»''' — это область для ввода вопроса.

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

'''«Канал»''' - список созданных каналов связей.

'''«Модель генерации»''' - список доступных моделей

'''«Шаблон запроса к LLM»''' - шаблон запроса (промпт) к модели генерации.

'''«Использовать кэш ответов»''' - в этом меню можно выбрать, использовать ли только проверенные ответы или любые.

Также в блоке есть флажки '''«Использовать генерацию»''' и '''«Кэширование формулировки»'''. Если вы ставите активный флажок '''«Кэширование формулировки»''', то вопрос, который вы задали, будет направлен в кэш вопросов вместе с найденным ответом и будет доступен для редактирования на вкладке «Вопросы». <blockquote>'''Внимание:''' склейки не оседают в QAS, даже если флаг активен.</blockquote>Результат отработки метода отобразится после нажатия на кнопку '''«Получить ответ»''' внизу. Показатель ''«достоверность»'' отражает процент достоверности ответа, основываясь на всех найденных фрагментах. Вопросы, которые вы создаёте с помощью кнопки «Задать вопрос» (при активной галочке «Использовать генерацию»), отображаются в списке на вкладке '''«Вопросы»''' и становятся доступными для редактирования.
==== Вкладка «Кэш» ====
Во вкладке «Кэш» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 8):[[Файл:Рис. 7 Рабочая область вкладки «Кэш».png|мини|Рис. 8 Рабочая область вкладки «Кэш»]]
* панель управления;
* блок со списком вопросов содержит поиск по вопросам и ответам, а так же фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Скрыть боковую панель''' между списком вопросов и блоком для редактирования (появляется при наведении курсора);
* добавление нового вопроса;
* блок для работы с вопросами и ответами на них;
* блок поиска ответов;
* список доступных для работы режимов, которые включают в себя:
** '''[[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|«Подробный»]]''';
** '''[[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Проверка новых вопросов»|«Проверка новых вопросов»]]''';
** '''[[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|«Утверждение кандидатов»]]''';
** '''[[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Поиск несоответствий»|«Поиск несоответствий»]]''';
** '''[[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Векторный поиск»|«Векторный поиск»]]''';
* вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|«Шаблоны запросов»]]''';
* вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*вкладка '''«Категории»''' содержит список всех созданных каналов, можно как редактировать или удалять уже существующие, так и добавлять новые;
*вкладка '''«Логи обработки»''' — это меню для просмотра результата (ошибок) после и во время массовой обработки вопросов (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|разд. ''Панель управления вкладки «Кэш»'']]). При желании их можно экспортировать кликнув на кнопку ''Экспорт'' в правом нижнем углу меню.
*Информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.

===== Добавление новых и редактирование вопросов =====

''Вопросы в QAS могут быть трех видов:''

'''Кандидаты''' — это новые запросы к системе, которые, по мнению самой системы, являются семантически близкими к основному вопросу и его формулировкам. Чтобы перевести кандидата в формулировки, нужно ''утвердить'' их (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|разд. Режим работы "Утверждение кандидатов"]])

'''Формулировки (алиасы)''' — это различные варианты одного и того же вопроса. Этот список станет основой для системы при поступлении новых запросов. Она будет использовать его, чтобы определить, в кандидаты к какому основному вопросу стоит отнести новый.

'''Основной вопрос''' — это новый вопрос, который ранее не существовал в базе данных QAS, а также не имел семантически близких аналогов. Каждому основному вопросу присваивается категория. Он может включать дополнительные формулировки и кандидатов.

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

* категорию вопроса;

* текст вопроса.

Чтобы ''отредактировать'' уже существующий вопрос, нужно выбрать его из списка. После этого его текст и ответы появятся в блоке для редактирования, который находится в середине страницы. Если вопрос слишком длинный и не помещается в одну строку, просто нажмите на него, и он будет развёрнут. [[Файл:2024-10-14 15-55-53.png|мини|''Рис. 9 Интерфейс вкладки «Дополнительно»'']]

Меню '''«Дополнительно»''' включает в себя следующие опции:

- изменение формулировки основного вопроса,

- изменение категории вопроса (перенос в другую категорию) осуществляется путём выбора из списка доступных категорий, расположенного в верхней части окна (рис. 9). Вопрос будет перенесен без потерь со всеми ответами, кандидатами и формулировками.

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

Поэтому мы создаём короткие вопросы, помечаем их как «неполные» и добавляем уточняющие вопросы в ответ. Например: «Уточните, пожалуйста, что именно вы хотите узнать по поводу детского сада?» Получив такой вопрос, абонент должен будет уточнить свои потребности, а затем робот объединит оба запроса и выдаст ответ, если он есть в базе данных QAS.</blockquote>- добавление, удаление или перенос. Чтобы удалить формулировку, необходимо навести курсор на нужную фразу. После этого справа появятся две кнопки (см. рис. 8). Одна из них в виде ''стрелочки'' предназначена для того, чтобы сделать эту формулировку ''основным вопросом''. А кнопка в виде ''корзинки'' позволяет удалить выбранную фразу. Есть возможность удалять несколько формулировок, для этого нужно выбрать формулировки для удаления и нажать на кнопку ''Удалить,'' рядом с кнопкой ''Переместить.'' <blockquote>При удалении основного вопроса на вкладке ''Дополнительно'', сначала нужно переназначить основным вопросом другую формулировку и после этого удалить. </blockquote>- есть возможность переместить формулировки и/или кандидатов в другой вопрос. Для этого поставьте галочку напротив нужной фразы и нажмите кнопку «Переместить». В появившемся диалоговом окне выберите нужный вопрос (вы можете предварительно отфильтровать вопросы по категориям). Выберите, из выпадающего списка куда следует переместить выбранные вопросы: в формулировки или в список кандидатов, — и нажмите кнопку «Переместить». После этого '''обязательно''' сохраните изменения в текущем вопросе. <blockquote>'''Обращаем ваше внимание,''' что если вы указываете, что перемещение должно быть выполнено в кандидаты, то вам необходимо будет затем перейти и ''утвердить'' кандидата.</blockquote>- так же вы можете ознакомиться со списком ''кандидатов'', который включает формулировки, близкие по смыслу к основному вопросу. Если среди них есть подходящие варианты, отметьте их галочкой и нажмите кнопку «Утвердить». После этого выбранные формулировки появятся в общем списке «Формулировки». ''Добавление большого количества разных формулировок необходимо, чтобы модель могла понимать суть вопроса, независимо от того, как его сформулирует человек, и выдавать один и тот же ответ на разные варианты этого вопроса.''

- ''удаление'' вопроса из базы на вкладке «Дополнительно» внизу будет кнопка ''Удалить вопрос полностью''.

'''Внимание:''' ''Нажимая на кнопку '''Удалить вопрос полностью''' в меню Дополнительно, вы удаляете весь вопрос, включая формулировки, ответы на него из всех каналов и всех кандидатов.''

- после того как вы внесете изменения, кнопка «Сохранить» станет активной в меню «Дополнительно» и на панели для редактирования ответов.

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

Каждый вопрос сопровождается флажком '''«Проверено»''', который отмечает ответы, проверенные пользователем. При наведении курсора мыши на ответ, вместо канала к которому принадлежит вопрос, появляются кнопки:

* копировать в канал, с ее помощью можно продублировать ответ для любого доступного канала;
* переместить в канал, перемещает ответ с текущего канала на другой выбранный пользователем канал;
* удалить ответ.
Также вы можете добавить новый вопрос в список, воспользовавшись функцией поиска ответа на вкладке '''«Кэш»''' с включенным флажком '''«Использовать генерацию»''' или задав новый вопрос по документам на вкладке '''«Документы»,''' так же выбрав опцию '''«Использовать генерацию»'''. Если похожего вопроса раньше не было, то он появится в списке на вкладке «Вопросы». Вы сможете редактировать и изменять его по своему усмотрению. В случае, если похожий вопрос уже встречался, система предложит его как кандидата к похожему вопросу. Это значит, что его нужно будет перенести в формулировки (утвердить) и сохранить изменения.

===== Поиск по вопросам и ответам. Фильтрация =====
[[Файл:2024-08-06 16-23-15.png|мини|''Рис. 10 Иллюстрация поиска по вопросам'']]
В разделе '''«Кэш»''' есть три вида поиска:

# поиск по вопросам и их формулировкам, в том числе и кандидатам;
# поиск по ответам.
# поиск по категории

А так же два вида фильтрации:

# по содержанию ответов: ''Все'', ''Проверенные'', ''Непроверенные'', ''Пустые.''
# по полноте вопроса: ''Все, Полный, Неполный.'' К полным вопросам относятся вопросы с конкретикой. К неполным - короткие вопросы без конкретики.

[[Файл:2024-08-06 16-38-29.png|мини|''Рис. 11 Иллюстрация поиска по ответам'']]С помощью '''поиска по вопросам и их формулировкам''' можно найти все вопросы или вопросы в определённой категории, которые содержат определённое слово или фразу в своей формулировке. Поиск работает как для основного вопроса, так и для дополнительных формулировок. <blockquote>Например, на рисунке 9 в категории «Водительские права» мы ищем все вопросы, в которых есть сочетание букв «''замена''». Если открыть меню, внизу экрана, ''«Дополнительно»'', то можно увидеть, что это сочетание используется в альтернативных формулировках вопроса, найденные сочетания подсвечиваются. </blockquote>Обращаем внимание, что если в основном вопросе нет искомого слова или сочетания букв, то система все равно выведет вопрос, если найдет совпадения в альтернативных формулировках. [[Файл:2024-08-06 16-24-00.png|мини|''Рис. 12 Результат работы двух видов поиска одновременно'']]
Предусмотрен ''поиск по ответам'', в поле '''«Ответ»''' можно ввести слово или фразу и система подсветит поля ответов, где искомое сочетание было найдено (рис. 11). По умолчанию канал связи стоит в положении «не выбран» и выводятся ''все'' ответы ''из всех каналов'', где найдено слово или фраза. Можно принудительно выбрать канал из списка, тогда отобразятся ответы выбранного канала и будут подсвечены те ответы, где найден искомый текст. Область ответа с искомым текстом будет подсвечена бледно-голубым (рис. 12). Можно одновременно использовать два вида поиска. В результате будут отображены вопросы, в которых присутствует искомое значение – как в вопросах, так и в ответах (рис. 11).

===== Поиск ответа =====
[[Файл:2025-07-04 15-31-58.png|мини|''Рис. 13 Интерфейс блока «Поиск ответов»'']]
Блок '''«Поиск ответа»''' (рис. 13) работает так же, как кнопка '''«Задать вопрос»''' на вкладке '''«Документы»'''. <blockquote>Важно отметить, что поиск ответа происходит в два этапа:

# поиск нужных фрагментов из документов в категории,
# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.
</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов. <blockquote>Для запуска поиска есть горячие клавиши Ctrl+Enter или по кнопке Получить ответ. </blockquote>В выпадающем списке '''«Модель генерации»''' вы можете выбрать модель, которая будет создавать итоговый ответ. Чтобы в списке появились дополнительные модели, кроме стандартной, администратор должен их добавить. После этого они появятся в списке, и вы сможете использовать их вместо стандартной модели.

'''«Шаблон запроса к LLM»:''' здесь вы можете выбрать, какой промпт отправить на генеративную модель вместе с найденными фрагментами и вопросом. Если промпт не выбран, LLM будет использовать стандартный запрос. Подробнее о шаблонах запросов [[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|тут]]. <blockquote>'''Для чего это нужно?'''

Если стандартный промпт не работает так, как нужно для конкретной категории, или требуется что-то особенное, можно создать новый шаблон. Это делается без изменения стандартного промпта. </blockquote>Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Меню '''«Использовать кэш»'''. В этом меню можно выбрать, использовать ли только проверенные ответы или любые. Кэш-память позволяет сервису быстрее отвечать на запросы пользователей. А опция '''«Только проверенные ответы»''' гарантирует, что ответы, которые получает пользователь, были отредактированы и проверены оператором.

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

Аналогично вкладке «Документы», вы можете настроить '''количество документов''', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.

===== Функционал режима «Проверка новых вопросов» =====
Режим «Проверка новых вопросов» содержит перечень всех новых вопросов. В рабочей области находится таблица, в которой представлен список новых вопросов, ответы на них, категория, присвоенная этим вопросам, а также дата создания вопроса. Есть возможность фильтрации по каждой из колонок (рис. 14).
[[Файл:New questions mode.png|мини|''Рис.14 Интерфейс режима утверждения новых вопросов'']]
При наведении на любую строку слева появляются иконка и чекбокс:
# [[Файл:Circle-check-solid.png|безрамки|22x22пкс]] Утвердить — позволяет утвердить ответ на текущий вопрос. Это означает, что ответ и категория соответствует вопросу. После утверждения вопрос пропадет из таблицы и получит статус '''«Проверено».'''
# [[Файл:Checkbox.png|безрамки|25x25пкс]] Чекбокс — позволяет выбрать несколько позиций таблицы для утверждения или удаления. Утверждение означает, что у всех выбранных позиций ответ и категория соответствует вопросу. Для утверждения всех выбранных позиций необходимо нажать кнопку «Утвердить», внизу таблицы, в правом нижнем углу. Для удаления — на значок ''корзинки'' (п. 5 списка ниже), так же в нижнем углу.
В «подвале» таблицы расположены следующие функциональные элементы:

# [[Файл:Expand.png|безрамки|20x20пкс]] Развернуть — разворачивает таблицу и входит в полноэкранный режим.
# [[Файл:Compress.png|безрамки|23x23пкс]] Свернуть — выходит из полноэкранного режима и возвращает таблицу в исходное состояние.
# [[Файл:Approve changes mode.png|безрамки|187x187пкс]] — позволяет переключаться между состояниями режима '''«Подтверждения изменений».''' При включенном режиме при каждом массовом утверждении ответов на вопросы будет появляться диалоговое окно, которое будет запрашивать подтверждение текущих изменений.
# Кнопка '''«Утвердить»''' — позволяет утвердить все выбранные на данный момент ответы на вопросы. Кнопка не активна, пока не выбрана ни одна позиция в таблице.
# [[Файл:Delete icon.png|безрамки|22x22пкс]] — позволяет удалить все выбранные на данный момент ответы на вопросы. При включенном режиме '''«Подтверждения изменений»''' при удалении запросит подтверждение в диалоговом окне.
[[Файл:New questions mode changed.png|мини|''Рис.14.1. Работа в режиме утверждения новых вопросов'']]Данный режим позволяет как точено, так и массово проверять ответы и категорию на соответствие вопросу.
В таблице реализована возможность самостоятельной правки вопросов/ответов/категорий. Для этого надо кликнуть на интересующую вас ячейку и внести правки. Сразу после изменений в верхней правой части ячейки появится иконка для отката изменений [[Файл:Undo.png|безрамки|24x24пкс]] на '''начальное''' состояние. Если в строке произошли какие-то изменения, то ''строка автоматически переходит в состояние выбранной'' (рис. 14.1).

В таблице реализована клавиатурная доступность, которая позволяет перемещаться между ячейками и утверждать выбранные позиции в таблице. Для этого используются следующие комбинации клавиш: Ctrl + ⬆/⬇/⬅/➡/Enter.

===== Функционал режима «Утверждение кандидатов» =====
[[Файл:Рис. 13 Интерфейс режима Утверждения кандидатов.png|мини|''Рис. 15. Интерфейс режима Утверждения кандидатов'']]
Режим «Утверждение кандидатов» содержит перечень всех кандидатов. В рабочей области находится таблица, в которой представлен список кандидатов, перечень основных вопросов, где эти кандидаты находятся, а также категория, присвоенная этим вопросам (рис. 15).

При наведении на любую строку слева появляются две иконки:
# [[Файл:Сделать основным без фона.png|безрамки|26x26px]] Сделать основным — позволяет сделать кандидата основным вопросом. По нажатию на эту кнопку появляется диалоговое окно, где требуется подтвердить намерение сделать кандидата основным вопросом. В форме подтверждения нужно выбрать категорию, в которую хотели бы добавить вопрос и аналогично функционалу добавить новый вопрос (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|Добавление новых и редактирование вопросов]]).
# [[Файл:Утвердить.png|безрамки|26x26px]] Утвердить — позволяет утвердить кандидата, в текущем вопросе, включая её в формулировку вопроса. Это означает, что кандидат подходит по смыслу к основному вопросу и его формулировкам.[[Файл:Рис 14. Работа в режиме Утверждение кандидатов.jpg|мини|''Рис.15.1. Работа в режиме Утверждение кандидатов'']]

Чтобы утвердить сразу несколько кандидатов, отметьте их галочками. После этого внизу появится строка с выпадающим списком всех основных вопросов из базы данных QAS.

По умолчанию система предлагает утвердить выбранного кандидата или кандидатов в текущем вопросе. Однако если вы хотите перенести его в другой вопрос, просто начните вводить его название в поле поиска. Затем нажмите кнопку «Утвердить», расположенную в правом нижнем углу (рис. 15.1).

Если вы хотите ''удалить'' кандидата или кандидатов, выделите их и нажмите на иконку «Корзинка», которая находится над кнопкой «Утвердить».

===== Функционал режима «Поиск несоответствий» =====

Режим "Поиска несоответствий кэша ответов и документов" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Несоответствия"''''' и '''''"Ошибки"''.''' Чтобы запустить поиск несоответствий, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

[[Файл:Поиск несоответствий 1.png|мини|''Рис.16. Работа в режиме Поиска несоответствий. Вкладка несоответствий'']]
При активном табе '''"Несоответствия"''' показана таблица результатов поиска для работы с найденными ответами из кэша, которые не соответствуют фрагменту документа (рис.16). Таблица разделена на 4 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''фрагмент из документа'', по которому был дан текущий ответ,
* ''исправленный ответ'', на который предлагается заменить текущий.

Проанализировав предложенные ответы в столбце ''"Исправленный ответ"'', можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены предложенных ответов на ответы из кэша необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

[[Файл:Поиск несоответствий 2.png|мини|''Рис.16.1. Работа в режиме Поиска несоответствий. Вкладка Ошибок'']]
При активном табе '''"Ошибки"''' показана таблица результатов поиска для работы с найденными ответами из кэша, по которым были выявлены ошибки, например, отсутствие информации (рис.16.1). Таблица разделена на 3 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''ошибка'' поиска''.''

Здесь можно скорректировать ответ из кэша, при необходимости (в ячейке таблицы), или удалить запись (строку). Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены исправленных ответов необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

===== Функционал режима «Векторный поиск» =====
[[Файл:Векторный поиск.png|мини|''Рис.17. Работа в режиме Векторного поиска'']]
Режим "Векторного поиска" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Документы"''''' и '''''"Ответы"''''' (рис.17). Он предназначен для поиска и замены ответов и фраз в документах, векторно похожих на текст запроса. Чтобы запустить векторный поиск, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

После окончания поиска будет отображена таблица, которая разделена на 3 столбца:
* ''документ / вопрос'' (в зависимости от выбранного таба),
* ''фраза / ответ'' (в зависимости от выбранного таба),
* ''сходство'', в процентах.
Проанализировав найденные фразы/ответы, можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].
[[Файл:Векторный поиск 2.png|мини|''Рис.17.1. Замена информации в режиме векторного поиска'']]

Затем слева от таблицы заполняем форму для того, чтобы модель генерации предложила варианты замены информации (фразы или ответа). Для этого заполняем недостающие поля: ''Текст замены'' и опционально ''Модель генерации'' (по умолчанию default) и ''Шаблон запроса к LLM'' типа "Векторная замена информации". После нажатия на кнопку ''"Показать варианты замены"'' запустится процесс подготовки предложений по замене информации: появится четвертый столбец ''"Измененная фраза" / "Измененный ответ"'' и в ней по очереди построчно будут заполнятся фразы/ответы (рис. 17.1).

После окончания обработки можно отредактировать или удалить предложенные варианты замены, выделить нужные и нажать внизу таблицы кнопку ''"Заменить фразы"'' / ''"Заменить ответы"'' для замены фраз в документе/ответов соответственно.

===== Панель управления вкладки «Кэш» =====
{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления вкладки «Кэш»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:2024-07-08_22-41-00_(1).png|центр|безрамки|40x40пкс]]
|Выбрать вопросы
|При нажатии на эту кнопку активируется режим, в котором можно выбрать несколько вопросов из списка для последующего перемещения или удаления. Сама кнопка подсвечивается красным контуром, показывая, что она активна. Нажав на неё повторно, можно выключить режим и сбросить выбор. После того как вы отметили галочками вопросы, справа от кнопки появляется опции «Переместить вопросы» [[Файл:Копировать.png|безрамки|20x20px]] и «Удалить выбранные вопросы»[[Файл:2024-07-08 22-55-51-no-bg-preview (carve.photos).png|безрамки|20x20px]].
Если вы собираетесь переместить вопросы, но в них уже есть проверенные ответы или кандидаты, в диалоговом окне появится соответствующее предупреждение. При этом перемещаться они не будут. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-35.png|центр|безрамки|40x40пкс]]
|Экспорт вопросов
|Эта кнопка позволяет экспортировать вопросы в формате CSV для классификатора или для отчета.
Структура файла для классификатора выглядит следующим образом: ''Категория'' ⇥ ''Вопрос.''
Структура файла отчетности: ''Категория⇥ Вопрос⇥ Обозначение вопроса(основной/алиас/кандидат).'' Эта кнопка доступна только в режиме '''«Подробный».'''
|-
|[[Файл:Автосохранение_(1).png|центр|безрамки|40x40пкс]]
|Автосохранение
|Позволяет включить автосохранение. При включенном (вокруг кнопки появляется красный контур) режиме будет сохраняться через 10 секунд после изменения данных. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Обновить_данные_вопроса.png|центр|безрамки|40x40пкс]]
|Обновить данные вопроса
|С помощью этой кнопки можно обновить данные текущего вопроса, например, после генерации ответов. По нажатию на кнопку обновятся все ответы, которые система сгенерировала на этот вопрос. Генерация ответов происходит для разных каналов связи. Вы можете просмотреть их, выбрав нужный канал в меню рядом с основным вопросом. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация ответов
|эта кнопка предназначена для генерации ответов. По нажатию на кнопку появляется диалоговое окно, в котором требуется:

* ввести желаемое количество ''ответов'',
* выбрать ''категорию'', для которой требуется генерация,
* выбрать ''канал'',
* выбрать ''режим генерации'': по документам или перефразирование проверенных,
* указать, для каких вопросов нужно сгенерировать ответы: для всех или только для пустых,
* далее выбрать, следует ли заменить существующие ответы. Если «да», то ответы будут заменены на новые. Если «нет», то они будут дополнены новыми вариантами,
* указать модель генерации (по умолчанию используется default). Другие модели будут отображаться в списке только после того, как администратор добавит их,
* и наконец, указать ''количество документов [1,10]'', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.
* и нажать на кнопку «Запуск».

Генерация может занимать достаточно продолжительное время. Помимо канала по умолчанию, ответы генерируются и для других каналов, после окончания обновите данные вопроса и просмотрите все существующие каналы.<blockquote>'''''Совет:''''' ''лучше использовать сначала режим генерации ответов по документам, после чего проверить их правильность и запускать генерацию в режиме перефразирования ответов. Также перед тем, как сгенерировать ответы, обновите страницу.'' </blockquote>Убедитесь, что предыдущая генерация ответов закончена, иначе кнопка не сработает, и вам нужно будет либо остановить предыдущую генерацию, либо подождать, пока она завершится. Для удобства отслеживания на иконке отображается прогресс генерации. Иконка выглядит так [[Файл:Иконка генерации.png|безрамки|20x20px]], если генерация запущена. При наведении на нее она меняется на ''Остановить генерацию ответов'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить генерацию. Все ответы, которые успели сгенерироваться, останутся. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка вопросов
|Нажав на кнопку, появится меню с двумя разделами: '''«Загрузка»''' и '''«Замена».'''
''Функционал раздела '''«Замена».'''''

Этот раздел позволяет заменить определенный текст в ответах на вопросы. Для этого необходимо заполнить следующие поля:

* категория
* искомый текст в ответах
* замена
* и нажать запуск.
''Функционал раздела '''«Загрузка».'''''Этот раздел предназначен для обработки множества вопросов (в режиме '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]) или пар вопрос-ответ (в '''JSON'''-режиме [[Файл:JSON.png|безрамки|80x80пкс]]).

Режим '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]'''.'''

Для массовой обработки вопросов в режиме Текст требуется выбрать:

* файл с вопросами в формате .csv,
* выбрать категорию, к которой относятся вопросы из файла,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Любые ответы'',
* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и если не активирован флаг «Использовать генерацию», функция работать не будет). Другие модели будут отображаться в списке только после того, как администратор добавит их.
* а также активировать только флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]''). Можно активировать остальные флаги для случаев, когда нужно помимо обработки нужно ''еще и сгенерировать ответы.''
* а так же активировать опцию «Установить порог похожести,%». Если вы активируете её, то сможете выбрать значение по умолчанию — 90% или задать своё собственное.<blockquote>'''Важно:''' в файле могут быть вопросы '''только''' по одной тематике.</blockquote>Обработка вопросов осуществляется по следующей схеме: каждый новый вопрос сравнивается с предыдущими (и формулировками). Если обнаруживается вопрос, который кажется схожим по смыслу, то новый вопрос включается в список его возможных кандидатов. Если же не находится вопроса, который имеет семантическую близость с новым, то новый становится основным.<blockquote>'''''Совет:''' д''ля массовой обработки вопросов без генерации ответов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Любые ответы».</blockquote>Режим '''JSON'''[[Файл:JSON.png|безрамки|80x80пкс]].

Чтобы массово обрабатывать пары вопрос-ответ, переключитесь в режим JSON и заполните следующие поля:

* файл с вопросами в формате .json.

<blockquote>Формат json-файла для загрузки в интерфейс:

[

[ "вопрос2", "ответ 2" ],

[ "вопрос1", "ответ 1" ]

]</blockquote>

* выбрать категорию, к которой относятся пары вопрос-ответ в файле,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Не использовать'',
* оставьте параметр «Количество документов» в значении по умолчанию — 1.
* автоматически ставится флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]'').
* порог схожести и устанавливается на 98% без возможности редактирования.

Этот функционал позволяет создать основную базу. После того как пары вопросов и ответов будут добавлены, можно будет [https://wiki.connect2ai.net/index.php#Добавление_новых_и_редактирование_вопросов добавлять формулировки в вопросы]. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Лупа.png|центр|безрамки|50x50пкс]]
|Поиск несоответствий кэша ответов и документов / Векторный поиск
|Позволяет запустить поиск разного вида в зависимости от выбранного режима: '''«Поиск несоответствий»''' или '''«Векторный поиск»'''.

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

''1. "Вопрос по документации",''

''2.'' "Поиск несоответствий информации".

Поиск может занимать достаточно продолжительное время. Для удобства отслеживания на иконке отображается прогресс поиска. При наведении на нее она меняется на ''"Остановить поиск несоответствий кэша ответов и документов"'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить поиск.

В режиме '''«Векторный поиск»''' при нажатии на кнопку появляется форма для поиска фрагментов, векторно похожих на фразу запроса. Для запуска в ней нужно указать ''Текст'' запроса, ''Категорию'' поиска и ''Порог схожести''. Далее будет выведена таблица с данными поиска с разделением на документы и ответы.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

[[Файл:Шаблоны запросов.png|мини|''Рис. 18. Интерфейс вкладки Шаблоны запросов'']]

===== Функционал вкладки «Шаблоны запросов» =====

Данный раздел позволяет управлять шаблонами промптов: создавать, редактировать, удалять и настраивать их использование ''(Рис. 18)''.

'''1. Интерфейс вкладки'''

'''- ''Фильтрация по типу'''''

В верхней части окна слева расположен выпадающий список '''«Тип»''', позволяющий отфильтровать шаблоны по категориям:

- Чат

- Запрос к документу

- Очистка документа

- Генератор синонимичных фраз

- Перефразировка фрагмента текста

- Суммаризация текста

- Генератор вопросов по тексту

- Векторная замена информации

- Поиск несоответствий информации

Напротив каждого типа в скобках указано количество доступных шаблонов.

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

'''''- Список шаблонов'''''

Справа от списка типов отображаются шаблоны выбранной категории. При выборе шаблона из списка его содержимое отображается в области просмотра.

'''''- Редактирование шаблона'''''

- ''Название шаблона'' – можно изменить в соответствующем поле.
[[Файл:Сведение в единый.png|мини|''Рис. 19. Шаблон сведения ответа в единый'']]
- ''Текст шаблона'' – поддерживает параметры в квадратных скобках <code>[###Сопроводительный текст, если нужен{Параметр}]</code>, которые являются необязательными. Квадратные скобки обозначают необязательный параметр, то есть его может не быть и система все равно отработает.

- ''Шаблон сведения ответа в единый'' (опционально) – используется в суммаризации для объединения нескольких частей в один результат. <blockquote>Например, разбили совещание на куски, сделали по кускам суммаризации, а потом нужно в один результат все свести ''(Рис. 19)''.</blockquote> - ''Параметры генерации:''

* max_tokens - ограничение максимального количества токенов, возвращаемых моделью в ответ на заданный запрос (prompt);
* top_k - параметр, определяющий количество наиболее вероятных токенов, которые модель учитывает при генерации текста. Чем ниже значение, тем более предсказуемым и повторяющимся будет ответ модели;
* top_p - параметр отвечает за динамический выбор словаря модели и является альтернативой настройке «температуры» ответа. Используется для уменьшения вероятности генерации неожиданных или нежелательных ответов;
* temperature - параметр влияет на детерминированность или случайность генерируемых ответов. При более низких значениях алгоритм предпочитает наиболее вероятные токены, что обеспечивает точность и краткость, идеально подходящие для фактических ответов. При повышении температуры выбор становится более случайным, что способствует разнообразию и творческим идеям, например, при создании стихов;
* repeat_penalty - количество повторений слов в ответе.

- ''Использовать данный шаблон по умолчанию'' – если активировать эту опцию, шаблон будет применяться автоматически в зависимости от типа (например, в QAS для запросов к документам или в SPR для суммаризации).

'''2. Добавление нового шаблона'''

1. Нажмите кнопку '''«Добавить»''' внизу вкладки.

2. Заполните поля:

- ''Название шаблона''

- ''Тип шаблона'' (выберите из выпадающего списка)

- ''Текст шаблона'' (обязательное поле)

- ''Параметры генерации''

3. Нажмите '''«Добавить»''' для сохранения.

'''3. Редактирование и удаление шаблонов'''

- Чтобы изменить шаблон, откройте его, внесите правки и нажмите '''«Сохранить».'''

- Для удаления выберите шаблон и нажмите '''«Удалить»'''. <blockquote>'''Примечание:''' Не забывайте сохранять изменения после редактирования шаблонов.</blockquote>
[[Файл:2025-07-04 17-05-52.png|мини|''Рис. 20 Рабочая область вкладки «Интерактив».'']]

==== Вкладка «Интерактив» ====

Вкладка '''«Интерактив»''' включает в себя три режима:

# режим протоколирования,
# чат,
# очистка текста.
[[Файл:Шаблон.png|мини|''Рис.21. Блок редактирования и просмотра шаблона'']]Чтобы '''переключиться между режимами''', просто нажмите на соответствующие иконки на панели управления. Активный режим выделяется красным контуром вокруг иконки.

'''Режим протоколирования''' [[Файл:Remove-bg.ai 1741353006272.png|безрамки|20x20пкс]] служит для создания протоколов — кратких резюме — на основе стенограмм. Она обладает двумя ключевыми функциями: позволяет создавать шаблоны для протоколов и создавать протоколы.
[[Файл:2025-07-04 17-06-57.png|мини|''Рис. 22. Форма для загрузки файла для протоколирования.'']]
[[Файл:2025-05-21 15-23-39.png|мини|''Рис. 23. Интерфейс вкладки Интерактив в режиме Чат'']]
Слева располагается список всех шаблонов, где вы можете найти подходящий или создать новый. Для добавления нового шаблона необходимо нажать на кнопку '''«Добавить шаблон»''' и заполнить все необходимые поля в появившемся окне: '''указать название шаблона''', а также '''наименования разделов''' и '''описать их содержание'''.
В центральной части экрана, вы можете редактировать шаблон. Здесь вы можете внести изменения и сохранить их, либо удалить, нажав соответствующие кнопки внизу блока (см. рис. 21).

В нижней части экрана вы найдете форму для отправки файла на протоколирование (см. рис. 22). Для загрузки файла воспользуйтесь кнопкой '''«Выберите файл»'''. Справа от поля выбора файла располагается значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении на которую всплывает подсказка с поддерживаемыми типами файлов.

'''[[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|Шаблон запроса к LLM]]''' стоит по умолчанию, в выпадающем списке для этого функционала доступны только шаблоны типа "Суммаризация текста". Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Затем выберите одну из опций использования '''Шаблона протокола''': '''"Использовать"''' или с '''"Не использовать"'''. Справа будет отображаться сгенерированный протокол, его можно будет выгрузить в формате docx или txt (см. раздел. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Интерактив»|Панель управления вкладки «Интерактив»]]). В рабочей области так же есть информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.

'''В режиме «Чат»''' [[Файл:Чат (1).png|безрамки|20x20пкс]] можно в свободной форме пообщаться с LLM-моделью. Есть возможность обращаться к нескольким моделям. Рабочая область показана на рисунке 23. Слева на рисунке есть блок с выбором LLM-модели, "Шаблон запроса к LLM" типа "Чат" и опция «Глубина истории сообщений», которая варьируется в диапазоне [3, 10]. История сообщений в чате сохраняется с ориентиром на глубину.

Функция '''«Размышление*»''' модели

Помимо основного ответа, большая языковая модель предоставляет возможность просмотреть логику своих рассуждений. Эта информация отображается в раскрывающемся блоке «Размышление».

* Назначение: Позволяет понять ход мыслей модели, который привел к конечному ответу.
* Практическое применение: Анализ «Размышления» помогает при необходимости скорректировать исходный запрос (промпт) для получения более точного результата.

*доступна только для больших «думающих» моделей.<blockquote>Внимание: варианты моделей появляются в интерфейсе после того, как администраторы их добавят. </blockquote>
В центре экрана расположен сам чат. Внизу области расположено окно, в которое можно ввести свой запрос и отправить его по клику на кнопку «Отправить» [[Файл:Отправить.png|безрамки|20x20пкс]] . Очистить историю можно воспользовавшись одноименной кнопкой [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]]. Справа от чата блок с «Поиском ответов», подробнее о нем и его параметрах можно прочитать [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].
[[Файл:2025-05-28 16-48-05.png|мини|''Рис. 24 Интерфейс вкладки Интерактив в режиме Очистка чата'']]

'''Режим «Очистка текста»''' [[Файл:Photo 2025-05-21 12-43-53.jpg|безрамки|20x20пкс]] этот инструмент помогает убрать из текста лишнее и сделать его более читабельным. Чтобы воспользоваться функцией, вставьте текст в поле «Чистка текста» (в центре рабочей области) и нажмите кнопку «Очистить». После завершения процесса справа от исходного текста появится очищенный вариант (рис. 24). В него нельзя вносить изменения, но можно скопировать с помощью клавиш Ctrl+C или экспортировать в виде документа [[Файл:Сохранить doc (1).png|безрамки|20x20пкс]] docx или txt на выбор.

===== Панель управления вкладки «Интерактив» =====
{| class="wikitable"
|+
!'''Иконка кнопки'''
!'''Название кнопки'''
!'''Описание'''
|-
|[[Файл:Remove-bg.ai 1741353006272.png|центр|безрамки|40x40пкс]]
|Протоколирование
|Режим протоколирования позволяет создавать протокол на основе стенограмм. Когда режим активен, вокруг появляется красный фон.
|-
|[[Файл:Чат (1).png|центр|безрамки|40x40пкс]]
|Чат
|Режим чата позволяет свободно общаться с LLM-моделью на любые темы. Когда вокруг кнопки появляется красный фон, режим активируется.
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать как документ
|Позволяет экспортировать документ протокола в одном из форматов docx или txt для режимов: протоколирование и очистка текста.
|-
|[[Файл:Меню пользователя new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Совместная работа ===

В QAS допускается работать нескольким пользователям, если они работают в разных категориях.

=== Методика работы с QAS ===

Чтобы начать пользоваться сервисом ответов на вопросы, вам нужно загрузить документацию, ответы на которую вы будете давать пользователям. Определить категорию этих документов. Напоминаем, что файл должен быть максимально ёмким, подробным и кратким подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Добавление файла в список|раздел Добавление файла в список]]. Если в документе используются аббревиатуры или слова с неофициальными ("народными") вариантами написания/произношения, например, «материнский капитал» (маткапитал, маткап и так далее), их следует включить в глоссарий. Глоссарий можно найти в разделе [[QAS. UPS руководство по работе с интерфейсом#Функционал меню «Дополнительно»|«Дополнительно»]] на вкладке «Документы» под текстом документа.

===== <big>Добавление вопросов</big> =====
Если у вас нет готовых вопросов по документации есть два варианта:

# добавлять вопросы и их формулировки вручную,
# запустить генерацию вопросов по документации (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|Панель управления вкладки Документы]]).

После того, как генерация вопросов завершится, необходимо пройти на вкладку Вопросы и проверить вопросы на соответствие документации и адекватность.

Если у вас есть csv файл с фразами-вопросами, то есть возможность загрузить их массово, воспользовавшись кнопкой «Массовая обработка вопросов» на панели управления вкладки Вопросы (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После этого нужно скомпоновать по смыслу вопросы и почистить ненужные.

===== <big>Добавление ответов</big> =====
После того как вопросы будут загружены в базу вопросов QAS. Можно запустить генерацию ответов (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После ее завершения нужно проверить правильность и соответствие ответов вопросу, если ответ вас устраивает — поставьте галочку «Проверено». Либо отредактируйте ответ и так же отметьте его проверенным. Так же можно самостоятельно добавить ответы на вопроса из документации. А так же есть возможность запустить перефразирование уже проверенных ответов, что поможет немного расширить вариации ответов.

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

''Пример корректного ответа и нет:''
{| class="wikitable"
|+
!'''Вопрос'''
!'''Ответ, который потенциально приведет к ошибке'''
!'''Ответ, который НЕ приведет к ошибке'''
|-
|Реабилитационный сертификат
|'''По данному вопросу''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|По вопросу '''оформления реабилитационного сертификата''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|}

===== <big>Работа с кэшем вопросов</big> =====
После того как вы создадите базу вопросов и ответов, можно приступить к проверке работы кэша. В разделе «Кэш» вы найдёте блок для поиска ответа. В поле «Текст» введите свой вопрос, который может быть похож на уже существующие и на которые может ответить ваша загруженная документация. Установите необходимые настройки поиска, подробности можно найти [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].

Далее возможны различные варианты развития событий:

* Если ''вопрос не похож'' ни на один из уже имеющихся в базе данных, и активирован флаг «Использовать генерацию», система сгенерирует ответ на основе документации (если в ней есть ответ на этот вопрос). А сам вопрос будет добавлен в список основных (при условии, что активна галка «кэширование формулировки»). Если функция генерации отключена, в ответ на вопрос будет указано «Информация не найдена». Сам вопрос будет отображаться в общем списке вопросов как основной, для работы с ним и с подобными нужно отфильтровать по «Пустым ответам».
* Если система ''обнаружит сходство с каким-либо вопросом из базы данных'', новый вопрос будет добавлен в список кандидатов к этому вопросу. Если кандидат попадет в верный вопрос его нужно будет утвердить (перенести в формулировки). Вы сможете найти его местоположение, перейдя в режим «Утверждение кандидатов» и отфильтровав одноименную колонку с помощью формулировки вашего запроса в поле «вопрос». Подробности о работе с кандидатами [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|тут]]'''<big>.</big>'''
* Если в базе данных уже ''есть похожий запрос'', но ''система не может найти его'' и генерирует новый ответ на ваш запрос, то решить эту проблему можно, добавив ваш новый вопрос как основной запрос. Поскольку, если система не считает похожим ни на один вопрос, то лучше добавить его как отдельный вопрос со своим ответом.
* Склейки (несколько вопросов разделенные «|») попадают в QAS, но не оседают там, даже если включена галочка «кэширование формулировок».

===== <big>Запуск в прод</big> =====
При массовом обращении к системе, например, на проде удобнее всего с новыми запросами работать через отчет по [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|кандидатам]]. С его помощью можно увидеть, в какие категории и в какие вопросы поступают новые запросы, и сразу же внести изменения — поменять категорию или утвердить кандидатов. А также увидеть, каким запросам не присвоилась категория вообще.

Файл:Параметры поиска документа.jpg

2025-12-29T12:56:48Z

E.Elagina:

Параметры поиска документа

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

2025-12-29T12:44:50Z

E.Elagina: /* Вкладка «Документы» */

=== Главное меню ===
[[Файл:QAS.png|мини|''Рис. 1 Главный экран UPS'']]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# QAS ЧаВО,
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]]
# Выход.
Переключаться между продуктами можно двумя способами:

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]] .
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).

Перейти в раздел '''«ЧаВО»''' (QAS) можно кликнув по соответствующей кнопке на главном экране UPS (см.рис. 1).

=== Описание интерфейса сервиса «ЧаВО» (QAS) ===
Рабочая область сервиса «ЧаВО» (QAS) (сервиса ответов на вопросы) включает в себя следующие блоки:
*панель управления;
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Документы»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Кэш»|«Кэш»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Интерактив»|«Интерактив»]];'''
*вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области;
*вкладка '''«Категории»''' содержит список всех созданных категорий, можно как редактировать уже существующие, так и добавлять новые. Есть фильтрация по названию. Доступен ''экспорт''[[Файл:2025-12-10 11-22-58 (1).png|безрамки|28x28пкс]] и ''импорт'' [[Файл:2025-12-10 11-23-23 (1).png|безрамки|30x30пкс]] категории, для переноса на другой сервер; А так же ''удаление'' категории.
<blockquote>'''ВНИМАНИЕ: удаление категории''' происходит '''со всеми документами и вопросами,''' система сообщит об этом.</blockquote><blockquote>'''Как работает импорт:'''
* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.

'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>

==== Вкладка «Документы» ====
[[Файл:Photo 2025-05-21 12-43-54.jpg|мини|''Рис. 2 Рабочая область сервиса «ЧаВО»'']]Во вкладке «Документы» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 2):

* панель управления;
* блок со списком документов содержит поиск по названию и фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Спрятать боковую панель''' между списком документов и блоком для редактирования (появляется при наведении мыши на середину между блоками);
* добавление нового документа в базу;
[[Файл:Photo 2025-05-21 12-43-54 (2).jpg|мини|''Рис. 3 Пример отработки кнопки «Очистить текст»'']]
*блок '''«Редактирование документа»''' с полями: «Название», «Дополнительно» и текстом выбранного файла, который можно редактировать. Можно переименовывать файл, после чего нужно сохранить изменения. Кнопка сохранения становится активной как только будут внесены изменения. Чтобы сделать текст более читабельным, его можно очистить от лишнего. Для этого нажмите кнопку '''«Очистить текст»''', которая находится под основным блоком слева от '''«Сохранить»''', предварительно выбрав шаблон запроса, если требуется. Или воспользуйтесь кнопкой на [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|панели управления]] [[Файл:2025-10-08 15-19-11 (1).png|безрамки|20x20пкс]].
<blockquote>'''Важно:''' при уже запущенном процессе очистки кнопка остановит текущий процесс отчистки.</blockquote>После завершения очистки справа появится окно с изменениями. Кнопка, открывающая данные по очистке позволяет просмотреть так же:

* Прогресс выполнения (%)
* Позицию в очереди (правило '''«один аккаунт — одна операция очистки»''')
* Результаты обработки. Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''

Вы сможете сравнить исходный и очищенный текст. Если нужно внести правки, их можно сделать прямо в блоке с очищенным документом. После проверки и внесения правок, если все устраивает, нажмите '''«Заменить в документе»''' под блоком с очищенным текстом. Изменения вступят в силу. ''Не забудьте сохранить документ.'' Рядом с этой кнопкой есть '''«Закрыть»'''. Она закрывает окно с очищенным текстом без сохранения изменений.
<blockquote>Для очистки текста, ''который не загружен в базу данных'' QAS, используйте режим «Очистка текста» на вкладке «Интерактивный режим».</blockquote>
*блок поиска фрагментов по базе.

[[Файл:2025-12-29 15-35-16.png|мини|''Рис.4. Добавление нового файла'']]

===== Добавление файла в список =====
В нижней части блока со списком файлов есть кнопка '''«Добавить файл»'''. Если нажать на нее, то появится диалоговое окно, как показано на рисунке 4. Чтобы добавить файл, нужно заполнить все необходимые поля и выбрать нужный файл с компьютера, в кодировке '''Unicode UTF-8'''.

Поддерживаемые '''форматы''':

* .odt
* .docx
* .doc
* .rtf
* .ods
* .xlsx
* .xls
* .pdf
* .txt.

Максимальный размер файла неограничен. Если вы хотите ''добавить новую категорию'' при загрузке документа, вам нужно ввести название новой категории в соответствующее поле и нажать кнопку '''«Добавить новую категорию…».''' После этого загружаемый документ будет отнесён к новой категории, и файл успешно добавится в базу. Также, при установленной галочке «'''Дополнительно запустить очистку текста»''' можно выбрать шаблон запроса, при необходимости, и после загрузки документа будет открыта дополнительно вкладка справа с результатом очищенного документа, который можно отредактировать и заменить в загруженном документе.

'''Блок «Параметры поиска документа»'''

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

Доступные опции:

* Использовать начало документа — в поиск будет включен первый фрагмент текста.
* Использовать аннотацию — при поиске система будет учитывать подготовленное краткое описание (аннотацию) документа. Аннотация генерируется автоматически на этапе векторизации при активном флаге.
* Использовать заголовок документа — в поисковые данные добавляется название файла, которое указано в интерфейсе. Поэтому важно указывать название отражающее содержание документа.
* Использовать якоря по содержимому — для индексации будут выделены ключевые смысловые блоки (якоря), автоматически определенные внутри документа.

Затем нажмите на кнопку '''«Добавить».'''

===== Функционал меню «Дополнительно» =====
[[Файл:2025-05-23 17-11-07.png|мини|''Рис. 5 Иллюстрация функций кнопки Дополнительно'']]
На вкладке дополнительно вы можете посмотреть:

* категорию к которой относиться документ,
* глоссарий, в котором укажите название объекта из документа (рис. 5), а также его синоним в соответствующих полях внизу страницы. Это поможет модели лучше понимать, о чём её спрашивают. Например, научить ее тому, что «госпошлина = пошлина», «загранник = загранпаспорту», «загранпаспорт = заграничному паспорту», а «загранпаспорт нового образца = загранпаспорту на 10 лет» и нажмите кнопку добавить.
<blockquote>Поиск в базе работает '''на основе векторного анализа текста'''. Чтобы система точнее находила нужные документы, важно выделить ключевые термины и создать глоссарий.

Как это сделать:

# Внимательно изучите документ.
# Выпишите основные термины и их возможные синонимы.
# Внесите их в глоссарий в формате: ''основной термин = синоним''.

Пример:

Если в документе слово ''«апостиль»'' иногда называют «''услугой»,'' укажите в глоссарий:

<code>апостиль = услуга</code>.</blockquote>Предусмотрено массовое удаление синонимов, для этого выделите нужное галочками. Кликнув на поле с фразами вы можете отредактировать формулировку. После внесения изменений нажмите кнопку '''«Сохранить»'''. Она станет активной сразу же после того, как вы внесете какие-либо изменения в документ. Эта кнопка является дубликатом кнопки '''«Сохранить»''' в блоке редактирования документа.
* есть кнопка для экспорта глоссария, если это необходимо в формате .csv.
* а так же доступен импорт с тремя опциями: дополнить, заменить и отменить импорт.
* здесь же находится кнопка для удаления документа.

===== Поиск фрагментов в документах =====
Поиск фрагментов — это первый этап для ответа на вопрос. Система сначала ищет фрагмент (фрагменты) в документах, после отправляет их вместе с промптом на модель генерации.

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

===== Панель управления вкладки «Документы» =====
В верхней части экрана располагается панель управления, на которой находятся кнопки: ''генерация ответов, экспорт документов, очистка документа, массовая обработка вопросов, задать вопрос'' и ''меню пользователя.''
{| class="wikitable"
|+''Табл. 1 Описание функционала панели управления.''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать документ
|Позволяет экспортировать документ в одном из форматов .docx или .txt
|-
|[[Файл:2025-10-08 15-19-11 (1).png|центр|безрамки|40x40пкс]]
|Очистка документа
|При нажатии на кнопку открывается диалоговое окно, в котором необходимо:

# Выбрать модель генерации — укажите модель ИИ для обработки текста
# Выбрать шаблон очистки — определите параметры форматирования текста

<blockquote>'''Важно!''' Очистка будет применена к текущему активному документу.

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

Действует правило '''«один аккаунт — одна операция очистки».'''</blockquote>После запуска кнопка меняется на ''«Остановить очистку документа»,'' по нажатию на нее запущенная вами очистка завершается.

Посмотреть прогресс очистки можно нажав на кнопку ''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Очистка текста»]]'' под документом.

Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация вопросов
|эта кнопка предназначена для генерации вопросов. По нажатию на кнопку появляется диалоговое окно, в котором требуется выбрать:

* категорию вопросов для генерации;
* если не нужно генерировать вопросы для всех документов, выберите нужный,
* выберите канал,
* выберете модель генерации (по умолчанию используется default), другие модели будут отображаться в списке только после того, как администратор добавит их,
* выберите шаблон запроса к LLM (по умолчанию используется шаблон "из коробки" типа "Генератор вопросов по тексту"),
* запустите генерацию.
Генерация вопросов запускается ''для каждой'' категории ''отдельно''.
<blockquote>'''''Совет''': генерацию лучше запускать в нерабочее время, так как она может занять много времени.'' Для удобства отслеживания на иконке отображается прогресс генерации.</blockquote>Есть возможность включить или отключить опцию ''генерации ответов'' сразу для документа. Для случаев, когда добавился новый документ в категорию и нет под него ВОП из «живых» фраз.

<blockquote>'''''Совет''''': если есть возможность использовать «живые» фразы людей, то всегда лучше брать их, а не генерировать синтетические вопросы.</blockquote>
|-
|[[Файл:2024-07-08 22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка документов
|позволяет сделать массовую замену текста в документах. В диалоговом окне нужно выбрать категорию, искомый текст и текст замены.
|-
|[[Файл:Задать_вопрос_нов.png|центр|безрамки|40x40пкс]]
|Задать вопрос1
|генерирует ответ на вопрос на основе информации, содержащейся в одном или нескольких документах.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы, шаблоны)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:Ask.png|мини|Рис. 6 Блок «Задать вопрос»|589x589пкс]]
1 По нажатию на кнопку '''«Задать вопрос»''' (рис. 6), появляется диалоговое окно с полями:

'''«Вопрос»''' — это область для ввода вопроса.

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

'''«Канал»''' - список созданных каналов связей.

'''«Модель генерации»''' - список доступных моделей

'''«Шаблон запроса к LLM»''' - шаблон запроса (промпт) к модели генерации.

'''«Использовать кэш ответов»''' - в этом меню можно выбрать, использовать ли только проверенные ответы или любые.

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

===== Добавление новых и редактирование вопросов =====

''Вопросы в QAS могут быть трех видов:''

'''Кандидаты''' — это новые запросы к системе, которые, по мнению самой системы, являются семантически близкими к основному вопросу и его формулировкам. Чтобы перевести кандидата в формулировки, нужно ''утвердить'' их (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|разд. Режим работы "Утверждение кандидатов"]])

'''Формулировки (алиасы)''' — это различные варианты одного и того же вопроса. Этот список станет основой для системы при поступлении новых запросов. Она будет использовать его, чтобы определить, в кандидаты к какому основному вопросу стоит отнести новый.

'''Основной вопрос''' — это новый вопрос, который ранее не существовал в базе данных QAS, а также не имел семантически близких аналогов. Каждому основному вопросу присваивается категория. Он может включать дополнительные формулировки и кандидатов.

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

* категорию вопроса;

* текст вопроса.

Чтобы ''отредактировать'' уже существующий вопрос, нужно выбрать его из списка. После этого его текст и ответы появятся в блоке для редактирования, который находится в середине страницы. Если вопрос слишком длинный и не помещается в одну строку, просто нажмите на него, и он будет развёрнут. [[Файл:2024-10-14 15-55-53.png|мини|''Рис. 8 Интерфейс вкладки «Дополнительно»'']]

Меню '''«Дополнительно»''' включает в себя следующие опции:

- изменение формулировки основного вопроса,

- изменение категории вопроса (перенос в другую категорию) осуществляется путём выбора из списка доступных категорий, расположенного в верхней части окна (рис. 8). Вопрос будет перенесен без потерь со всеми ответами, кандидатами и формулировками.

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

Поэтому мы создаём короткие вопросы, помечаем их как «неполные» и добавляем уточняющие вопросы в ответ. Например: «Уточните, пожалуйста, что именно вы хотите узнать по поводу детского сада?» Получив такой вопрос, абонент должен будет уточнить свои потребности, а затем робот объединит оба запроса и выдаст ответ, если он есть в базе данных QAS.</blockquote>- добавление, удаление или перенос. Чтобы удалить формулировку, необходимо навести курсор на нужную фразу. После этого справа появятся две кнопки (см. рис. 8). Одна из них в виде ''стрелочки'' предназначена для того, чтобы сделать эту формулировку ''основным вопросом''. А кнопка в виде ''корзинки'' позволяет удалить выбранную фразу. Есть возможность удалять несколько формулировок, для этого нужно выбрать формулировки для удаления и нажать на кнопку ''Удалить,'' рядом с кнопкой ''Переместить.'' <blockquote>При удалении основного вопроса на вкладке ''Дополнительно'', сначала нужно переназначить основным вопросом другую формулировку и после этого удалить. </blockquote>- есть возможность переместить формулировки и/или кандидатов в другой вопрос. Для этого поставьте галочку напротив нужной фразы и нажмите кнопку «Переместить». В появившемся диалоговом окне выберите нужный вопрос (вы можете предварительно отфильтровать вопросы по категориям). Выберите, из выпадающего списка куда следует переместить выбранные вопросы: в формулировки или в список кандидатов, — и нажмите кнопку «Переместить». После этого '''обязательно''' сохраните изменения в текущем вопросе. <blockquote>'''Обращаем ваше внимание,''' что если вы указываете, что перемещение должно быть выполнено в кандидаты, то вам необходимо будет затем перейти и ''утвердить'' кандидата.</blockquote>- так же вы можете ознакомиться со списком ''кандидатов'', который включает формулировки, близкие по смыслу к основному вопросу. Если среди них есть подходящие варианты, отметьте их галочкой и нажмите кнопку «Утвердить». После этого выбранные формулировки появятся в общем списке «Формулировки». ''Добавление большого количества разных формулировок необходимо, чтобы модель могла понимать суть вопроса, независимо от того, как его сформулирует человек, и выдавать один и тот же ответ на разные варианты этого вопроса.''

- ''удаление'' вопроса из базы на вкладке «Дополнительно» внизу будет кнопка ''Удалить вопрос полностью''.

'''Внимание:''' ''Нажимая на кнопку '''Удалить вопрос полностью''' в меню Дополнительно, вы удаляете весь вопрос, включая формулировки, ответы на него из всех каналов и всех кандидатов.''

- после того как вы внесете изменения, кнопка «Сохранить» станет активной в меню «Дополнительно» и на панели для редактирования ответов.

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

Каждый вопрос сопровождается флажком '''«Проверено»''', который отмечает ответы, проверенные пользователем. При наведении курсора мыши на ответ, вместо канала к которому принадлежит вопрос, появляются кнопки:

* копировать в канал, с ее помощью можно продублировать ответ для любого доступного канала;
* переместить в канал, перемещает ответ с текущего канала на другой выбранный пользователем канал;
* удалить ответ.
Также вы можете добавить новый вопрос в список, воспользовавшись функцией поиска ответа на вкладке '''«Кэш»''' с включенным флажком '''«Использовать генерацию»''' или задав новый вопрос по документам на вкладке '''«Документы»,''' так же выбрав опцию '''«Использовать генерацию»'''. Если похожего вопроса раньше не было, то он появится в списке на вкладке «Вопросы». Вы сможете редактировать и изменять его по своему усмотрению. В случае, если похожий вопрос уже встречался, система предложит его как кандидата к похожему вопросу. Это значит, что его нужно будет перенести в формулировки (утвердить) и сохранить изменения.

===== Поиск по вопросам и ответам. Фильтрация =====
[[Файл:2024-08-06 16-23-15.png|мини|''Рис. 9 Иллюстрация поиска по вопросам'']]
В разделе '''«Кэш»''' есть три вида поиска:

# поиск по вопросам и их формулировкам, в том числе и кандидатам;
# поиск по ответам.
# поиск по категории

А так же два вида фильтрации:

# по содержанию ответов: ''Все'', ''Проверенные'', ''Непроверенные'', ''Пустые.''
# по полноте вопроса: ''Все, Полный, Неполный.'' К полным вопросам относятся вопросы с конкретикой. К неполным - короткие вопросы без конкретики.

[[Файл:2024-08-06 16-38-29.png|мини|''Рис. 10 Иллюстрация поиска по ответам'']]С помощью '''поиска по вопросам и их формулировкам''' можно найти все вопросы или вопросы в определённой категории, которые содержат определённое слово или фразу в своей формулировке. Поиск работает как для основного вопроса, так и для дополнительных формулировок. <blockquote>Например, на рисунке 9 в категории «Водительские права» мы ищем все вопросы, в которых есть сочетание букв «''замена''». Если открыть меню, внизу экрана, ''«Дополнительно»'', то можно увидеть, что это сочетание используется в альтернативных формулировках вопроса, найденные сочетания подсвечиваются. </blockquote>Обращаем внимание, что если в основном вопросе нет искомого слова или сочетания букв, то система все равно выведет вопрос, если найдет совпадения в альтернативных формулировках. [[Файл:2024-08-06 16-24-00.png|мини|''Рис. 11 Результат работы двух видов поиска одновременно'']]
Предусмотрен ''поиск по ответам'', в поле '''«Ответ»''' можно ввести слово или фразу и система подсветит поля ответов, где искомое сочетание было найдено (рис. 10). По умолчанию канал связи стоит в положении «не выбран» и выводятся ''все'' ответы ''из всех каналов'', где найдено слово или фраза. Можно принудительно выбрать канал из списка, тогда отобразятся ответы выбранного канала и будут подсвечены те ответы, где найден искомый текст. Область ответа с искомым текстом будет подсвечена бледно-голубым (рис. 10). Можно одновременно использовать два вида поиска. В результате будут отображены вопросы, в которых присутствует искомое значение – как в вопросах, так и в ответах (рис. 11).

===== Поиск ответа =====
[[Файл:2025-07-04 15-31-58.png|мини|''Рис. 12 Интерфейс блока «Поиск ответов»'']]
Блок '''«Поиск ответа»''' (рис. 12) работает так же, как кнопка '''«Задать вопрос»''' на вкладке '''«Документы»'''. <blockquote>Важно отметить, что поиск ответа происходит в два этапа:

# поиск нужных фрагментов из документов в категории,
# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.
</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов. <blockquote>Для запуска поиска есть горячие клавиши Ctrl+Enter или по кнопке Получить ответ. </blockquote>В выпадающем списке '''«Модель генерации»''' вы можете выбрать модель, которая будет создавать итоговый ответ. Чтобы в списке появились дополнительные модели, кроме стандартной, администратор должен их добавить. После этого они появятся в списке, и вы сможете использовать их вместо стандартной модели.

'''«Шаблон запроса к LLM»:''' здесь вы можете выбрать, какой промпт отправить на генеративную модель вместе с найденными фрагментами и вопросом. Если промпт не выбран, LLM будет использовать стандартный запрос. Подробнее о шаблонах запросов [[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|тут]]. <blockquote>'''Для чего это нужно?'''

Если стандартный промпт не работает так, как нужно для конкретной категории, или требуется что-то особенное, можно создать новый шаблон. Это делается без изменения стандартного промпта. </blockquote>Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Меню '''«Использовать кэш»'''. В этом меню можно выбрать, использовать ли только проверенные ответы или любые. Кэш-память позволяет сервису быстрее отвечать на запросы пользователей. А опция '''«Только проверенные ответы»''' гарантирует, что ответы, которые получает пользователь, были отредактированы и проверены оператором.

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

Аналогично вкладке «Документы», вы можете настроить '''количество документов''', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.

===== Функционал режима «Проверка новых вопросов» =====
Режим «Проверка новых вопросов» содержит перечень всех новых вопросов. В рабочей области находится таблица, в которой представлен список новых вопросов, ответы на них, категория, присвоенная этим вопросам, а также дата создания вопроса. Есть возможность фильтрации по каждой из колонок (рис. 13).
[[Файл:New questions mode.png|мини|''Рис.13. Интерфейс режима утверждения новых вопросов'']]
При наведении на любую строку слева появляются иконка и чекбокс:
# [[Файл:Circle-check-solid.png|безрамки|22x22пкс]] Утвердить — позволяет утвердить ответ на текущий вопрос. Это означает, что ответ и категория соответствует вопросу. После утверждения вопрос пропадет из таблицы и получит статус '''«Проверено».'''
# [[Файл:Checkbox.png|безрамки|25x25пкс]] Чекбокс — позволяет выбрать несколько позиций таблицы для утверждения или удаления. Утверждение означает, что у всех выбранных позиций ответ и категория соответствует вопросу. Для утверждения всех выбранных позиций необходимо нажать кнопку «Утвердить», внизу таблицы, в правом нижнем углу. Для удаления — на значок ''корзинки'' (п. 5 списка ниже), так же в нижнем углу.
В «подвале» таблицы расположены следующие функциональные элементы:

# [[Файл:Expand.png|безрамки|20x20пкс]] Развернуть — разворачивает таблицу и входит в полноэкранный режим.
# [[Файл:Compress.png|безрамки|23x23пкс]] Свернуть — выходит из полноэкранного режима и возвращает таблицу в исходное состояние.
# [[Файл:Approve changes mode.png|безрамки|187x187пкс]] — позволяет переключаться между состояниями режима '''«Подтверждения изменений».''' При включенном режиме при каждом массовом утверждении ответов на вопросы будет появляться диалоговое окно, которое будет запрашивать подтверждение текущих изменений.
# Кнопка '''«Утвердить»''' — позволяет утвердить все выбранные на данный момент ответы на вопросы. Кнопка не активна, пока не выбрана ни одна позиция в таблице.
# [[Файл:Delete icon.png|безрамки|22x22пкс]] — позволяет удалить все выбранные на данный момент ответы на вопросы. При включенном режиме '''«Подтверждения изменений»''' при удалении запросит подтверждение в диалоговом окне.
[[Файл:New questions mode changed.png|мини|''Рис.13.1. Работа в режиме утверждения новых вопросов'']]Данный режим позволяет как точено, так и массово проверять ответы и категорию на соответствие вопросу.
В таблице реализована возможность самостоятельной правки вопросов/ответов/категорий. Для этого надо кликнуть на интересующую вас ячейку и внести правки. Сразу после изменений в верхней правой части ячейки появится иконка для отката изменений [[Файл:Undo.png|безрамки|24x24пкс]] на '''начальное''' состояние. Если в строке произошли какие-то изменения, то ''строка автоматически переходит в состояние выбранной'' (рис. 13.1).

В таблице реализована клавиатурная доступность, которая позволяет перемещаться между ячейками и утверждать выбранные позиции в таблице. Для этого используются следующие комбинации клавиш: Ctrl + ⬆/⬇/⬅/➡/Enter.

===== Функционал режима «Утверждение кандидатов» =====
[[Файл:Рис. 13 Интерфейс режима Утверждения кандидатов.png|мини|''Рис. 14. Интерфейс режима Утверждения кандидатов'']]
Режим «Утверждение кандидатов» содержит перечень всех кандидатов. В рабочей области находится таблица, в которой представлен список кандидатов, перечень основных вопросов, где эти кандидаты находятся, а также категория, присвоенная этим вопросам (рис. 14).

При наведении на любую строку слева появляются две иконки:
# [[Файл:Сделать основным без фона.png|безрамки|26x26px]] Сделать основным — позволяет сделать кандидата основным вопросом. По нажатию на эту кнопку появляется диалоговое окно, где требуется подтвердить намерение сделать кандидата основным вопросом. В форме подтверждения нужно выбрать категорию, в которую хотели бы добавить вопрос и аналогично функционалу добавить новый вопрос (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|Добавление новых и редактирование вопросов]]).
# [[Файл:Утвердить.png|безрамки|26x26px]] Утвердить — позволяет утвердить кандидата, в текущем вопросе, включая её в формулировку вопроса. Это означает, что кандидат подходит по смыслу к основному вопросу и его формулировкам.[[Файл:Рис 14. Работа в режиме Утверждение кандидатов.jpg|мини|''Рис.14.1. Работа в режиме Утверждение кандидатов'']]

Чтобы утвердить сразу несколько кандидатов, отметьте их галочками. После этого внизу появится строка с выпадающим списком всех основных вопросов из базы данных QAS.

По умолчанию система предлагает утвердить выбранного кандидата или кандидатов в текущем вопросе. Однако если вы хотите перенести его в другой вопрос, просто начните вводить его название в поле поиска. Затем нажмите кнопку «Утвердить», расположенную в правом нижнем углу (рис. 14.1).

Если вы хотите ''удалить'' кандидата или кандидатов, выделите их и нажмите на иконку «Корзинка», которая находится над кнопкой «Утвердить».

===== Функционал режима «Поиск несоответствий» =====

Режим "Поиска несоответствий кэша ответов и документов" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Несоответствия"''''' и '''''"Ошибки"''.''' Чтобы запустить поиск несоответствий, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

[[Файл:Поиск несоответствий 1.png|мини|''Рис.15. Работа в режиме Поиска несоответствий. Вкладка несоответствий'']]
При активном табе '''"Несоответствия"''' показана таблица результатов поиска для работы с найденными ответами из кэша, которые не соответствуют фрагменту документа (рис.15). Таблица разделена на 4 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''фрагмент из документа'', по которому был дан текущий ответ,
* ''исправленный ответ'', на который предлагается заменить текущий.

Проанализировав предложенные ответы в столбце ''"Исправленный ответ"'', можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены предложенных ответов на ответы из кэша необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

[[Файл:Поиск несоответствий 2.png|мини|''Рис.15.1. Работа в режиме Поиска несоответствий. Вкладка Ошибок'']]
При активном табе '''"Ошибки"''' показана таблица результатов поиска для работы с найденными ответами из кэша, по которым были выявлены ошибки, например, отсутствие информации (рис.15.1). Таблица разделена на 3 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''ошибка'' поиска''.''

Здесь можно скорректировать ответ из кэша, при необходимости (в ячейке таблицы), или удалить запись (строку). Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены исправленных ответов необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

===== Функционал режима «Векторный поиск» =====
[[Файл:Векторный поиск.png|мини|''Рис.16. Работа в режиме Векторного поиска'']]
Режим "Векторного поиска" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Документы"''''' и '''''"Ответы"''''' (рис.16). Он предназначен для поиска и замены ответов и фраз в документах, векторно похожих на текст запроса. Чтобы запустить векторный поиск, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

После окончания поиска будет отображена таблица, которая разделена на 3 столбца:
* ''документ / вопрос'' (в зависимости от выбранного таба),
* ''фраза / ответ'' (в зависимости от выбранного таба),
* ''сходство'', в процентах.
Проанализировав найденные фразы/ответы, можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].
[[Файл:Векторный поиск 2.png|мини|''Рис.16.1. Замена информации в режиме векторного поиска'']]

Затем слева от таблицы заполняем форму для того, чтобы модель генерации предложила варианты замены информации (фразы или ответа). Для этого заполняем недостающие поля: ''Текст замены'' и опционально ''Модель генерации'' (по умолчанию default) и ''Шаблон запроса к LLM'' типа "Векторная замена информации". После нажатия на кнопку ''"Показать варианты замены"'' запустится процесс подготовки предложений по замене информации: появится четвертый столбец ''"Измененная фраза" / "Измененный ответ"'' и в ней по очереди построчно будут заполнятся фразы/ответы (рис. 16.1).

После окончания обработки можно отредактировать или удалить предложенные варианты замены, выделить нужные и нажать внизу таблицы кнопку ''"Заменить фразы"'' / ''"Заменить ответы"'' для замены фраз в документе/ответов соответственно.

===== Панель управления вкладки «Кэш» =====
{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления вкладки «Кэш»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:2024-07-08_22-41-00_(1).png|центр|безрамки|40x40пкс]]
|Выбрать вопросы
|При нажатии на эту кнопку активируется режим, в котором можно выбрать несколько вопросов из списка для последующего перемещения или удаления. Сама кнопка подсвечивается красным контуром, показывая, что она активна. Нажав на неё повторно, можно выключить режим и сбросить выбор. После того как вы отметили галочками вопросы, справа от кнопки появляется опции «Переместить вопросы» [[Файл:Копировать.png|безрамки|20x20px]] и «Удалить выбранные вопросы»[[Файл:2024-07-08 22-55-51-no-bg-preview (carve.photos).png|безрамки|20x20px]].
Если вы собираетесь переместить вопросы, но в них уже есть проверенные ответы или кандидаты, в диалоговом окне появится соответствующее предупреждение. При этом перемещаться они не будут. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-35.png|центр|безрамки|40x40пкс]]
|Экспорт вопросов
|Эта кнопка позволяет экспортировать вопросы в формате CSV для классификатора или для отчета.
Структура файла для классификатора выглядит следующим образом: ''Категория'' ⇥ ''Вопрос.''
Структура файла отчетности: ''Категория⇥ Вопрос⇥ Обозначение вопроса(основной/алиас/кандидат).'' Эта кнопка доступна только в режиме '''«Подробный».'''
|-
|[[Файл:Автосохранение_(1).png|центр|безрамки|40x40пкс]]
|Автосохранение
|Позволяет включить автосохранение. При включенном (вокруг кнопки появляется красный контур) режиме будет сохраняться через 10 секунд после изменения данных. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Обновить_данные_вопроса.png|центр|безрамки|40x40пкс]]
|Обновить данные вопроса
|С помощью этой кнопки можно обновить данные текущего вопроса, например, после генерации ответов. По нажатию на кнопку обновятся все ответы, которые система сгенерировала на этот вопрос. Генерация ответов происходит для разных каналов связи. Вы можете просмотреть их, выбрав нужный канал в меню рядом с основным вопросом. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация ответов
|эта кнопка предназначена для генерации ответов. По нажатию на кнопку появляется диалоговое окно, в котором требуется:

* ввести желаемое количество ''ответов'',
* выбрать ''категорию'', для которой требуется генерация,
* выбрать ''канал'',
* выбрать ''режим генерации'': по документам или перефразирование проверенных,
* указать, для каких вопросов нужно сгенерировать ответы: для всех или только для пустых,
* далее выбрать, следует ли заменить существующие ответы. Если «да», то ответы будут заменены на новые. Если «нет», то они будут дополнены новыми вариантами,
* указать модель генерации (по умолчанию используется default). Другие модели будут отображаться в списке только после того, как администратор добавит их,
* и наконец, указать ''количество документов [1,10]'', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.
* и нажать на кнопку «Запуск».

Генерация может занимать достаточно продолжительное время. Помимо канала по умолчанию, ответы генерируются и для других каналов, после окончания обновите данные вопроса и просмотрите все существующие каналы.<blockquote>'''''Совет:''''' ''лучше использовать сначала режим генерации ответов по документам, после чего проверить их правильность и запускать генерацию в режиме перефразирования ответов. Также перед тем, как сгенерировать ответы, обновите страницу.'' </blockquote>Убедитесь, что предыдущая генерация ответов закончена, иначе кнопка не сработает, и вам нужно будет либо остановить предыдущую генерацию, либо подождать, пока она завершится. Для удобства отслеживания на иконке отображается прогресс генерации. Иконка выглядит так [[Файл:Иконка генерации.png|безрамки|20x20px]], если генерация запущена. При наведении на нее она меняется на ''Остановить генерацию ответов'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить генерацию. Все ответы, которые успели сгенерироваться, останутся. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка вопросов
|Нажав на кнопку, появится меню с двумя разделами: '''«Загрузка»''' и '''«Замена».'''
''Функционал раздела '''«Замена».'''''

Этот раздел позволяет заменить определенный текст в ответах на вопросы. Для этого необходимо заполнить следующие поля:

* категория
* искомый текст в ответах
* замена
* и нажать запуск.
''Функционал раздела '''«Загрузка».'''''Этот раздел предназначен для обработки множества вопросов (в режиме '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]) или пар вопрос-ответ (в '''JSON'''-режиме [[Файл:JSON.png|безрамки|80x80пкс]]).

Режим '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]'''.'''

Для массовой обработки вопросов в режиме Текст требуется выбрать:

* файл с вопросами в формате .csv,
* выбрать категорию, к которой относятся вопросы из файла,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Любые ответы'',
* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и если не активирован флаг «Использовать генерацию», функция работать не будет). Другие модели будут отображаться в списке только после того, как администратор добавит их.
* а также активировать только флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]''). Можно активировать остальные флаги для случаев, когда нужно помимо обработки нужно ''еще и сгенерировать ответы.''
* а так же активировать опцию «Установить порог похожести,%». Если вы активируете её, то сможете выбрать значение по умолчанию — 90% или задать своё собственное.<blockquote>'''Важно:''' в файле могут быть вопросы '''только''' по одной тематике.</blockquote>Обработка вопросов осуществляется по следующей схеме: каждый новый вопрос сравнивается с предыдущими (и формулировками). Если обнаруживается вопрос, который кажется схожим по смыслу, то новый вопрос включается в список его возможных кандидатов. Если же не находится вопроса, который имеет семантическую близость с новым, то новый становится основным.<blockquote>'''''Совет:''' д''ля массовой обработки вопросов без генерации ответов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Любые ответы».</blockquote>Режим '''JSON'''[[Файл:JSON.png|безрамки|80x80пкс]].

Чтобы массово обрабатывать пары вопрос-ответ, переключитесь в режим JSON и заполните следующие поля:

* файл с вопросами в формате .json.

<blockquote>Формат json-файла для загрузки в интерфейс:

[

[ "вопрос2", "ответ 2" ],

[ "вопрос1", "ответ 1" ]

]</blockquote>

* выбрать категорию, к которой относятся пары вопрос-ответ в файле,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Не использовать'',
* оставьте параметр «Количество документов» в значении по умолчанию — 1.
* автоматически ставится флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]'').
* порог схожести и устанавливается на 98% без возможности редактирования.

Этот функционал позволяет создать основную базу. После того как пары вопросов и ответов будут добавлены, можно будет [https://wiki.connect2ai.net/index.php#Добавление_новых_и_редактирование_вопросов добавлять формулировки в вопросы]. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Лупа.png|центр|безрамки|50x50пкс]]
|Поиск несоответствий кэша ответов и документов / Векторный поиск
|Позволяет запустить поиск разного вида в зависимости от выбранного режима: '''«Поиск несоответствий»''' или '''«Векторный поиск»'''.

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

''1. "Вопрос по документации",''

''2.'' "Поиск несоответствий информации".

Поиск может занимать достаточно продолжительное время. Для удобства отслеживания на иконке отображается прогресс поиска. При наведении на нее она меняется на ''"Остановить поиск несоответствий кэша ответов и документов"'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить поиск.

В режиме '''«Векторный поиск»''' при нажатии на кнопку появляется форма для поиска фрагментов, векторно похожих на фразу запроса. Для запуска в ней нужно указать ''Текст'' запроса, ''Категорию'' поиска и ''Порог схожести''. Далее будет выведена таблица с данными поиска с разделением на документы и ответы.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

[[Файл:Шаблоны запросов.png|мини|''Рис. 17. Интерфейс вкладки Шаблоны запросов'']]

===== Функционал вкладки «Шаблоны запросов» =====

Данный раздел позволяет управлять шаблонами промптов: создавать, редактировать, удалять и настраивать их использование ''(Рис. 17)''.

'''1. Интерфейс вкладки'''

'''- ''Фильтрация по типу'''''

В верхней части окна слева расположен выпадающий список '''«Тип»''', позволяющий отфильтровать шаблоны по категориям:

- Чат

- Запрос к документу

- Очистка документа

- Генератор синонимичных фраз

- Перефразировка фрагмента текста

- Суммаризация текста

- Генератор вопросов по тексту

- Векторная замена информации

- Поиск несоответствий информации

Напротив каждого типа в скобках указано количество доступных шаблонов.

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

'''''- Список шаблонов'''''

Справа от списка типов отображаются шаблоны выбранной категории. При выборе шаблона из списка его содержимое отображается в области просмотра.

'''''- Редактирование шаблона'''''

- ''Название шаблона'' – можно изменить в соответствующем поле.
[[Файл:Сведение в единый.png|мини|''Рис. 18. Шаблон сведения ответа в единый'']]
- ''Текст шаблона'' – поддерживает параметры в квадратных скобках <code>[###Сопроводительный текст, если нужен{Параметр}]</code>, которые являются необязательными. Квадратные скобки обозначают необязательный параметр, то есть его может не быть и система все равно отработает.

- ''Шаблон сведения ответа в единый'' (опционально) – используется в суммаризации для объединения нескольких частей в один результат. <blockquote>Например, разбили совещание на куски, сделали по кускам суммаризации, а потом нужно в один результат все свести ''(Рис. 18)''.</blockquote> - ''Параметры генерации:''

* max_tokens - ограничение максимального количества токенов, возвращаемых моделью в ответ на заданный запрос (prompt);
* top_k - параметр, определяющий количество наиболее вероятных токенов, которые модель учитывает при генерации текста. Чем ниже значение, тем более предсказуемым и повторяющимся будет ответ модели;
* top_p - параметр отвечает за динамический выбор словаря модели и является альтернативой настройке «температуры» ответа. Используется для уменьшения вероятности генерации неожиданных или нежелательных ответов;
* temperature - параметр влияет на детерминированность или случайность генерируемых ответов. При более низких значениях алгоритм предпочитает наиболее вероятные токены, что обеспечивает точность и краткость, идеально подходящие для фактических ответов. При повышении температуры выбор становится более случайным, что способствует разнообразию и творческим идеям, например, при создании стихов;
* repeat_penalty - количество повторений слов в ответе.

- ''Использовать данный шаблон по умолчанию'' – если активировать эту опцию, шаблон будет применяться автоматически в зависимости от типа (например, в QAS для запросов к документам или в SPR для суммаризации).

'''2. Добавление нового шаблона'''

1. Нажмите кнопку '''«Добавить»''' внизу вкладки.

2. Заполните поля:

- ''Название шаблона''

- ''Тип шаблона'' (выберите из выпадающего списка)

- ''Текст шаблона'' (обязательное поле)

- ''Параметры генерации''

3. Нажмите '''«Добавить»''' для сохранения.

'''3. Редактирование и удаление шаблонов'''

- Чтобы изменить шаблон, откройте его, внесите правки и нажмите '''«Сохранить».'''

- Для удаления выберите шаблон и нажмите '''«Удалить»'''. <blockquote>'''Примечание:''' Не забывайте сохранять изменения после редактирования шаблонов.</blockquote>
[[Файл:2025-07-04 17-05-52.png|мини|''Рис. 19. Рабочая область вкладки «Интерактив».'']]

==== Вкладка «Интерактив» ====

Вкладка '''«Интерактив»''' включает в себя три режима:

# режим протоколирования,
# чат,
# очистка текста.
[[Файл:Шаблон.png|мини|''Рис.20. Блок редактирования и просмотра шаблона'']]Чтобы '''переключиться между режимами''', просто нажмите на соответствующие иконки на панели управления. Активный режим выделяется красным контуром вокруг иконки.

'''Режим протоколирования''' [[Файл:Remove-bg.ai 1741353006272.png|безрамки|20x20пкс]] служит для создания протоколов — кратких резюме — на основе стенограмм. Она обладает двумя ключевыми функциями: позволяет создавать шаблоны для протоколов и создавать протоколы.
[[Файл:2025-07-04 17-06-57.png|мини|''Рис. 21. Форма для загрузки файла для протоколирования.'']]
[[Файл:2025-05-21 15-23-39.png|мини|''Рис. 22. Интерфейс вкладки Интерактив в режиме Чат'']]
Слева располагается список всех шаблонов, где вы можете найти подходящий или создать новый. Для добавления нового шаблона необходимо нажать на кнопку '''«Добавить шаблон»''' и заполнить все необходимые поля в появившемся окне: '''указать название шаблона''', а также '''наименования разделов''' и '''описать их содержание'''.
В центральной части экрана, вы можете редактировать шаблон. Здесь вы можете внести изменения и сохранить их, либо удалить, нажав соответствующие кнопки внизу блока (см. рис. 20).

В нижней части экрана вы найдете форму для отправки файла на протоколирование (см. рис. 21). Для загрузки файла воспользуйтесь кнопкой '''«Выберите файл»'''. Справа от поля выбора файла располагается значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении на которую всплывает подсказка с поддерживаемыми типами файлов.

'''[[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|Шаблон запроса к LLM]]''' стоит по умолчанию, в выпадающем списке для этого функционала доступны только шаблоны типа "Суммаризация текста". Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Затем выберите одну из опций использования '''Шаблона протокола''': '''"Использовать"''' или с '''"Не использовать"'''. Справа будет отображаться сгенерированный протокол, его можно будет выгрузить в формате docx или txt (см. раздел. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Интерактив»|Панель управления вкладки «Интерактив»]]). В рабочей области так же есть информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.

'''В режиме «Чат»''' [[Файл:Чат (1).png|безрамки|20x20пкс]] можно в свободной форме пообщаться с LLM-моделью. Есть возможность обращаться к нескольким моделям. Рабочая область показана на рисунке 22. Слева на рисунке есть блок с выбором LLM-модели, "Шаблон запроса к LLM" типа "Чат" и опция «Глубина истории сообщений», которая варьируется в диапазоне [3, 10]. История сообщений в чате сохраняется с ориентиром на глубину.

Функция '''«Размышление*»''' модели

Помимо основного ответа, большая языковая модель предоставляет возможность просмотреть логику своих рассуждений. Эта информация отображается в раскрывающемся блоке «Размышление».

* Назначение: Позволяет понять ход мыслей модели, который привел к конечному ответу.
* Практическое применение: Анализ «Размышления» помогает при необходимости скорректировать исходный запрос (промпт) для получения более точного результата.

*доступна только для больших «думающих» моделей.<blockquote>Внимание: варианты моделей появляются в интерфейсе после того, как администраторы их добавят. </blockquote>
В центре экрана расположен сам чат. Внизу области расположено окно, в которое можно ввести свой запрос и отправить его по клику на кнопку «Отправить» [[Файл:Отправить.png|безрамки|20x20пкс]] . Очистить историю можно воспользовавшись одноименной кнопкой [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]]. Справа от чата блок с «Поиском ответов», подробнее о нем и его параметрах можно прочитать [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].
[[Файл:2025-05-28 16-48-05.png|мини|''Рис. 23 Интерфейс вкладки Интерактив в режиме Очистка чата'']]

'''Режим «Очистка текста»''' [[Файл:Photo 2025-05-21 12-43-53.jpg|безрамки|20x20пкс]] этот инструмент помогает убрать из текста лишнее и сделать его более читабельным. Чтобы воспользоваться функцией, вставьте текст в поле «Чистка текста» (в центре рабочей области) и нажмите кнопку «Очистить». После завершения процесса справа от исходного текста появится очищенный вариант (рис. 23). В него нельзя вносить изменения, но можно скопировать с помощью клавиш Ctrl+C или экспортировать в виде документа [[Файл:Сохранить doc (1).png|безрамки|20x20пкс]] docx или txt на выбор.

===== Панель управления вкладки «Интерактив» =====
{| class="wikitable"
|+
!'''Иконка кнопки'''
!'''Название кнопки'''
!'''Описание'''
|-
|[[Файл:Remove-bg.ai 1741353006272.png|центр|безрамки|40x40пкс]]
|Протоколирование
|Режим протоколирования позволяет создавать протокол на основе стенограмм. Когда режим активен, вокруг появляется красный фон.
|-
|[[Файл:Чат (1).png|центр|безрамки|40x40пкс]]
|Чат
|Режим чата позволяет свободно общаться с LLM-моделью на любые темы. Когда вокруг кнопки появляется красный фон, режим активируется.
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать как документ
|Позволяет экспортировать документ протокола в одном из форматов docx или txt для режимов: протоколирование и очистка текста.
|-
|[[Файл:Меню пользователя new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Совместная работа ===

В QAS допускается работать нескольким пользователям, если они работают в разных категориях.

=== Методика работы с QAS ===

Чтобы начать пользоваться сервисом ответов на вопросы, вам нужно загрузить документацию, ответы на которую вы будете давать пользователям. Определить категорию этих документов. Напоминаем, что файл должен быть максимально ёмким, подробным и кратким подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Добавление файла в список|раздел Добавление файла в список]]. Если в документе используются аббревиатуры или слова с неофициальными ("народными") вариантами написания/произношения, например, «материнский капитал» (маткапитал, маткап и так далее), их следует включить в глоссарий. Глоссарий можно найти в разделе [[QAS. UPS руководство по работе с интерфейсом#Функционал меню «Дополнительно»|«Дополнительно»]] на вкладке «Документы» под текстом документа.

===== <big>Добавление вопросов</big> =====
Если у вас нет готовых вопросов по документации есть два варианта:

# добавлять вопросы и их формулировки вручную,
# запустить генерацию вопросов по документации (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|Панель управления вкладки Документы]]).

После того, как генерация вопросов завершится, необходимо пройти на вкладку Вопросы и проверить вопросы на соответствие документации и адекватность.

Если у вас есть csv файл с фразами-вопросами, то есть возможность загрузить их массово, воспользовавшись кнопкой «Массовая обработка вопросов» на панели управления вкладки Вопросы (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После этого нужно скомпоновать по смыслу вопросы и почистить ненужные.

===== <big>Добавление ответов</big> =====
После того как вопросы будут загружены в базу вопросов QAS. Можно запустить генерацию ответов (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После ее завершения нужно проверить правильность и соответствие ответов вопросу, если ответ вас устраивает — поставьте галочку «Проверено». Либо отредактируйте ответ и так же отметьте его проверенным. Так же можно самостоятельно добавить ответы на вопроса из документации. А так же есть возможность запустить перефразирование уже проверенных ответов, что поможет немного расширить вариации ответов.

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

''Пример корректного ответа и нет:''
{| class="wikitable"
|+
!'''Вопрос'''
!'''Ответ, который потенциально приведет к ошибке'''
!'''Ответ, который НЕ приведет к ошибке'''
|-
|Реабилитационный сертификат
|'''По данному вопросу''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|По вопросу '''оформления реабилитационного сертификата''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|}

===== <big>Работа с кэшем вопросов</big> =====
После того как вы создадите базу вопросов и ответов, можно приступить к проверке работы кэша. В разделе «Кэш» вы найдёте блок для поиска ответа. В поле «Текст» введите свой вопрос, который может быть похож на уже существующие и на которые может ответить ваша загруженная документация. Установите необходимые настройки поиска, подробности можно найти [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].

Далее возможны различные варианты развития событий:

* Если ''вопрос не похож'' ни на один из уже имеющихся в базе данных, и активирован флаг «Использовать генерацию», система сгенерирует ответ на основе документации (если в ней есть ответ на этот вопрос). А сам вопрос будет добавлен в список основных (при условии, что активна галка «кэширование формулировки»). Если функция генерации отключена, в ответ на вопрос будет указано «Информация не найдена». Сам вопрос будет отображаться в общем списке вопросов как основной, для работы с ним и с подобными нужно отфильтровать по «Пустым ответам».
* Если система ''обнаружит сходство с каким-либо вопросом из базы данных'', новый вопрос будет добавлен в список кандидатов к этому вопросу. Если кандидат попадет в верный вопрос его нужно будет утвердить (перенести в формулировки). Вы сможете найти его местоположение, перейдя в режим «Утверждение кандидатов» и отфильтровав одноименную колонку с помощью формулировки вашего запроса в поле «вопрос». Подробности о работе с кандидатами [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|тут]]'''<big>.</big>'''
* Если в базе данных уже ''есть похожий запрос'', но ''система не может найти его'' и генерирует новый ответ на ваш запрос, то решить эту проблему можно, добавив ваш новый вопрос как основной запрос. Поскольку, если система не считает похожим ни на один вопрос, то лучше добавить его как отдельный вопрос со своим ответом.
* Склейки (несколько вопросов разделенные «|») попадают в QAS, но не оседают там, даже если включена галочка «кэширование формулировок».

===== <big>Запуск в прод</big> =====
При массовом обращении к системе, например, на проде удобнее всего с новыми запросами работать через отчет по [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|кандидатам]]. С его помощью можно увидеть, в какие категории и в какие вопросы поступают новые запросы, и сразу же внести изменения — поменять категорию или утвердить кандидатов. А также увидеть, каким запросам не присвоилась категория вообще.

Файл:2025-12-29 15-35-16.png

2025-12-29T12:36:25Z

E.Elagina:

параметры поиска документа

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

2025-12-24T10:13:20Z

E.Elagina: /* Поиск ответа */

=== Главное меню ===
[[Файл:QAS.png|мини|''Рис. 1 Главный экран UPS'']]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# QAS ЧаВО,
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]]
# Выход.
Переключаться между продуктами можно двумя способами:

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]] .
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).

Перейти в раздел '''«ЧаВО»''' (QAS) можно кликнув по соответствующей кнопке на главном экране UPS (см.рис. 1).

=== Описание интерфейса сервиса «ЧаВО» (QAS) ===
Рабочая область сервиса «ЧаВО» (QAS) (сервиса ответов на вопросы) включает в себя следующие блоки:
*панель управления;
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Документы»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Кэш»|«Кэш»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Интерактив»|«Интерактив»]];'''
*вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области;
*вкладка '''«Категории»''' содержит список всех созданных категорий, можно как редактировать уже существующие, так и добавлять новые. Есть фильтрация по названию. Доступен ''экспорт''[[Файл:2025-12-10 11-22-58 (1).png|безрамки|28x28пкс]] и ''импорт'' [[Файл:2025-12-10 11-23-23 (1).png|безрамки|30x30пкс]] категории, для переноса на другой сервер; А так же ''удаление'' категории.
<blockquote>'''ВНИМАНИЕ: удаление категории''' происходит '''со всеми документами и вопросами,''' система сообщит об этом.</blockquote><blockquote>'''Как работает импорт:'''
* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.

'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>

==== Вкладка «Документы» ====
[[Файл:Photo 2025-05-21 12-43-54.jpg|мини|''Рис. 2 Рабочая область сервиса «ЧаВО»'']]Во вкладке «Документы» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 2):

* панель управления;
* блок со списком документов содержит поиск по названию и фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Спрятать боковую панель''' между списком документов и блоком для редактирования (появляется при наведении мыши на середину между блоками);
* добавление нового документа в базу;
[[Файл:Photo 2025-05-21 12-43-54 (2).jpg|мини|''Рис. 3 Пример отработки кнопки «Очистить текст»'']]
*блок '''«Редактирование документа»''' с полями: «Название», «Дополнительно» и текстом выбранного файла, который можно редактировать. Можно переименовывать файл, после чего нужно сохранить изменения. Кнопка сохранения становится активной как только будут внесены изменения. Чтобы сделать текст более читабельным, его можно очистить от лишнего. Для этого нажмите кнопку '''«Очистить текст»''', которая находится под основным блоком слева от '''«Сохранить»''', предварительно выбрав шаблон запроса, если требуется. Или воспользуйтесь кнопкой на [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|панели управления]] [[Файл:2025-10-08 15-19-11 (1).png|безрамки|20x20пкс]].
<blockquote>'''Важно:''' при уже запущенном процессе очистки кнопка остановит текущий процесс отчистки.</blockquote>После завершения очистки справа появится окно с изменениями. Кнопка, открывающая данные по очистке позволяет просмотреть так же:

* Прогресс выполнения (%)
* Позицию в очереди (правило '''«один аккаунт — одна операция очистки»''')
* Результаты обработки. Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''

Вы сможете сравнить исходный и очищенный текст. Если нужно внести правки, их можно сделать прямо в блоке с очищенным документом. После проверки и внесения правок, если все устраивает, нажмите '''«Заменить в документе»''' под блоком с очищенным текстом. Изменения вступят в силу. ''Не забудьте сохранить документ.'' Рядом с этой кнопкой есть '''«Закрыть»'''. Она закрывает окно с очищенным текстом без сохранения изменений.
<blockquote>Для очистки текста, ''который не загружен в базу данных'' QAS, используйте режим «Очистка текста» на вкладке «Интерактивный режим».</blockquote>
*блок поиска фрагментов по базе.

[[Файл:2025-10-08 15-24-58.png|мини|''Рис.4. Добавление нового файла'']]

===== Добавление файла в список =====
В нижней части блока со списком файлов есть кнопка '''«Добавить файл»'''. Если нажать на нее, то появится диалоговое окно, как показано на рисунке 4. Чтобы добавить файл, нужно заполнить все необходимые поля и выбрать нужный файл с компьютера, в кодировке '''Unicode UTF-8'''.

Поддерживаемые '''форматы''':

* .odt
* .docx
* .doc
* .rtf
* .ods
* .xlsx
* .xls
* .pdf
* .txt.

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

===== Функционал меню «Дополнительно» =====
[[Файл:2025-05-23 17-11-07.png|мини|''Рис. 5 Иллюстрация функций кнопки Дополнительно'']]
На вкладке дополнительно вы можете посмотреть:

* категорию к которой относиться документ,
* глоссарий, в котором укажите название объекта из документа (рис. 5), а также его синоним в соответствующих полях внизу страницы. Это поможет модели лучше понимать, о чём её спрашивают. Например, научить ее тому, что «госпошлина = пошлина», «загранник = загранпаспорту», «загранпаспорт = заграничному паспорту», а «загранпаспорт нового образца = загранпаспорту на 10 лет» и нажмите кнопку добавить.
<blockquote>Поиск в базе работает '''на основе векторного анализа текста'''. Чтобы система точнее находила нужные документы, важно выделить ключевые термины и создать глоссарий.

Как это сделать:

# Внимательно изучите документ.
# Выпишите основные термины и их возможные синонимы.
# Внесите их в глоссарий в формате: ''основной термин = синоним''.

Пример:

Если в документе слово ''«апостиль»'' иногда называют «''услугой»,'' укажите в глоссарий:

<code>апостиль = услуга</code>.</blockquote>Предусмотрено массовое удаление синонимов, для этого выделите нужное галочками. Кликнув на поле с фразами вы можете отредактировать формулировку. После внесения изменений нажмите кнопку '''«Сохранить»'''. Она станет активной сразу же после того, как вы внесете какие-либо изменения в документ. Эта кнопка является дубликатом кнопки '''«Сохранить»''' в блоке редактирования документа.
* есть кнопка для экспорта глоссария, если это необходимо в формате .csv.
* а так же доступен импорт с тремя опциями: дополнить, заменить и отменить импорт.
* здесь же находится кнопка для удаления документа.

===== Поиск фрагментов в документах =====
Поиск фрагментов — это первый этап для ответа на вопрос. Система сначала ищет фрагмент (фрагменты) в документах, после отправляет их вместе с промптом на модель генерации.

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

===== Панель управления вкладки «Документы» =====
В верхней части экрана располагается панель управления, на которой находятся кнопки: ''генерация ответов, экспорт документов, очистка документа, массовая обработка вопросов, задать вопрос'' и ''меню пользователя.''
{| class="wikitable"
|+''Табл. 1 Описание функционала панели управления.''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать документ
|Позволяет экспортировать документ в одном из форматов .docx или .txt
|-
|[[Файл:2025-10-08 15-19-11 (1).png|центр|безрамки|40x40пкс]]
|Очистка документа
|При нажатии на кнопку открывается диалоговое окно, в котором необходимо:

# Выбрать модель генерации — укажите модель ИИ для обработки текста
# Выбрать шаблон очистки — определите параметры форматирования текста

<blockquote>'''Важно!''' Очистка будет применена к текущему активному документу.

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

Действует правило '''«один аккаунт — одна операция очистки».'''</blockquote>После запуска кнопка меняется на ''«Остановить очистку документа»,'' по нажатию на нее запущенная вами очистка завершается.

Посмотреть прогресс очистки можно нажав на кнопку ''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Очистка текста»]]'' под документом.

Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация вопросов
|эта кнопка предназначена для генерации вопросов. По нажатию на кнопку появляется диалоговое окно, в котором требуется выбрать:

* категорию вопросов для генерации;
* если не нужно генерировать вопросы для всех документов, выберите нужный,
* выберите канал,
* выберете модель генерации (по умолчанию используется default), другие модели будут отображаться в списке только после того, как администратор добавит их,
* выберите шаблон запроса к LLM (по умолчанию используется шаблон "из коробки" типа "Генератор вопросов по тексту"),
* запустите генерацию.
Генерация вопросов запускается ''для каждой'' категории ''отдельно''.
<blockquote>'''''Совет''': генерацию лучше запускать в нерабочее время, так как она может занять много времени.'' Для удобства отслеживания на иконке отображается прогресс генерации.</blockquote>Есть возможность включить или отключить опцию ''генерации ответов'' сразу для документа. Для случаев, когда добавился новый документ в категорию и нет под него ВОП из «живых» фраз.

<blockquote>'''''Совет''''': если есть возможность использовать «живые» фразы людей, то всегда лучше брать их, а не генерировать синтетические вопросы.</blockquote>
|-
|[[Файл:2024-07-08 22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка документов
|позволяет сделать массовую замену текста в документах. В диалоговом окне нужно выбрать категорию, искомый текст и текст замены.
|-
|[[Файл:Задать_вопрос_нов.png|центр|безрамки|40x40пкс]]
|Задать вопрос1
|генерирует ответ на вопрос на основе информации, содержащейся в одном или нескольких документах.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы, шаблоны)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:Ask.png|мини|Рис. 6 Блок «Задать вопрос»|589x589пкс]]
1 По нажатию на кнопку '''«Задать вопрос»''' (рис. 6), появляется диалоговое окно с полями:

'''«Вопрос»''' — это область для ввода вопроса.

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

'''«Канал»''' - список созданных каналов связей.

'''«Модель генерации»''' - список доступных моделей

'''«Шаблон запроса к LLM»''' - шаблон запроса (промпт) к модели генерации.

'''«Использовать кэш ответов»''' - в этом меню можно выбрать, использовать ли только проверенные ответы или любые.

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

===== Добавление новых и редактирование вопросов =====

''Вопросы в QAS могут быть трех видов:''

'''Кандидаты''' — это новые запросы к системе, которые, по мнению самой системы, являются семантически близкими к основному вопросу и его формулировкам. Чтобы перевести кандидата в формулировки, нужно ''утвердить'' их (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|разд. Режим работы "Утверждение кандидатов"]])

'''Формулировки (алиасы)''' — это различные варианты одного и того же вопроса. Этот список станет основой для системы при поступлении новых запросов. Она будет использовать его, чтобы определить, в кандидаты к какому основному вопросу стоит отнести новый.

'''Основной вопрос''' — это новый вопрос, который ранее не существовал в базе данных QAS, а также не имел семантически близких аналогов. Каждому основному вопросу присваивается категория. Он может включать дополнительные формулировки и кандидатов.

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

* категорию вопроса;

* текст вопроса.

Чтобы ''отредактировать'' уже существующий вопрос, нужно выбрать его из списка. После этого его текст и ответы появятся в блоке для редактирования, который находится в середине страницы. Если вопрос слишком длинный и не помещается в одну строку, просто нажмите на него, и он будет развёрнут. [[Файл:2024-10-14 15-55-53.png|мини|''Рис. 8 Интерфейс вкладки «Дополнительно»'']]

Меню '''«Дополнительно»''' включает в себя следующие опции:

- изменение формулировки основного вопроса,

- изменение категории вопроса (перенос в другую категорию) осуществляется путём выбора из списка доступных категорий, расположенного в верхней части окна (рис. 8). Вопрос будет перенесен без потерь со всеми ответами, кандидатами и формулировками.

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

Поэтому мы создаём короткие вопросы, помечаем их как «неполные» и добавляем уточняющие вопросы в ответ. Например: «Уточните, пожалуйста, что именно вы хотите узнать по поводу детского сада?» Получив такой вопрос, абонент должен будет уточнить свои потребности, а затем робот объединит оба запроса и выдаст ответ, если он есть в базе данных QAS.</blockquote>- добавление, удаление или перенос. Чтобы удалить формулировку, необходимо навести курсор на нужную фразу. После этого справа появятся две кнопки (см. рис. 8). Одна из них в виде ''стрелочки'' предназначена для того, чтобы сделать эту формулировку ''основным вопросом''. А кнопка в виде ''корзинки'' позволяет удалить выбранную фразу. Есть возможность удалять несколько формулировок, для этого нужно выбрать формулировки для удаления и нажать на кнопку ''Удалить,'' рядом с кнопкой ''Переместить.'' <blockquote>При удалении основного вопроса на вкладке ''Дополнительно'', сначала нужно переназначить основным вопросом другую формулировку и после этого удалить. </blockquote>- есть возможность переместить формулировки и/или кандидатов в другой вопрос. Для этого поставьте галочку напротив нужной фразы и нажмите кнопку «Переместить». В появившемся диалоговом окне выберите нужный вопрос (вы можете предварительно отфильтровать вопросы по категориям). Выберите, из выпадающего списка куда следует переместить выбранные вопросы: в формулировки или в список кандидатов, — и нажмите кнопку «Переместить». После этого '''обязательно''' сохраните изменения в текущем вопросе. <blockquote>'''Обращаем ваше внимание,''' что если вы указываете, что перемещение должно быть выполнено в кандидаты, то вам необходимо будет затем перейти и ''утвердить'' кандидата.</blockquote>- так же вы можете ознакомиться со списком ''кандидатов'', который включает формулировки, близкие по смыслу к основному вопросу. Если среди них есть подходящие варианты, отметьте их галочкой и нажмите кнопку «Утвердить». После этого выбранные формулировки появятся в общем списке «Формулировки». ''Добавление большого количества разных формулировок необходимо, чтобы модель могла понимать суть вопроса, независимо от того, как его сформулирует человек, и выдавать один и тот же ответ на разные варианты этого вопроса.''

- ''удаление'' вопроса из базы на вкладке «Дополнительно» внизу будет кнопка ''Удалить вопрос полностью''.

'''Внимание:''' ''Нажимая на кнопку '''Удалить вопрос полностью''' в меню Дополнительно, вы удаляете весь вопрос, включая формулировки, ответы на него из всех каналов и всех кандидатов.''

- после того как вы внесете изменения, кнопка «Сохранить» станет активной в меню «Дополнительно» и на панели для редактирования ответов.

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

Каждый вопрос сопровождается флажком '''«Проверено»''', который отмечает ответы, проверенные пользователем. При наведении курсора мыши на ответ, вместо канала к которому принадлежит вопрос, появляются кнопки:

* копировать в канал, с ее помощью можно продублировать ответ для любого доступного канала;
* переместить в канал, перемещает ответ с текущего канала на другой выбранный пользователем канал;
* удалить ответ.
Также вы можете добавить новый вопрос в список, воспользовавшись функцией поиска ответа на вкладке '''«Кэш»''' с включенным флажком '''«Использовать генерацию»''' или задав новый вопрос по документам на вкладке '''«Документы»,''' так же выбрав опцию '''«Использовать генерацию»'''. Если похожего вопроса раньше не было, то он появится в списке на вкладке «Вопросы». Вы сможете редактировать и изменять его по своему усмотрению. В случае, если похожий вопрос уже встречался, система предложит его как кандидата к похожему вопросу. Это значит, что его нужно будет перенести в формулировки (утвердить) и сохранить изменения.

===== Поиск по вопросам и ответам. Фильтрация =====
[[Файл:2024-08-06 16-23-15.png|мини|''Рис. 9 Иллюстрация поиска по вопросам'']]
В разделе '''«Кэш»''' есть три вида поиска:

# поиск по вопросам и их формулировкам, в том числе и кандидатам;
# поиск по ответам.
# поиск по категории

А так же два вида фильтрации:

# по содержанию ответов: ''Все'', ''Проверенные'', ''Непроверенные'', ''Пустые.''
# по полноте вопроса: ''Все, Полный, Неполный.'' К полным вопросам относятся вопросы с конкретикой. К неполным - короткие вопросы без конкретики.

[[Файл:2024-08-06 16-38-29.png|мини|''Рис. 10 Иллюстрация поиска по ответам'']]С помощью '''поиска по вопросам и их формулировкам''' можно найти все вопросы или вопросы в определённой категории, которые содержат определённое слово или фразу в своей формулировке. Поиск работает как для основного вопроса, так и для дополнительных формулировок. <blockquote>Например, на рисунке 9 в категории «Водительские права» мы ищем все вопросы, в которых есть сочетание букв «''замена''». Если открыть меню, внизу экрана, ''«Дополнительно»'', то можно увидеть, что это сочетание используется в альтернативных формулировках вопроса, найденные сочетания подсвечиваются. </blockquote>Обращаем внимание, что если в основном вопросе нет искомого слова или сочетания букв, то система все равно выведет вопрос, если найдет совпадения в альтернативных формулировках. [[Файл:2024-08-06 16-24-00.png|мини|''Рис. 11 Результат работы двух видов поиска одновременно'']]
Предусмотрен ''поиск по ответам'', в поле '''«Ответ»''' можно ввести слово или фразу и система подсветит поля ответов, где искомое сочетание было найдено (рис. 10). По умолчанию канал связи стоит в положении «не выбран» и выводятся ''все'' ответы ''из всех каналов'', где найдено слово или фраза. Можно принудительно выбрать канал из списка, тогда отобразятся ответы выбранного канала и будут подсвечены те ответы, где найден искомый текст. Область ответа с искомым текстом будет подсвечена бледно-голубым (рис. 10). Можно одновременно использовать два вида поиска. В результате будут отображены вопросы, в которых присутствует искомое значение – как в вопросах, так и в ответах (рис. 11).

===== Поиск ответа =====
[[Файл:2025-07-04 15-31-58.png|мини|''Рис. 12 Интерфейс блока «Поиск ответов»'']]
Блок '''«Поиск ответа»''' (рис. 12) работает так же, как кнопка '''«Задать вопрос»''' на вкладке '''«Документы»'''. <blockquote>Важно отметить, что поиск ответа происходит в два этапа:

# поиск нужных фрагментов из документов в категории,
# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.
</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов. <blockquote>Для запуска поиска есть горячие клавиши Ctrl+Enter или по кнопке Получить ответ. </blockquote>В выпадающем списке '''«Модель генерации»''' вы можете выбрать модель, которая будет создавать итоговый ответ. Чтобы в списке появились дополнительные модели, кроме стандартной, администратор должен их добавить. После этого они появятся в списке, и вы сможете использовать их вместо стандартной модели.

'''«Шаблон запроса к LLM»:''' здесь вы можете выбрать, какой промпт отправить на генеративную модель вместе с найденными фрагментами и вопросом. Если промпт не выбран, LLM будет использовать стандартный запрос. Подробнее о шаблонах запросов [[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|тут]]. <blockquote>'''Для чего это нужно?'''

Если стандартный промпт не работает так, как нужно для конкретной категории, или требуется что-то особенное, можно создать новый шаблон. Это делается без изменения стандартного промпта. </blockquote>Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Меню '''«Использовать кэш»'''. В этом меню можно выбрать, использовать ли только проверенные ответы или любые. Кэш-память позволяет сервису быстрее отвечать на запросы пользователей. А опция '''«Только проверенные ответы»''' гарантирует, что ответы, которые получает пользователь, были отредактированы и проверены оператором.

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

Аналогично вкладке «Документы», вы можете настроить '''количество документов''', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.

===== Функционал режима «Проверка новых вопросов» =====
Режим «Проверка новых вопросов» содержит перечень всех новых вопросов. В рабочей области находится таблица, в которой представлен список новых вопросов, ответы на них, категория, присвоенная этим вопросам, а также дата создания вопроса. Есть возможность фильтрации по каждой из колонок (рис. 13).
[[Файл:New questions mode.png|мини|''Рис.13. Интерфейс режима утверждения новых вопросов'']]
При наведении на любую строку слева появляются иконка и чекбокс:
# [[Файл:Circle-check-solid.png|безрамки|22x22пкс]] Утвердить — позволяет утвердить ответ на текущий вопрос. Это означает, что ответ и категория соответствует вопросу. После утверждения вопрос пропадет из таблицы и получит статус '''«Проверено».'''
# [[Файл:Checkbox.png|безрамки|25x25пкс]] Чекбокс — позволяет выбрать несколько позиций таблицы для утверждения или удаления. Утверждение означает, что у всех выбранных позиций ответ и категория соответствует вопросу. Для утверждения всех выбранных позиций необходимо нажать кнопку «Утвердить», внизу таблицы, в правом нижнем углу. Для удаления — на значок ''корзинки'' (п. 5 списка ниже), так же в нижнем углу.
В «подвале» таблицы расположены следующие функциональные элементы:

# [[Файл:Expand.png|безрамки|20x20пкс]] Развернуть — разворачивает таблицу и входит в полноэкранный режим.
# [[Файл:Compress.png|безрамки|23x23пкс]] Свернуть — выходит из полноэкранного режима и возвращает таблицу в исходное состояние.
# [[Файл:Approve changes mode.png|безрамки|187x187пкс]] — позволяет переключаться между состояниями режима '''«Подтверждения изменений».''' При включенном режиме при каждом массовом утверждении ответов на вопросы будет появляться диалоговое окно, которое будет запрашивать подтверждение текущих изменений.
# Кнопка '''«Утвердить»''' — позволяет утвердить все выбранные на данный момент ответы на вопросы. Кнопка не активна, пока не выбрана ни одна позиция в таблице.
# [[Файл:Delete icon.png|безрамки|22x22пкс]] — позволяет удалить все выбранные на данный момент ответы на вопросы. При включенном режиме '''«Подтверждения изменений»''' при удалении запросит подтверждение в диалоговом окне.
[[Файл:New questions mode changed.png|мини|''Рис.13.1. Работа в режиме утверждения новых вопросов'']]Данный режим позволяет как точено, так и массово проверять ответы и категорию на соответствие вопросу.
В таблице реализована возможность самостоятельной правки вопросов/ответов/категорий. Для этого надо кликнуть на интересующую вас ячейку и внести правки. Сразу после изменений в верхней правой части ячейки появится иконка для отката изменений [[Файл:Undo.png|безрамки|24x24пкс]] на '''начальное''' состояние. Если в строке произошли какие-то изменения, то ''строка автоматически переходит в состояние выбранной'' (рис. 13.1).

В таблице реализована клавиатурная доступность, которая позволяет перемещаться между ячейками и утверждать выбранные позиции в таблице. Для этого используются следующие комбинации клавиш: Ctrl + ⬆/⬇/⬅/➡/Enter.

===== Функционал режима «Утверждение кандидатов» =====
[[Файл:Рис. 13 Интерфейс режима Утверждения кандидатов.png|мини|''Рис. 14. Интерфейс режима Утверждения кандидатов'']]
Режим «Утверждение кандидатов» содержит перечень всех кандидатов. В рабочей области находится таблица, в которой представлен список кандидатов, перечень основных вопросов, где эти кандидаты находятся, а также категория, присвоенная этим вопросам (рис. 14).

При наведении на любую строку слева появляются две иконки:
# [[Файл:Сделать основным без фона.png|безрамки|26x26px]] Сделать основным — позволяет сделать кандидата основным вопросом. По нажатию на эту кнопку появляется диалоговое окно, где требуется подтвердить намерение сделать кандидата основным вопросом. В форме подтверждения нужно выбрать категорию, в которую хотели бы добавить вопрос и аналогично функционалу добавить новый вопрос (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|Добавление новых и редактирование вопросов]]).
# [[Файл:Утвердить.png|безрамки|26x26px]] Утвердить — позволяет утвердить кандидата, в текущем вопросе, включая её в формулировку вопроса. Это означает, что кандидат подходит по смыслу к основному вопросу и его формулировкам.[[Файл:Рис 14. Работа в режиме Утверждение кандидатов.jpg|мини|''Рис.14.1. Работа в режиме Утверждение кандидатов'']]

Чтобы утвердить сразу несколько кандидатов, отметьте их галочками. После этого внизу появится строка с выпадающим списком всех основных вопросов из базы данных QAS.

По умолчанию система предлагает утвердить выбранного кандидата или кандидатов в текущем вопросе. Однако если вы хотите перенести его в другой вопрос, просто начните вводить его название в поле поиска. Затем нажмите кнопку «Утвердить», расположенную в правом нижнем углу (рис. 14.1).

Если вы хотите ''удалить'' кандидата или кандидатов, выделите их и нажмите на иконку «Корзинка», которая находится над кнопкой «Утвердить».

===== Функционал режима «Поиск несоответствий» =====

Режим "Поиска несоответствий кэша ответов и документов" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Несоответствия"''''' и '''''"Ошибки"''.''' Чтобы запустить поиск несоответствий, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

[[Файл:Поиск несоответствий 1.png|мини|''Рис.15. Работа в режиме Поиска несоответствий. Вкладка несоответствий'']]
При активном табе '''"Несоответствия"''' показана таблица результатов поиска для работы с найденными ответами из кэша, которые не соответствуют фрагменту документа (рис.15). Таблица разделена на 4 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''фрагмент из документа'', по которому был дан текущий ответ,
* ''исправленный ответ'', на который предлагается заменить текущий.

Проанализировав предложенные ответы в столбце ''"Исправленный ответ"'', можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены предложенных ответов на ответы из кэша необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

[[Файл:Поиск несоответствий 2.png|мини|''Рис.15.1. Работа в режиме Поиска несоответствий. Вкладка Ошибок'']]
При активном табе '''"Ошибки"''' показана таблица результатов поиска для работы с найденными ответами из кэша, по которым были выявлены ошибки, например, отсутствие информации (рис.15.1). Таблица разделена на 3 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''ошибка'' поиска''.''

Здесь можно скорректировать ответ из кэша, при необходимости (в ячейке таблицы), или удалить запись (строку). Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены исправленных ответов необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

===== Функционал режима «Векторный поиск» =====
[[Файл:Векторный поиск.png|мини|''Рис.16. Работа в режиме Векторного поиска'']]
Режим "Векторного поиска" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Документы"''''' и '''''"Ответы"''''' (рис.16). Он предназначен для поиска и замены ответов и фраз в документах, векторно похожих на текст запроса. Чтобы запустить векторный поиск, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

После окончания поиска будет отображена таблица, которая разделена на 3 столбца:
* ''документ / вопрос'' (в зависимости от выбранного таба),
* ''фраза / ответ'' (в зависимости от выбранного таба),
* ''сходство'', в процентах.
Проанализировав найденные фразы/ответы, можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].
[[Файл:Векторный поиск 2.png|мини|''Рис.16.1. Замена информации в режиме векторного поиска'']]

Затем слева от таблицы заполняем форму для того, чтобы модель генерации предложила варианты замены информации (фразы или ответа). Для этого заполняем недостающие поля: ''Текст замены'' и опционально ''Модель генерации'' (по умолчанию default) и ''Шаблон запроса к LLM'' типа "Векторная замена информации". После нажатия на кнопку ''"Показать варианты замены"'' запустится процесс подготовки предложений по замене информации: появится четвертый столбец ''"Измененная фраза" / "Измененный ответ"'' и в ней по очереди построчно будут заполнятся фразы/ответы (рис. 16.1).

После окончания обработки можно отредактировать или удалить предложенные варианты замены, выделить нужные и нажать внизу таблицы кнопку ''"Заменить фразы"'' / ''"Заменить ответы"'' для замены фраз в документе/ответов соответственно.

===== Панель управления вкладки «Кэш» =====
{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления вкладки «Кэш»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:2024-07-08_22-41-00_(1).png|центр|безрамки|40x40пкс]]
|Выбрать вопросы
|При нажатии на эту кнопку активируется режим, в котором можно выбрать несколько вопросов из списка для последующего перемещения или удаления. Сама кнопка подсвечивается красным контуром, показывая, что она активна. Нажав на неё повторно, можно выключить режим и сбросить выбор. После того как вы отметили галочками вопросы, справа от кнопки появляется опции «Переместить вопросы» [[Файл:Копировать.png|безрамки|20x20px]] и «Удалить выбранные вопросы»[[Файл:2024-07-08 22-55-51-no-bg-preview (carve.photos).png|безрамки|20x20px]].
Если вы собираетесь переместить вопросы, но в них уже есть проверенные ответы или кандидаты, в диалоговом окне появится соответствующее предупреждение. При этом перемещаться они не будут. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-35.png|центр|безрамки|40x40пкс]]
|Экспорт вопросов
|Эта кнопка позволяет экспортировать вопросы в формате CSV для классификатора или для отчета.
Структура файла для классификатора выглядит следующим образом: ''Категория'' ⇥ ''Вопрос.''
Структура файла отчетности: ''Категория⇥ Вопрос⇥ Обозначение вопроса(основной/алиас/кандидат).'' Эта кнопка доступна только в режиме '''«Подробный».'''
|-
|[[Файл:Автосохранение_(1).png|центр|безрамки|40x40пкс]]
|Автосохранение
|Позволяет включить автосохранение. При включенном (вокруг кнопки появляется красный контур) режиме будет сохраняться через 10 секунд после изменения данных. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Обновить_данные_вопроса.png|центр|безрамки|40x40пкс]]
|Обновить данные вопроса
|С помощью этой кнопки можно обновить данные текущего вопроса, например, после генерации ответов. По нажатию на кнопку обновятся все ответы, которые система сгенерировала на этот вопрос. Генерация ответов происходит для разных каналов связи. Вы можете просмотреть их, выбрав нужный канал в меню рядом с основным вопросом. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация ответов
|эта кнопка предназначена для генерации ответов. По нажатию на кнопку появляется диалоговое окно, в котором требуется:

* ввести желаемое количество ''ответов'',
* выбрать ''категорию'', для которой требуется генерация,
* выбрать ''канал'',
* выбрать ''режим генерации'': по документам или перефразирование проверенных,
* указать, для каких вопросов нужно сгенерировать ответы: для всех или только для пустых,
* далее выбрать, следует ли заменить существующие ответы. Если «да», то ответы будут заменены на новые. Если «нет», то они будут дополнены новыми вариантами,
* указать модель генерации (по умолчанию используется default). Другие модели будут отображаться в списке только после того, как администратор добавит их,
* и наконец, указать ''количество документов [1,10]'', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.
* и нажать на кнопку «Запуск».

Генерация может занимать достаточно продолжительное время. Помимо канала по умолчанию, ответы генерируются и для других каналов, после окончания обновите данные вопроса и просмотрите все существующие каналы.<blockquote>'''''Совет:''''' ''лучше использовать сначала режим генерации ответов по документам, после чего проверить их правильность и запускать генерацию в режиме перефразирования ответов. Также перед тем, как сгенерировать ответы, обновите страницу.'' </blockquote>Убедитесь, что предыдущая генерация ответов закончена, иначе кнопка не сработает, и вам нужно будет либо остановить предыдущую генерацию, либо подождать, пока она завершится. Для удобства отслеживания на иконке отображается прогресс генерации. Иконка выглядит так [[Файл:Иконка генерации.png|безрамки|20x20px]], если генерация запущена. При наведении на нее она меняется на ''Остановить генерацию ответов'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить генерацию. Все ответы, которые успели сгенерироваться, останутся. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка вопросов
|Нажав на кнопку, появится меню с двумя разделами: '''«Загрузка»''' и '''«Замена».'''
''Функционал раздела '''«Замена».'''''

Этот раздел позволяет заменить определенный текст в ответах на вопросы. Для этого необходимо заполнить следующие поля:

* категория
* искомый текст в ответах
* замена
* и нажать запуск.
''Функционал раздела '''«Загрузка».'''''Этот раздел предназначен для обработки множества вопросов (в режиме '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]) или пар вопрос-ответ (в '''JSON'''-режиме [[Файл:JSON.png|безрамки|80x80пкс]]).

Режим '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]'''.'''

Для массовой обработки вопросов в режиме Текст требуется выбрать:

* файл с вопросами в формате .csv,
* выбрать категорию, к которой относятся вопросы из файла,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Любые ответы'',
* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и если не активирован флаг «Использовать генерацию», функция работать не будет). Другие модели будут отображаться в списке только после того, как администратор добавит их.
* а также активировать только флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]''). Можно активировать остальные флаги для случаев, когда нужно помимо обработки нужно ''еще и сгенерировать ответы.''
* а так же активировать опцию «Установить порог похожести,%». Если вы активируете её, то сможете выбрать значение по умолчанию — 90% или задать своё собственное.<blockquote>'''Важно:''' в файле могут быть вопросы '''только''' по одной тематике.</blockquote>Обработка вопросов осуществляется по следующей схеме: каждый новый вопрос сравнивается с предыдущими (и формулировками). Если обнаруживается вопрос, который кажется схожим по смыслу, то новый вопрос включается в список его возможных кандидатов. Если же не находится вопроса, который имеет семантическую близость с новым, то новый становится основным.<blockquote>'''''Совет:''' д''ля массовой обработки вопросов без генерации ответов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Любые ответы».</blockquote>Режим '''JSON'''[[Файл:JSON.png|безрамки|80x80пкс]].

Чтобы массово обрабатывать пары вопрос-ответ, переключитесь в режим JSON и заполните следующие поля:

* файл с вопросами в формате .json.

<blockquote>Формат json-файла для загрузки в интерфейс:

[

[ "вопрос2", "ответ 2" ],

[ "вопрос1", "ответ 1" ]

]</blockquote>

* выбрать категорию, к которой относятся пары вопрос-ответ в файле,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Не использовать'',
* оставьте параметр «Количество документов» в значении по умолчанию — 1.
* автоматически ставится флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]'').
* порог схожести и устанавливается на 98% без возможности редактирования.

Этот функционал позволяет создать основную базу. После того как пары вопросов и ответов будут добавлены, можно будет [https://wiki.connect2ai.net/index.php#Добавление_новых_и_редактирование_вопросов добавлять формулировки в вопросы]. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Лупа.png|центр|безрамки|50x50пкс]]
|Поиск несоответствий кэша ответов и документов / Векторный поиск
|Позволяет запустить поиск разного вида в зависимости от выбранного режима: '''«Поиск несоответствий»''' или '''«Векторный поиск»'''.

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

''1. "Вопрос по документации",''

''2.'' "Поиск несоответствий информации".

Поиск может занимать достаточно продолжительное время. Для удобства отслеживания на иконке отображается прогресс поиска. При наведении на нее она меняется на ''"Остановить поиск несоответствий кэша ответов и документов"'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить поиск.

В режиме '''«Векторный поиск»''' при нажатии на кнопку появляется форма для поиска фрагментов, векторно похожих на фразу запроса. Для запуска в ней нужно указать ''Текст'' запроса, ''Категорию'' поиска и ''Порог схожести''. Далее будет выведена таблица с данными поиска с разделением на документы и ответы.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

[[Файл:Шаблоны запросов.png|мини|''Рис. 17. Интерфейс вкладки Шаблоны запросов'']]

===== Функционал вкладки «Шаблоны запросов» =====

Данный раздел позволяет управлять шаблонами промптов: создавать, редактировать, удалять и настраивать их использование ''(Рис. 17)''.

'''1. Интерфейс вкладки'''

'''- ''Фильтрация по типу'''''

В верхней части окна слева расположен выпадающий список '''«Тип»''', позволяющий отфильтровать шаблоны по категориям:

- Чат

- Запрос к документу

- Очистка документа

- Генератор синонимичных фраз

- Перефразировка фрагмента текста

- Суммаризация текста

- Генератор вопросов по тексту

- Векторная замена информации

- Поиск несоответствий информации

Напротив каждого типа в скобках указано количество доступных шаблонов.

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

'''''- Список шаблонов'''''

Справа от списка типов отображаются шаблоны выбранной категории. При выборе шаблона из списка его содержимое отображается в области просмотра.

'''''- Редактирование шаблона'''''

- ''Название шаблона'' – можно изменить в соответствующем поле.
[[Файл:Сведение в единый.png|мини|''Рис. 18. Шаблон сведения ответа в единый'']]
- ''Текст шаблона'' – поддерживает параметры в квадратных скобках <code>[###Сопроводительный текст, если нужен{Параметр}]</code>, которые являются необязательными. Квадратные скобки обозначают необязательный параметр, то есть его может не быть и система все равно отработает.

- ''Шаблон сведения ответа в единый'' (опционально) – используется в суммаризации для объединения нескольких частей в один результат. <blockquote>Например, разбили совещание на куски, сделали по кускам суммаризации, а потом нужно в один результат все свести ''(Рис. 18)''.</blockquote> - ''Параметры генерации:''

* max_tokens - ограничение максимального количества токенов, возвращаемых моделью в ответ на заданный запрос (prompt);
* top_k - параметр, определяющий количество наиболее вероятных токенов, которые модель учитывает при генерации текста. Чем ниже значение, тем более предсказуемым и повторяющимся будет ответ модели;
* top_p - параметр отвечает за динамический выбор словаря модели и является альтернативой настройке «температуры» ответа. Используется для уменьшения вероятности генерации неожиданных или нежелательных ответов;
* temperature - параметр влияет на детерминированность или случайность генерируемых ответов. При более низких значениях алгоритм предпочитает наиболее вероятные токены, что обеспечивает точность и краткость, идеально подходящие для фактических ответов. При повышении температуры выбор становится более случайным, что способствует разнообразию и творческим идеям, например, при создании стихов;
* repeat_penalty - количество повторений слов в ответе.

- ''Использовать данный шаблон по умолчанию'' – если активировать эту опцию, шаблон будет применяться автоматически в зависимости от типа (например, в QAS для запросов к документам или в SPR для суммаризации).

'''2. Добавление нового шаблона'''

1. Нажмите кнопку '''«Добавить»''' внизу вкладки.

2. Заполните поля:

- ''Название шаблона''

- ''Тип шаблона'' (выберите из выпадающего списка)

- ''Текст шаблона'' (обязательное поле)

- ''Параметры генерации''

3. Нажмите '''«Добавить»''' для сохранения.

'''3. Редактирование и удаление шаблонов'''

- Чтобы изменить шаблон, откройте его, внесите правки и нажмите '''«Сохранить».'''

- Для удаления выберите шаблон и нажмите '''«Удалить»'''. <blockquote>'''Примечание:''' Не забывайте сохранять изменения после редактирования шаблонов.</blockquote>
[[Файл:2025-07-04 17-05-52.png|мини|''Рис. 19. Рабочая область вкладки «Интерактив».'']]

==== Вкладка «Интерактив» ====

Вкладка '''«Интерактив»''' включает в себя три режима:

# режим протоколирования,
# чат,
# очистка текста.
[[Файл:Шаблон.png|мини|''Рис.20. Блок редактирования и просмотра шаблона'']]Чтобы '''переключиться между режимами''', просто нажмите на соответствующие иконки на панели управления. Активный режим выделяется красным контуром вокруг иконки.

'''Режим протоколирования''' [[Файл:Remove-bg.ai 1741353006272.png|безрамки|20x20пкс]] служит для создания протоколов — кратких резюме — на основе стенограмм. Она обладает двумя ключевыми функциями: позволяет создавать шаблоны для протоколов и создавать протоколы.
[[Файл:2025-07-04 17-06-57.png|мини|''Рис. 21. Форма для загрузки файла для протоколирования.'']]
[[Файл:2025-05-21 15-23-39.png|мини|''Рис. 22. Интерфейс вкладки Интерактив в режиме Чат'']]
Слева располагается список всех шаблонов, где вы можете найти подходящий или создать новый. Для добавления нового шаблона необходимо нажать на кнопку '''«Добавить шаблон»''' и заполнить все необходимые поля в появившемся окне: '''указать название шаблона''', а также '''наименования разделов''' и '''описать их содержание'''.
В центральной части экрана, вы можете редактировать шаблон. Здесь вы можете внести изменения и сохранить их, либо удалить, нажав соответствующие кнопки внизу блока (см. рис. 20).

В нижней части экрана вы найдете форму для отправки файла на протоколирование (см. рис. 21). Для загрузки файла воспользуйтесь кнопкой '''«Выберите файл»'''. Справа от поля выбора файла располагается значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении на которую всплывает подсказка с поддерживаемыми типами файлов.

'''[[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|Шаблон запроса к LLM]]''' стоит по умолчанию, в выпадающем списке для этого функционала доступны только шаблоны типа "Суммаризация текста". Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Затем выберите одну из опций использования '''Шаблона протокола''': '''"Использовать"''' или с '''"Не использовать"'''. Справа будет отображаться сгенерированный протокол, его можно будет выгрузить в формате docx или txt (см. раздел. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Интерактив»|Панель управления вкладки «Интерактив»]]). В рабочей области так же есть информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.

'''В режиме «Чат»''' [[Файл:Чат (1).png|безрамки|20x20пкс]] можно в свободной форме пообщаться с LLM-моделью. Есть возможность обращаться к нескольким моделям. Рабочая область показана на рисунке 22. Слева на рисунке есть блок с выбором LLM-модели, "Шаблон запроса к LLM" типа "Чат" и опция «Глубина истории сообщений», которая варьируется в диапазоне [3, 10]. История сообщений в чате сохраняется с ориентиром на глубину.

Функция '''«Размышление*»''' модели

Помимо основного ответа, большая языковая модель предоставляет возможность просмотреть логику своих рассуждений. Эта информация отображается в раскрывающемся блоке «Размышление».

* Назначение: Позволяет понять ход мыслей модели, который привел к конечному ответу.
* Практическое применение: Анализ «Размышления» помогает при необходимости скорректировать исходный запрос (промпт) для получения более точного результата.

*доступна только для больших «думающих» моделей.<blockquote>Внимание: варианты моделей появляются в интерфейсе после того, как администраторы их добавят. </blockquote>
В центре экрана расположен сам чат. Внизу области расположено окно, в которое можно ввести свой запрос и отправить его по клику на кнопку «Отправить» [[Файл:Отправить.png|безрамки|20x20пкс]] . Очистить историю можно воспользовавшись одноименной кнопкой [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]]. Справа от чата блок с «Поиском ответов», подробнее о нем и его параметрах можно прочитать [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].
[[Файл:2025-05-28 16-48-05.png|мини|''Рис. 23 Интерфейс вкладки Интерактив в режиме Очистка чата'']]

'''Режим «Очистка текста»''' [[Файл:Photo 2025-05-21 12-43-53.jpg|безрамки|20x20пкс]] этот инструмент помогает убрать из текста лишнее и сделать его более читабельным. Чтобы воспользоваться функцией, вставьте текст в поле «Чистка текста» (в центре рабочей области) и нажмите кнопку «Очистить». После завершения процесса справа от исходного текста появится очищенный вариант (рис. 23). В него нельзя вносить изменения, но можно скопировать с помощью клавиш Ctrl+C или экспортировать в виде документа [[Файл:Сохранить doc (1).png|безрамки|20x20пкс]] docx или txt на выбор.

===== Панель управления вкладки «Интерактив» =====
{| class="wikitable"
|+
!'''Иконка кнопки'''
!'''Название кнопки'''
!'''Описание'''
|-
|[[Файл:Remove-bg.ai 1741353006272.png|центр|безрамки|40x40пкс]]
|Протоколирование
|Режим протоколирования позволяет создавать протокол на основе стенограмм. Когда режим активен, вокруг появляется красный фон.
|-
|[[Файл:Чат (1).png|центр|безрамки|40x40пкс]]
|Чат
|Режим чата позволяет свободно общаться с LLM-моделью на любые темы. Когда вокруг кнопки появляется красный фон, режим активируется.
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать как документ
|Позволяет экспортировать документ протокола в одном из форматов docx или txt для режимов: протоколирование и очистка текста.
|-
|[[Файл:Меню пользователя new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Совместная работа ===

В QAS допускается работать нескольким пользователям, если они работают в разных категориях.

=== Методика работы с QAS ===

Чтобы начать пользоваться сервисом ответов на вопросы, вам нужно загрузить документацию, ответы на которую вы будете давать пользователям. Определить категорию этих документов. Напоминаем, что файл должен быть максимально ёмким, подробным и кратким подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Добавление файла в список|раздел Добавление файла в список]]. Если в документе используются аббревиатуры или слова с неофициальными ("народными") вариантами написания/произношения, например, «материнский капитал» (маткапитал, маткап и так далее), их следует включить в глоссарий. Глоссарий можно найти в разделе [[QAS. UPS руководство по работе с интерфейсом#Функционал меню «Дополнительно»|«Дополнительно»]] на вкладке «Документы» под текстом документа.

===== <big>Добавление вопросов</big> =====
Если у вас нет готовых вопросов по документации есть два варианта:

# добавлять вопросы и их формулировки вручную,
# запустить генерацию вопросов по документации (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|Панель управления вкладки Документы]]).

После того, как генерация вопросов завершится, необходимо пройти на вкладку Вопросы и проверить вопросы на соответствие документации и адекватность.

Если у вас есть csv файл с фразами-вопросами, то есть возможность загрузить их массово, воспользовавшись кнопкой «Массовая обработка вопросов» на панели управления вкладки Вопросы (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После этого нужно скомпоновать по смыслу вопросы и почистить ненужные.

===== <big>Добавление ответов</big> =====
После того как вопросы будут загружены в базу вопросов QAS. Можно запустить генерацию ответов (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После ее завершения нужно проверить правильность и соответствие ответов вопросу, если ответ вас устраивает — поставьте галочку «Проверено». Либо отредактируйте ответ и так же отметьте его проверенным. Так же можно самостоятельно добавить ответы на вопроса из документации. А так же есть возможность запустить перефразирование уже проверенных ответов, что поможет немного расширить вариации ответов.

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

''Пример корректного ответа и нет:''
{| class="wikitable"
|+
!'''Вопрос'''
!'''Ответ, который потенциально приведет к ошибке'''
!'''Ответ, который НЕ приведет к ошибке'''
|-
|Реабилитационный сертификат
|'''По данному вопросу''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|По вопросу '''оформления реабилитационного сертификата''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|}

===== <big>Работа с кэшем вопросов</big> =====
После того как вы создадите базу вопросов и ответов, можно приступить к проверке работы кэша. В разделе «Кэш» вы найдёте блок для поиска ответа. В поле «Текст» введите свой вопрос, который может быть похож на уже существующие и на которые может ответить ваша загруженная документация. Установите необходимые настройки поиска, подробности можно найти [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].

Далее возможны различные варианты развития событий:

* Если ''вопрос не похож'' ни на один из уже имеющихся в базе данных, и активирован флаг «Использовать генерацию», система сгенерирует ответ на основе документации (если в ней есть ответ на этот вопрос). А сам вопрос будет добавлен в список основных (при условии, что активна галка «кэширование формулировки»). Если функция генерации отключена, в ответ на вопрос будет указано «Информация не найдена». Сам вопрос будет отображаться в общем списке вопросов как основной, для работы с ним и с подобными нужно отфильтровать по «Пустым ответам».
* Если система ''обнаружит сходство с каким-либо вопросом из базы данных'', новый вопрос будет добавлен в список кандидатов к этому вопросу. Если кандидат попадет в верный вопрос его нужно будет утвердить (перенести в формулировки). Вы сможете найти его местоположение, перейдя в режим «Утверждение кандидатов» и отфильтровав одноименную колонку с помощью формулировки вашего запроса в поле «вопрос». Подробности о работе с кандидатами [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|тут]]'''<big>.</big>'''
* Если в базе данных уже ''есть похожий запрос'', но ''система не может найти его'' и генерирует новый ответ на ваш запрос, то решить эту проблему можно, добавив ваш новый вопрос как основной запрос. Поскольку, если система не считает похожим ни на один вопрос, то лучше добавить его как отдельный вопрос со своим ответом.
* Склейки (несколько вопросов разделенные «|») попадают в QAS, но не оседают там, даже если включена галочка «кэширование формулировок».

===== <big>Запуск в прод</big> =====
При массовом обращении к системе, например, на проде удобнее всего с новыми запросами работать через отчет по [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|кандидатам]]. С его помощью можно увидеть, в какие категории и в какие вопросы поступают новые запросы, и сразу же внести изменения — поменять категорию или утвердить кандидатов. А также увидеть, каким запросам не присвоилась категория вообще.

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

2025-12-24T10:09:52Z

E.Elagina: /* Панель управления вкладки «Кэш» */

=== Главное меню ===
[[Файл:QAS.png|мини|''Рис. 1 Главный экран UPS'']]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# QAS ЧаВО,
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]]
# Выход.
Переключаться между продуктами можно двумя способами:

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]] .
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).

Перейти в раздел '''«ЧаВО»''' (QAS) можно кликнув по соответствующей кнопке на главном экране UPS (см.рис. 1).

=== Описание интерфейса сервиса «ЧаВО» (QAS) ===
Рабочая область сервиса «ЧаВО» (QAS) (сервиса ответов на вопросы) включает в себя следующие блоки:
*панель управления;
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Документы»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Кэш»|«Кэш»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Интерактив»|«Интерактив»]];'''
*вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области;
*вкладка '''«Категории»''' содержит список всех созданных категорий, можно как редактировать уже существующие, так и добавлять новые. Есть фильтрация по названию. Доступен ''экспорт''[[Файл:2025-12-10 11-22-58 (1).png|безрамки|28x28пкс]] и ''импорт'' [[Файл:2025-12-10 11-23-23 (1).png|безрамки|30x30пкс]] категории, для переноса на другой сервер; А так же ''удаление'' категории.
<blockquote>'''ВНИМАНИЕ: удаление категории''' происходит '''со всеми документами и вопросами,''' система сообщит об этом.</blockquote><blockquote>'''Как работает импорт:'''
* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.

'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>

==== Вкладка «Документы» ====
[[Файл:Photo 2025-05-21 12-43-54.jpg|мини|''Рис. 2 Рабочая область сервиса «ЧаВО»'']]Во вкладке «Документы» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 2):

* панель управления;
* блок со списком документов содержит поиск по названию и фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Спрятать боковую панель''' между списком документов и блоком для редактирования (появляется при наведении мыши на середину между блоками);
* добавление нового документа в базу;
[[Файл:Photo 2025-05-21 12-43-54 (2).jpg|мини|''Рис. 3 Пример отработки кнопки «Очистить текст»'']]
*блок '''«Редактирование документа»''' с полями: «Название», «Дополнительно» и текстом выбранного файла, который можно редактировать. Можно переименовывать файл, после чего нужно сохранить изменения. Кнопка сохранения становится активной как только будут внесены изменения. Чтобы сделать текст более читабельным, его можно очистить от лишнего. Для этого нажмите кнопку '''«Очистить текст»''', которая находится под основным блоком слева от '''«Сохранить»''', предварительно выбрав шаблон запроса, если требуется. Или воспользуйтесь кнопкой на [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|панели управления]] [[Файл:2025-10-08 15-19-11 (1).png|безрамки|20x20пкс]].
<blockquote>'''Важно:''' при уже запущенном процессе очистки кнопка остановит текущий процесс отчистки.</blockquote>После завершения очистки справа появится окно с изменениями. Кнопка, открывающая данные по очистке позволяет просмотреть так же:

* Прогресс выполнения (%)
* Позицию в очереди (правило '''«один аккаунт — одна операция очистки»''')
* Результаты обработки. Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''

Вы сможете сравнить исходный и очищенный текст. Если нужно внести правки, их можно сделать прямо в блоке с очищенным документом. После проверки и внесения правок, если все устраивает, нажмите '''«Заменить в документе»''' под блоком с очищенным текстом. Изменения вступят в силу. ''Не забудьте сохранить документ.'' Рядом с этой кнопкой есть '''«Закрыть»'''. Она закрывает окно с очищенным текстом без сохранения изменений.
<blockquote>Для очистки текста, ''который не загружен в базу данных'' QAS, используйте режим «Очистка текста» на вкладке «Интерактивный режим».</blockquote>
*блок поиска фрагментов по базе.

[[Файл:2025-10-08 15-24-58.png|мини|''Рис.4. Добавление нового файла'']]

===== Добавление файла в список =====
В нижней части блока со списком файлов есть кнопка '''«Добавить файл»'''. Если нажать на нее, то появится диалоговое окно, как показано на рисунке 4. Чтобы добавить файл, нужно заполнить все необходимые поля и выбрать нужный файл с компьютера, в кодировке '''Unicode UTF-8'''.

Поддерживаемые '''форматы''':

* .odt
* .docx
* .doc
* .rtf
* .ods
* .xlsx
* .xls
* .pdf
* .txt.

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

===== Функционал меню «Дополнительно» =====
[[Файл:2025-05-23 17-11-07.png|мини|''Рис. 5 Иллюстрация функций кнопки Дополнительно'']]
На вкладке дополнительно вы можете посмотреть:

* категорию к которой относиться документ,
* глоссарий, в котором укажите название объекта из документа (рис. 5), а также его синоним в соответствующих полях внизу страницы. Это поможет модели лучше понимать, о чём её спрашивают. Например, научить ее тому, что «госпошлина = пошлина», «загранник = загранпаспорту», «загранпаспорт = заграничному паспорту», а «загранпаспорт нового образца = загранпаспорту на 10 лет» и нажмите кнопку добавить.
<blockquote>Поиск в базе работает '''на основе векторного анализа текста'''. Чтобы система точнее находила нужные документы, важно выделить ключевые термины и создать глоссарий.

Как это сделать:

# Внимательно изучите документ.
# Выпишите основные термины и их возможные синонимы.
# Внесите их в глоссарий в формате: ''основной термин = синоним''.

Пример:

Если в документе слово ''«апостиль»'' иногда называют «''услугой»,'' укажите в глоссарий:

<code>апостиль = услуга</code>.</blockquote>Предусмотрено массовое удаление синонимов, для этого выделите нужное галочками. Кликнув на поле с фразами вы можете отредактировать формулировку. После внесения изменений нажмите кнопку '''«Сохранить»'''. Она станет активной сразу же после того, как вы внесете какие-либо изменения в документ. Эта кнопка является дубликатом кнопки '''«Сохранить»''' в блоке редактирования документа.
* есть кнопка для экспорта глоссария, если это необходимо в формате .csv.
* а так же доступен импорт с тремя опциями: дополнить, заменить и отменить импорт.
* здесь же находится кнопка для удаления документа.

===== Поиск фрагментов в документах =====
Поиск фрагментов — это первый этап для ответа на вопрос. Система сначала ищет фрагмент (фрагменты) в документах, после отправляет их вместе с промптом на модель генерации.

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

===== Панель управления вкладки «Документы» =====
В верхней части экрана располагается панель управления, на которой находятся кнопки: ''генерация ответов, экспорт документов, очистка документа, массовая обработка вопросов, задать вопрос'' и ''меню пользователя.''
{| class="wikitable"
|+''Табл. 1 Описание функционала панели управления.''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать документ
|Позволяет экспортировать документ в одном из форматов .docx или .txt
|-
|[[Файл:2025-10-08 15-19-11 (1).png|центр|безрамки|40x40пкс]]
|Очистка документа
|При нажатии на кнопку открывается диалоговое окно, в котором необходимо:

# Выбрать модель генерации — укажите модель ИИ для обработки текста
# Выбрать шаблон очистки — определите параметры форматирования текста

<blockquote>'''Важно!''' Очистка будет применена к текущему активному документу.

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

Действует правило '''«один аккаунт — одна операция очистки».'''</blockquote>После запуска кнопка меняется на ''«Остановить очистку документа»,'' по нажатию на нее запущенная вами очистка завершается.

Посмотреть прогресс очистки можно нажав на кнопку ''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Очистка текста»]]'' под документом.

Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация вопросов
|эта кнопка предназначена для генерации вопросов. По нажатию на кнопку появляется диалоговое окно, в котором требуется выбрать:

* категорию вопросов для генерации;
* если не нужно генерировать вопросы для всех документов, выберите нужный,
* выберите канал,
* выберете модель генерации (по умолчанию используется default), другие модели будут отображаться в списке только после того, как администратор добавит их,
* выберите шаблон запроса к LLM (по умолчанию используется шаблон "из коробки" типа "Генератор вопросов по тексту"),
* запустите генерацию.
Генерация вопросов запускается ''для каждой'' категории ''отдельно''.
<blockquote>'''''Совет''': генерацию лучше запускать в нерабочее время, так как она может занять много времени.'' Для удобства отслеживания на иконке отображается прогресс генерации.</blockquote>Есть возможность включить или отключить опцию ''генерации ответов'' сразу для документа. Для случаев, когда добавился новый документ в категорию и нет под него ВОП из «живых» фраз.

<blockquote>'''''Совет''''': если есть возможность использовать «живые» фразы людей, то всегда лучше брать их, а не генерировать синтетические вопросы.</blockquote>
|-
|[[Файл:2024-07-08 22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка документов
|позволяет сделать массовую замену текста в документах. В диалоговом окне нужно выбрать категорию, искомый текст и текст замены.
|-
|[[Файл:Задать_вопрос_нов.png|центр|безрамки|40x40пкс]]
|Задать вопрос1
|генерирует ответ на вопрос на основе информации, содержащейся в одном или нескольких документах.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы, шаблоны)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:Ask.png|мини|Рис. 6 Блок «Задать вопрос»|589x589пкс]]
1 По нажатию на кнопку '''«Задать вопрос»''' (рис. 6), появляется диалоговое окно с полями:

'''«Вопрос»''' — это область для ввода вопроса.

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

'''«Канал»''' - список созданных каналов связей.

'''«Модель генерации»''' - список доступных моделей

'''«Шаблон запроса к LLM»''' - шаблон запроса (промпт) к модели генерации.

'''«Использовать кэш ответов»''' - в этом меню можно выбрать, использовать ли только проверенные ответы или любые.

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

===== Добавление новых и редактирование вопросов =====

''Вопросы в QAS могут быть трех видов:''

'''Кандидаты''' — это новые запросы к системе, которые, по мнению самой системы, являются семантически близкими к основному вопросу и его формулировкам. Чтобы перевести кандидата в формулировки, нужно ''утвердить'' их (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|разд. Режим работы "Утверждение кандидатов"]])

'''Формулировки (алиасы)''' — это различные варианты одного и того же вопроса. Этот список станет основой для системы при поступлении новых запросов. Она будет использовать его, чтобы определить, в кандидаты к какому основному вопросу стоит отнести новый.

'''Основной вопрос''' — это новый вопрос, который ранее не существовал в базе данных QAS, а также не имел семантически близких аналогов. Каждому основному вопросу присваивается категория. Он может включать дополнительные формулировки и кандидатов.

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

* категорию вопроса;

* текст вопроса.

Чтобы ''отредактировать'' уже существующий вопрос, нужно выбрать его из списка. После этого его текст и ответы появятся в блоке для редактирования, который находится в середине страницы. Если вопрос слишком длинный и не помещается в одну строку, просто нажмите на него, и он будет развёрнут. [[Файл:2024-10-14 15-55-53.png|мини|''Рис. 8 Интерфейс вкладки «Дополнительно»'']]

Меню '''«Дополнительно»''' включает в себя следующие опции:

- изменение формулировки основного вопроса,

- изменение категории вопроса (перенос в другую категорию) осуществляется путём выбора из списка доступных категорий, расположенного в верхней части окна (рис. 8). Вопрос будет перенесен без потерь со всеми ответами, кандидатами и формулировками.

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

Поэтому мы создаём короткие вопросы, помечаем их как «неполные» и добавляем уточняющие вопросы в ответ. Например: «Уточните, пожалуйста, что именно вы хотите узнать по поводу детского сада?» Получив такой вопрос, абонент должен будет уточнить свои потребности, а затем робот объединит оба запроса и выдаст ответ, если он есть в базе данных QAS.</blockquote>- добавление, удаление или перенос. Чтобы удалить формулировку, необходимо навести курсор на нужную фразу. После этого справа появятся две кнопки (см. рис. 8). Одна из них в виде ''стрелочки'' предназначена для того, чтобы сделать эту формулировку ''основным вопросом''. А кнопка в виде ''корзинки'' позволяет удалить выбранную фразу. Есть возможность удалять несколько формулировок, для этого нужно выбрать формулировки для удаления и нажать на кнопку ''Удалить,'' рядом с кнопкой ''Переместить.'' <blockquote>При удалении основного вопроса на вкладке ''Дополнительно'', сначала нужно переназначить основным вопросом другую формулировку и после этого удалить. </blockquote>- есть возможность переместить формулировки и/или кандидатов в другой вопрос. Для этого поставьте галочку напротив нужной фразы и нажмите кнопку «Переместить». В появившемся диалоговом окне выберите нужный вопрос (вы можете предварительно отфильтровать вопросы по категориям). Выберите, из выпадающего списка куда следует переместить выбранные вопросы: в формулировки или в список кандидатов, — и нажмите кнопку «Переместить». После этого '''обязательно''' сохраните изменения в текущем вопросе. <blockquote>'''Обращаем ваше внимание,''' что если вы указываете, что перемещение должно быть выполнено в кандидаты, то вам необходимо будет затем перейти и ''утвердить'' кандидата.</blockquote>- так же вы можете ознакомиться со списком ''кандидатов'', который включает формулировки, близкие по смыслу к основному вопросу. Если среди них есть подходящие варианты, отметьте их галочкой и нажмите кнопку «Утвердить». После этого выбранные формулировки появятся в общем списке «Формулировки». ''Добавление большого количества разных формулировок необходимо, чтобы модель могла понимать суть вопроса, независимо от того, как его сформулирует человек, и выдавать один и тот же ответ на разные варианты этого вопроса.''

- ''удаление'' вопроса из базы на вкладке «Дополнительно» внизу будет кнопка ''Удалить вопрос полностью''.

'''Внимание:''' ''Нажимая на кнопку '''Удалить вопрос полностью''' в меню Дополнительно, вы удаляете весь вопрос, включая формулировки, ответы на него из всех каналов и всех кандидатов.''

- после того как вы внесете изменения, кнопка «Сохранить» станет активной в меню «Дополнительно» и на панели для редактирования ответов.

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

Каждый вопрос сопровождается флажком '''«Проверено»''', который отмечает ответы, проверенные пользователем. При наведении курсора мыши на ответ, вместо канала к которому принадлежит вопрос, появляются кнопки:

* копировать в канал, с ее помощью можно продублировать ответ для любого доступного канала;
* переместить в канал, перемещает ответ с текущего канала на другой выбранный пользователем канал;
* удалить ответ.
Также вы можете добавить новый вопрос в список, воспользовавшись функцией поиска ответа на вкладке '''«Кэш»''' с включенным флажком '''«Использовать генерацию»''' или задав новый вопрос по документам на вкладке '''«Документы»,''' так же выбрав опцию '''«Использовать генерацию»'''. Если похожего вопроса раньше не было, то он появится в списке на вкладке «Вопросы». Вы сможете редактировать и изменять его по своему усмотрению. В случае, если похожий вопрос уже встречался, система предложит его как кандидата к похожему вопросу. Это значит, что его нужно будет перенести в формулировки (утвердить) и сохранить изменения.

===== Поиск по вопросам и ответам. Фильтрация =====
[[Файл:2024-08-06 16-23-15.png|мини|''Рис. 9 Иллюстрация поиска по вопросам'']]
В разделе '''«Кэш»''' есть три вида поиска:

# поиск по вопросам и их формулировкам, в том числе и кандидатам;
# поиск по ответам.
# поиск по категории

А так же два вида фильтрации:

# по содержанию ответов: ''Все'', ''Проверенные'', ''Непроверенные'', ''Пустые.''
# по полноте вопроса: ''Все, Полный, Неполный.'' К полным вопросам относятся вопросы с конкретикой. К неполным - короткие вопросы без конкретики.

[[Файл:2024-08-06 16-38-29.png|мини|''Рис. 10 Иллюстрация поиска по ответам'']]С помощью '''поиска по вопросам и их формулировкам''' можно найти все вопросы или вопросы в определённой категории, которые содержат определённое слово или фразу в своей формулировке. Поиск работает как для основного вопроса, так и для дополнительных формулировок. <blockquote>Например, на рисунке 9 в категории «Водительские права» мы ищем все вопросы, в которых есть сочетание букв «''замена''». Если открыть меню, внизу экрана, ''«Дополнительно»'', то можно увидеть, что это сочетание используется в альтернативных формулировках вопроса, найденные сочетания подсвечиваются. </blockquote>Обращаем внимание, что если в основном вопросе нет искомого слова или сочетания букв, то система все равно выведет вопрос, если найдет совпадения в альтернативных формулировках. [[Файл:2024-08-06 16-24-00.png|мини|''Рис. 11 Результат работы двух видов поиска одновременно'']]
Предусмотрен ''поиск по ответам'', в поле '''«Ответ»''' можно ввести слово или фразу и система подсветит поля ответов, где искомое сочетание было найдено (рис. 10). По умолчанию канал связи стоит в положении «не выбран» и выводятся ''все'' ответы ''из всех каналов'', где найдено слово или фраза. Можно принудительно выбрать канал из списка, тогда отобразятся ответы выбранного канала и будут подсвечены те ответы, где найден искомый текст. Область ответа с искомым текстом будет подсвечена бледно-голубым (рис. 10). Можно одновременно использовать два вида поиска. В результате будут отображены вопросы, в которых присутствует искомое значение – как в вопросах, так и в ответах (рис. 11).

===== Поиск ответа =====
[[Файл:2025-07-04 15-31-58.png|мини|''Рис. 12 Интерфейс блока «Поиск ответов»'']]
Блок '''«Поиск ответа»''' (рис. 12) работает так же, как кнопка '''«Задать вопрос»''' на вкладке '''«Документы»'''. <blockquote>Важно отметить, что поиск ответа происходит в два этапа:

# поиск нужных фрагментов из документов в категории,
# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.
</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов.

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

'''«Шаблон запроса к LLM»:''' здесь вы можете выбрать, какой промпт отправить на генеративную модель вместе с найденными фрагментами и вопросом. Если промпт не выбран, LLM будет использовать стандартный запрос. Подробнее о шаблонах запросов [[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|тут]]. <blockquote>'''Для чего это нужно?'''

Если стандартный промпт не работает так, как нужно для конкретной категории, или требуется что-то особенное, можно создать новый шаблон. Это делается без изменения стандартного промпта. </blockquote>Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Меню '''«Использовать кэш»'''. В этом меню можно выбрать, использовать ли только проверенные ответы или любые. Кэш-память позволяет сервису быстрее отвечать на запросы пользователей. А опция '''«Только проверенные ответы»''' гарантирует, что ответы, которые получает пользователь, были отредактированы и проверены оператором.

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

Аналогично вкладке «Документы», вы можете настроить '''количество документов''', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.

===== Функционал режима «Проверка новых вопросов» =====
Режим «Проверка новых вопросов» содержит перечень всех новых вопросов. В рабочей области находится таблица, в которой представлен список новых вопросов, ответы на них, категория, присвоенная этим вопросам, а также дата создания вопроса. Есть возможность фильтрации по каждой из колонок (рис. 13).
[[Файл:New questions mode.png|мини|''Рис.13. Интерфейс режима утверждения новых вопросов'']]
При наведении на любую строку слева появляются иконка и чекбокс:
# [[Файл:Circle-check-solid.png|безрамки|22x22пкс]] Утвердить — позволяет утвердить ответ на текущий вопрос. Это означает, что ответ и категория соответствует вопросу. После утверждения вопрос пропадет из таблицы и получит статус '''«Проверено».'''
# [[Файл:Checkbox.png|безрамки|25x25пкс]] Чекбокс — позволяет выбрать несколько позиций таблицы для утверждения или удаления. Утверждение означает, что у всех выбранных позиций ответ и категория соответствует вопросу. Для утверждения всех выбранных позиций необходимо нажать кнопку «Утвердить», внизу таблицы, в правом нижнем углу. Для удаления — на значок ''корзинки'' (п. 5 списка ниже), так же в нижнем углу.
В «подвале» таблицы расположены следующие функциональные элементы:

# [[Файл:Expand.png|безрамки|20x20пкс]] Развернуть — разворачивает таблицу и входит в полноэкранный режим.
# [[Файл:Compress.png|безрамки|23x23пкс]] Свернуть — выходит из полноэкранного режима и возвращает таблицу в исходное состояние.
# [[Файл:Approve changes mode.png|безрамки|187x187пкс]] — позволяет переключаться между состояниями режима '''«Подтверждения изменений».''' При включенном режиме при каждом массовом утверждении ответов на вопросы будет появляться диалоговое окно, которое будет запрашивать подтверждение текущих изменений.
# Кнопка '''«Утвердить»''' — позволяет утвердить все выбранные на данный момент ответы на вопросы. Кнопка не активна, пока не выбрана ни одна позиция в таблице.
# [[Файл:Delete icon.png|безрамки|22x22пкс]] — позволяет удалить все выбранные на данный момент ответы на вопросы. При включенном режиме '''«Подтверждения изменений»''' при удалении запросит подтверждение в диалоговом окне.
[[Файл:New questions mode changed.png|мини|''Рис.13.1. Работа в режиме утверждения новых вопросов'']]Данный режим позволяет как точено, так и массово проверять ответы и категорию на соответствие вопросу.
В таблице реализована возможность самостоятельной правки вопросов/ответов/категорий. Для этого надо кликнуть на интересующую вас ячейку и внести правки. Сразу после изменений в верхней правой части ячейки появится иконка для отката изменений [[Файл:Undo.png|безрамки|24x24пкс]] на '''начальное''' состояние. Если в строке произошли какие-то изменения, то ''строка автоматически переходит в состояние выбранной'' (рис. 13.1).

В таблице реализована клавиатурная доступность, которая позволяет перемещаться между ячейками и утверждать выбранные позиции в таблице. Для этого используются следующие комбинации клавиш: Ctrl + ⬆/⬇/⬅/➡/Enter.

===== Функционал режима «Утверждение кандидатов» =====
[[Файл:Рис. 13 Интерфейс режима Утверждения кандидатов.png|мини|''Рис. 14. Интерфейс режима Утверждения кандидатов'']]
Режим «Утверждение кандидатов» содержит перечень всех кандидатов. В рабочей области находится таблица, в которой представлен список кандидатов, перечень основных вопросов, где эти кандидаты находятся, а также категория, присвоенная этим вопросам (рис. 14).

При наведении на любую строку слева появляются две иконки:
# [[Файл:Сделать основным без фона.png|безрамки|26x26px]] Сделать основным — позволяет сделать кандидата основным вопросом. По нажатию на эту кнопку появляется диалоговое окно, где требуется подтвердить намерение сделать кандидата основным вопросом. В форме подтверждения нужно выбрать категорию, в которую хотели бы добавить вопрос и аналогично функционалу добавить новый вопрос (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|Добавление новых и редактирование вопросов]]).
# [[Файл:Утвердить.png|безрамки|26x26px]] Утвердить — позволяет утвердить кандидата, в текущем вопросе, включая её в формулировку вопроса. Это означает, что кандидат подходит по смыслу к основному вопросу и его формулировкам.[[Файл:Рис 14. Работа в режиме Утверждение кандидатов.jpg|мини|''Рис.14.1. Работа в режиме Утверждение кандидатов'']]

Чтобы утвердить сразу несколько кандидатов, отметьте их галочками. После этого внизу появится строка с выпадающим списком всех основных вопросов из базы данных QAS.

По умолчанию система предлагает утвердить выбранного кандидата или кандидатов в текущем вопросе. Однако если вы хотите перенести его в другой вопрос, просто начните вводить его название в поле поиска. Затем нажмите кнопку «Утвердить», расположенную в правом нижнем углу (рис. 14.1).

Если вы хотите ''удалить'' кандидата или кандидатов, выделите их и нажмите на иконку «Корзинка», которая находится над кнопкой «Утвердить».

===== Функционал режима «Поиск несоответствий» =====

Режим "Поиска несоответствий кэша ответов и документов" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Несоответствия"''''' и '''''"Ошибки"''.''' Чтобы запустить поиск несоответствий, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

[[Файл:Поиск несоответствий 1.png|мини|''Рис.15. Работа в режиме Поиска несоответствий. Вкладка несоответствий'']]
При активном табе '''"Несоответствия"''' показана таблица результатов поиска для работы с найденными ответами из кэша, которые не соответствуют фрагменту документа (рис.15). Таблица разделена на 4 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''фрагмент из документа'', по которому был дан текущий ответ,
* ''исправленный ответ'', на который предлагается заменить текущий.

Проанализировав предложенные ответы в столбце ''"Исправленный ответ"'', можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены предложенных ответов на ответы из кэша необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

[[Файл:Поиск несоответствий 2.png|мини|''Рис.15.1. Работа в режиме Поиска несоответствий. Вкладка Ошибок'']]
При активном табе '''"Ошибки"''' показана таблица результатов поиска для работы с найденными ответами из кэша, по которым были выявлены ошибки, например, отсутствие информации (рис.15.1). Таблица разделена на 3 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''ошибка'' поиска''.''

Здесь можно скорректировать ответ из кэша, при необходимости (в ячейке таблицы), или удалить запись (строку). Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены исправленных ответов необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

===== Функционал режима «Векторный поиск» =====
[[Файл:Векторный поиск.png|мини|''Рис.16. Работа в режиме Векторного поиска'']]
Режим "Векторного поиска" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Документы"''''' и '''''"Ответы"''''' (рис.16). Он предназначен для поиска и замены ответов и фраз в документах, векторно похожих на текст запроса. Чтобы запустить векторный поиск, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

После окончания поиска будет отображена таблица, которая разделена на 3 столбца:
* ''документ / вопрос'' (в зависимости от выбранного таба),
* ''фраза / ответ'' (в зависимости от выбранного таба),
* ''сходство'', в процентах.
Проанализировав найденные фразы/ответы, можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].
[[Файл:Векторный поиск 2.png|мини|''Рис.16.1. Замена информации в режиме векторного поиска'']]

Затем слева от таблицы заполняем форму для того, чтобы модель генерации предложила варианты замены информации (фразы или ответа). Для этого заполняем недостающие поля: ''Текст замены'' и опционально ''Модель генерации'' (по умолчанию default) и ''Шаблон запроса к LLM'' типа "Векторная замена информации". После нажатия на кнопку ''"Показать варианты замены"'' запустится процесс подготовки предложений по замене информации: появится четвертый столбец ''"Измененная фраза" / "Измененный ответ"'' и в ней по очереди построчно будут заполнятся фразы/ответы (рис. 16.1).

После окончания обработки можно отредактировать или удалить предложенные варианты замены, выделить нужные и нажать внизу таблицы кнопку ''"Заменить фразы"'' / ''"Заменить ответы"'' для замены фраз в документе/ответов соответственно.

===== Панель управления вкладки «Кэш» =====
{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления вкладки «Кэш»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:2024-07-08_22-41-00_(1).png|центр|безрамки|40x40пкс]]
|Выбрать вопросы
|При нажатии на эту кнопку активируется режим, в котором можно выбрать несколько вопросов из списка для последующего перемещения или удаления. Сама кнопка подсвечивается красным контуром, показывая, что она активна. Нажав на неё повторно, можно выключить режим и сбросить выбор. После того как вы отметили галочками вопросы, справа от кнопки появляется опции «Переместить вопросы» [[Файл:Копировать.png|безрамки|20x20px]] и «Удалить выбранные вопросы»[[Файл:2024-07-08 22-55-51-no-bg-preview (carve.photos).png|безрамки|20x20px]].
Если вы собираетесь переместить вопросы, но в них уже есть проверенные ответы или кандидаты, в диалоговом окне появится соответствующее предупреждение. При этом перемещаться они не будут. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-35.png|центр|безрамки|40x40пкс]]
|Экспорт вопросов
|Эта кнопка позволяет экспортировать вопросы в формате CSV для классификатора или для отчета.
Структура файла для классификатора выглядит следующим образом: ''Категория'' ⇥ ''Вопрос.''
Структура файла отчетности: ''Категория⇥ Вопрос⇥ Обозначение вопроса(основной/алиас/кандидат).'' Эта кнопка доступна только в режиме '''«Подробный».'''
|-
|[[Файл:Автосохранение_(1).png|центр|безрамки|40x40пкс]]
|Автосохранение
|Позволяет включить автосохранение. При включенном (вокруг кнопки появляется красный контур) режиме будет сохраняться через 10 секунд после изменения данных. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Обновить_данные_вопроса.png|центр|безрамки|40x40пкс]]
|Обновить данные вопроса
|С помощью этой кнопки можно обновить данные текущего вопроса, например, после генерации ответов. По нажатию на кнопку обновятся все ответы, которые система сгенерировала на этот вопрос. Генерация ответов происходит для разных каналов связи. Вы можете просмотреть их, выбрав нужный канал в меню рядом с основным вопросом. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация ответов
|эта кнопка предназначена для генерации ответов. По нажатию на кнопку появляется диалоговое окно, в котором требуется:

* ввести желаемое количество ''ответов'',
* выбрать ''категорию'', для которой требуется генерация,
* выбрать ''канал'',
* выбрать ''режим генерации'': по документам или перефразирование проверенных,
* указать, для каких вопросов нужно сгенерировать ответы: для всех или только для пустых,
* далее выбрать, следует ли заменить существующие ответы. Если «да», то ответы будут заменены на новые. Если «нет», то они будут дополнены новыми вариантами,
* указать модель генерации (по умолчанию используется default). Другие модели будут отображаться в списке только после того, как администратор добавит их,
* и наконец, указать ''количество документов [1,10]'', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.
* и нажать на кнопку «Запуск».

Генерация может занимать достаточно продолжительное время. Помимо канала по умолчанию, ответы генерируются и для других каналов, после окончания обновите данные вопроса и просмотрите все существующие каналы.<blockquote>'''''Совет:''''' ''лучше использовать сначала режим генерации ответов по документам, после чего проверить их правильность и запускать генерацию в режиме перефразирования ответов. Также перед тем, как сгенерировать ответы, обновите страницу.'' </blockquote>Убедитесь, что предыдущая генерация ответов закончена, иначе кнопка не сработает, и вам нужно будет либо остановить предыдущую генерацию, либо подождать, пока она завершится. Для удобства отслеживания на иконке отображается прогресс генерации. Иконка выглядит так [[Файл:Иконка генерации.png|безрамки|20x20px]], если генерация запущена. При наведении на нее она меняется на ''Остановить генерацию ответов'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить генерацию. Все ответы, которые успели сгенерироваться, останутся. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка вопросов
|Нажав на кнопку, появится меню с двумя разделами: '''«Загрузка»''' и '''«Замена».'''
''Функционал раздела '''«Замена».'''''

Этот раздел позволяет заменить определенный текст в ответах на вопросы. Для этого необходимо заполнить следующие поля:

* категория
* искомый текст в ответах
* замена
* и нажать запуск.
''Функционал раздела '''«Загрузка».'''''Этот раздел предназначен для обработки множества вопросов (в режиме '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]) или пар вопрос-ответ (в '''JSON'''-режиме [[Файл:JSON.png|безрамки|80x80пкс]]).

Режим '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]'''.'''

Для массовой обработки вопросов в режиме Текст требуется выбрать:

* файл с вопросами в формате .csv,
* выбрать категорию, к которой относятся вопросы из файла,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Любые ответы'',
* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и если не активирован флаг «Использовать генерацию», функция работать не будет). Другие модели будут отображаться в списке только после того, как администратор добавит их.
* а также активировать только флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]''). Можно активировать остальные флаги для случаев, когда нужно помимо обработки нужно ''еще и сгенерировать ответы.''
* а так же активировать опцию «Установить порог похожести,%». Если вы активируете её, то сможете выбрать значение по умолчанию — 90% или задать своё собственное.<blockquote>'''Важно:''' в файле могут быть вопросы '''только''' по одной тематике.</blockquote>Обработка вопросов осуществляется по следующей схеме: каждый новый вопрос сравнивается с предыдущими (и формулировками). Если обнаруживается вопрос, который кажется схожим по смыслу, то новый вопрос включается в список его возможных кандидатов. Если же не находится вопроса, который имеет семантическую близость с новым, то новый становится основным.<blockquote>'''''Совет:''' д''ля массовой обработки вопросов без генерации ответов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Любые ответы».</blockquote>Режим '''JSON'''[[Файл:JSON.png|безрамки|80x80пкс]].

Чтобы массово обрабатывать пары вопрос-ответ, переключитесь в режим JSON и заполните следующие поля:

* файл с вопросами в формате .json.

<blockquote>Формат json-файла для загрузки в интерфейс:

[

[ "вопрос2", "ответ 2" ],

[ "вопрос1", "ответ 1" ]

]</blockquote>

* выбрать категорию, к которой относятся пары вопрос-ответ в файле,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Не использовать'',
* оставьте параметр «Количество документов» в значении по умолчанию — 1.
* автоматически ставится флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]'').
* порог схожести и устанавливается на 98% без возможности редактирования.

Этот функционал позволяет создать основную базу. После того как пары вопросов и ответов будут добавлены, можно будет [https://wiki.connect2ai.net/index.php#Добавление_новых_и_редактирование_вопросов добавлять формулировки в вопросы]. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Лупа.png|центр|безрамки|50x50пкс]]
|Поиск несоответствий кэша ответов и документов / Векторный поиск
|Позволяет запустить поиск разного вида в зависимости от выбранного режима: '''«Поиск несоответствий»''' или '''«Векторный поиск»'''.

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

''1. "Вопрос по документации",''

''2.'' "Поиск несоответствий информации".

Поиск может занимать достаточно продолжительное время. Для удобства отслеживания на иконке отображается прогресс поиска. При наведении на нее она меняется на ''"Остановить поиск несоответствий кэша ответов и документов"'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить поиск.

В режиме '''«Векторный поиск»''' при нажатии на кнопку появляется форма для поиска фрагментов, векторно похожих на фразу запроса. Для запуска в ней нужно указать ''Текст'' запроса, ''Категорию'' поиска и ''Порог схожести''. Далее будет выведена таблица с данными поиска с разделением на документы и ответы.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

[[Файл:Шаблоны запросов.png|мини|''Рис. 17. Интерфейс вкладки Шаблоны запросов'']]

===== Функционал вкладки «Шаблоны запросов» =====

Данный раздел позволяет управлять шаблонами промптов: создавать, редактировать, удалять и настраивать их использование ''(Рис. 17)''.

'''1. Интерфейс вкладки'''

'''- ''Фильтрация по типу'''''

В верхней части окна слева расположен выпадающий список '''«Тип»''', позволяющий отфильтровать шаблоны по категориям:

- Чат

- Запрос к документу

- Очистка документа

- Генератор синонимичных фраз

- Перефразировка фрагмента текста

- Суммаризация текста

- Генератор вопросов по тексту

- Векторная замена информации

- Поиск несоответствий информации

Напротив каждого типа в скобках указано количество доступных шаблонов.

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

'''''- Список шаблонов'''''

Справа от списка типов отображаются шаблоны выбранной категории. При выборе шаблона из списка его содержимое отображается в области просмотра.

'''''- Редактирование шаблона'''''

- ''Название шаблона'' – можно изменить в соответствующем поле.
[[Файл:Сведение в единый.png|мини|''Рис. 18. Шаблон сведения ответа в единый'']]
- ''Текст шаблона'' – поддерживает параметры в квадратных скобках <code>[###Сопроводительный текст, если нужен{Параметр}]</code>, которые являются необязательными. Квадратные скобки обозначают необязательный параметр, то есть его может не быть и система все равно отработает.

- ''Шаблон сведения ответа в единый'' (опционально) – используется в суммаризации для объединения нескольких частей в один результат. <blockquote>Например, разбили совещание на куски, сделали по кускам суммаризации, а потом нужно в один результат все свести ''(Рис. 18)''.</blockquote> - ''Параметры генерации:''

* max_tokens - ограничение максимального количества токенов, возвращаемых моделью в ответ на заданный запрос (prompt);
* top_k - параметр, определяющий количество наиболее вероятных токенов, которые модель учитывает при генерации текста. Чем ниже значение, тем более предсказуемым и повторяющимся будет ответ модели;
* top_p - параметр отвечает за динамический выбор словаря модели и является альтернативой настройке «температуры» ответа. Используется для уменьшения вероятности генерации неожиданных или нежелательных ответов;
* temperature - параметр влияет на детерминированность или случайность генерируемых ответов. При более низких значениях алгоритм предпочитает наиболее вероятные токены, что обеспечивает точность и краткость, идеально подходящие для фактических ответов. При повышении температуры выбор становится более случайным, что способствует разнообразию и творческим идеям, например, при создании стихов;
* repeat_penalty - количество повторений слов в ответе.

- ''Использовать данный шаблон по умолчанию'' – если активировать эту опцию, шаблон будет применяться автоматически в зависимости от типа (например, в QAS для запросов к документам или в SPR для суммаризации).

'''2. Добавление нового шаблона'''

1. Нажмите кнопку '''«Добавить»''' внизу вкладки.

2. Заполните поля:

- ''Название шаблона''

- ''Тип шаблона'' (выберите из выпадающего списка)

- ''Текст шаблона'' (обязательное поле)

- ''Параметры генерации''

3. Нажмите '''«Добавить»''' для сохранения.

'''3. Редактирование и удаление шаблонов'''

- Чтобы изменить шаблон, откройте его, внесите правки и нажмите '''«Сохранить».'''

- Для удаления выберите шаблон и нажмите '''«Удалить»'''. <blockquote>'''Примечание:''' Не забывайте сохранять изменения после редактирования шаблонов.</blockquote>
[[Файл:2025-07-04 17-05-52.png|мини|''Рис. 19. Рабочая область вкладки «Интерактив».'']]

==== Вкладка «Интерактив» ====

Вкладка '''«Интерактив»''' включает в себя три режима:

# режим протоколирования,
# чат,
# очистка текста.
[[Файл:Шаблон.png|мини|''Рис.20. Блок редактирования и просмотра шаблона'']]Чтобы '''переключиться между режимами''', просто нажмите на соответствующие иконки на панели управления. Активный режим выделяется красным контуром вокруг иконки.

'''Режим протоколирования''' [[Файл:Remove-bg.ai 1741353006272.png|безрамки|20x20пкс]] служит для создания протоколов — кратких резюме — на основе стенограмм. Она обладает двумя ключевыми функциями: позволяет создавать шаблоны для протоколов и создавать протоколы.
[[Файл:2025-07-04 17-06-57.png|мини|''Рис. 21. Форма для загрузки файла для протоколирования.'']]
[[Файл:2025-05-21 15-23-39.png|мини|''Рис. 22. Интерфейс вкладки Интерактив в режиме Чат'']]
Слева располагается список всех шаблонов, где вы можете найти подходящий или создать новый. Для добавления нового шаблона необходимо нажать на кнопку '''«Добавить шаблон»''' и заполнить все необходимые поля в появившемся окне: '''указать название шаблона''', а также '''наименования разделов''' и '''описать их содержание'''.
В центральной части экрана, вы можете редактировать шаблон. Здесь вы можете внести изменения и сохранить их, либо удалить, нажав соответствующие кнопки внизу блока (см. рис. 20).

В нижней части экрана вы найдете форму для отправки файла на протоколирование (см. рис. 21). Для загрузки файла воспользуйтесь кнопкой '''«Выберите файл»'''. Справа от поля выбора файла располагается значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении на которую всплывает подсказка с поддерживаемыми типами файлов.

'''[[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|Шаблон запроса к LLM]]''' стоит по умолчанию, в выпадающем списке для этого функционала доступны только шаблоны типа "Суммаризация текста". Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Затем выберите одну из опций использования '''Шаблона протокола''': '''"Использовать"''' или с '''"Не использовать"'''. Справа будет отображаться сгенерированный протокол, его можно будет выгрузить в формате docx или txt (см. раздел. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Интерактив»|Панель управления вкладки «Интерактив»]]). В рабочей области так же есть информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.

'''В режиме «Чат»''' [[Файл:Чат (1).png|безрамки|20x20пкс]] можно в свободной форме пообщаться с LLM-моделью. Есть возможность обращаться к нескольким моделям. Рабочая область показана на рисунке 22. Слева на рисунке есть блок с выбором LLM-модели, "Шаблон запроса к LLM" типа "Чат" и опция «Глубина истории сообщений», которая варьируется в диапазоне [3, 10]. История сообщений в чате сохраняется с ориентиром на глубину.

Функция '''«Размышление*»''' модели

Помимо основного ответа, большая языковая модель предоставляет возможность просмотреть логику своих рассуждений. Эта информация отображается в раскрывающемся блоке «Размышление».

* Назначение: Позволяет понять ход мыслей модели, который привел к конечному ответу.
* Практическое применение: Анализ «Размышления» помогает при необходимости скорректировать исходный запрос (промпт) для получения более точного результата.

*доступна только для больших «думающих» моделей.<blockquote>Внимание: варианты моделей появляются в интерфейсе после того, как администраторы их добавят. </blockquote>
В центре экрана расположен сам чат. Внизу области расположено окно, в которое можно ввести свой запрос и отправить его по клику на кнопку «Отправить» [[Файл:Отправить.png|безрамки|20x20пкс]] . Очистить историю можно воспользовавшись одноименной кнопкой [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]]. Справа от чата блок с «Поиском ответов», подробнее о нем и его параметрах можно прочитать [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].
[[Файл:2025-05-28 16-48-05.png|мини|''Рис. 23 Интерфейс вкладки Интерактив в режиме Очистка чата'']]

'''Режим «Очистка текста»''' [[Файл:Photo 2025-05-21 12-43-53.jpg|безрамки|20x20пкс]] этот инструмент помогает убрать из текста лишнее и сделать его более читабельным. Чтобы воспользоваться функцией, вставьте текст в поле «Чистка текста» (в центре рабочей области) и нажмите кнопку «Очистить». После завершения процесса справа от исходного текста появится очищенный вариант (рис. 23). В него нельзя вносить изменения, но можно скопировать с помощью клавиш Ctrl+C или экспортировать в виде документа [[Файл:Сохранить doc (1).png|безрамки|20x20пкс]] docx или txt на выбор.

===== Панель управления вкладки «Интерактив» =====
{| class="wikitable"
|+
!'''Иконка кнопки'''
!'''Название кнопки'''
!'''Описание'''
|-
|[[Файл:Remove-bg.ai 1741353006272.png|центр|безрамки|40x40пкс]]
|Протоколирование
|Режим протоколирования позволяет создавать протокол на основе стенограмм. Когда режим активен, вокруг появляется красный фон.
|-
|[[Файл:Чат (1).png|центр|безрамки|40x40пкс]]
|Чат
|Режим чата позволяет свободно общаться с LLM-моделью на любые темы. Когда вокруг кнопки появляется красный фон, режим активируется.
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать как документ
|Позволяет экспортировать документ протокола в одном из форматов docx или txt для режимов: протоколирование и очистка текста.
|-
|[[Файл:Меню пользователя new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Совместная работа ===

В QAS допускается работать нескольким пользователям, если они работают в разных категориях.

=== Методика работы с QAS ===

Чтобы начать пользоваться сервисом ответов на вопросы, вам нужно загрузить документацию, ответы на которую вы будете давать пользователям. Определить категорию этих документов. Напоминаем, что файл должен быть максимально ёмким, подробным и кратким подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Добавление файла в список|раздел Добавление файла в список]]. Если в документе используются аббревиатуры или слова с неофициальными ("народными") вариантами написания/произношения, например, «материнский капитал» (маткапитал, маткап и так далее), их следует включить в глоссарий. Глоссарий можно найти в разделе [[QAS. UPS руководство по работе с интерфейсом#Функционал меню «Дополнительно»|«Дополнительно»]] на вкладке «Документы» под текстом документа.

===== <big>Добавление вопросов</big> =====
Если у вас нет готовых вопросов по документации есть два варианта:

# добавлять вопросы и их формулировки вручную,
# запустить генерацию вопросов по документации (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|Панель управления вкладки Документы]]).

После того, как генерация вопросов завершится, необходимо пройти на вкладку Вопросы и проверить вопросы на соответствие документации и адекватность.

Если у вас есть csv файл с фразами-вопросами, то есть возможность загрузить их массово, воспользовавшись кнопкой «Массовая обработка вопросов» на панели управления вкладки Вопросы (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После этого нужно скомпоновать по смыслу вопросы и почистить ненужные.

===== <big>Добавление ответов</big> =====
После того как вопросы будут загружены в базу вопросов QAS. Можно запустить генерацию ответов (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После ее завершения нужно проверить правильность и соответствие ответов вопросу, если ответ вас устраивает — поставьте галочку «Проверено». Либо отредактируйте ответ и так же отметьте его проверенным. Так же можно самостоятельно добавить ответы на вопроса из документации. А так же есть возможность запустить перефразирование уже проверенных ответов, что поможет немного расширить вариации ответов.

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

''Пример корректного ответа и нет:''
{| class="wikitable"
|+
!'''Вопрос'''
!'''Ответ, который потенциально приведет к ошибке'''
!'''Ответ, который НЕ приведет к ошибке'''
|-
|Реабилитационный сертификат
|'''По данному вопросу''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|По вопросу '''оформления реабилитационного сертификата''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|}

===== <big>Работа с кэшем вопросов</big> =====
После того как вы создадите базу вопросов и ответов, можно приступить к проверке работы кэша. В разделе «Кэш» вы найдёте блок для поиска ответа. В поле «Текст» введите свой вопрос, который может быть похож на уже существующие и на которые может ответить ваша загруженная документация. Установите необходимые настройки поиска, подробности можно найти [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].

Далее возможны различные варианты развития событий:

* Если ''вопрос не похож'' ни на один из уже имеющихся в базе данных, и активирован флаг «Использовать генерацию», система сгенерирует ответ на основе документации (если в ней есть ответ на этот вопрос). А сам вопрос будет добавлен в список основных (при условии, что активна галка «кэширование формулировки»). Если функция генерации отключена, в ответ на вопрос будет указано «Информация не найдена». Сам вопрос будет отображаться в общем списке вопросов как основной, для работы с ним и с подобными нужно отфильтровать по «Пустым ответам».
* Если система ''обнаружит сходство с каким-либо вопросом из базы данных'', новый вопрос будет добавлен в список кандидатов к этому вопросу. Если кандидат попадет в верный вопрос его нужно будет утвердить (перенести в формулировки). Вы сможете найти его местоположение, перейдя в режим «Утверждение кандидатов» и отфильтровав одноименную колонку с помощью формулировки вашего запроса в поле «вопрос». Подробности о работе с кандидатами [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|тут]]'''<big>.</big>'''
* Если в базе данных уже ''есть похожий запрос'', но ''система не может найти его'' и генерирует новый ответ на ваш запрос, то решить эту проблему можно, добавив ваш новый вопрос как основной запрос. Поскольку, если система не считает похожим ни на один вопрос, то лучше добавить его как отдельный вопрос со своим ответом.
* Склейки (несколько вопросов разделенные «|») попадают в QAS, но не оседают там, даже если включена галочка «кэширование формулировок».

===== <big>Запуск в прод</big> =====
При массовом обращении к системе, например, на проде удобнее всего с новыми запросами работать через отчет по [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|кандидатам]]. С его помощью можно увидеть, в какие категории и в какие вопросы поступают новые запросы, и сразу же внести изменения — поменять категорию или утвердить кандидатов. А также увидеть, каким запросам не присвоилась категория вообще.

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

2025-12-24T10:06:51Z

E.Elagina: /* Главное меню */

=== Главное меню ===
[[Файл:QAS.png|мини|''Рис. 1 Главный экран UPS'']]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# QAS ЧаВО,
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]]
# Выход.
Переключаться между продуктами можно двумя способами:

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]] .
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).

Перейти в раздел '''«ЧаВО»''' (QAS) можно кликнув по соответствующей кнопке на главном экране UPS (см.рис. 1).

=== Описание интерфейса сервиса «ЧаВО» (QAS) ===
Рабочая область сервиса «ЧаВО» (QAS) (сервиса ответов на вопросы) включает в себя следующие блоки:
*панель управления;
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Документы»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Кэш»|«Кэш»]]''';
*вкладка '''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Интерактив»|«Интерактив»]];'''
*вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области;
*вкладка '''«Категории»''' содержит список всех созданных категорий, можно как редактировать уже существующие, так и добавлять новые. Есть фильтрация по названию. Доступен ''экспорт''[[Файл:2025-12-10 11-22-58 (1).png|безрамки|28x28пкс]] и ''импорт'' [[Файл:2025-12-10 11-23-23 (1).png|безрамки|30x30пкс]] категории, для переноса на другой сервер; А так же ''удаление'' категории.
<blockquote>'''ВНИМАНИЕ: удаление категории''' происходит '''со всеми документами и вопросами,''' система сообщит об этом.</blockquote><blockquote>'''Как работает импорт:'''
* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.

'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>

==== Вкладка «Документы» ====
[[Файл:Photo 2025-05-21 12-43-54.jpg|мини|''Рис. 2 Рабочая область сервиса «ЧаВО»'']]Во вкладке «Документы» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 2):

* панель управления;
* блок со списком документов содержит поиск по названию и фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Спрятать боковую панель''' между списком документов и блоком для редактирования (появляется при наведении мыши на середину между блоками);
* добавление нового документа в базу;
[[Файл:Photo 2025-05-21 12-43-54 (2).jpg|мини|''Рис. 3 Пример отработки кнопки «Очистить текст»'']]
*блок '''«Редактирование документа»''' с полями: «Название», «Дополнительно» и текстом выбранного файла, который можно редактировать. Можно переименовывать файл, после чего нужно сохранить изменения. Кнопка сохранения становится активной как только будут внесены изменения. Чтобы сделать текст более читабельным, его можно очистить от лишнего. Для этого нажмите кнопку '''«Очистить текст»''', которая находится под основным блоком слева от '''«Сохранить»''', предварительно выбрав шаблон запроса, если требуется. Или воспользуйтесь кнопкой на [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|панели управления]] [[Файл:2025-10-08 15-19-11 (1).png|безрамки|20x20пкс]].
<blockquote>'''Важно:''' при уже запущенном процессе очистки кнопка остановит текущий процесс отчистки.</blockquote>После завершения очистки справа появится окно с изменениями. Кнопка, открывающая данные по очистке позволяет просмотреть так же:

* Прогресс выполнения (%)
* Позицию в очереди (правило '''«один аккаунт — одна операция очистки»''')
* Результаты обработки. Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''

Вы сможете сравнить исходный и очищенный текст. Если нужно внести правки, их можно сделать прямо в блоке с очищенным документом. После проверки и внесения правок, если все устраивает, нажмите '''«Заменить в документе»''' под блоком с очищенным текстом. Изменения вступят в силу. ''Не забудьте сохранить документ.'' Рядом с этой кнопкой есть '''«Закрыть»'''. Она закрывает окно с очищенным текстом без сохранения изменений.
<blockquote>Для очистки текста, ''который не загружен в базу данных'' QAS, используйте режим «Очистка текста» на вкладке «Интерактивный режим».</blockquote>
*блок поиска фрагментов по базе.

[[Файл:2025-10-08 15-24-58.png|мини|''Рис.4. Добавление нового файла'']]

===== Добавление файла в список =====
В нижней части блока со списком файлов есть кнопка '''«Добавить файл»'''. Если нажать на нее, то появится диалоговое окно, как показано на рисунке 4. Чтобы добавить файл, нужно заполнить все необходимые поля и выбрать нужный файл с компьютера, в кодировке '''Unicode UTF-8'''.

Поддерживаемые '''форматы''':

* .odt
* .docx
* .doc
* .rtf
* .ods
* .xlsx
* .xls
* .pdf
* .txt.

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

===== Функционал меню «Дополнительно» =====
[[Файл:2025-05-23 17-11-07.png|мини|''Рис. 5 Иллюстрация функций кнопки Дополнительно'']]
На вкладке дополнительно вы можете посмотреть:

* категорию к которой относиться документ,
* глоссарий, в котором укажите название объекта из документа (рис. 5), а также его синоним в соответствующих полях внизу страницы. Это поможет модели лучше понимать, о чём её спрашивают. Например, научить ее тому, что «госпошлина = пошлина», «загранник = загранпаспорту», «загранпаспорт = заграничному паспорту», а «загранпаспорт нового образца = загранпаспорту на 10 лет» и нажмите кнопку добавить.
<blockquote>Поиск в базе работает '''на основе векторного анализа текста'''. Чтобы система точнее находила нужные документы, важно выделить ключевые термины и создать глоссарий.

Как это сделать:

# Внимательно изучите документ.
# Выпишите основные термины и их возможные синонимы.
# Внесите их в глоссарий в формате: ''основной термин = синоним''.

Пример:

Если в документе слово ''«апостиль»'' иногда называют «''услугой»,'' укажите в глоссарий:

<code>апостиль = услуга</code>.</blockquote>Предусмотрено массовое удаление синонимов, для этого выделите нужное галочками. Кликнув на поле с фразами вы можете отредактировать формулировку. После внесения изменений нажмите кнопку '''«Сохранить»'''. Она станет активной сразу же после того, как вы внесете какие-либо изменения в документ. Эта кнопка является дубликатом кнопки '''«Сохранить»''' в блоке редактирования документа.
* есть кнопка для экспорта глоссария, если это необходимо в формате .csv.
* а так же доступен импорт с тремя опциями: дополнить, заменить и отменить импорт.
* здесь же находится кнопка для удаления документа.

===== Поиск фрагментов в документах =====
Поиск фрагментов — это первый этап для ответа на вопрос. Система сначала ищет фрагмент (фрагменты) в документах, после отправляет их вместе с промптом на модель генерации.

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

===== Панель управления вкладки «Документы» =====
В верхней части экрана располагается панель управления, на которой находятся кнопки: ''генерация ответов, экспорт документов, очистка документа, массовая обработка вопросов, задать вопрос'' и ''меню пользователя.''
{| class="wikitable"
|+''Табл. 1 Описание функционала панели управления.''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать документ
|Позволяет экспортировать документ в одном из форматов .docx или .txt
|-
|[[Файл:2025-10-08 15-19-11 (1).png|центр|безрамки|40x40пкс]]
|Очистка документа
|При нажатии на кнопку открывается диалоговое окно, в котором необходимо:

# Выбрать модель генерации — укажите модель ИИ для обработки текста
# Выбрать шаблон очистки — определите параметры форматирования текста

<blockquote>'''Важно!''' Очистка будет применена к текущему активному документу.

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

Действует правило '''«один аккаунт — одна операция очистки».'''</blockquote>После запуска кнопка меняется на ''«Остановить очистку документа»,'' по нажатию на нее запущенная вами очистка завершается.

Посмотреть прогресс очистки можно нажав на кнопку ''[[QAS. UPS руководство по работе с интерфейсом#Вкладка «Документы»|«Очистка текста»]]'' под документом.

Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация вопросов
|эта кнопка предназначена для генерации вопросов. По нажатию на кнопку появляется диалоговое окно, в котором требуется выбрать:

* категорию вопросов для генерации;
* если не нужно генерировать вопросы для всех документов, выберите нужный,
* выберите канал,
* выберете модель генерации (по умолчанию используется default), другие модели будут отображаться в списке только после того, как администратор добавит их,
* выберите шаблон запроса к LLM (по умолчанию используется шаблон "из коробки" типа "Генератор вопросов по тексту"),
* запустите генерацию.
Генерация вопросов запускается ''для каждой'' категории ''отдельно''.
<blockquote>'''''Совет''': генерацию лучше запускать в нерабочее время, так как она может занять много времени.'' Для удобства отслеживания на иконке отображается прогресс генерации.</blockquote>Есть возможность включить или отключить опцию ''генерации ответов'' сразу для документа. Для случаев, когда добавился новый документ в категорию и нет под него ВОП из «живых» фраз.

<blockquote>'''''Совет''''': если есть возможность использовать «живые» фразы людей, то всегда лучше брать их, а не генерировать синтетические вопросы.</blockquote>
|-
|[[Файл:2024-07-08 22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка документов
|позволяет сделать массовую замену текста в документах. В диалоговом окне нужно выбрать категорию, искомый текст и текст замены.
|-
|[[Файл:Задать_вопрос_нов.png|центр|безрамки|40x40пкс]]
|Задать вопрос1
|генерирует ответ на вопрос на основе информации, содержащейся в одном или нескольких документах.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы, шаблоны)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:Ask.png|мини|Рис. 6 Блок «Задать вопрос»|589x589пкс]]
1 По нажатию на кнопку '''«Задать вопрос»''' (рис. 6), появляется диалоговое окно с полями:

'''«Вопрос»''' — это область для ввода вопроса.

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

'''«Канал»''' - список созданных каналов связей.

'''«Модель генерации»''' - список доступных моделей

'''«Шаблон запроса к LLM»''' - шаблон запроса (промпт) к модели генерации.

'''«Использовать кэш ответов»''' - в этом меню можно выбрать, использовать ли только проверенные ответы или любые.

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

===== Добавление новых и редактирование вопросов =====

''Вопросы в QAS могут быть трех видов:''

'''Кандидаты''' — это новые запросы к системе, которые, по мнению самой системы, являются семантически близкими к основному вопросу и его формулировкам. Чтобы перевести кандидата в формулировки, нужно ''утвердить'' их (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|разд. Режим работы "Утверждение кандидатов"]])

'''Формулировки (алиасы)''' — это различные варианты одного и того же вопроса. Этот список станет основой для системы при поступлении новых запросов. Она будет использовать его, чтобы определить, в кандидаты к какому основному вопросу стоит отнести новый.

'''Основной вопрос''' — это новый вопрос, который ранее не существовал в базе данных QAS, а также не имел семантически близких аналогов. Каждому основному вопросу присваивается категория. Он может включать дополнительные формулировки и кандидатов.

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

* категорию вопроса;

* текст вопроса.

Чтобы ''отредактировать'' уже существующий вопрос, нужно выбрать его из списка. После этого его текст и ответы появятся в блоке для редактирования, который находится в середине страницы. Если вопрос слишком длинный и не помещается в одну строку, просто нажмите на него, и он будет развёрнут. [[Файл:2024-10-14 15-55-53.png|мини|''Рис. 8 Интерфейс вкладки «Дополнительно»'']]

Меню '''«Дополнительно»''' включает в себя следующие опции:

- изменение формулировки основного вопроса,

- изменение категории вопроса (перенос в другую категорию) осуществляется путём выбора из списка доступных категорий, расположенного в верхней части окна (рис. 8). Вопрос будет перенесен без потерь со всеми ответами, кандидатами и формулировками.

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

Поэтому мы создаём короткие вопросы, помечаем их как «неполные» и добавляем уточняющие вопросы в ответ. Например: «Уточните, пожалуйста, что именно вы хотите узнать по поводу детского сада?» Получив такой вопрос, абонент должен будет уточнить свои потребности, а затем робот объединит оба запроса и выдаст ответ, если он есть в базе данных QAS.</blockquote>- добавление, удаление или перенос. Чтобы удалить формулировку, необходимо навести курсор на нужную фразу. После этого справа появятся две кнопки (см. рис. 8). Одна из них в виде ''стрелочки'' предназначена для того, чтобы сделать эту формулировку ''основным вопросом''. А кнопка в виде ''корзинки'' позволяет удалить выбранную фразу. Есть возможность удалять несколько формулировок, для этого нужно выбрать формулировки для удаления и нажать на кнопку ''Удалить,'' рядом с кнопкой ''Переместить.'' <blockquote>При удалении основного вопроса на вкладке ''Дополнительно'', сначала нужно переназначить основным вопросом другую формулировку и после этого удалить. </blockquote>- есть возможность переместить формулировки и/или кандидатов в другой вопрос. Для этого поставьте галочку напротив нужной фразы и нажмите кнопку «Переместить». В появившемся диалоговом окне выберите нужный вопрос (вы можете предварительно отфильтровать вопросы по категориям). Выберите, из выпадающего списка куда следует переместить выбранные вопросы: в формулировки или в список кандидатов, — и нажмите кнопку «Переместить». После этого '''обязательно''' сохраните изменения в текущем вопросе. <blockquote>'''Обращаем ваше внимание,''' что если вы указываете, что перемещение должно быть выполнено в кандидаты, то вам необходимо будет затем перейти и ''утвердить'' кандидата.</blockquote>- так же вы можете ознакомиться со списком ''кандидатов'', который включает формулировки, близкие по смыслу к основному вопросу. Если среди них есть подходящие варианты, отметьте их галочкой и нажмите кнопку «Утвердить». После этого выбранные формулировки появятся в общем списке «Формулировки». ''Добавление большого количества разных формулировок необходимо, чтобы модель могла понимать суть вопроса, независимо от того, как его сформулирует человек, и выдавать один и тот же ответ на разные варианты этого вопроса.''

- ''удаление'' вопроса из базы на вкладке «Дополнительно» внизу будет кнопка ''Удалить вопрос полностью''.

'''Внимание:''' ''Нажимая на кнопку '''Удалить вопрос полностью''' в меню Дополнительно, вы удаляете весь вопрос, включая формулировки, ответы на него из всех каналов и всех кандидатов.''

- после того как вы внесете изменения, кнопка «Сохранить» станет активной в меню «Дополнительно» и на панели для редактирования ответов.

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

Каждый вопрос сопровождается флажком '''«Проверено»''', который отмечает ответы, проверенные пользователем. При наведении курсора мыши на ответ, вместо канала к которому принадлежит вопрос, появляются кнопки:

* копировать в канал, с ее помощью можно продублировать ответ для любого доступного канала;
* переместить в канал, перемещает ответ с текущего канала на другой выбранный пользователем канал;
* удалить ответ.
Также вы можете добавить новый вопрос в список, воспользовавшись функцией поиска ответа на вкладке '''«Кэш»''' с включенным флажком '''«Использовать генерацию»''' или задав новый вопрос по документам на вкладке '''«Документы»,''' так же выбрав опцию '''«Использовать генерацию»'''. Если похожего вопроса раньше не было, то он появится в списке на вкладке «Вопросы». Вы сможете редактировать и изменять его по своему усмотрению. В случае, если похожий вопрос уже встречался, система предложит его как кандидата к похожему вопросу. Это значит, что его нужно будет перенести в формулировки (утвердить) и сохранить изменения.

===== Поиск по вопросам и ответам. Фильтрация =====
[[Файл:2024-08-06 16-23-15.png|мини|''Рис. 9 Иллюстрация поиска по вопросам'']]
В разделе '''«Кэш»''' есть три вида поиска:

# поиск по вопросам и их формулировкам, в том числе и кандидатам;
# поиск по ответам.
# поиск по категории

А так же два вида фильтрации:

# по содержанию ответов: ''Все'', ''Проверенные'', ''Непроверенные'', ''Пустые.''
# по полноте вопроса: ''Все, Полный, Неполный.'' К полным вопросам относятся вопросы с конкретикой. К неполным - короткие вопросы без конкретики.

[[Файл:2024-08-06 16-38-29.png|мини|''Рис. 10 Иллюстрация поиска по ответам'']]С помощью '''поиска по вопросам и их формулировкам''' можно найти все вопросы или вопросы в определённой категории, которые содержат определённое слово или фразу в своей формулировке. Поиск работает как для основного вопроса, так и для дополнительных формулировок. <blockquote>Например, на рисунке 9 в категории «Водительские права» мы ищем все вопросы, в которых есть сочетание букв «''замена''». Если открыть меню, внизу экрана, ''«Дополнительно»'', то можно увидеть, что это сочетание используется в альтернативных формулировках вопроса, найденные сочетания подсвечиваются. </blockquote>Обращаем внимание, что если в основном вопросе нет искомого слова или сочетания букв, то система все равно выведет вопрос, если найдет совпадения в альтернативных формулировках. [[Файл:2024-08-06 16-24-00.png|мини|''Рис. 11 Результат работы двух видов поиска одновременно'']]
Предусмотрен ''поиск по ответам'', в поле '''«Ответ»''' можно ввести слово или фразу и система подсветит поля ответов, где искомое сочетание было найдено (рис. 10). По умолчанию канал связи стоит в положении «не выбран» и выводятся ''все'' ответы ''из всех каналов'', где найдено слово или фраза. Можно принудительно выбрать канал из списка, тогда отобразятся ответы выбранного канала и будут подсвечены те ответы, где найден искомый текст. Область ответа с искомым текстом будет подсвечена бледно-голубым (рис. 10). Можно одновременно использовать два вида поиска. В результате будут отображены вопросы, в которых присутствует искомое значение – как в вопросах, так и в ответах (рис. 11).

===== Поиск ответа =====
[[Файл:2025-07-04 15-31-58.png|мини|''Рис. 12 Интерфейс блока «Поиск ответов»'']]
Блок '''«Поиск ответа»''' (рис. 12) работает так же, как кнопка '''«Задать вопрос»''' на вкладке '''«Документы»'''. <blockquote>Важно отметить, что поиск ответа происходит в два этапа:

# поиск нужных фрагментов из документов в категории,
# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.
</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов.

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

'''«Шаблон запроса к LLM»:''' здесь вы можете выбрать, какой промпт отправить на генеративную модель вместе с найденными фрагментами и вопросом. Если промпт не выбран, LLM будет использовать стандартный запрос. Подробнее о шаблонах запросов [[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|тут]]. <blockquote>'''Для чего это нужно?'''

Если стандартный промпт не работает так, как нужно для конкретной категории, или требуется что-то особенное, можно создать новый шаблон. Это делается без изменения стандартного промпта. </blockquote>Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Меню '''«Использовать кэш»'''. В этом меню можно выбрать, использовать ли только проверенные ответы или любые. Кэш-память позволяет сервису быстрее отвечать на запросы пользователей. А опция '''«Только проверенные ответы»''' гарантирует, что ответы, которые получает пользователь, были отредактированы и проверены оператором.

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

Аналогично вкладке «Документы», вы можете настроить '''количество документов''', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.

===== Функционал режима «Проверка новых вопросов» =====
Режим «Проверка новых вопросов» содержит перечень всех новых вопросов. В рабочей области находится таблица, в которой представлен список новых вопросов, ответы на них, категория, присвоенная этим вопросам, а также дата создания вопроса. Есть возможность фильтрации по каждой из колонок (рис. 13).
[[Файл:New questions mode.png|мини|''Рис.13. Интерфейс режима утверждения новых вопросов'']]
При наведении на любую строку слева появляются иконка и чекбокс:
# [[Файл:Circle-check-solid.png|безрамки|22x22пкс]] Утвердить — позволяет утвердить ответ на текущий вопрос. Это означает, что ответ и категория соответствует вопросу. После утверждения вопрос пропадет из таблицы и получит статус '''«Проверено».'''
# [[Файл:Checkbox.png|безрамки|25x25пкс]] Чекбокс — позволяет выбрать несколько позиций таблицы для утверждения или удаления. Утверждение означает, что у всех выбранных позиций ответ и категория соответствует вопросу. Для утверждения всех выбранных позиций необходимо нажать кнопку «Утвердить», внизу таблицы, в правом нижнем углу. Для удаления — на значок ''корзинки'' (п. 5 списка ниже), так же в нижнем углу.
В «подвале» таблицы расположены следующие функциональные элементы:

# [[Файл:Expand.png|безрамки|20x20пкс]] Развернуть — разворачивает таблицу и входит в полноэкранный режим.
# [[Файл:Compress.png|безрамки|23x23пкс]] Свернуть — выходит из полноэкранного режима и возвращает таблицу в исходное состояние.
# [[Файл:Approve changes mode.png|безрамки|187x187пкс]] — позволяет переключаться между состояниями режима '''«Подтверждения изменений».''' При включенном режиме при каждом массовом утверждении ответов на вопросы будет появляться диалоговое окно, которое будет запрашивать подтверждение текущих изменений.
# Кнопка '''«Утвердить»''' — позволяет утвердить все выбранные на данный момент ответы на вопросы. Кнопка не активна, пока не выбрана ни одна позиция в таблице.
# [[Файл:Delete icon.png|безрамки|22x22пкс]] — позволяет удалить все выбранные на данный момент ответы на вопросы. При включенном режиме '''«Подтверждения изменений»''' при удалении запросит подтверждение в диалоговом окне.
[[Файл:New questions mode changed.png|мини|''Рис.13.1. Работа в режиме утверждения новых вопросов'']]Данный режим позволяет как точено, так и массово проверять ответы и категорию на соответствие вопросу.
В таблице реализована возможность самостоятельной правки вопросов/ответов/категорий. Для этого надо кликнуть на интересующую вас ячейку и внести правки. Сразу после изменений в верхней правой части ячейки появится иконка для отката изменений [[Файл:Undo.png|безрамки|24x24пкс]] на '''начальное''' состояние. Если в строке произошли какие-то изменения, то ''строка автоматически переходит в состояние выбранной'' (рис. 13.1).

В таблице реализована клавиатурная доступность, которая позволяет перемещаться между ячейками и утверждать выбранные позиции в таблице. Для этого используются следующие комбинации клавиш: Ctrl + ⬆/⬇/⬅/➡/Enter.

===== Функционал режима «Утверждение кандидатов» =====
[[Файл:Рис. 13 Интерфейс режима Утверждения кандидатов.png|мини|''Рис. 14. Интерфейс режима Утверждения кандидатов'']]
Режим «Утверждение кандидатов» содержит перечень всех кандидатов. В рабочей области находится таблица, в которой представлен список кандидатов, перечень основных вопросов, где эти кандидаты находятся, а также категория, присвоенная этим вопросам (рис. 14).

При наведении на любую строку слева появляются две иконки:
# [[Файл:Сделать основным без фона.png|безрамки|26x26px]] Сделать основным — позволяет сделать кандидата основным вопросом. По нажатию на эту кнопку появляется диалоговое окно, где требуется подтвердить намерение сделать кандидата основным вопросом. В форме подтверждения нужно выбрать категорию, в которую хотели бы добавить вопрос и аналогично функционалу добавить новый вопрос (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|Добавление новых и редактирование вопросов]]).
# [[Файл:Утвердить.png|безрамки|26x26px]] Утвердить — позволяет утвердить кандидата, в текущем вопросе, включая её в формулировку вопроса. Это означает, что кандидат подходит по смыслу к основному вопросу и его формулировкам.[[Файл:Рис 14. Работа в режиме Утверждение кандидатов.jpg|мини|''Рис.14.1. Работа в режиме Утверждение кандидатов'']]

Чтобы утвердить сразу несколько кандидатов, отметьте их галочками. После этого внизу появится строка с выпадающим списком всех основных вопросов из базы данных QAS.

По умолчанию система предлагает утвердить выбранного кандидата или кандидатов в текущем вопросе. Однако если вы хотите перенести его в другой вопрос, просто начните вводить его название в поле поиска. Затем нажмите кнопку «Утвердить», расположенную в правом нижнем углу (рис. 14.1).

Если вы хотите ''удалить'' кандидата или кандидатов, выделите их и нажмите на иконку «Корзинка», которая находится над кнопкой «Утвердить».

===== Функционал режима «Поиск несоответствий» =====

Режим "Поиска несоответствий кэша ответов и документов" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Несоответствия"''''' и '''''"Ошибки"''.''' Чтобы запустить поиск несоответствий, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

[[Файл:Поиск несоответствий 1.png|мини|''Рис.15. Работа в режиме Поиска несоответствий. Вкладка несоответствий'']]
При активном табе '''"Несоответствия"''' показана таблица результатов поиска для работы с найденными ответами из кэша, которые не соответствуют фрагменту документа (рис.15). Таблица разделена на 4 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''фрагмент из документа'', по которому был дан текущий ответ,
* ''исправленный ответ'', на который предлагается заменить текущий.

Проанализировав предложенные ответы в столбце ''"Исправленный ответ"'', можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены предложенных ответов на ответы из кэша необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

[[Файл:Поиск несоответствий 2.png|мини|''Рис.15.1. Работа в режиме Поиска несоответствий. Вкладка Ошибок'']]
При активном табе '''"Ошибки"''' показана таблица результатов поиска для работы с найденными ответами из кэша, по которым были выявлены ошибки, например, отсутствие информации (рис.15.1). Таблица разделена на 3 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''ошибка'' поиска''.''

Здесь можно скорректировать ответ из кэша, при необходимости (в ячейке таблицы), или удалить запись (строку). Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены исправленных ответов необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

===== Функционал режима «Векторный поиск» =====
[[Файл:Векторный поиск.png|мини|''Рис.16. Работа в режиме Векторного поиска'']]
Режим "Векторного поиска" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Документы"''''' и '''''"Ответы"''''' (рис.16). Он предназначен для поиска и замены ответов и фраз в документах, векторно похожих на текст запроса. Чтобы запустить векторный поиск, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

После окончания поиска будет отображена таблица, которая разделена на 3 столбца:
* ''документ / вопрос'' (в зависимости от выбранного таба),
* ''фраза / ответ'' (в зависимости от выбранного таба),
* ''сходство'', в процентах.
Проанализировав найденные фразы/ответы, можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].
[[Файл:Векторный поиск 2.png|мини|''Рис.16.1. Замена информации в режиме векторного поиска'']]

Затем слева от таблицы заполняем форму для того, чтобы модель генерации предложила варианты замены информации (фразы или ответа). Для этого заполняем недостающие поля: ''Текст замены'' и опционально ''Модель генерации'' (по умолчанию default) и ''Шаблон запроса к LLM'' типа "Векторная замена информации". После нажатия на кнопку ''"Показать варианты замены"'' запустится процесс подготовки предложений по замене информации: появится четвертый столбец ''"Измененная фраза" / "Измененный ответ"'' и в ней по очереди построчно будут заполнятся фразы/ответы (рис. 16.1).

После окончания обработки можно отредактировать или удалить предложенные варианты замены, выделить нужные и нажать внизу таблицы кнопку ''"Заменить фразы"'' / ''"Заменить ответы"'' для замены фраз в документе/ответов соответственно.

===== Панель управления вкладки «Кэш» =====
{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления вкладки «Кэш»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:2024-07-08_22-41-00_(1).png|центр|безрамки|40x40пкс]]
|Выбрать вопросы
|При нажатии на эту кнопку активируется режим, в котором можно выбрать несколько вопросов из списка для последующего перемещения или удаления. Сама кнопка подсвечивается красным контуром, показывая, что она активна. Нажав на неё повторно, можно выключить режим и сбросить выбор. После того как вы отметили галочками вопросы, справа от кнопки появляется опции «Переместить вопросы» [[Файл:Копировать.png|безрамки|20x20px]] и «Удалить выбранные вопросы»[[Файл:2024-07-08 22-55-51-no-bg-preview (carve.photos).png|безрамки|20x20px]].
Если вы собираетесь переместить вопросы, но в них уже есть проверенные ответы или кандидаты, в диалоговом окне появится соответствующее предупреждение. При этом перемещаться они не будут. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-35.png|центр|безрамки|40x40пкс]]
|Экспорт вопросов
|Эта кнопка позволяет экспортировать вопросы в формате CSV для классификатора или для отчета.
Структура файла для классификатора выглядит следующим образом: ''Категория'' ⇥ ''Вопрос.''
Структура файла отчетности: ''Категория⇥ Вопрос⇥ Обозначение вопроса(основной/алиас/кандидат).'' Эта кнопка доступна только в режиме '''«Подробный».'''
|-
|[[Файл:Автосохранение_(1).png|центр|безрамки|40x40пкс]]
|Автосохранение
|Позволяет включить автосохранение. При включенном (вокруг кнопки появляется красный контур) режиме будет сохраняться через 10 секунд после изменения данных. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Обновить_данные_вопроса.png|центр|безрамки|40x40пкс]]
|Обновить данные вопроса
|С помощью этой кнопки можно обновить данные текущего вопроса, например, после генерации ответов. По нажатию на кнопку обновятся все ответы, которые система сгенерировала на этот вопрос. Генерация ответов происходит для разных каналов связи. Вы можете просмотреть их, выбрав нужный канал в меню рядом с основным вопросом. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Answer_gen_(1).png|центр|безрамки|40x40пкс]]
|Генерация ответов
|эта кнопка предназначена для генерации ответов. По нажатию на кнопку появляется диалоговое окно, в котором требуется:

* ввести желаемое количество ''ответов'',
* выбрать ''категорию'', для которой требуется генерация,
* выбрать ''канал'',
* выбрать ''режим генерации'': по документам или перефразирование проверенных,
* указать, для каких вопросов нужно сгенерировать ответы: для всех или только для пустых,
* далее выбрать, следует ли заменить существующие ответы. Если «да», то ответы будут заменены на новые. Если «нет», то они будут дополнены новыми вариантами,
* указать модель генерации (по умолчанию используется default). Другие модели будут отображаться в списке только после того, как администратор добавит их,
* и наконец, указать ''количество документов [1,10]'', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.
* и нажать на кнопку «Запуск».

Генерация может занимать достаточно продолжительное время. Помимо канала по умолчанию, ответы генерируются и для других каналов, после окончания обновите данные вопроса и просмотрите все существующие каналы.<blockquote>'''''Совет:''''' ''лучше использовать сначала режим генерации ответов по документам, после чего проверить их правильность и запускать генерацию в режиме перефразирования ответов. Также перед тем, как сгенерировать ответы, обновите страницу.'' </blockquote>Убедитесь, что предыдущая генерация ответов закончена, иначе кнопка не сработает, и вам нужно будет либо остановить предыдущую генерацию, либо подождать, пока она завершится. Для удобства отслеживания на иконке отображается прогресс генерации. Иконка выглядит так [[Файл:Иконка генерации.png|безрамки|20x20px]], если генерация запущена. При наведении на нее она меняется на ''Остановить генерацию ответов'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить генерацию. Все ответы, которые успели сгенерироваться, останутся. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:2024-07-08_22-41-58.png|центр|безрамки|40x40пкс]]
|Массовая обработка вопросов
|Нажав на кнопку, появится меню с двумя разделами: '''«Загрузка»''' и '''«Замена».'''
''Функционал раздела '''«Замена».'''''

Этот раздел позволяет заменить определенный текст в ответах на вопросы. Для этого необходимо заполнить следующие поля:

* категория
* искомый текст в ответах
* замена
* и нажать запуск.
''Функционал раздела '''«Загрузка».'''''Этот раздел предназначен для обработки множества вопросов (в режиме '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]) или пар вопрос-ответ (в '''JSON'''-режиме [[Файл:JSON.png|безрамки|80x80пкс]]).

Режим '''Текст''' [[Файл:Текст.png|безрамки|80x80пкс]]'''.'''

Для массовой обработки вопросов в режиме Текст требуется выбрать:

* файл с вопросами в формате .csv,
* выбрать категорию, к которой относятся вопросы из файла,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Любые ответы'',
* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и если не активирован флаг «Использовать генерацию», функция работать не будет.). Другие модели будут отображаться в списке только после того, как администратор добавит их.
* укажите ''количество документов [1, 10]'', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Для случаев с генерацией ответов.<blockquote>Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.</blockquote>
* а также активировать только флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]''). Можно активировать остальные флаги для случаев, когда нужно помимо обработки нужно ''еще и сгенерировать ответы.''
* а так же активировать опцию «Установить порог похожести,%». Если вы активируете её, то сможете выбрать значение по умолчанию — 90% или задать своё собственное.<blockquote>'''Важно:''' в файле могут быть вопросы '''только''' по одной тематике.</blockquote>Обработка вопросов осуществляется по следующей схеме: каждый новый вопрос сравнивается с предыдущими (и формулировками). Если обнаруживается вопрос, который кажется схожим по смыслу, то новый вопрос включается в список его возможных кандидатов. Если же не находится вопроса, который имеет семантическую близость с новым, то новый становится основным.<blockquote>'''''Совет:''' д''ля массовой обработки вопросов без генерации ответов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Любые ответы».</blockquote>Режим '''JSON'''[[Файл:JSON.png|безрамки|80x80пкс]].

Чтобы массово обрабатывать пары вопрос-ответ, переключитесь в режим JSON и заполните следующие поля:

* файл с вопросами в формате .json.

<blockquote>Формат json-файла для загрузки в интерфейс:

[

[ "вопрос2", "ответ 2" ],

[ "вопрос1", "ответ 1" ]

]</blockquote>

* выбрать категорию, к которой относятся пары вопрос-ответ в файле,
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Не использовать'',
* оставьте параметр «Количество документов» в значении по умолчанию — 1.
* автоматически ставится флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]'').
* порог схожести и устанавливается на 98% без возможности редактирования.

Этот функционал позволяет создать основную базу. После того как пары вопросов и ответов будут добавлены, можно будет [https://wiki.connect2ai.net/index.php#Добавление_новых_и_редактирование_вопросов добавлять формулировки в вопросы]. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Лупа.png|центр|безрамки|50x50пкс]]
|Поиск несоответствий кэша ответов и документов / Векторный поиск
|Позволяет запустить поиск разного вида в зависимости от выбранного режима: '''«Поиск несоответствий»''' или '''«Векторный поиск»'''.

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

''1. "Вопрос по документации",''

''2.'' "Поиск несоответствий информации".

Поиск может занимать достаточно продолжительное время. Для удобства отслеживания на иконке отображается прогресс поиска. При наведении на нее она меняется на ''"Остановить поиск несоответствий кэша ответов и документов"'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить поиск.

В режиме '''«Векторный поиск»''' при нажатии на кнопку появляется форма для поиска фрагментов, векторно похожих на фразу запроса. Для запуска в ней нужно указать ''Текст'' запроса, ''Категорию'' поиска и ''Порог схожести''. Далее будет выведена таблица с данными поиска с разделением на документы и ответы.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

[[Файл:Шаблоны запросов.png|мини|''Рис. 17. Интерфейс вкладки Шаблоны запросов'']]

===== Функционал вкладки «Шаблоны запросов» =====

Данный раздел позволяет управлять шаблонами промптов: создавать, редактировать, удалять и настраивать их использование ''(Рис. 17)''.

'''1. Интерфейс вкладки'''

'''- ''Фильтрация по типу'''''

В верхней части окна слева расположен выпадающий список '''«Тип»''', позволяющий отфильтровать шаблоны по категориям:

- Чат

- Запрос к документу

- Очистка документа

- Генератор синонимичных фраз

- Перефразировка фрагмента текста

- Суммаризация текста

- Генератор вопросов по тексту

- Векторная замена информации

- Поиск несоответствий информации

Напротив каждого типа в скобках указано количество доступных шаблонов.

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

'''''- Список шаблонов'''''

Справа от списка типов отображаются шаблоны выбранной категории. При выборе шаблона из списка его содержимое отображается в области просмотра.

'''''- Редактирование шаблона'''''

- ''Название шаблона'' – можно изменить в соответствующем поле.
[[Файл:Сведение в единый.png|мини|''Рис. 18. Шаблон сведения ответа в единый'']]
- ''Текст шаблона'' – поддерживает параметры в квадратных скобках <code>[###Сопроводительный текст, если нужен{Параметр}]</code>, которые являются необязательными. Квадратные скобки обозначают необязательный параметр, то есть его может не быть и система все равно отработает.

- ''Шаблон сведения ответа в единый'' (опционально) – используется в суммаризации для объединения нескольких частей в один результат. <blockquote>Например, разбили совещание на куски, сделали по кускам суммаризации, а потом нужно в один результат все свести ''(Рис. 18)''.</blockquote> - ''Параметры генерации:''

* max_tokens - ограничение максимального количества токенов, возвращаемых моделью в ответ на заданный запрос (prompt);
* top_k - параметр, определяющий количество наиболее вероятных токенов, которые модель учитывает при генерации текста. Чем ниже значение, тем более предсказуемым и повторяющимся будет ответ модели;
* top_p - параметр отвечает за динамический выбор словаря модели и является альтернативой настройке «температуры» ответа. Используется для уменьшения вероятности генерации неожиданных или нежелательных ответов;
* temperature - параметр влияет на детерминированность или случайность генерируемых ответов. При более низких значениях алгоритм предпочитает наиболее вероятные токены, что обеспечивает точность и краткость, идеально подходящие для фактических ответов. При повышении температуры выбор становится более случайным, что способствует разнообразию и творческим идеям, например, при создании стихов;
* repeat_penalty - количество повторений слов в ответе.

- ''Использовать данный шаблон по умолчанию'' – если активировать эту опцию, шаблон будет применяться автоматически в зависимости от типа (например, в QAS для запросов к документам или в SPR для суммаризации).

'''2. Добавление нового шаблона'''

1. Нажмите кнопку '''«Добавить»''' внизу вкладки.

2. Заполните поля:

- ''Название шаблона''

- ''Тип шаблона'' (выберите из выпадающего списка)

- ''Текст шаблона'' (обязательное поле)

- ''Параметры генерации''

3. Нажмите '''«Добавить»''' для сохранения.

'''3. Редактирование и удаление шаблонов'''

- Чтобы изменить шаблон, откройте его, внесите правки и нажмите '''«Сохранить».'''

- Для удаления выберите шаблон и нажмите '''«Удалить»'''. <blockquote>'''Примечание:''' Не забывайте сохранять изменения после редактирования шаблонов.</blockquote>
[[Файл:2025-07-04 17-05-52.png|мини|''Рис. 19. Рабочая область вкладки «Интерактив».'']]

==== Вкладка «Интерактив» ====

Вкладка '''«Интерактив»''' включает в себя три режима:

# режим протоколирования,
# чат,
# очистка текста.
[[Файл:Шаблон.png|мини|''Рис.20. Блок редактирования и просмотра шаблона'']]Чтобы '''переключиться между режимами''', просто нажмите на соответствующие иконки на панели управления. Активный режим выделяется красным контуром вокруг иконки.

'''Режим протоколирования''' [[Файл:Remove-bg.ai 1741353006272.png|безрамки|20x20пкс]] служит для создания протоколов — кратких резюме — на основе стенограмм. Она обладает двумя ключевыми функциями: позволяет создавать шаблоны для протоколов и создавать протоколы.
[[Файл:2025-07-04 17-06-57.png|мини|''Рис. 21. Форма для загрузки файла для протоколирования.'']]
[[Файл:2025-05-21 15-23-39.png|мини|''Рис. 22. Интерфейс вкладки Интерактив в режиме Чат'']]
Слева располагается список всех шаблонов, где вы можете найти подходящий или создать новый. Для добавления нового шаблона необходимо нажать на кнопку '''«Добавить шаблон»''' и заполнить все необходимые поля в появившемся окне: '''указать название шаблона''', а также '''наименования разделов''' и '''описать их содержание'''.
В центральной части экрана, вы можете редактировать шаблон. Здесь вы можете внести изменения и сохранить их, либо удалить, нажав соответствующие кнопки внизу блока (см. рис. 20).

В нижней части экрана вы найдете форму для отправки файла на протоколирование (см. рис. 21). Для загрузки файла воспользуйтесь кнопкой '''«Выберите файл»'''. Справа от поля выбора файла располагается значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении на которую всплывает подсказка с поддерживаемыми типами файлов.

'''[[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|Шаблон запроса к LLM]]''' стоит по умолчанию, в выпадающем списке для этого функционала доступны только шаблоны типа "Суммаризация текста". Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.

Затем выберите одну из опций использования '''Шаблона протокола''': '''"Использовать"''' или с '''"Не использовать"'''. Справа будет отображаться сгенерированный протокол, его можно будет выгрузить в формате docx или txt (см. раздел. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Интерактив»|Панель управления вкладки «Интерактив»]]). В рабочей области так же есть информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.

'''В режиме «Чат»''' [[Файл:Чат (1).png|безрамки|20x20пкс]] можно в свободной форме пообщаться с LLM-моделью. Есть возможность обращаться к нескольким моделям. Рабочая область показана на рисунке 22. Слева на рисунке есть блок с выбором LLM-модели, "Шаблон запроса к LLM" типа "Чат" и опция «Глубина истории сообщений», которая варьируется в диапазоне [3, 10]. История сообщений в чате сохраняется с ориентиром на глубину.

Функция '''«Размышление*»''' модели

Помимо основного ответа, большая языковая модель предоставляет возможность просмотреть логику своих рассуждений. Эта информация отображается в раскрывающемся блоке «Размышление».

* Назначение: Позволяет понять ход мыслей модели, который привел к конечному ответу.
* Практическое применение: Анализ «Размышления» помогает при необходимости скорректировать исходный запрос (промпт) для получения более точного результата.

*доступна только для больших «думающих» моделей.<blockquote>Внимание: варианты моделей появляются в интерфейсе после того, как администраторы их добавят. </blockquote>
В центре экрана расположен сам чат. Внизу области расположено окно, в которое можно ввести свой запрос и отправить его по клику на кнопку «Отправить» [[Файл:Отправить.png|безрамки|20x20пкс]] . Очистить историю можно воспользовавшись одноименной кнопкой [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]]. Справа от чата блок с «Поиском ответов», подробнее о нем и его параметрах можно прочитать [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].
[[Файл:2025-05-28 16-48-05.png|мини|''Рис. 23 Интерфейс вкладки Интерактив в режиме Очистка чата'']]

'''Режим «Очистка текста»''' [[Файл:Photo 2025-05-21 12-43-53.jpg|безрамки|20x20пкс]] этот инструмент помогает убрать из текста лишнее и сделать его более читабельным. Чтобы воспользоваться функцией, вставьте текст в поле «Чистка текста» (в центре рабочей области) и нажмите кнопку «Очистить». После завершения процесса справа от исходного текста появится очищенный вариант (рис. 23). В него нельзя вносить изменения, но можно скопировать с помощью клавиш Ctrl+C или экспортировать в виде документа [[Файл:Сохранить doc (1).png|безрамки|20x20пкс]] docx или txt на выбор.

===== Панель управления вкладки «Интерактив» =====
{| class="wikitable"
|+
!'''Иконка кнопки'''
!'''Название кнопки'''
!'''Описание'''
|-
|[[Файл:Remove-bg.ai 1741353006272.png|центр|безрамки|40x40пкс]]
|Протоколирование
|Режим протоколирования позволяет создавать протокол на основе стенограмм. Когда режим активен, вокруг появляется красный фон.
|-
|[[Файл:Чат (1).png|центр|безрамки|40x40пкс]]
|Чат
|Режим чата позволяет свободно общаться с LLM-моделью на любые темы. Когда вокруг кнопки появляется красный фон, режим активируется.
|-
|[[Файл:Сохранить doc (1).png|центр|безрамки|40x40пкс]]
|Экспортировать как документ
|Позволяет экспортировать документ протокола в одном из форматов docx или txt для режимов: протоколирование и очистка текста.
|-
|[[Файл:Меню пользователя new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Совместная работа ===

В QAS допускается работать нескольким пользователям, если они работают в разных категориях.

=== Методика работы с QAS ===

Чтобы начать пользоваться сервисом ответов на вопросы, вам нужно загрузить документацию, ответы на которую вы будете давать пользователям. Определить категорию этих документов. Напоминаем, что файл должен быть максимально ёмким, подробным и кратким подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Добавление файла в список|раздел Добавление файла в список]]. Если в документе используются аббревиатуры или слова с неофициальными ("народными") вариантами написания/произношения, например, «материнский капитал» (маткапитал, маткап и так далее), их следует включить в глоссарий. Глоссарий можно найти в разделе [[QAS. UPS руководство по работе с интерфейсом#Функционал меню «Дополнительно»|«Дополнительно»]] на вкладке «Документы» под текстом документа.

===== <big>Добавление вопросов</big> =====
Если у вас нет готовых вопросов по документации есть два варианта:

# добавлять вопросы и их формулировки вручную,
# запустить генерацию вопросов по документации (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|Панель управления вкладки Документы]]).

После того, как генерация вопросов завершится, необходимо пройти на вкладку Вопросы и проверить вопросы на соответствие документации и адекватность.

Если у вас есть csv файл с фразами-вопросами, то есть возможность загрузить их массово, воспользовавшись кнопкой «Массовая обработка вопросов» на панели управления вкладки Вопросы (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После этого нужно скомпоновать по смыслу вопросы и почистить ненужные.

===== <big>Добавление ответов</big> =====
После того как вопросы будут загружены в базу вопросов QAS. Можно запустить генерацию ответов (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]). После ее завершения нужно проверить правильность и соответствие ответов вопросу, если ответ вас устраивает — поставьте галочку «Проверено». Либо отредактируйте ответ и так же отметьте его проверенным. Так же можно самостоятельно добавить ответы на вопроса из документации. А так же есть возможность запустить перефразирование уже проверенных ответов, что поможет немного расширить вариации ответов.

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

''Пример корректного ответа и нет:''
{| class="wikitable"
|+
!'''Вопрос'''
!'''Ответ, который потенциально приведет к ошибке'''
!'''Ответ, который НЕ приведет к ошибке'''
|-
|Реабилитационный сертификат
|'''По данному вопросу''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|По вопросу '''оформления реабилитационного сертификата''' необходимо обратиться в филиал фонда «Защитники Отечества» Новосибирской области.
Адрес фонда: Новосибирская область, г. Новосибирск, ул. Октябрьская, д. 34;

Режим работы: ежедневно с 09:00 до 18:00;

Контактный телефон: 117 (доб. 1), 8 (383) 304-89-99;

Сайт: <nowiki>https://fzo.gov.ru/</nowiki>
|}

===== <big>Работа с кэшем вопросов</big> =====
После того как вы создадите базу вопросов и ответов, можно приступить к проверке работы кэша. В разделе «Кэш» вы найдёте блок для поиска ответа. В поле «Текст» введите свой вопрос, который может быть похож на уже существующие и на которые может ответить ваша загруженная документация. Установите необходимые настройки поиска, подробности можно найти [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа|тут]].

Далее возможны различные варианты развития событий:

* Если ''вопрос не похож'' ни на один из уже имеющихся в базе данных, и активирован флаг «Использовать генерацию», система сгенерирует ответ на основе документации (если в ней есть ответ на этот вопрос). А сам вопрос будет добавлен в список основных (при условии, что активна галка «кэширование формулировки»). Если функция генерации отключена, в ответ на вопрос будет указано «Информация не найдена». Сам вопрос будет отображаться в общем списке вопросов как основной, для работы с ним и с подобными нужно отфильтровать по «Пустым ответам».
* Если система ''обнаружит сходство с каким-либо вопросом из базы данных'', новый вопрос будет добавлен в список кандидатов к этому вопросу. Если кандидат попадет в верный вопрос его нужно будет утвердить (перенести в формулировки). Вы сможете найти его местоположение, перейдя в режим «Утверждение кандидатов» и отфильтровав одноименную колонку с помощью формулировки вашего запроса в поле «вопрос». Подробности о работе с кандидатами [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|тут]]'''<big>.</big>'''
* Если в базе данных уже ''есть похожий запрос'', но ''система не может найти его'' и генерирует новый ответ на ваш запрос, то решить эту проблему можно, добавив ваш новый вопрос как основной запрос. Поскольку, если система не считает похожим ни на один вопрос, то лучше добавить его как отдельный вопрос со своим ответом.
* Склейки (несколько вопросов разделенные «|») попадают в QAS, но не оседают там, даже если включена галочка «кэширование формулировок».

===== <big>Запуск в прод</big> =====
При массовом обращении к системе, например, на проде удобнее всего с новыми запросами работать через отчет по [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|кандидатам]]. С его помощью можно увидеть, в какие категории и в какие вопросы поступают новые запросы, и сразу же внести изменения — поменять категорию или утвердить кандидатов. А также увидеть, каким запросам не присвоилась категория вообще.

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

2025-12-24T10:03:13Z

E.Elagina: /* Функционал вкладки «Данные» SMC */

=='''Классификатор (SMC)'''==

[[Файл:Главный экран.png|мини|''Рис. 1. Иконки начального экран UPS.''|граница]]В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# SMC Классификатор,
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#Работа с сервисом исходящих обзвонов «Информатор»|CLS Информатор]],
# Выход.
[[Файл:Раб экран классификатора.png|мини|''Рис. 2. Рабочая область «SMC»'']]

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20пкс]] (см. табл. 2).
# Воспользоваться кнопкой в виде линии , которая находится снизу в центе экрана (см. рис. 2).
Рабочая область '''«SMC»''' включает в себя (рис. 2):
*панель управления,
*кнопки переключения между версиями моделей,
* блоки для работы с моделями и данными,
*информация о текущей модели,
*информацию об обучении и тестировании, для обученных и протестированных моделей,
*информационные вкладки.
[[Файл:Model info smc.png|мини|''Рис. 3 Информационный блок о модели.'']]
В блоке интерфейса '''«Классификатор»''' есть 3 вкладки:

1. '''«Модели»''' – содержит все созданные модели SMC списком в алфавитном порядке. Модели с постобработкой помечены значком [[Файл:Подсказка.jpg|безрамки|20x20пкс]].

2. '''«Данные»''' – содержит все корпуса данных SMC списком в алфавитном порядке.

3. '''«Метки»''' – содержит все словари меток SMC.
===Функционал вкладки «Модели» ===
Во вкладке '''«Модели»''' доступен просмотр информации о модели, а именно:
*название модели,
*версия модели: ''черновик'', ''рабочая'', ''архив'' (табл. 1),
*статус модели.
{| class="wikitable"
|+''Табл. 1. Версии модели.''
!'''Иконка версии'''
!'''Наименование версии модели'''
!'''Описание'''
|-
|[[Файл:Черновик.png|безрамки|40x40px|центр]]
|Черновик

|это не примененная модель. Можно обучать, переобучать, тестировать, устанавливать и применять. Можно экспортировать и импортировать. Цвет акцента версии модели - серый. После применения (установки) модель (см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Модели» SMC|табл.2]] «Установка») становится «Рабочей версией».
|-
|[[Файл:Рабочая нов.png|безрамки|40x40px|центр]]
|Рабочая

|это модель, которая уже используется в прод (англ. ''production –'' производство'')''. Применённую модель нельзя установить заново или обучить. Можно провести ручное тестирование и проверить конкретные фразы (см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Модели» SMC|табл.2]] «Ручная проверка»). Можно экспортировать модель. Цвет акцента версии модели - зелёный. По нажатию кнопки «Архив»- «Рабочая» модель переходит в архивную версию.
|-
|[[Файл:Архив нов.png|безрамки|40x40px|центр]]
|Архивная

|это рабочая модель, которая переводится в архив (резервную копию) после применения черновика. Можно вернуть архивную модель в рабочую версию, нажав на кнопку «Откат». При этом рабочая версия также становится архивной, то есть рабочая и архивная версии меняются местами. Цвет акцента версии модели - синий.
|}[[Файл:Model status.png|мини|''Рис. 4. Примеры статусов модели.'']]Модель SMC имеет свойство '''«Статус»''' (рис. 4), которые принимает следующие значения:
*''Обучение''. Это модель, которая в данный момент обучается.
* ''Обучена''. Доступен просмотр информации о точности обучения, параметрах модели и матрица ошибок.
*''Тестирование.'' Это модель, которая в данный момент тестируется.
*''Протестирована''. Появляются доп. кнопки '''«Обучение»''' и '''«Тест»''' (под матрицей ошибок), нажав на которые можно посмотреть матрицу обучения и тестирования соответственно.
*''Установлена.'' В этот статус модель переходит при нажатии кнопки «'''Установка»'''. В этом статусе возможны ''Импорт'', ''Экспорт'', ''Обучение'', ''Ручная'' ''проверка'', ''Применение'' модели – по соответствующим кнопкам на панели управления.
*''Применена.'' В статус ''Применена'' модель переходит при нажатии кнопки «'''Применение»'''. Для модели в статусе ''Применена'' возможны только – ''Ручная проверка'' конкретной фразой по кнопке «'''Ручная проверка»''' и ''экспорт'' (выгрузка) по кнопке «'''Экспорт»''' (см. [[SMC. UPS руководство по работе с интерфейсом|табл. 2]]).
*''Ошибка''. Информирует о сбое процессов импорта, обучения, тестирования, остановки обучения. <blockquote>'''''Пустые модели больше не отображаются в интерфейсе.'''''</blockquote>

Возможны ''манипуляции'' с моделями SMC:
*удаление модели, удаляется текущая версия модели,
*добавление новой модели SMC, нажмите кнопку '''«Добавить новую модель»'''. Далее доступны два способа:
*# Из файла: загрузите архив с готовой моделью.
*# Обучить модель: создайте модель с нуля, выбрав для обучения либо корпус текстов, либо словарь меток.
====Панель управления вкладки «Модели» SMC====
В правом верхнем углу экрана располагается панель управления для вкладки '''«Модели»'''. На ней располагаются кнопки из таблицы 2. Цвет кнопок указывает на доступность действия для данной модели: синий означает, что кнопка активна, а голубой - что она неактивна.

{| class="wikitable"
|+''Табл. 2. Описание функционала панели управления на вкладке «Модели».''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать(выгрузить) модель SMC.
|-
|[[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|позволяет импортировать (добавить) модель SMC.
|-
|[[Файл:Обучение.png|безрамки|40x40px|центр]]
|Обучение
|позволяет обучить модель SMC, выбрав данные для обучения из выпадающего списка. И затем следует выбрать метод обучения — по корпусу или по меткам (подробнее см. разд. [[SMC. UPS руководство по работе с интерфейсом|Функционал вкладки Метки]]). Обучение на словаре меток имеет преимущества перед корпусом в том, что обучение модели происходит в разы быстрее.
|-
|[[Файл:Обновление групп.png|безрамки|40x40px|центр]]
|Обновление групп в модели
|позволяет обновить группы в модели SMC. При нажатии на кнопку – открывается форма для указания корпуса.
|-
|[[Файл:Тестирование.png|безрамки|40x40px|центр]]
|Тестирование
|позволяет протестировать модель SMC корпусом данных. При нажатии на кнопку – открывается форма для указания корпуса, с помощью которого нужно протестировать модель.
|-
|[[Файл:Ручная проверка.png|безрамки|40x40px|центр]]
|Ручная проверка1
|позволяет протестировать модель SMC конкретной фразой, увидеть величину достоверности каждого класса, определенного системой.
|-
|[[Файл:Установка обработчика в рабочую версию модели.png|безрамки|40x40px|центр]]
|Установка обработчика в рабочую версию модели
|позволяет перезаписать обработчик на применяемой модели без перевода из тестового режима, если изменился только обработчик, а корпус остался прежним.
|-
|[[Файл:Установка.png|безрамки|40x40px|центр]]
|Установка
|переводит модель SMC в статус ''установлена''. После чего кнопка меняется на кнопку «Применение»[[Файл:Primenenie.png|безрамки|20x20px]] . Пока модель не применена (не используется), можно ее ''обучить'', ''протестировать'', ''экспортировать'' или ''импортировать'' данные. После того как модель начинает использоваться, возможность ее обучения или изменения исчезает. Остается возможность ''экспорта'' и ''ручной проверки'' модели.
|-
|[[Файл:Откат.png|безрамки|40x40px|центр]]
|Откат
|позволяет перевести архивную версию модели SMC обратно в рабочую.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:2025-04-15 14-31-32.png|мини|''Рис. 5. Диалоговое окно режима «Ручная проверка».'']]
1 Режим '''«Ручная проверка».'''

Как описано в таблице 2 этот режим позволяет протестировать модель SMC конкретной фразой. При нажатии на кнопку открывается диалоговое окно со следующими вкладками:
*классификация,
*прочее.

Вкладка '''классификация''' содержит поля:
*''текст'' - в это поле записывается фраза для проверки;
*''порог доверия -'' показатель, отражающий степень уверенности в принадлежности новой фразы к конкретному классу (рис. 6). Другими словами, пороговое значение указывает, при какой минимальной вероятности полагаем, что фраза относится к определённому классу.
*Функция ''коррекции'' предназначена для исправления опечаток в тексте. Существует три режима работы этой функции, каждый из которых определяет допустимое количество ошибок в слове:
**'''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)[[Файл:2025-04-15 14-35-46.png|мини|''Рис. 6. Функционал вкладки Классификация.'']]
**'''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
**'''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
**либо коррекция может '''Отсутствовать'''.
<blockquote>'''Важно:''' Эти режимы действуют только при коррекции по словарю модели. Поскольку идет сравнение слова с опечаткой со словом из словаря без ошибок.</blockquote>Есть галочка '''расширенный режим -''' позволяет обратиться сразу к нескольким моделям SMC. После нажатия на кнопку '''классифицировать''', выводится результат - метки классов, которые модель смогла распознать.

Классификатор (SMC) также выводит следующую информацию:

1. '''Классы''': здесь отображается название класса, к которому был отнесен текст, и вероятность его принадлежности к этому классу.

2. '''Группы''': отображается название группы и число совпавших классов. Если метки совпадают с несколькими группами, они отображаются в порядке убывания числа совпавших классов (т.е. чем полнее группа, тем выше ее позиция в списке).

3. '''Ближайшие группы''': отображаются группы, до которых не хватает всего одной метки, с указанием процента заполненности и сортировкой по убыванию этого процента.

Вкладка '''прочее''' SMC Классификатора включает в себя несколько опций: ''анализ на эмоциональность'', ''пунктуация, анализ токсичности'' и ''коррекция ошибок, обратная нормализация, сжатие'''''.'''

Сжатие - позволяет выделить основной смысл фразы.

* ''текст'' - в это поле записывается фраза для проверки;

*''порог сжатия'' - означает процент сжатия фразы, например, порог сжатия 100 - выводит всю фразу в окно результата'''.'''

Все эти манипуляция можно производить с фразой в блоке - ''текст.'' [[Файл:Информационные вкладки тест.jpg|мини|''Рис. 7. Интерфейс раздела «Классификатор»: Информационные вкладки для протестированной модели.'']]
====Информационные вкладки SMC: Сервер, Ошибки, Логи, Постобработка====
Справа на экране располагаются информационные вкладки (рис. 7)
*'''«Серверы»''' – отображает информацию о серверах и процессах,
*'''«Ошибки разметки»''' – в этот раздел попадают фразы и метки, предположительно с ошибкой разметки, то есть те, что вызвали сложности у модели. Это может быть связано с недостаточным количеством данных с этими метками в корпусе (так называемые «слабые данные»), либо наиболее часто встречающаяся - с действительной проблемой в процессе разметки данных (то есть, недостающая метка или избыточная),
*'''«Ошибки обучения»''' – отображает информацию об ошибках обучения для модели в состоянии «Обучена», те фразы, которыми модель так и не обучилась. Также можно, находясь на вкладке '''«Ошибки обучения»''' использовать метод '''«Ручная проверка»''',
*'''«Ошибки тестирования»''' – доступны для модели в состоянии ''Протестирована'' – отображает информацию об ошибках тестирования. Можно выгрузить ошибки в файл с помощью кнопки '''«Экспорт»'''. Есть возможность преобразовать ошибки в данные корпуса,
* '''«Логи»''' – отображают логи процессов обучения, тестирования, точности обучения на разных этапах обучения,
*'''«Постобработка»''' – редактор для написания кода handler.py.
[[Файл:Data screen new.png|мини|''Рис. 8. Интерфейс вкладки данные с родительскими и дочерними вкладками'']]
[[Файл:2025-12-11 10-52-07.png|мини|''Рис. 9 Интерфейс вкладки данные'']]
[[Файл:Data corpus info.jpg|мини|''Рис. 10. Информация о корпусе данных.'']]
===Функционал вкладки «Данные» SMC ===
Вкладка '''«Данные» SMC''' (рис. 8) содержит список всех доступных корпусов данных. При выборе различных корпусов данных можно просмотреть информацию о них (рис. 10):

• '''Название корпуса''': можно изменить с помощью иконки '''«Карандаш».''' Можно удалить корпус с помощью иконки '''«Корзина»''' (см. рис. 10).

• '''Количество строк''' – общее количество фраз в корпусе.

• '''Количество классов''' – общее количество классов в корпусе.

• '''Количество групп''' – отображает общее количества групп в корпусе данных (подробнее см. раздел ''[[SMC. UPS руководство по работе с интерфейсом#Описание подготовки и этапов разметки корпуса данных SMC|«Описание подготовки и этапов разметки корпуса данных SMC»]]'').[[Файл:Род класс.png|мини|''Рис. 11. Создание родительского класса.'']]Под информационным блоком о корпусе данных SMC есть '''список классов''', в котором содержатся названия классов и информация о количестве фраз в каждом классе. Можно удалять и добавлять классы. В самом низу списка есть меню для '''''Экспорт списка классов''''' в формате csv. Есть возможность ''скрыть'' блок с корпусами данных, нажав на стрелочку между блоком корпусов и информационным блоком корпуса. Существует три вида (ранга) классов (меток):
#Обычный класс — это класс, который не относится ни к одному из родительских классов.
#Родительский класс — это класс, который включает в себя другие классы. Например, родительский класс «Паспорт» включает в себя два класса-потомка: «паспорт рф_о» и «загранпаспорт_о».
#Класс-потомок — это класс, который относится к какому-либо родительскому классу.

Чтобы преобразовать обычный класс в родительский, нужно выбрать его в списке классов и нажать на самую правую иконку в виде папки (рис. 11), которая говорит '''«Сделать класс родительским»'''. Чтобы добавить метку в родительский класс, нужно нажать правой кнопкой мыши на метку и выбрать нужный родительский класс из появившегося списка. После этого появится диалоговое окно, подтверждающее действие, и изменения вступят в силу (см. рис. 12). Метка станет классом-потомком.[[Файл:Перемещение метки в род.класс.png|мини|''Рис. 12. Перемещение метки в родительский класс.'']]

Удалить родительскую метку, в отличие от обычной, просто так нельзя. Сначала ее нужно вернуть в статус обычной, нажав на иконку '''«Сделать класс обычным»''' напротив нужного класса (рис. 13). После этого она будет расформирована и ее можно будет удалить.

==== Добавление нового корпуса ====
[[Файл:Сделать класс обчным.png|мини|''Рис. 13. Сделать родительский класс обычным.'']]Для создания нового корпуса данных SMC выполните следующие шаги:

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

После создания корпуса вы можете заполнить его данными одним из следующих способов:

'''1. Ручное добавление'''

* В нижней части экрана находится форма для ввода текста.
* Добавляйте фразы вручную и сразу выполняйте их разметку в интерфейсе.

'''2. Импорт данных'''

Нажмите кнопку «Импорт» и выберите подходящий источник:

* Логи из модели. Создаёт корпус на основе логов рабочей версии и черновых моделей.
* Из ЧаВО. Позволяет загрузить все вопросы из базы знаний QAS. Как использовать:
*# Введите название корпуса.
*# Нажмите кнопку «Добавить». В результате будет создан корпус, где вопросам из QAS соответствуют метки их категорий.
* Из файла. Загрузите данные из CSV-файла, подготовленного по шаблону системы.
* Из корпуса. Скопируйте данные из существующего в системе корпуса в новый.

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

При включении флага '''«Показать определившиеся группы»''' слева появится третий столбец «Группа». В нём будет отображаться название группы, назначенной для данной фразы. Это работает, если у вас создан список групп и заданы комбинации классов, которые в них входят.

Вы можете редактировать группы меток непосредственно в таблице данных:

* Создание или изменение групп
** Введите название новой группы или выберите существующую для одной или нескольких (предварительно выделив галочками) строк таблицы.
** Изменения автоматически синхронизируются с таблицей групп.
* Массовое присвоение групп для выбранных строк
** Выделите нужные строки в таблице.
** Присвойте им группу, внизу появится форма с функцией «Изменить группу»:
*** Для строк '''без группы''' — будет '''установлена''' выбранная группа.
*** Для строк с уже '''назначенной''' группой — группа будет '''переопределена''' на новую.

[[Файл:2024-05-21 12-03-29.png|мини|''Рис. 14. Возможности фильтрации.'']]

Можно ''фильтровать'' (рис. 14):

1. по названию класса,

2. по фразе или слову,

3. для более точной фильтрации можно использовать переключатель «и», «или», «кроме» и «только».

Есть возможность ''редактировать фразу'' в корпусе: вносить изменения в поле с фразой и ''сохранять'' изменения (кнопка '''«Дискета»''' на панели управления). Можно ''дополнять'' корпус данных по кнопке '''«Импорт»''' на панели управления (подробнее см. [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Данные» сервиса SMC|описание функций панели управления]]). '''После дополнения не забудьте сохранить изменения.''' ''Удаление'' фраз из корпуса возможно как по одной, так и сразу несколько, для этого нужно выделить необходимые для удаления фразы и нажать на красную иконку '''«Корзина»''' в правом нижнем углу блока работы с данными.[[Файл:Разм данных новая.png|мини|''Рис. 15. Добавление и разметка фраз.'']]

Можно вручную ''добавлять'' фразы в корпус по одной или сразу несколько (каждая фраза с новой строки, enter в конце каждой фразы)(рис. 15), записав их в поле '''«Фразы»''' в нижней части блока для работы с данными. Можно ''назначить'' или ''изменить'' классы (метки) для фразы, указав новый в поле '''«Класс»''' или выбрав существующий класс из выпадающего списка. Метки классов могут быть больше чем одна на одну фразу (мультиклассовая классификация). <blockquote>Рассмотрим пример разметки новой фразы. Допустим мы хотим добавить вручную две фразы:
#''«Здравствуйте, у меня возникли неполадки, возникающие во время установки SBS. Помогите решить проблему. Заранее спасибо.»''
#''«Добрый день, у меня появляется ошибка при установке биометрии. Заранее благодарю за ответ.»''
Разметка производится исходя из того '''«о чем эта фраза?»''', задача разметки в том, чтобы помочь модели понять суть фразы. Например, во фразах выше говорится об ''ошибках во время установки сервиса биометрии'', так же присутствует ''благодарность'' и ''приветствие,'' соответственно метки будут: ''SBS, ошибка, установка_ПО, благодарность, приветствие.''

'''ВАЖНО''': соблюдать однозначность в корпусе.</blockquote>[[Файл:Добавить общий класс.png|мини|''Рис. 16(а). Добавление общего класса.'']]Имеется функция '''«Добавить общий класс»'''. С ее помощью можно присвоить одну или несколько общих меток сразу нескольким выбранным из списка фразам (рис. 16 (а)), если была допущена ошибка при разметке фраз. Для изменения набора меток у одной фразы нужно всего лишь один раз щелкнуть на список классов и добавить нужную метку из выпадающего списка или навести курсор на лишнюю метку и, также щелкнув, удалить ее. Если необходимо удалить сразу несколько меток с фразы или нескольких фраз, под кнопкой '''«Добавить общий класс»''' есть кнопка '''«Удалить классы»''' (рис. 16 (б)). Сначала выделите нужные фразы, а затем выберите класс (классы), которые вы хотите удалить из выпадающего списка, и кликните по кнопке «Удалить классы».

[[Файл:Удаление нескольких классов 1.jpg|мини|''Рис. 16(б). Удаление нескольких классов.'']][[Файл:Объединение меток разных род.классов.png|мини|''Рис. 17. Объединение меток разных родительских классов.'']]Кроме того, существует еще одна полезная функция для работы в корпусе данных SMC — '''«объединить метки»'''. Для лучшего понимания рассмотрим пример. Предположим, у вас есть две метки с одинаковым названием — «версия» и «версия», но в одном случае название содержит английскую «е», а в другом — русскую (классы отображаются в алфавитном порядке, метка с английскими буквами будет нарушать его). И этими метками уже помечены некоторые фразы. Чтобы решить эту проблему, можно воспользоваться функцией '''«объединения»'''. Необходимо скопировать название правильной метки из списка меток («карандаш» — выделить название), затем нажать на «карандаш» напротив неправильной метки и заменить ее названием корректной метки. После этого метки объединятся и останется только корректная метка. Если эти метки принадлежат какой-либо группе, то замена произойдет и в ней. Возможность объединения групп также предусмотрена и осуществляется по такому же алгоритму.

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

==== Работа с группами классов ====
Интерфейс вкладки «Группы» аналогичен вкладке «Данные». Панель управления описана в таблице 3.

'''Основные функции вкладки:'''

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

'''Фильтрация и поиск:'''

* Фильтруйте данные по группам и классам.
* Для точной настройки фильтра используйте правую панель с операторами: «И», «ИЛИ», «Кроме», «Только».
* Для отображения повторяющихся строк включите флажок '''«Показать дубликаты»''' и выбрав одну из опций: полные (будут отображены полные дубли) и классов (отобразятся дубли по комбинации классов).

'''Массовые операции с группами:'''

# Выделите нужные группы с помощью флажков.
# В нижней части окна появится меню для массовых действий:
#* Добавить класс: выбранный класс будет добавлен ко всем выделенным группам.
#* Удалить класс: выбранный класс будет удален из всех выделенных групп.
#* Копировать: создание копий выделенных групп в одном из трёх режимов:
#** Простое копирование.
#** Копирование с добавлением выбранного класса.
#** Копирование с удалением выбранного класса.

'''Обновление модели после изменения групп'''

Если вы внесли изменения в состав или названия групп, необходимо применить эти изменения к работающей модели.

# Нажмите кнопку '''«Обновление групп в модели»''' на панели управления.
# Модель классификатора будет дообучена с учётом внесённых правок без необходимости полного повторного обучения.

<blockquote>'''Важно''': Эта операция необходима после переименования групп, массового добавления/удаления классов или изменения состава групп, чтобы модель начала учитывать новые правила.</blockquote>

==== Описание подготовки и этапов разметки корпуса данных ====
Классификатор SMC использует '''мультиклассовый подход''': одна текстовая фраза может быть отнесена одновременно к нескольким классам (меткам).

Процесс подготовки данных состоит из двух ключевых этапов (вы можете выполнить оба или только один из них):

'''Разметка фраз классами'''

При добавлении новой фразы необходимо назначить ей один или несколько классов.

* Выбор существующего класса: укажите нужные классы из выпадающего списка «Классы».
* Создание нового класса: введите название нового класса в поле «Класс» и нажмите кнопку «Добавить новый класс».

<blockquote>Подробное описание функционала вкладки «Данные» и пример разметки новой фразы представлены в соответствующем разделе инструкции.</blockquote>'''Группировка классов'''

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

* Назначение: Группировка помогает модели без дообучения определять, к какой группе классов принадлежит новая, ранее не встречавшаяся фраза.
* Результат: Формируются группы, которые агрегируют несколько отдельных классов (меток) и используются для конечного ответа.

====Панель управления вкладки «Данные» сервиса SMC====
Панель управления на вкладке '''«Данные»''' отличается своими функциями. В таблице 3 представлен список кнопок.

{| class="wikitable"
|+''Табл. 3 Описание функционала панели инструментов вкладки «Данные»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
! '''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать (выгрузить) корпус данных.
|-
| [[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|позволяет импортировать данные из внешнего файла, логов обращений к модели, уже существующего в системе корпуса или базы знаний ЧаВО.
Если выбран вариант «Из файла», нужно выбрать файл для загрузки. Поддерживаемые форматы файлов: csv, txt. Кодировка — UTF-8.

Затем можно выбрать действие: дополнить или заменить. Если выбрано «дополнить», данные текущего корпуса будут дополнены данными из файла или корпуса.

Если выбрано «заменить», данные текущего корпуса будут полностью заменены данными из файла или корпуса.
|-
|[[Файл:Авторазметка_(2).png|центр|безрамки|40x40пкс]]
|Авторазметка
|позволяет автоматически разметить корпус по словарю меток (подробнее см. [[SMC. UPS руководство по работе с интерфейсом|разд Функционал вкладки Метки]]). В диалоговом окне необходимо заполнить поля с названием задачи, выбрать из списка нужный словарь меток. Из выпадающего списка «Метки» выбрать либо замену меток, либо дополнение. И запустить авторазметку.
После этого автоматически размеченный корпус будет доступен для обычного редактирования разметки.
|-
|[[Файл:Копировать.png|безрамки|40x40px|центр]]
|Копировать
|позволяет скопировать корпус данных.
|-
|[[Файл:Сохранить.png|безрамки|40x40px|центр]]
|Сохранить
|сохранение изменений.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

=== Функционал вкладки «Метки» ===
[[Файл:2024-10-15 11-23-22.png|мини|''Рис. 19. Интерфейс вкладки Метки.'']]Интерфейс вкладки «Метки» представлен на рисунке 19. Слева вы увидите список всех доступных словарей. Чтобы открыть один из них, просто нажмите на его название — и в центральной части экрана появится сам словарь.

Процесс добавления нового словаря состоит из двух простых шагов:

1. Нажмите на кнопку «Добавить словарь меток», расположенную в нижней левой части экрана. В появившемся диалоговом окне введите название нового словаря.

2. Затем добавьте данные в словарь: укажите название метки и пороговое значение коэффициента достоверности в левой части таблицы и её определяющие фразы в правой части таблицы. Более подробную информацию вы найдёте в разделе [[SMC. UPS руководство по работе с интерфейсом#Подготовка словаря меток|«Подготовка словаря меток»]]. Если у вас уже есть файл с описанием меток, вы можете воспользоваться кнопкой Импорт на панели управления (см. раздел [[SMC. UPS руководство по работе с интерфейсом#Панель управления вкладки «Метки»|Панель управления вкладки «Метки»]]).

==== Подготовка словаря меток ====

Подготовка словаря меток включает в себя определение набора требуемых меток под конкретную задачу. После этого нужно в описание каждой метки добавить все возможные определяющие фразы, которые однозначно определяют эту метку, каждое слово (фраза) с новой строки. Не нужно добавлять целые фразы, как это делается при разметке SMC. Принцип описания больше похож на разметку SEE корпуса: просто укажите ключевые слова или словосочетания, которые определяют данную метку, а также все, что хотите отнести к этой метке. <blockquote>Например, мы создаем метку «Документация» и в определяющих фразах указываем все возможные варианты, которые однозначно описывают эту метку с новой строки: «дока», «инструкция», «документация», «мануал».</blockquote>Подготовленный для импорта документ должен быть в формате csv. И иметь следующую структуру:<blockquote>Метка<TAB>Описание 1, Описание 2, ..., Описание N<TAB>Порог</blockquote>Пороговое значение в файле указывается в диапазоне [0,1]. Далее при необходимости это значение можно будет поменять в интерфейсе.

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

Чтобы ''удалить'' лишнюю фразу или метку - наведите курсор на выбранную строку и нажмите на появившуюся иконку корзинки в конце строки [[Файл:Delete icon.png|безрамки|18x18пкс]]. Не забудьте сохранить изменения.

Также сверху таблицы словаря меток располагается поле ввода "Поиск по фразе". При ее заполнении будут отфильтровываться метки, содержащие введенную фразу (левая таблица), и совпадения по фразе в выбранной метке (правая таблица).

==== Панель управления вкладки «Метки» ====

Описание функционала панели управления на вкладке '''«Метки»''' представлено в таблице 4.
{| class="wikitable"
|+''Табл. 4 Описание функционала панели инструментов вкладки «Метки»''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
! '''Описание'''
|-
|[[Файл:Экспорт нов.png|безрамки|40x40px|центр]]
|Экспорт
|позволяет экспортировать (выгрузить) словарь меток.
|-
| [[Файл:Импорт нов.png|безрамки|40x40px|центр]]
|Импорт
|Позволяет импортировать (добавлять) данные из файла. По нажатию на кнопку появится диалоговое окно, в котором требуется выбрать файл с компьютера в формате csv.
|-
|[[Файл:Сохранить.png|безрамки|40x40px|центр]]
|Сохранить
|сохранение изменений.
|-
|[[Файл:Удаление_документа.png|центр|безрамки|40x40пкс]]
|Удалить
|позволяет удалить выбранный словарь меток.
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (модели, корпуса, метки)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи.
При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

===Работа с ошибками SMC===
[[Файл:Ошиб тест тип 1.png|мини|''Рис. 20. Иллюстрация ошибки тестирования первого типа.'']][[Файл:Ошибка тест тип 1 3.png|мини|''Рис. 21. Обогащение корпуса данных.'']]Во время работы с классификатором, вы можете столкнуться с 3-мя видами ошибок:
*ошибки разметки;
*ошибки обучения;
*ошибки тестирования.

Как описано выше в разделе «''Информационные вкладки: Сервер, Ошибки, Логи, Постобработка» -'' '''«ошибки разметки»''' – раздел куда попадают фразы и метки, предположительно с ошибкой разметки, то есть те, что вызвали сложности у модели. Это может быть связано с недостаточным количеством данных с этими метками в корпусе (так называемые «слабые данные»), либо наиболее часто встречающаяся - с действительной проблемой в процессе разметки данных (то есть, недостающая метка или избыточная). Вкладка '''«ошибки обучения»''' – отображает информацию об ошибках обучения для модели в состоянии '''«Обучена»''', те фразы, которыми модель так и не обучилась.

'''«Ошибки тестирования»''' являются наиболее сложными и делятся на два основных типа:
# нехватка данных, тогда необходимо обогатить корпус данных фразами и разметкой;
#нехватка комбинаций меток для группы.
[[Файл:Ошибка тест тип 2.png|мини|''Рис. 22. Иллюстрация ошибки тестирования второго типа.'']]

'''Пример ошибки типа 1. Нехватка данных.'''

Есть фраза «Директор МФЦ иркутской области» - модель классифицирует ее неправильно, на скриншоте (см. рис. 20) этой фразе присвоены метки: ''Иркутская область_о, как_в, губернатор_о'' Это происходит из-за того, что ''директор'' и ''губернатор'' - имеют семантическое сходство, так как являются руководителями. Но в связке с Иркутской областью - упоминания директора в корпусе не было. Поэтому модель исходя из имеющихся у нее данных - определила для этой фразы - метку губернатор_о. Группа: ''кто является губернатором иркутской области района.''

Если мы отфильтруем корпус данных по слову ''директор,'' то увидим, что в корпусе отсутствуют фразы где и ''директор'' и ''иркутская область'' упоминались бы одновременно, а так же не была определена метка ''мфц_о,'' следовательно фразы ''директор мфц'' (дополнительно добавленная выделенная фраза) тоже не хватало (см. рис. 21). Нужно добавить эти фразы в корпус, сохранить изменения, переобучить модель, так как вносились изменения в данные, и ошибка будет устранена.[[Файл:Ошибка тест тип 2 нов.png|мини|''Рис. 23. Добавление новой комбинации меток для группы.'']]'''Пример ошибки типа 2. Нехватка комбинаций меток для группы.'''

Имеется фраза ''«а какие документы нужно подать для оформления путевки инвалиду»''. Проводим тестирование в ручном режиме и видим, что этой фразе не присвоена ни одна группа, а значит нет конечной точки, которой бы соответствовал полученный от модели набор меток. (см. рис. 22).

Переходим во вкладку '''Данные''', выбираем нужный корпус данных, идем во вкладку '''Группы'''. Далее фильтруем группы по '''Классам''': инвалидность_о, путевка в санаторий_о переводим '''переключатель''' справа в положение ''«и»'' (см. рис. 23) и смотрим, что у нас отсутствует комбинация меток: с подачей документов. Добавляем еще одну комбинацию (см. рис. 23), сохраняем изменения, переходим во вкладку Модели, кликаем на кнопку [[Файл:Обновление групп.png|безрамки|20x20px]] «Обновление групп», в диалоговом окне выбираем модель и нажимаем кнопку обновить - ошибка устранена. Переобучать модель не нужно, кнопка «Обновление групп» позволяет внести изменения без переобучения.

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

2025-12-24T10:01:26Z

E.Elagina: /* Вкладка «Коннекторы» */

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

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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# SES Сценарная машина,
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]],
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]].
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2).
[[Файл:2025-06-09 14-33-48.png|мини|''Рис. 2 Рабочая область SES'']]

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

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

==== Добавление и настройка робота ====
Чтобы добавить нового робота, нажмите кнопку '''«Добавить робота»'''. В появившемся диалоговом окне введите название и нажмите '''«Добавить»'''. В нижнем правом углу экрана появится сообщение «Добавлено!». По умолчанию робот создается с предварительными настройками. В нем сразу есть текстовки для исключений и событий, ознакомиться и поправить их можно, перейдя на вкладку [[SES. UPS руководство по работе с интерфейсом|«Настройки»]]. Робот может быть 3х версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
{| class="wikitable"
|+''Табл. 1 Версии робота.''
!'''Иконка версии'''
!'''Наименование версии робота'''
!'''Описание'''
|-
|[[Файл:Черновик.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]], если вы планируете предоставлять консультации.

Здесь представлен общий перечень необходимых сервисов. В зависимости от специфики проекта некоторые из них могут отсутствовать.
[[Файл:2025-07-04 17-15-25.png|мини|''Рис. 3 Интерфейс вкладки Скрипты'']]

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

У скриптов есть параметр '''''«Область действия»''''', в котором есть 5 опций:

- ''конечные точки'', позволяет подключать скрипт в действиях конечных точек;

- ''элементы данных'', позволяет подключать скрипт в действиях элементов данных и контейнеров;

Скриптов на ЭД и КТ может быть несколько. Остальные скрипты общие и доступны только по одному на каждый тип:

- ''завершение сессии'' — скрипты, которые могут выполняться после завершения диалога, если скрипт указать в настройках в действиях на событии «Завершение диалога»;

- ''перед каждым вопросом'' — для случаев, когда нужно актуализировать какую-то информацию постоянно и использовать ее в условиях.<blockquote>

Скриптом «перед каждым вопросом» можно выставить, например, сегодняшнюю дату - ${custom.today}, а потом ее в сравнении дат использовать в условиях получения данных. Для случаев записи на прием проверять, '''что дата точно больше сегодняшней.'''

'''Скрипт проверки пишется админом.''' </blockquote>

- ''после каждого ответа'' — для случаев, где требуется пошагово после каждого ответа передавать информацию во внешнюю систему.

- ''передача диалога,'' скрипты для передачи диалогов.

- ''старт диалога.''

====== Дефолтные скрипты ======
В системе реализованы шаблоны скриптов по умолчанию:

Назначение:

* Автоматическое создание базовой функции при создании нового скрипта
* Возможность последующего редактирования

Расположение и настройка:

* Файлы находятся в переводчике по пути: <code>lang\ru.json</code>
* Реализовано для гибкости - администратор может изменять настройки
* Не зашито в код системы

Типы дефолтных скриптов:

* <code>_defaultScriptContainer</code> - для ЭД типа "Контейнер" (скрипты обработки)
* <code>_defaultScriptData</code> - для ЭД (скрипты постобработки)
* <code>_defaultScriptAction</code> - для действий в ЭД/КТ

[[Файл:Scrirts.png|мини|''Рис. 4 Отладка скриптов интеграции'']]
Есть '''режим отладки скриптов интеграций''' с функцией извлечения данных из сессии (рис. 4). То есть можно [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|тестировать робота в чате отладчика]] и, в случае если отработка некорректна или нужно проверить внесенные изменения в скрипт, то можно открыть вкладку «Скрипты» -> выбрать нужный скрипт -> кликнуть на закладку «Проверка» (слева откроется дополнительное окно) и нажать на кнопку «Вставить данные сессии». Тогда в открывшемся окне появятся все данные из текущей сессии из чата отладчика. По нажатию на кнопку «Тест», появится окно с результатом отработки скрипта.

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

[[Файл:2025-11-01 09-55-26.png|мини|''Рис. 5 Интерфейс вкладки «Интервалы»'']]

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

====== Группировка интервалов рабочего времени ======
Для удобства настройки сложных и переменных графиков работы в системе предусмотрена возможность объединять интервалы времени в группы. Это позволяет избежать создания громоздких условий в Контрольных Точках (КТ), когда рабочие часы оператора меняются каждый день или разбиты на несколько промежутков.

Для того, чтобы создать группу интервалов кликните на '''+''' справа от вкладки под номером '''1'''. Группа разделена на вкладки (табы), что позволяет удобно структурировать разные периоды.

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

* На одной вкладке настроить график для будних дней. Или для каждого дня отдельно.
* На другой вкладке — график для выходных.
* На третьей — особый график для праздников.

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

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

* '''события''' — действия, которые выполнит робот при наступлении определенного условия в диалоге, например «Не найдено» (см. раздел «События» ниже);
* '''исключения''' — это действия, которые выполняются, если событие повторяется указанное число раз подряд (см. раздел «Исключения» ниже);
* '''данные''';
* '''модели''' — настройка моделей, если требуется использовать параметры, отличные от параметров по умолчанию;
* '''коннекторы'''.

'''События''' есть 10-ти типов и прописываются для каждого канала связи отдельно:
[[Файл:2025-10-06 16-01-17.png|мини|''Рис. 6 Интерфейс вкладки «Настройки»'']]
# Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
# Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
# Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
# Запрос повтора — действия на случай, если абонент запросил повтор информации. Если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.
# Тишина — добавляем действие в моменты, когда от человека нет ответа, то есть тишина.
# Перебивание — событие доступно ''только для голосовых каналов (например, voice)''. Она позволяет настроить реакцию на прерывание речи.
# Задержка ответа — событие доступно ''только для голосовых каналов (например, voice)''. Это действия, которые появляются, когда идет генерация. Например, можно написать: «Секундочку, выясняю». Это нужно, чтобы человек понимал, что робот не просто молчит.
# Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя, то есть настройка действий если это событие произошло. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
# Нет данных — это событие происходит, когда система пытается получить конкретный недостающий элемент данных, например название филиала, и ей это не удалось.
# Ошибка.

'''При наступлении события система выполнит указанное в канале действие. Если действие для этого события в канале не задано, то ничего не произойдет.'''

Вы можете настроить реакции робота на определённые события. Более подробную информацию о них вы найдёте в разделе «Исключения».

'''Исключения''' есть трех типов '''Тишина''', '''Не найдено''' и '''Нет данных'''.

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

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

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

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

На вкладке можно настроить параметры голосового канала. Вот что там можно сделать:

* Выбрать голос, которым будет говорить робот.

* Установить основную модель распознавания (рекомендуем оставлять common).

* Определить фоновую модель распознавания (рекомендуем background).

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

* '''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)
* '''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
* '''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
* либо коррекция может '''Отсутствовать'''.

[[Файл:2025-10-06 16-47-09.png|мини|''Рис.7 Вкладка настроек коннектора telegram'']]

===== Вкладка «Коннекторы» =====
Позволяет настроить связь робота по одному из каналов: ''freeswitch'', ''max'', ''telegram'', ''vk'', ''web, nats.''

Для мессенджеров, таких как '''max''', '''telegram''', '''vk''', характерны следующие настройки:

* ''токен'',
* ''группа'' ''(для vk),''
* ''название бота'',
* ''обслуживающий сервер'' - имя сервера SES, который обслуживает данный коннектор,
* ''периодичность обновления'' - время периодичности запроса в api для получения новых сообщений,
* ''фразы-активаторы'' - список фраз, на которые будет реагировать робот в общих чатах, и считать, что сообщение адресовано ему,
* ''переменные,''
* ''фраза сброса сессии,''
* ''доступы'' - список пользователей, которые могут писать роботу. Если пустой, то могут все.

Для канала '''web,''' в частности, для встраивания чат-виджетов ''(рис 7.1).'' Данный коннектор предназначен для встраивания интерактивного виджета на ваш сайт. Доступно два типа виджета: '''Чат и Ассистент (Суфлер)'''.
[[Файл:2025-11-14 11-16-35.png|мини|''Рис. 7.1 Вкладка настроек коннектора web'']]
'''Общие параметры (для обоих типов)'''

Следующие настройки являются общими независимо от выбранного типа виджета.

* Домен: Укажите домен вашего сайта, на который будет встраиваться виджет. Это необходимо для безопасности, чтобы виджет мог работать только на указанном сайте.
* Токен: Уникальный идентификатор, который указан в теге <code>[[SES. Руководство администратора#Настройка виджета для сайта|<script>]]</code> для встраивания виджета на сайт.
* Акцентный цвет: Основной цвет интерфейса виджета (кнопки, заголовки, выделение). Используется для согласования с фирменным стилем вашего сайта.
* Заголовок виджета: Текст, который отображается в шапке открытого окна чата.
* Приветственное сообщение: Первое сообщение, которое видит пользователь при открытии чата.
* WebSocket-серверы: Технический параметр для установки соединения. Обычно заполняется автоматически и изменяется только по указанию технической поддержки.
* Язык: можно указать язык для виджета. Если не указывать, то будет дефолтный из конфига UPS.
<blockquote>Мультиязычность настраивается в настройках пользователя.</blockquote>'''Функциональные возможности'''

Эти опции позволяют включить или отключить определенные функции виджета.

* Голосовые ответы: Пользователь может прослушивать ответы от робота в аудиоформате.
* Отправка аудиосообщений: Пользователь может записывать и отправлять голосовые сообщения.
* Отправка файлов: Пользователь имеет возможность прикреплять и отправлять файлы.
* Аудиозвонок: Пользователь может инициировать голосовой звонок.
[[Файл:Ассистент.jpg|мини|''Рис. 7.2 Настройка переменных для режима "Ассистент"'']]
'''Выбор типа виджета'''

Перед сохранением конфигурации необходимо выбрать тип виджета, так как это влияет на доступность дополнительных параметров.

''Тип: "Чат"''

Стандартный режим для интерактивного общения с пользователем. Все "Функциональные возможности" и "Общие параметры" доступны для настройки. Также доступен блок "Переменные".

''Тип: "Ассистент" (Суфлер)''

Режим, предназначенный для подсказок оператору во время разговора с абонентом. Все переменные, необходимые для работы ассистента, настраиваются и передаются отдельно в личном кабинете пользователя. Сначала нужно авторизоваться в системе UPS ''(рис. 7.2)'', и дальше суфлер подключится сразу ко внутреннему номеру, который указан в настройках пользователя, там же можно переопределить цветовую схему под каждого пользователя.

Для канала '''freeswitch''' (телефонная линия):

* ''название коннектора,''
* ''режим обслуживания:''
** Режим «Как робот»
*** <code>Внутренний номер</code>: Указывается внутренний номер этого робота.
*** Опция ассистента: Дополнительно настраивается параметр, который определяет, будет ли ассистент (суфлер) работать после перевода звонка на оператора.
*** <code>Конечная точка</code>
** Режим «Как ассистент»
*** <code>Внутренний номер</code>: Указывается внутренний номер робота-ассистента (суфлера).
*** <code>Номер для перевода звонка</code>: Указывается номер, на который будет переключаться звонок (номер колл-центра или конкретного оператора).
Работа ''суфлера после перевода звонка'' на оператора возможна ''в двух режимах'':

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

Флаг '''"Автостарт ассистента"''' при активации этой опции, ассистент запускается автоматически.

Настройки канала '''''nats''''':

* название коннектора,
* адрес серверов,
* канал входящих сообщений,
* канал исходящих,
* обработчик.

Принцип работы:

* Отправитель (канал исходящих сообщений) отправляет сообщение в определенный subject.
* Получатели (канал входящих сообщений), которые проявили интерес к этому subject, получают сообщение.
* Subject выступает в роли классификатора, позволяя разделять различные потоки сообщений для разных задач и сервисов.

Для работы коннектора необходимо указать адрес сервера NATS и топики (Subjects) для отправки и получения сообщений.

[[Файл:Функционал действий.png|мини|''Рис. 8 Функционал Действий'']]

==== Виды действий в роботе и работа с ними ====
'''1. Основные действия'''

Доступны следующие типы действий:

* '''Сказать'''

Настройте текстовые ответы робота. Это может быть простая фраза-заглушка, ответ, сгенерированный AI (LLM), или ответ из базы знаний (QAS). Типы ответов «Сказать» подробно описаны в разделе 2.

<blockquote>При наведении мыши на поле «Фраза» появляется кнопки-иконки [[Файл:Управление фразой действия.png|безрамки|64x64пкс]], где можно выбрать одно из действий:
# Добавить кнопку (подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Добавление кнопок в действия|«Добавление кнопок в действия»]]). Доступно пользовательское расположение кнопок, которые регулируются переносами на новые строки.
# Перефразировать. Если нужно добавить вариации фразы (рис. 8). Предложенные фразы можно отредактировать или удалить, кликнув по иконке корзинки напротив нужной фразы и добавить в список фраз.
# Удалить лишнюю фразу можно, если она не единственная.
</blockquote>

* '''Подтвердить'''

Настраивается фраза для подтверждения.

* '''Отправить файл'''

Позволяет отправить файл в ответ на запрос пользователя.

* '''Остановить выполнение действий'''

Немедленно прекращает выполнение всех последующих действий в текущем сценарии и сбрасывает точку выполнения диалога.

* '''Передача диалога'''

Переводит разговор, например, на оператора или в другой отдел. Для настройки необходимо указать ''Назначение'' передачи.

* '''Забыть данные'''

Позволяет стереть определенные данные, введенные пользователем, чтобы запросить их заново. При активации опции ''Перезапросить'' система автоматически сформирует запрос на ввод недостающих данных.

* '''Завершить диалог'''

Завершает текущий разговор с пользователем и закрывает сессию.

У некоторых действий есть опции:
* ''Считать действие успешным прохождением точки'' — этот флаг устанавливается на действия, которые означают, что сервис выполнился. В основном для отчетности.
* ''Прерываемое'' — этот флаг активируется для голосового канала и говорит о том, что допускается прерывание (перебивание) робота в момент синтеза ответа. Если он активен, робот будет реагировать на стоп-слова, в противном случае — нет.
* '''Установка переменной'''
позволяет задать или изменить значение переменной после выполнения определенного события в сценарии. Это мощный инструмент для создания сложной логики, например, для подсчета количества попыток входа в сервис и последующих действий в зависимости от этого значения.

* '''Принудительно перейти в КТ'''

позволяет принудительно отправить диалог в выбранную конечную точку.

'''2. Типы ответов для действия «Сказать»'''

При использовании действия «Сказать» вы можете выбрать один из четырех типов ответа:

1. ''Последовательно''

Робот будет выдавать вопросы и информацию по порядку, строго следуя списку, указанному в поле «Фразы».

2. ''Случайная фраза''

Робот выберет и произнесет одну случайную фразу из заданного списка.

3. ''Из внутреннего источника (недоступно для действий в элементах данных)''

Ответ формируется из Системы ответов на вопросы (QAS) для ответа из ''QAS документация'' нужно настроить'':''

* Условия присвоения категорий: Определяет правила, при которых система может направить запрос в эту категорию QAS для поиска ответа.

* Условия вывода ответа: Настройте параметры, такие как использование кеша ответов, генерация ответа и кеширование формулировок и [[QAS. UPS руководство по работе с интерфейсом#%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%20%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B8%20%C2%AB%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D1%8B%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2%C2%BB|выбрать шаблон запроса]]. Подробности [[QAS. UPS руководство по работе с интерфейсом|тут]].<blockquote>'''Обратите внимание:''' если вам нужно изменить шаблон запроса для определенной категории, это делается путем добавления отдельного действия. Настройка этого действия аналогична основному, но с выбором нужного шаблона. В Условиях запуска указываете данные, которые запустят это действие с шаблоном-исключением. </blockquote>

''QAS-чат'': Ответы генерируются AI-моделью (LLM) по умолчанию или другой моделью, добавленной администратором.

4. ''Из внешнего источника''

Позволяет подключить скрипты интеграций для выполнения специальных действий, если таковые имеются. Для действия «Сказать» с типом «Из внешнего источника» нажмите на специальную кнопку, расположенную рядом с полем выбора скрипта [[Файл:Postprocessing.png|безрамки]]. Откроется вкладка с выбранным скриптом, где вы можете:

* Просматривать код текущего скрипта,
* Редактировать существующий скрипт,
* Создавать новый скрипт.

<blockquote>Редактирование и создание скриптов не влияют на сохранение ЭД/КТ, т.к. они ссылаются только на id скрипта. Если вы выбираете другой скрипт для действия, обязательно сохраните изменения.</blockquote>'''3. Управление действиями'''

Для каждого действия доступны три опции управления (обычно отображаются в виде значков [[Файл:Для действий.png|безрамки|72x72пкс]]):

1. ''Копировать''

Чтобы скопировать действие в другой канал, нажмите эту кнопку и в открывшемся окне выберите целевой канал из списка.

2. ''Переместить''

Чтобы переместить действие в другой канал, выполните те же шаги, что и для копирования. <blockquote>'''Внимание:''' При перемещении действие будет удалено из исходного канала.</blockquote>3. ''Удалить действие''

Чтобы удалить действие, нажмите на кнопку в виде корзины.

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

===== Добавление кнопок в действия =====
В сценарной машине предусмотрена возможность добавления кнопок.

При наведении мыши на поле «Фраза» появляется кнопки-иконки , где по иконке с плюсом можно добавить кнопку:

# название кнопки;
# текст для отправки — это тот текст, который отправится на модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]], [[SEE. UPS руководство по работе с интерфейсом|SEE]]).

Чтобы внести изменения в созданную кнопку, кликните по ней левой клавишей мыши (ЛКМ) и в открывшемся меню можно редактировать или удалить эту кнопку.

Интерфейс позволяет гибко управлять расположением кнопок с помощью переносов на новую строку.

Чтобы настроить порядок кнопок:

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

Этот инструмент позволяет визуально сгруппировать кнопки и организовать интерфейс максимально удобно для пользователя.

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

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

''Переменные'' — служат для хранения данных, полученных из API или по каналам, запущенным извне. Например, это может быть ID пользователя в Telegram или CID из телефонного канала, то есть определившийся номер телефона.<blockquote>'''Переменные, как и данные, можно выбирать из выпадающего списка.''' Доступны все названия и значения, которые использовались ранее. Если вам нужно создать новую переменную и значение, просто введите их с клавиатуры. После этого они также будут предлагаться вам в дальнейшем.</blockquote>''Данные'' — элемент данных, полученный от моделей SMC или SEE.

''Интервал'' — период времени, в который запускается это действие. У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.
''Подтвердить'' — запуск действия в зависимости от наличия подтверждения от абонента.
[[Файл:Уведомление дублей.png|мини|''Рис. 9. Уведомление об одинаковых блоках ИЛИ в условиях запуска действий'']]
В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»'' (рис. 9)''.''<blockquote>'''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.</blockquote>

Также при сохранении настроек в окне "Условий запуска" если были обнаружены одинаковые блоки условий "ИЛИ", то будет соответствующее оповещение с выделением повторяющихся блоков ''(Рис. 9''.)

Пример использования условий запуска действий в конечной точке ''«Проверка статуса»:''<blockquote>
'''Ситуация 1.'''

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

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

'''Ситуация 2.'''

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

1. Определить элемент данных, который отвечает за отслеживание цифр (код). В нашем случае это модель SEE number и элемент данных «Код заявления».

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

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

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

==== Добавление и настройка элементов данных ====
[[Файл:Снимок экрана 2025-07-16 154838.png|мини|''Рис. 10. Массовое добавление элементов данных'']]
[[Файл:2025-12-11 11-15-27.png|мини|''Рис. 10.1. Бланк настройки элемента данных'']]
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку '''«Добавить элемент»'''. В появившемся диалоговом окне возможны два варианта добавления: '''"Одиночное"''' и '''"Массовое"'''.

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

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

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

'''Контейнер''' — составной элемент данных, который собирает необходимые данные, чтобы отправить их во внешнюю БД по API с помощью скриптов интеграции.

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

===== Настройка элемента данных =====
[[Файл:2025-04-23 14-43-07.png|мини|''Рис. 11 Проверка модели в ЭД'']]
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (''Рис. 10.1'').

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

'''«Вес»''' — это параметр, который определяет приоритет этого элемент данных в спорных ситуациях. По умолчанию установлено значение 3. Также вес ЭД отображается в [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчике]] и, если у вас активировано [[SES. UPS руководство по работе с интерфейсом#Панель управления SES|табличное представление сценария]], то и в самой таблице. <blockquote>Совет по работе с весом ЭД.

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

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

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

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

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

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

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

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

Рядом с комментарием находится кнопка '''Исключения''' [[Файл:Исключения .png|безрамки|20x20пкс]]. По нажатию на эту кнопку можно для определенных элементов данных настроить нестандартные исключения, то есть исключения, отличные от общих настроек (рис.12). <blockquote>
Например, для ЭД «Название филиала». [[SES. UPS руководство по работе с интерфейсом#Вкладка «Настройки»|В общих настройках]] робота МФЦ указано, что количество исключений для события «Нет данных» равно 3 (в счетчик входит и первое обращение к роботу, если там не было нужной информации). Однако мы хотим, чтобы, если с первого раза филиал не был найден, робот больше не запрашивал у абонента его название. Вместо этого робот должен показать заглушку с предложением поискать нужный филиал на сайте. Для таких случаев можно настроить '''нестандартное исключение.''' </blockquote>Настройка нестандартного исключения:

# выберете нужный элемент данных,
# кликните на значок исключения [[Файл:Исключения .png|безрамки|20x20пкс]],
# в появившемся окне активируйте флаг «включить нестандартные исключения»,
# заполните тип исключения Нет данных,
# установите максимальное кол-во исключений подряд (если хотите уточнять один раз, то макс.кол-во устанавливайте равным 2),
# установите канал связи при необходимости,
# и выберете действие на случай, если исключение наступило.
[[Файл:Постобработка ЭД.png|мини|''Рис. 12.1. Постобработка данных'']]
Далее находится кнопка '''«Постобработка»''' [[Файл:Postprocessing.png|безрамки]]'''.''' При нажатии на нее появится всплывающее окно с редактором кода, где можно написать функцию, которая будет срабатывать после того как ЭД был получен (Рис. 12.1). Установите галочку '''«Включить постобработку»''' и в редакторе отобразится функция-обработчик, которая принимает на вход три параметра: ''значение ЭД, текст последнего сообщения, канал'', и возвращает значение ЭД и опционально текст сообщения.<blockquote>'''Пример:'''

<code>def handler(value, message, channel):</code>

<code> if value == 'старый' and message == 'старый' and channel == 'voice':</code>

<code> return 'новый', {'text':'новый'}</code>

<code> elif value == 'новый' and message == 'новый' and channel == 'voice':</code>

<code> return 'старый', {'text':'старый'}</code>

<code> return value, {'text': 'не тот канал'}</code></blockquote>

'''Тестирование скриптов в ЭД'''

Процесс тестирования скриптов в ЭД аналогичен тестированию скриптов во вкладке "Скрипты", с учетом того, что скрипты находятся непосредственно в самих ЭД.

Важное отличие:

* Для ЭД типа «Класс» или «Сущность» - поле «Значение» обязательно для заполнения.
* Для ЭД типа [[SES. UPS руководство по работе с интерфейсом#Произвольный элемент данных|«Произвольный»]] - поле «Значение» заполняется по необходимости (опционально).

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

'''Работает только в условиях запуска. Если ЭД с этим флагом стоит на входе в КТ, то фраг игнорируется.'''</blockquote><blockquote>'''Пример: Запись на прием'''

1. Процесс взаимодействия с пользователем

Пользователь хочет записаться на прием. Для этого необходимо собрать следующие данные:

* Намерение (цель обращения).
* Адрес (куда хочет попасть пользователь).
* ФИО.
* Номер телефона.

2. Работа моделей в КТ "Запись на прием"

* Все модели, отвечающие за обработку запроса, работают в фоновом режиме.
* На любом этапе диалога они могут «выхватывать» сущности (например, извлекать ФИО, адрес и т. д.).

3. Проблема ложного срабатывания

Модель может ошибочно извлечь данные, если:

* Пользователь вводит информацию, которая частично совпадает с искомой сущностью (например, город ''"Владимир"'' может быть ошибочно принят за имя).
* Это приводит к некорректной обработке данных до завершения сценария.

4. Решение: ограничение работы модели

Чтобы избежать ложных срабатываний:

* Активируйте галочку '''«Получать только прямым запросом»''' в настройках ЭД.
* Если галочка активна, модель (например, извлечение ФИО) сработает только когда:
** Сценарий диалога дошел до запроса ФИО.
** Пользователь явно отвечает на вопрос о недостающих данных по ФИО.

Таким образом, '''система не будет обрабатывать случайные упоминания имен или других сущностей вне контекста запроса.'''</blockquote>Флажок '''«Подставлять ответ модели в запрос к ЧаВО»''' предназначен для работы с типами ЭД «Сущность». Его основная функция — подставлять в запросы пользователей ответ от модели (название тэга) SEE вместо исходного текста абонента, на который среагировала модель.<blockquote>'''Пример использования'''

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

# Создаем модель SEE с тегами:
#* <code>до 14 лет</code>
#* <code>с 14 лет до 18 лет</code>
#* <code>с 18 лет</code> ''(Теги формируются на основе предоставленной документации.)''
# Добавляем ЭД в качестве недостающего элемента в настройки КТ.
# Когда сценарий доходит до дозапроса этого ЭД или абонент сам предоставляет данные, система отправляет запрос в QAS. Например, абонент отвечает, что ему 44 года, но в документах нет такого варианта. В них информация сгруппирована <code>до 14 лет</code>, <code>с 14 лет до 18 лет</code> и <code>с 18 лет.</code> Соответственно система не найдет похожую информацию.
# Решение:
#* Если флажок активирован, система подставит ближайший подходящий тег (в данном случае — <code>с 18 лет</code>).
#* Это поможет QAS корректно находить информацию в документации.
'''Важно:''' если ваша модель SEE '''не отдаст ответ''', то настройка '''не сработает'''. Проверьте и при необходимости дообучите модель.</blockquote>

Флаг '''«Удалять сущность из запроса к ЧаВО»''' предназначен для типов «ЭД Сущность» и работает наоборот: он удаляет из запроса пользователя слова или фразы, которые распознала модель.

Флажок '''«Режим долгого ожидания»''' Открывает дополнительное меню с триггерами окончания ожидания. Это данные, при получении которых мы прекращаем ждать именно этот элемент данных (ЭД). Например, если получили его же или другие данные, например, просьбу позвать оператора.<blockquote>'''Обратите внимание:''' чтобы этот режим работал правильно, создайте нестандартное исключение для ЭД (описание выше). Иначе система будет ориентироваться на общие настройки количества исключений.</blockquote>

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

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

===== События элемента данных =====

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

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

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

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

'''Тип события''' '''«Элемент получен».''' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).

'''Тип события''' '''«Тишина»''' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек молчит.[[Файл:Уведомление об отсутствующем классе.png|мини|''Рис. 14. Уведомление об отсутствующем классе'']]<blockquote>
Например, если робот спрашивает у абонента, какой паспорт ему нужен, а человек молчит, можно через некоторое время повторить вопрос или сказать: «Говорите громче, не слышно».</blockquote>

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

В таблице элементов данных предусмотрено уведомление ''(Рис. 14)'' об отсутствующей модели на сервере, которую использует элемент данных, а также об отсутствующем классе/группе в выбранной модели. При таких случаях слева от элемента данных расположен значок [[Файл:Warning.png|безрамки]], при наведении курсора мыши на который появляется соответствующее сообщение.

===== Произвольный элемент данных =====
Элемент данных типа «Произвольный» предназначен для обработки произвольных текстовых данных от пользователя, таких как:

- Нажатия кнопок (текста на кнопках),

- Точные текстовые фразы,

- Данные, присваиваемые через скрипты.

''Простая настройка:''

- Текст: текст от пользователя (например, текст на кнопке или точная фраза), который нужно «отловить».

- Значение элемента данных: присваиваемое значение этому элементу данных (param).

''Универсальное применение:''

- Обработка различных кнопок в одном элементе данных.

- Возможность скриптового присвоения любых значений.

- Замена использования элемента-заглушки со скриптами.

- Пользоваться таким ЭД можно точно так же как и другими элементами. Вести в разные действия и категории исходя из значения произвольного ЭД.<blockquote>''Пример использования''

Сценарий: Обработка различных текстов с кнопок БЕЗ обработки моделями, то есть модель может «не знать» этих фраз:

- Текст: "Поддержка участников СВО" → Значение ЭД: «Поддержка СВО»

- Текст: "Льготы для пенсионеров" → Значение ЭД: «Социальные услуги»

Таким образом, один произвольный элемент данных может обрабатывать множество различных вариантов ввода.</blockquote>[[SES. UPS руководство по работе с интерфейсом#События элемента данных|События]] на этом элементе аналогичные как и на обычных ЭД.

[[Файл:2025-10-06 13-10-56.png|мини|''Рис. 15 Интерфейс контейнерного ЭД'' ]]

===== Элемент данных типа «Контейнер» =====
Контейнер — это составной элемент данных, который объединяет несколько дочерних элементов для последующей обработки. Его основная функция — сбор необходимых данных и их отправка во внешнюю базу данных через API с использованием скриптов интеграции.

Доступ к редактору скриптов:

# Перейдите в карточку элемента данных «Контейнер»
# Нажмите на кнопку вызова редактора скриптов [[Файл:Postprocessing.png|безрамки]]
# ''Важно:'' Если скрипт не заполнен, кнопка будет подсвечиваться красным цветом

Создание функции обработки:

* При нажатии на кнопку открывается всплывающее окно с редактором кода
* Функция выполняется после получения всех данных элемента
* Для активации установите галочку «Включить скрипт обработки»

Функция принимает три входных параметра:

# <code>value</code> — значение текущего элемента данных
# <code>message</code> — текст последнего сообщения от пользователя
# <code>chanel</code> — идентификатор канала взаимодействия

Функция возвращает:

* Обязательно: обработанное значение элемента данных (value и записывает его в значение ЭД param)
* Опционально: текст сообщения для пользователя

События контейнерного ЭД:

* ''«Элемент получен».'' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).
* ''«Нет данных»'' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек говорит что-то, но не ответ на вопрос.

==== Добавление и настройка конечных точек ====
[[Файл:2024-11-18 12-00-28.png|мини|''Рис. 16 Рабочая область SES'']]Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В верхней правой части рабочей области расположена кнопка '''«Добавить конечную точку»''' (рис. 16). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки образуют «облако конечных точек».

===== Настройка конечной точки =====
После того как вы ввели название конечной точки и нажали кнопку '''«Добавить»''', слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается ''название конечной точки'', при желании его можно сменить. Также доступен выпадающий список «Тип». Здесь можно выбрать один из четырёх вариантов:[[Файл:2025-03-28 14-57-55.png|мини|''Рис. 17 Типы входа в конечные точки'']]'''«Отчетный»''' — эта та, которая участвует в статистике, т.е. несет какую-то полезную для анализа информационную нагрузку.

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

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

'''«Завершение диалога»''' — конечная точка, которая ставит точку в общении с пользователем.[[Файл:2025-05-28 16-23-27.png|мини|''Рис. 18 Вход в КТ по условиям'']]

Также можно выбрать еще '''Тип входа в КТ''' может быть трех видов (рис. 17):

'''- по условиям''', когда попадаем в КТ при условии получения определенных данных, например, класс от SMC (рис. 18). На вкладках «Условия» доступна ''фильтрация по элементу данных.''

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

Абонент обратился за консультацией. Робот предоставил ответ. После консультации абонент бездействует, а сессия еще не закрыта. Можно настроить КТ Оценка качества обслуживания, которая по истечению указанного времени запросит оценку, после ответа абонента, завершит сессию.</blockquote>- '''по ручному запуску''', когда КТ нужно принудительного запустить, например для рассылки. Чтобы настроить вход в конечную точку нужно выбрать в меню Вход опцию «По ручному запуску». Интерфейс КТ по ручному запуску идентичен КТ со входом «По бездействию», за исключением поля «Время».

Такой вариант входа в КТ подходит для исходящих сообщений (обзвонов), например, чтобы отправить абоненту напоминание-подтверждение о предстоящей записи: «Уточните, пожалуйста, вы придете на прием?»

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

'''Настройка исключений для конечных точек'''

Вы можете настроить автоматическое реагирование на сбои в работе конечных точек. Исключения [[Файл:Исключения .png|безрамки|20x20пкс]] - это специальные действия, которые выполняются при нескольких последовательных неудачных запусках конечной точки.

Система отслеживает статус запусков. Когда количество неудачных попыток подряд достигает заданного вами значения (например, 3), автоматически выполняется указанное вами действие.

Пример настройки:

* Условие: 3 неуспешных запуска подряд.
* Действие: Перевести звонок оператору ''или'' Завершить диалог.

===== Условия входа и запуска конечных точек. Сбор информации =====
'''Типы условий для входа'''

Для настройки условий '''входа''' в системе доступны три основных типа:

1. ''Данные''. Проверка значений элементов данных.

2. ''Переменные''. Работа с системными и пользовательскими переменными.

3. ''Подтверждение''. Проверка статуса подтверждения от пользователя. Возможные значения:

* Получено (пользователь подтвердил действие)
* Не получено (пользователь отклонил действие)

Для '''условий запуска''' есть дополнительно 4-ое условие, помимо вышеперечисленных:

4. ''Интервалы.'' У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.

Для '''сбора информации''' есть только 2 варианта условий: данные и переменные.<blockquote>Применение: Эти типы условий позволяют гибко управлять логикой диалога, направляя пользователя по различным сценариям в зависимости от текущего контекста.</blockquote>

'''Условия входа (Вход).''' Для того чтобы попасть в конечную точку и выполнить определенные действия, нужно выполнить условия входа. Их может быть как один элемент данных, так и их сочетание.<blockquote>Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: ''«Загранпаспорт»'' (получена метка от [[SMC. UPS руководство по работе с интерфейсом|SMC]], соответствующая этому элементу данных). А также сочетание элементов данных: ''«Паспорт»'' (получаем, если тип паспорта не указан сразу) и ''«Тип паспорта-загран»'' (тег «Загран» получили после уточнения типа паспорта).</blockquote>Условия входа объединены в блоки, которые имеют логическое условие «И». Чтобы добавить новое условие, необходимо нажать на кнопку «Добавить условие» [[Файл:Добавить условие.png|безрамки|20x20пкс]]. Блоки с условиями «И» разделены логическим «ИЛИ».
Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:
* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* + (Прибавить) — для увеличения счетчика,
* - (Вычесть) — для уменьшения счетчика,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

[[Файл:Рис. 17 Условия запуска.png|мини|''Рис. 19 Условия запуска'']]
'''''Условия запуска и Сбор информации''.''' Вкладка ''Сбор информации'' и меню ''Условия запуска'' идентичны по своему назначению'''.'''

По нажатию на эту кнопку открывается окно, где нужно указать '''''все''''' случаи (данные и их комбинации), '''''при которых точка сработает''''' (см.рис. 19). В окне «Условия запуска» элементы данных разделяются логическим оператором «ИЛИ». В случае с комбинациями условий ЭД отделяются друг от друга логическим «И». Как в случае с элементами, разделёнными операторами «ИЛИ», так и с элементами, разделёнными «И», порядок элементов можно менять. Аналогично для вкладки Сбор информации.

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

Условия можно редактировать: добавлять и удалять. Окно можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.<blockquote>Например, конечная точка «Консультация» активируется, если будут получены метки «Апостиль» ИЛИ «Банкротство» ИЛИ «Загранпаспорт» и «Тип паспорта — загран».</blockquote>В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»''. '''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.

У условий есть параметр ''«Тип»'', принимающий два значения: данные или переменная. Параметр ''«Искать»'' имеет три варианта:

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

Далее идет поле «Название», где из выпадающего списка требуется выбрать нужный элемент данных. <blockquote>Если в выбранном элементе данных не заполнено событие «Недостающий элемент», то в правом верхнем углу будет расположен значок [[Файл:Warning.png|безрамки]] со всплывающим уведомлением при наведении на него.</blockquote>Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:

* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

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

===== Условия присвоения категорий =====
[[Файл:2025-07-07 12-42-57.png|мини|''Рис. 20 Вкладка Действия и Условия присвоения категорий'']]
'''''Условия присвоения категорий'''.'' По клику на эту кнопку раскрывается меню (рис. 20), в котором есть выпадающий список со всеми категориями из [[QAS. UPS руководство по работе с интерфейсом|QAS]], а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ». ''Окно с условиями категорий или условиями запуска можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.''<blockquote>На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ». </blockquote>Флажок '''«Запрос в QAS с учетом прошлого контекста»''' указывает системе, что перед отправкой запроса в QAS необходимо проанализировать предыдущие сообщения пользователя. Это позволяет сохранять логику диалога и избегать необоснованной смены тематики.<blockquote>'''Пример работы'''

# Без включенной функции
#* Пользователь спрашивает: ''"Какие документы нужны для оформления СНИЛС?"'' → система направляет запрос в категорию СНИЛС.
#* Затем пользователь уточняет: ''"А сколько это стоит?"'' → система определяет метку Госпошлина и перенаправляет запрос в соответствующую категорию, теряя контекст СНИЛС.
# С включенной функцией
#* Если флажок активен (например, для категории ''Госпошлина''), система:
#** Проверяет предыдущие сообщения.
#** Если диалог начался в другой категории (например, СНИЛС), запросы объединяются (''"склеиваются"'').
#** Если контекст отсутствует, тематика меняется, но поиск ответа ведется сразу по обеим категориям (СНИЛС + Госпошлина).

'''Когда использовать'''

Активируйте эту настройку для категорий, которые могут:

* Быть частью более широкого запроса (например, ''Госпошлина'' как дополнение к ''СНИЛС'').
* Требовать сохранения контекста диалога.

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

===== Индикация удаленных категорий =====
Система визуально выделяет удаленные категории для привлечения вашего внимания:

# Конечные точки с недействительными категориями в табличном представлении: помечаются специальным значком и выделяются красным цветом. При наведении на значок сообщение: ''«Используются несуществующие категории в канала: [название_канала](кол-во)»''
# В облаке конечных точек: КТ с недействительными категориями также отображаются красным цветом, но без значка.
# В условиях присвоения категорий: Если используется удалённая категория, система отобразит предупреждающее уведомление ''«Используются несуществующие категории: [кол-во]»''.

Это позволяет быстро находить и корректировать объекты, которые зависят от неактуальных данных. А так же это важно для экспорта и импорта роботов (см. разд. Панель управления).

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

==== Связанная фильтрация ЭД и КТ ====
В интерфейсе реализована связанная фильтрация между таблицами Элементов Данных (ЭД) и Контрольных Точках (КТ). Это позволяет автоматически находить взаимосвязанные объекты.

'''Принцип работы:'''

* Фильтрация по ЭД: При вводе названия в фильтр таблицы Элементов Данных:
** В таблице ЭД отображаются только те элементы, названия которых соответствуют фильтру.
** Одновременно в таблице КТ автоматически отображаются только те Контрольные Точки, в которых используются отфильтрованные ЭД.

* Фильтрация по КТ: При вводе названия в фильтр таблицы Контрольных Точек:
** В таблице КТ отображаются только те точки, названия которых соответствуют фильтру,
** Одновременно в таблице ЭД автоматически отображаются только те Элементы Данных, которые используются в отфильтрованных КТ.

<blockquote>'''Важно''':

Система учитывает использование Элементов Данных во всех типах Контрольных Точек:

1. Входные данные (вход).

2. Собираемая информация (условия запуска/сбор информации).

3. Условия запуска действий.</blockquote>

==== Тестирование робота ====
[[Файл:2025-10-06 11-49-26.png|мини|307x307пкс|''Рис. 21 Окно чата для тестирования робота'']]
В интерфейсе SES есть чат с отладчиком (рис. 21), где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок [[Файл:Чат.png|безрамки|20x20px]] в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка '''«Перезапустить сессию»''' [[Файл:Обновить данные вопроса.png|безрамки|20x20px]], которая сбрасывает всю переписку и данные отладчика. А слева — кнопка '''«Данные сессии»''' [[Файл:Кнопка отладчик без полей.png|безрамки|20x20px]], предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS и не только, подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Данные сессии|Данные сессии]]. И кнопка '''«Тестирование скрипта»''' [[Файл:Пробирки.png|безрамки|20x20пкс]], подробнее [[SES. UPS руководство по работе с интерфейсом#Тестирование скриптом|тут]]. Есть возможность отправлять в чат файлы нажав на [[Файл:Скрепка.png|безрамки|20x20пкс]] и выбрав файл (в любом формате).

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

Режим отладки (дебаг):

* В режиме отладки появилась панель логов.
* Логи автоматически обновляются после каждого ответа от робота.
* Вместе с логами также обновляются данные текущей сессии.

Настройки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] чата позволяют выбрать настройки аудиоответов, а так же установить переменные, например, номер телефона.

Еще в меню настроек можно выбрать КТ по ручному запуску, чтобы протестировать работу КТ и сценария (рис. 22).
[[Файл:2025-10-20 10-56-18.png|мини|300x300пкс|''Рис. 22 Выбор конечной точки для тестирования.'']]

===== Тестирование в текстовых каналах =====

===== Данные сессии =====
Раскрыв данные сессии можете увидеть, все данные о текущем диалоге с роботом. Разберем по порядку, ниже представлены некоторые данные из ключа root, они нужны не все, разберем только нужные:<blockquote>
"started":"2025-06-10 09:46:05" — ''время начала сессии''

"modified":"2025-06-10 09:49:08" — ''когда произошли изменения последние (пришел запрос/изменилась тематика)''
"robot":"ffeaa99a-13d2-4bff-b458-1231c884f8ee" — ''id робота, у продовой версии будет приписка _prod''

"session":"beefb6a2-dc08-47d4-9e02-2495329173ec" — ''id сессии''

"channel":"default" — ''активный канал, в котором происходит тестирование''

"connector":"web"

"unknown":false.
</blockquote>
[[Файл:2025-10-06 12-45-38.png|мини|''Рис. 23 Пример работы с отладчиком'']]
Далее идет самая интересная для аналитиков часть - <code>"current"</code> . Раскрыв этот ключ можно посмотреть в какую конечную точку привёл сценарий, и была ли запросу присвоена какая-либо категория. А так же параметр ''data'', раскрыв который можно увидеть все классы (рис. 23 и 23.1), которые пришли от модели [[SMC. UPS руководство по работе с интерфейсом|SMC]] и/или модели [[SEE. UPS руководство по работе с интерфейсом|SEE]] и их достоверность и вес. Раскрыв в ''data'' параметр ''reply -'' увидеть данные ответа от робота. Имея все эти данные можно отладить работу сценария.
[[Файл:2025-10-06 12-47-26.png|мини|''Рис. 23.1 Работа с отладчиком. Просмотр параметра data и логов'' ]]
<blockquote>"current":{

"id":"Консультация ЧаВО" — конечная точка, в которую привел сценарий,

"qas":"оформить снилс" — запрос, который отправился в QAS.

}<blockquote>'''Обратите внимание:''' если параметр QAS в отладчике пустой, это значит, что ваш запрос не был передан в QAS. Если же в этом параметре отображается ваш запрос, но робот просит вас перефразировать его, то, вероятно, в базе данных не хватает формулировки с ответом или на ответе отсутствует пометка «проверено». Это может происходить, когда в настройках КТ, отвечающей за консультирование из базы данных QAS, установлен параметр «Использовать кэш ответов» в режиме «Только проверенные ответы». </blockquote>'''Отработка склеек и удержания контекста''': в QAS летит вообще вся история сообщений в рамках одного контекста общения '''через разделитель «|»'''. Модель генерации будет отвечать на последний вопрос в цепочке с учетом ранее написанных сообщений в этом контексте.

"answered":true — был ли ответ true/false
"category":[0:"МФЦ НСО СНИЛС"] — отображается список категорий, в которые попал вопрос (их может быть больше одной).

"nearest":NULL

''Следующий кусок ключа current проще объяснить на примере запроса "оформить паспорт":''

"entry":"entry":[0:"Паспорт, вес 3" ] — зашли в КТ по метке «Паспорт», запросили тип паспорта (загран), старый/новый образец и дошли до возраста получателя:

"missingRunData":[

0:"Возраст заявителя для заграна, вес 3"] — тут отображаются ЭД, которые нужны для «пропуска» дальше в действия.

"passedRunData":[ ] — список условий AND, который выполнился.

"waitingRunData":

"Возраст заявителя для заграна, вес 3" — отображается ЭД, который запросили и ждем получения.

"border":0 — отражает границу, от которой система смотрит на данные. Например, при border:1 - система будет смотреть от 2-го ЭД в списке data и ниже. При border:0 - с первого.

"preborder":0

}</blockquote><blockquote>"models":[...] — раскрыв список, можно посмотреть все модели, которые отработали за сессию.

"scripts":[] — отображает список скриптов, которые отработали за сессию.

"data":[...] — раскрыв data, можно увидеть параметр "message" — фраза-сообщение пользователя. И под каждым message, есть своя data, где находятся все метки и все тэги, пришедшие от моделей SMC и SEE на эту фразу.

"timers":[...]

"variables":{} — тут отображаются пришедшие переменные, если есть.

"error":"" — выводит ошибку при отработке скрипта.

"events":{ — параметр отображает счетчики событий за сессию (не найдено/нет данных/тишина).

"not found":{...}

"no data":{...}

"silence":{...}

}</blockquote>

[[Файл:2025-06-10 16-15-43.png|мини|''Рис. 24 Окно автотестирования скриптов'']]

===== Тестирование скриптом =====
[[Файл:2025-06-10 16-22-59.png|мини|''Рис. 25 Добавление скрипта для тестирования'']]
[[Файл:Тестирование скриптов.png|мини|''Рис. 26 Интерфейс окна «Тестирование скриптов»'']]
Теперь вы можете автоматически тестировать робота с помощью скриптов. Например, если у вас возникли сложности с маршрутизацией и нет желания каждый раз вручную воспроизводить весь диалог при отладке сценария, вы можете сохранить его для последующего тестирования. Для этого кликните на кнопку [[Файл:Пробирки.png|безрамки|20x20пкс]] справа от чата появится окно. Добавить скрипт можно путем '''''импорта из файла''''' [[Файл:Импорт нов.png|безрамки|20x20пкс]], если есть данные '''в формате txt''' или '''''импортировать диалог''''' из текущей сессии. Нажмите на иконку импорта или выберите ''«Скрипт»'' в выпадающем меню и нажмите '''''«Добавить скрипт»''''' (рис. 24). Появится диалоговое окно «''Добавление скрипта»''. Введите название скрипта, выберите файл и нажмите ''«Добавить»''. Если у вас уже открыта сессия, отметьте в окне добавления скрипта опцию '''''«Импорт из чата»'''.'' Если у вас несколько скриптов, переключаться между ними можно через выпадающий список ''«Скрипт».''

Правее него находятся иконки ''импорт'' [[Файл:Импорт нов.png|безрамки|20x20пкс]], ''экспорт'' [[Файл:Экспорт нов.png|безрамки|20x20пкс]] и ''удалить'' [[Файл:Удаление документа.png|безрамки|20x20пкс]]. Импорт был описан ранее. '''''Экспорт''''' позволяет выгрузить скрипт в формате txt. Кнопка '''''удалить''''' - удаляет весь скрипт.

Файл для импорта и экспорта - это простой текстовый файл, в котором все запросы к роботу, каждый с новой строки.

Галочки обозначают точки останова (рис. 25). Когда они стоят, автотест останавливается и ждет, пока вы нажмете кнопку «Дальше». параллельно можно открыть отладчик и смотреть, что происходит на каждом этапе теста.

У тестирования есть два основных режима:

# Полный тест:
#* Все галочки сняты
#* Тест выполняется автоматически от начала до конца, без остановок
# Пошаговый режим:
#* Тест останавливается на каждом шаге
#* Для продолжения нужно нажимать "Дальше"

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

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

Последняя отправленная фраза будет выделена голубым цветом.

===== Просмотр данных сессии =====
Эта функция позволяет вам в реальном времени отслеживать диалоги и данные сессии у другого пользователя в '''рамках одного бота'''.

'''Подключение к отслеживанию'''

# Нажмите на иконку «Просмотр сессии» [[Файл:2025-10-22 12-54-24 (1).png|безрамки|20x20пкс]] . Введите название переменной, за которой хотите следить и ее значение (если требуется, например, номер телефона абонента) в соответствующие поля.
# Нажмите кнопку «Подключиться».
# Меню закроется, и вы увидите всплывающее уведомление с подтверждением успешного подключения.
# В основном интерфейсе индикатор отслеживания (иконка «Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]) изменит свой вид: он будет зачеркнут и периодически мигать. Это сигнализирует о том, что соединение активно и система ожидает данные.
Как поступают данные:

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

'''Отключение от отслеживания'''

Чтобы прекратить отслеживание, выполните одно из следующих действий:

* Нажмите на индикатор отслеживания («Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]), который активен в режиме подключения.
* Выполните команду «Сброс сессии» [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]].

Любое из этих действий разорвет соединение для отслеживания, и индикатор вернется в обычное состояние.

'''Пример настройки просмотра сессии'''

Пользователь, за чьим диалогом будет наблюдение, должен создать у себя переменную (любую) и ее значение:

* <code>variable = за мной следят</code>

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

Пользователь, который хочет подключиться для просмотра, должен в своем разделе ''просмотра сессии'' создать точно такую же переменную:

* <code>variable = за мной следят</code>

И после того, как начнется диалог, в режиме реального времени наблюдатель будет видеть все данные сессии того, кто ведет диалог с роботом.<blockquote>'''Функция для пользователей UPS'''

Для более удобного отслеживания вы можете использовать уникальный <code>id пользователя UPS</code> , который передается в переменные сессии.

* Вместо того чтобы указывать одинаковые переменные у обоих пользователей, вы можете напрямую указать <code>id пользователя</code>, за которым хотите следить.
* Это позволяет вам следить за конкретным пользователем, при этом ему не обязательно вручную задавать у себя переменную.
</blockquote>

===== Тестирование голосовыми сообщениями и в голосовом канале =====
[[Файл:2025-06-10 12-44-58.png|мини|''Рис. 27 Тестирование робота с помощью микрофона.'']]
Робота можно протестировать, задавая вопросы голосом и/или вводя переменные. Например, можно проверить, как робот отправляет в разные конечные точки, получая одинаковые метки от SMC и номера телефонов различных ведомств. Например, метка «Мобилизация» от SMC в сочетании с номером телефона МФЦ приводит в КТ Консультация ЧаВО, а «Мобилизация» и номер единого контактного центра (ЕКЦ) — в КТ Перевод на оператора. Чтобы провести тестирование робота с переменными раскройте меню, кликнув на иконку шестеренки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] и заполните поля:

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

- Значение: укажите значение этой переменной..
[[Файл:2025-10-06 11-51-58.png|мини|''Рис. 28 Иллюстрация тестирования канала voice.'']]
В этом же меню вы можете настроить параметры аудиоответов и автовоспроизведения.

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

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

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

В дебаггере есть функция, позволяющая протестировать '''голосовой канал - voice''' (рис. 28), то есть ''имитировать звонок''. Чтобы запустить процесс, достаточно нажать на кнопку «Начать разговор» [[Файл:Начать разговор.png|безрамки|20x20пкс]] . Пока разговор активен, кнопка изменится на «Закончить разговор» [[Файл:Закончить разговор.png|безрамки|20x20пкс]] . Переменные задаются в меню, как и в текстовом канале. Для этого нажмите на иконку шестерёнки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] (рис. 21).

=== Архив диалогов ===
[[Файл:Архив диалогов нов.png|мини|''Рис. 29 Интерфейс архива диалогов'']]
После тестирования робота в любом канале можно заглянуть в Архив диалогов (рис. 29), чтобы изучить данные сессии. Для этого необходимо кликнуть на одноименную кнопку на панели инструментов рядом с кнопками версий робота [[Файл:Архив диалогов.png|безрамки|20x20пкс]]. Интерфейс архива содержит:

* Список доступных роботов слева на экране.
* Блок с фильтрацией диалогов.
* До момента пока вы не выберете диалог из списка справа будет пустой блок с текстом «Выберете диалог». После того как диалог выбран вы увидите отображение аналогичное рисунку 29.
* Информационные вкладки (см. в разделе [[SES. UPS руководство по работе с интерфейсом#Настройка робота|«Настройка робота»]]).

==== Работа с архивом диалога ====
Архив диалогов поддерживает версионность робота, то есть можно просмотреть диалоги одной из трех версий: черновик, прод или архивной. Для этого кликните по кнопке с нужной версией находясь уже в Архиве либо предварительно выбрав ее и перейдя в архив. Диалоги в архиве фильтруются по дате и времени, для этого кликните на иконку календаря [[Файл:Календарик с фоном.jpg|безрамки|20x20пкс]] в поле «Начало» и «Конец», чтобы выбрать дату. И время, кликнув на иконку часов ''(по умолчанию дата и время выставляются за текущие сутки)''. Выберите нужную дату и время, добавьте необходимые фильтры. Также можно отфильтровать звонки по:

# каналам связи:
* default,
* telegram,
* web,
* voice,
* vkontakte.
2. элементам данных — при нажатии на это поле открывается перечень всех элементов данных из сценария текущего робота.

3. номеру телефона,

4. ID диалога берется из отладчика — это значение атрибута <code>session</code>. В архиве диалогов предусмотрено копирование ID: при нажатии на иконку копирования она загорается зеленым, что означает успешное копирование в буфер обмена.

5. по названию и значению переменной,

3. либо тексту, либо ключевым словам, которые могут быть в искомом диалоге.

После настройки система, по нажатию кнопки «Поиск», отобразит все диалоги с роботом, учитывая выбранные фильтры (рис. 27). На самом верху над диалогом можно просмотреть его ID. В архиве диалоги сгруппированы по принципу «запрос от пользователя — ответ робота». При выборе каждой пары открывается отладчик, где можно увидеть метки и теги, полученные от моделей, копия [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчика]] из тестирования робота. Этот отладчик аналогичен тому, что используется в сценарной машине. Для голосового канала есть возможность прослушивания аудио диалога помимо текстового просмотра. Также есть возможность импортировать запросы диалога в скрипт тестирования в чат-отладчик по кнопке '''«Добавить в скрипт тестирования»''' снизу диалога и в появившемся окне введите название скрипта тестирования. После чего он появится в списке скриптов тестирования сценария.

Для вашего удобства во время ''активного'' диалога в архиве доступна кнопка '''«Следить за диалогом»'''. Нажмите кнопку «Следить за диалогом» во время просмотра архива ''активного'' диалога. Система начнёт автоматически обновлять список реплик, подгружая новые сообщения. Обновление происходит каждые 5 секунд, обеспечивая актуальный вид беседы без необходимости обновлять страницу вручную. Позволяет в реальном времени следить за развитием ещё не завершённого диалога, например, во время тестирования или активного общения с роботом.

===== Синхронизация текста и аудио в архиве диалогов =====
В архиве диалогов реализована условная синхронизация текстовой расшифровки с аудиозаписью на основе временных меток (datetime).

* При воспроизведении аудио: В текстовой расшифровке автоматически подсвечивается реплика (вопрос/ответ), которая звучит в данный момент.
* При клике на текст реплики: Воспроизведение аудио автоматически перематывается на тот момент записи, когда эта реплика абонента была произнесена.

Результат: Вы можете быстро находить нужные фрагменты разговора и удобно анализировать диалоги.

Чтобы '''выйти из Архива диалогов''' в сценарий нужно снова кликнуть на иконку [[Файл:Архив диалогов.png|безрамки|20x20пкс]].

=== Пользовательские справочники ===
[[Файл:Photo 2025-05-14 17-30-31.jpg|мини|''Рис. 30 Добавление пользовательского справочника'']]

Для доступа к справочнику нажмите на значок «Пользовательский справочник» [[Файл:Справочник (1).png|безрамки|20x20пкс]] на панели инструментов справа от архива диалогов. Чтобы создать новый справочник, нажмите кнопку '''«Добавить справочник»''' (рис. 30). В открывшемся окне заполните обязательные поля: название справочника и его структуру — наименования колонок. При необходимости задайте значения по умолчанию для каждой колонки. Эти значения будут автоматически заполнять новые строки. Затем нажмите '''«Добавить»'''.

Если значения по умолчанию не указаны, справочник будет пустым. Заполнять таблицу можно вручную.

Справочники можно переименовывать и удалять. Чтобы переименовать или удалить справочник, наведите курсор на его название. Появится две иконки: карандаш для переименования и корзинка для удаления. <blockquote>'''Перед переименованием справочника ''обязательно'' сохраните внесенные изменения, иначе они будут удалены.'''</blockquote>[[Файл:2025-05-20 14-45-35.png|мини|''Рис. 31 Удаление записей из пользовательского словаря'']]
При нажатии на карандаш откроется окно '''«Редактирование структуры».''' Важно помнить: изменения можно внести только в название справочника или в значения по умолчанию (если предыдущие значения были, они будут автоматически обновлены). ''Переименовать столбцы нельзя.'' После сохранения изменений нажмите кнопку '''«Сохранить»''', расположенную внизу под таблицей (рис. 31). <blockquote>'''Внимание! Справочники зависят от версии робота.''' Если вы вносите изменения в структуру справочника в черновой версии [[Файл:Черновик.png|безрамки|20x20пкс]], то для применения этих изменений в продовой версии нужно применить робота в прод.

'''Важно:''' переносится '''только структура справочника'''. Данные не дублируются. Их можно перенести вручную, экспортировав [[Файл:Экспорт нов.png|безрамки|20x20пкс]] из черновика и импортировав [[Файл:Импорт нов.png|безрамки|20x20пкс]] в прод. </blockquote>Вы можете фильтровать записи по содержанию любой колонки. Выделите галочками несколько записей сразу и удалите их. В правом нижнем углу появится иконка корзины, как только вы выберете хотя бы одну запись (рис. 31).

Справочники можно ''экспортировать'' и ''импортировать''. Экспорт и импорт осуществляются в формате JSON.
[[Файл:Снимок экрана 2025-07-16 175752.png|мини|''Рис. 32 Импорт пользовательского словаря'']]

''При импорте структуры импортируемого файла и справочника в интерфейсе должны совпадать''. Если они не совпадают, то заполнятся только совпадающие поля. Есть возможность ''импорта'' с дополнением новых данных, либо полной заменой (''Рис. 32''). Структура экспорта:<blockquote>
[

{"колонка1":"значение 1","колонка2":"значение 2","колонка3":"значение 3","id":"58845671-1150-4ae2-9c46-e8aeb2553c57"},

{"колонка1":"значение 2","колонка2":"значение 2","колонка3":"значение 3","id":"2e0a7f8e-6d64-4df9-a3ce-5862f8eb441c"}

]
</blockquote>Структура json-файла для импорта:<blockquote>[

{"колонка1":"значение 4","колонка2":"значение 5","колонка3":"значение 6"},

{"колонка1":"значение 2","колонка2":"значение 3","колонка3":""}

]

При импорте не обязательно указывать id.</blockquote>Чтобы '''выйти из Пользовательских справочников''' в сценарий нужно снова кликнуть на иконку [[Файл:Справочник (1).png|безрамки|20x20пкс]].

=== Панель управления SES ===
Панель управления SES включает в себя 8 кнопок: импорт, экспорт, обнуление черновика рабочей версией, применение робота, восстановление робота, применение настроек робота, массовая замена моделей в элементах данных и меню пользователя.

{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления''
!'''Иконка кнопки'''
!'''Название иконки'''
!'''Описание'''
|-
|[[Файл:Export.png|центр|безрамки|40x40пкс]]
|Экспорт
|Для создания резервной копии или переноса робота выполните его экспорт в ZIP-архив. В архив будут включены все настройки робота: элементы данных, конечные точки, скрипты, структуры пользовательских справочников (''но не включая сами данные''), а также связанные модели и базы данных QAS.<blockquote>'''Внимание!''' Перед экспортом убедитесь, что категории и модели актуальны. В противном случае экспорт может завершиться ошибкой, и робот не будет экспортирован.</blockquote>
|-
|[[Файл:ImportRobot.png|центр|безрамки|40x40пкс]]
|Импорт
|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''.|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''. Аналогично экспорту, доступен и импорт робота с моделями SMC, SEE и QAS в различные наборы данных.
<blockquote>'''Как работает импорт:'''

* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.
'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>
|-
|[[Файл:Стрелка.png|безрамки|40x40px|центр]]
|Обнулить черновик рабочей версией
|Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Применить.png|безрамки|40x40px|центр]]
|Применить
|По нажатию на эту кнопку черновая версия робота становится рабочей ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Откат.png|центр|безрамки|40x40px]]
|Восстановить
|С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной ''(кнопка активна только в архивной версии)''.
|-
|[[Файл:Разетка.png|центр|безрамки|40x40px]]
|Применить настройки робота
|Применяет сохранённые настройки робота и начинает работать в соответствии с ними, что аналогично перезагрузке программного обеспечения, но без необходимости самой перезагрузки.
После нажатия на кнопку система переносит эти настройки в настройки прода, но НЕ ПРИМЕНЯЕТ, на случай, если ошиблись.

Робот в любой версии начинает работать с новыми настройками только после нажатия на кнопку. Если вы нажали на кнопку, находясь в черновике, будут применены настройки черновика. Если же вы нажали на кнопку, работая в рабочей версии, то будут применены настройки рабочей версии, которые вы только что перенесли из черновика. <blockquote>Обратите внимание: после внесения каких-либо изменений кнопка будет красной [[Файл:Красная вилка (1).png|безрамки|20x20пкс]] и пульсировать, напоминая о необходимости применить настройки. </blockquote>
|-
|[[Файл:Смена моделей.png|центр|безрамки|40x40пкс]]
|Массовая замена моделей в элементах данных
|[[Файл:Замена моделей в ЭД.png|мини|''Рис. 33. Массовая замена моделей в элементах данных'']]Эта функция позволяет массово менять модели в элементах данных. После нажатия на кнопку появляется форма ''(Рис. 33)'', в которой необходимо указать тип элемента данных ''(Класс / Сущность)''. Затем в поле '''"Заменяемая модель"''' выбрать модель из списка моделей, используемых в уже существующих элементах данных ''(снизу будет указано количество элементов данных, использующих выбранную модель)'', и в поле '''"Заменяющая модель"''' выбрать доступную модель для замены. После нажатия на кнопку '''"Заменить"''' будет произведена замена выбранной модели в тех элементах данных, в которых она используется.
|-
|[[Файл:Меню пользователя new.png|безрамки|40x40px|центр]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, убрать/показать фон, выход из системы), а также возможность переключить ''отображение рабочей области с табличного на облачный вид и наоборот''.
В меню пользователя добавлена функция ''выбора набора данных*.''

При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

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

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

2025-12-24T10:00:21Z

E.Elagina: /* Вкладка «Коннекторы» */

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

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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# SES Сценарная машина,
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]],
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]].
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2).
[[Файл:2025-06-09 14-33-48.png|мини|''Рис. 2 Рабочая область SES'']]

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

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

==== Добавление и настройка робота ====
Чтобы добавить нового робота, нажмите кнопку '''«Добавить робота»'''. В появившемся диалоговом окне введите название и нажмите '''«Добавить»'''. В нижнем правом углу экрана появится сообщение «Добавлено!». По умолчанию робот создается с предварительными настройками. В нем сразу есть текстовки для исключений и событий, ознакомиться и поправить их можно, перейдя на вкладку [[SES. UPS руководство по работе с интерфейсом|«Настройки»]]. Робот может быть 3х версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
{| class="wikitable"
|+''Табл. 1 Версии робота.''
!'''Иконка версии'''
!'''Наименование версии робота'''
!'''Описание'''
|-
|[[Файл:Черновик.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]], если вы планируете предоставлять консультации.

Здесь представлен общий перечень необходимых сервисов. В зависимости от специфики проекта некоторые из них могут отсутствовать.
[[Файл:2025-07-04 17-15-25.png|мини|''Рис. 3 Интерфейс вкладки Скрипты'']]

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

У скриптов есть параметр '''''«Область действия»''''', в котором есть 5 опций:

- ''конечные точки'', позволяет подключать скрипт в действиях конечных точек;

- ''элементы данных'', позволяет подключать скрипт в действиях элементов данных и контейнеров;

Скриптов на ЭД и КТ может быть несколько. Остальные скрипты общие и доступны только по одному на каждый тип:

- ''завершение сессии'' — скрипты, которые могут выполняться после завершения диалога, если скрипт указать в настройках в действиях на событии «Завершение диалога»;

- ''перед каждым вопросом'' — для случаев, когда нужно актуализировать какую-то информацию постоянно и использовать ее в условиях.<blockquote>

Скриптом «перед каждым вопросом» можно выставить, например, сегодняшнюю дату - ${custom.today}, а потом ее в сравнении дат использовать в условиях получения данных. Для случаев записи на прием проверять, '''что дата точно больше сегодняшней.'''

'''Скрипт проверки пишется админом.''' </blockquote>

- ''после каждого ответа'' — для случаев, где требуется пошагово после каждого ответа передавать информацию во внешнюю систему.

- ''передача диалога,'' скрипты для передачи диалогов.

- ''старт диалога.''

====== Дефолтные скрипты ======
В системе реализованы шаблоны скриптов по умолчанию:

Назначение:

* Автоматическое создание базовой функции при создании нового скрипта
* Возможность последующего редактирования

Расположение и настройка:

* Файлы находятся в переводчике по пути: <code>lang\ru.json</code>
* Реализовано для гибкости - администратор может изменять настройки
* Не зашито в код системы

Типы дефолтных скриптов:

* <code>_defaultScriptContainer</code> - для ЭД типа "Контейнер" (скрипты обработки)
* <code>_defaultScriptData</code> - для ЭД (скрипты постобработки)
* <code>_defaultScriptAction</code> - для действий в ЭД/КТ

[[Файл:Scrirts.png|мини|''Рис. 4 Отладка скриптов интеграции'']]
Есть '''режим отладки скриптов интеграций''' с функцией извлечения данных из сессии (рис. 4). То есть можно [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|тестировать робота в чате отладчика]] и, в случае если отработка некорректна или нужно проверить внесенные изменения в скрипт, то можно открыть вкладку «Скрипты» -> выбрать нужный скрипт -> кликнуть на закладку «Проверка» (слева откроется дополнительное окно) и нажать на кнопку «Вставить данные сессии». Тогда в открывшемся окне появятся все данные из текущей сессии из чата отладчика. По нажатию на кнопку «Тест», появится окно с результатом отработки скрипта.

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

[[Файл:2025-11-01 09-55-26.png|мини|''Рис. 5 Интерфейс вкладки «Интервалы»'']]

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

====== Группировка интервалов рабочего времени ======
Для удобства настройки сложных и переменных графиков работы в системе предусмотрена возможность объединять интервалы времени в группы. Это позволяет избежать создания громоздких условий в Контрольных Точках (КТ), когда рабочие часы оператора меняются каждый день или разбиты на несколько промежутков.

Для того, чтобы создать группу интервалов кликните на '''+''' справа от вкладки под номером '''1'''. Группа разделена на вкладки (табы), что позволяет удобно структурировать разные периоды.

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

* На одной вкладке настроить график для будних дней. Или для каждого дня отдельно.
* На другой вкладке — график для выходных.
* На третьей — особый график для праздников.

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

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

* '''события''' — действия, которые выполнит робот при наступлении определенного условия в диалоге, например «Не найдено» (см. раздел «События» ниже);
* '''исключения''' — это действия, которые выполняются, если событие повторяется указанное число раз подряд (см. раздел «Исключения» ниже);
* '''данные''';
* '''модели''' — настройка моделей, если требуется использовать параметры, отличные от параметров по умолчанию;
* '''коннекторы'''.

'''События''' есть 10-ти типов и прописываются для каждого канала связи отдельно:
[[Файл:2025-10-06 16-01-17.png|мини|''Рис. 6 Интерфейс вкладки «Настройки»'']]
# Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
# Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
# Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
# Запрос повтора — действия на случай, если абонент запросил повтор информации. Если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.
# Тишина — добавляем действие в моменты, когда от человека нет ответа, то есть тишина.
# Перебивание — событие доступно ''только для голосовых каналов (например, voice)''. Она позволяет настроить реакцию на прерывание речи.
# Задержка ответа — событие доступно ''только для голосовых каналов (например, voice)''. Это действия, которые появляются, когда идет генерация. Например, можно написать: «Секундочку, выясняю». Это нужно, чтобы человек понимал, что робот не просто молчит.
# Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя, то есть настройка действий если это событие произошло. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
# Нет данных — это событие происходит, когда система пытается получить конкретный недостающий элемент данных, например название филиала, и ей это не удалось.
# Ошибка.

'''При наступлении события система выполнит указанное в канале действие. Если действие для этого события в канале не задано, то ничего не произойдет.'''

Вы можете настроить реакции робота на определённые события. Более подробную информацию о них вы найдёте в разделе «Исключения».

'''Исключения''' есть трех типов '''Тишина''', '''Не найдено''' и '''Нет данных'''.

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

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

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

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

На вкладке можно настроить параметры голосового канала. Вот что там можно сделать:

* Выбрать голос, которым будет говорить робот.

* Установить основную модель распознавания (рекомендуем оставлять common).

* Определить фоновую модель распознавания (рекомендуем background).

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

* '''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)
* '''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
* '''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
* либо коррекция может '''Отсутствовать'''.

[[Файл:2025-10-06 16-47-09.png|мини|''Рис.7 Вкладка настроек коннектора telegram'']]

===== Вкладка «Коннекторы» =====
Позволяет настроить связь робота по одному из каналов: ''freeswitch'', ''max'', ''telegram'', ''vk'', ''web, nats.''

Для мессенджеров, таких как '''max''', '''telegram''', '''vk''', характерны следующие настройки:

* ''токен'',
* ''группа'' ''(для vk),''
* ''название бота'',
* ''обслуживающий сервер'' - имя сервера SES, который обслуживает данный коннектор,
* ''периодичность обновления'' - время периодичности запроса в api для получения новых сообщений,
* ''фразы-активаторы'' - список фраз, на которые будет реагировать робот в общих чатах, и считать, что сообщение адресовано ему,
* ''переменные,''
* ''фраза сброса сессии,''
* ''доступы'' - список пользователей, которые могут писать роботу. Если пустой, то могут все.

Для канала '''web,''' в частности, для встраивания чат-виджетов ''(рис 7.1).'' Данный коннектор предназначен для встраивания интерактивного виджета на ваш сайт. Доступно два типа виджета: '''Чат и Ассистент (Суфлер)'''.
[[Файл:2025-11-14 11-16-35.png|мини|''Рис. 7.1 Вкладка настроек коннектора web'']]
'''Общие параметры (для обоих типов)'''

Следующие настройки являются общими независимо от выбранного типа виджета.

* Домен: Укажите домен вашего сайта, на который будет встраиваться виджет. Это необходимо для безопасности, чтобы виджет мог работать только на указанном сайте.
* Токен: Уникальный идентификатор, который указан в теге <code>[[SES. Руководство администратора#Настройка виджета для сайта|<script>]]</code> для встраивания виджета на сайт.
* Акцентный цвет: Основной цвет интерфейса виджета (кнопки, заголовки, выделение). Используется для согласования с фирменным стилем вашего сайта.
* Заголовок виджета: Текст, который отображается в шапке открытого окна чата.
* Приветственное сообщение: Первое сообщение, которое видит пользователь при открытии чата.
* WebSocket-серверы: Технический параметр для установки соединения. Обычно заполняется автоматически и изменяется только по указанию технической поддержки.
* Язык: можно указать язык для виджета. Если не указывать, то будет дефолтный из конфига UPS.
<blockquote>Мультиязычность настраивается в настройках пользователя.</blockquote>'''Функциональные возможности'''

Эти опции позволяют включить или отключить определенные функции виджета.

* Голосовые ответы: Пользователь может прослушивать ответы от робота в аудиоформате.
* Отправка аудиосообщений: Пользователь может записывать и отправлять голосовые сообщения.
* Отправка файлов: Пользователь имеет возможность прикреплять и отправлять файлы.
* Аудиозвонок: Пользователь может инициировать голосовой звонок.
[[Файл:Ассистент.jpg|мини|''Рис. 7.2 Настройка переменных для режима "Ассистент"'']]
'''Выбор типа виджета'''

Перед сохранением конфигурации необходимо выбрать тип виджета, так как это влияет на доступность дополнительных параметров.

''Тип: "Чат"''

Стандартный режим для интерактивного общения с пользователем. Все "Функциональные возможности" и "Общие параметры" доступны для настройки. Также доступен блок "Переменные".

''Тип: "Ассистент" (Суфлер)''

Режим, предназначенный для подсказок оператору во время разговора с абонентом. Все переменные, необходимые для работы ассистента, настраиваются и передаются отдельно в личном кабинете пользователя. Сначала нужно авторизоваться в системе UPS ''(рис. 7.2)'', и дальше суфлер подключится сразу ко внутреннему номеру, который указан в настройках пользователя, там же можно переопределить цветовую схему под каждого пользователя.

Для канала '''freeswitch''' (телефонная линия):

* ''название коннектора,''
* ''конечная точка,''
* ''режим обслуживания:''
** Режим «Как робот»
*** <code>Внутренний номер</code>: Указывается внутренний номер этого робота.
*** Опция ассистента: Дополнительно настраивается параметр, который определяет, будет ли ассистент (суфлер) работать после перевода звонка на оператора.
** Режим «Как ассистент»
*** <code>Внутренний номер</code>: Указывается внутренний номер робота-ассистента (суфлера).
*** <code>Номер для перевода звонка</code>: Указывается номер, на который будет переключаться звонок (номер колл-центра или конкретного оператора).
Работа ''суфлера после перевода звонка'' на оператора возможна ''в двух режимах'':

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

Флаг '''"Автостарт ассистента"''' при активации этой опции, ассистент запускается автоматически.

Настройки канала '''''nats''''':

* название коннектора,
* адрес серверов,
* канал входящих сообщений,
* канал исходящих,
* обработчик.

Принцип работы:

* Отправитель (канал исходящих сообщений) отправляет сообщение в определенный subject.
* Получатели (канал входящих сообщений), которые проявили интерес к этому subject, получают сообщение.
* Subject выступает в роли классификатора, позволяя разделять различные потоки сообщений для разных задач и сервисов.

Для работы коннектора необходимо указать адрес сервера NATS и топики (Subjects) для отправки и получения сообщений.

[[Файл:Функционал действий.png|мини|''Рис. 8 Функционал Действий'']]

==== Виды действий в роботе и работа с ними ====
'''1. Основные действия'''

Доступны следующие типы действий:

* '''Сказать'''

Настройте текстовые ответы робота. Это может быть простая фраза-заглушка, ответ, сгенерированный AI (LLM), или ответ из базы знаний (QAS). Типы ответов «Сказать» подробно описаны в разделе 2.

<blockquote>При наведении мыши на поле «Фраза» появляется кнопки-иконки [[Файл:Управление фразой действия.png|безрамки|64x64пкс]], где можно выбрать одно из действий:
# Добавить кнопку (подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Добавление кнопок в действия|«Добавление кнопок в действия»]]). Доступно пользовательское расположение кнопок, которые регулируются переносами на новые строки.
# Перефразировать. Если нужно добавить вариации фразы (рис. 8). Предложенные фразы можно отредактировать или удалить, кликнув по иконке корзинки напротив нужной фразы и добавить в список фраз.
# Удалить лишнюю фразу можно, если она не единственная.
</blockquote>

* '''Подтвердить'''

Настраивается фраза для подтверждения.

* '''Отправить файл'''

Позволяет отправить файл в ответ на запрос пользователя.

* '''Остановить выполнение действий'''

Немедленно прекращает выполнение всех последующих действий в текущем сценарии и сбрасывает точку выполнения диалога.

* '''Передача диалога'''

Переводит разговор, например, на оператора или в другой отдел. Для настройки необходимо указать ''Назначение'' передачи.

* '''Забыть данные'''

Позволяет стереть определенные данные, введенные пользователем, чтобы запросить их заново. При активации опции ''Перезапросить'' система автоматически сформирует запрос на ввод недостающих данных.

* '''Завершить диалог'''

Завершает текущий разговор с пользователем и закрывает сессию.

У некоторых действий есть опции:
* ''Считать действие успешным прохождением точки'' — этот флаг устанавливается на действия, которые означают, что сервис выполнился. В основном для отчетности.
* ''Прерываемое'' — этот флаг активируется для голосового канала и говорит о том, что допускается прерывание (перебивание) робота в момент синтеза ответа. Если он активен, робот будет реагировать на стоп-слова, в противном случае — нет.
* '''Установка переменной'''
позволяет задать или изменить значение переменной после выполнения определенного события в сценарии. Это мощный инструмент для создания сложной логики, например, для подсчета количества попыток входа в сервис и последующих действий в зависимости от этого значения.

* '''Принудительно перейти в КТ'''

позволяет принудительно отправить диалог в выбранную конечную точку.

'''2. Типы ответов для действия «Сказать»'''

При использовании действия «Сказать» вы можете выбрать один из четырех типов ответа:

1. ''Последовательно''

Робот будет выдавать вопросы и информацию по порядку, строго следуя списку, указанному в поле «Фразы».

2. ''Случайная фраза''

Робот выберет и произнесет одну случайную фразу из заданного списка.

3. ''Из внутреннего источника (недоступно для действий в элементах данных)''

Ответ формируется из Системы ответов на вопросы (QAS) для ответа из ''QAS документация'' нужно настроить'':''

* Условия присвоения категорий: Определяет правила, при которых система может направить запрос в эту категорию QAS для поиска ответа.

* Условия вывода ответа: Настройте параметры, такие как использование кеша ответов, генерация ответа и кеширование формулировок и [[QAS. UPS руководство по работе с интерфейсом#%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%20%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B8%20%C2%AB%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D1%8B%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2%C2%BB|выбрать шаблон запроса]]. Подробности [[QAS. UPS руководство по работе с интерфейсом|тут]].<blockquote>'''Обратите внимание:''' если вам нужно изменить шаблон запроса для определенной категории, это делается путем добавления отдельного действия. Настройка этого действия аналогична основному, но с выбором нужного шаблона. В Условиях запуска указываете данные, которые запустят это действие с шаблоном-исключением. </blockquote>

''QAS-чат'': Ответы генерируются AI-моделью (LLM) по умолчанию или другой моделью, добавленной администратором.

4. ''Из внешнего источника''

Позволяет подключить скрипты интеграций для выполнения специальных действий, если таковые имеются. Для действия «Сказать» с типом «Из внешнего источника» нажмите на специальную кнопку, расположенную рядом с полем выбора скрипта [[Файл:Postprocessing.png|безрамки]]. Откроется вкладка с выбранным скриптом, где вы можете:

* Просматривать код текущего скрипта,
* Редактировать существующий скрипт,
* Создавать новый скрипт.

<blockquote>Редактирование и создание скриптов не влияют на сохранение ЭД/КТ, т.к. они ссылаются только на id скрипта. Если вы выбираете другой скрипт для действия, обязательно сохраните изменения.</blockquote>'''3. Управление действиями'''

Для каждого действия доступны три опции управления (обычно отображаются в виде значков [[Файл:Для действий.png|безрамки|72x72пкс]]):

1. ''Копировать''

Чтобы скопировать действие в другой канал, нажмите эту кнопку и в открывшемся окне выберите целевой канал из списка.

2. ''Переместить''

Чтобы переместить действие в другой канал, выполните те же шаги, что и для копирования. <blockquote>'''Внимание:''' При перемещении действие будет удалено из исходного канала.</blockquote>3. ''Удалить действие''

Чтобы удалить действие, нажмите на кнопку в виде корзины.

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

===== Добавление кнопок в действия =====
В сценарной машине предусмотрена возможность добавления кнопок.

При наведении мыши на поле «Фраза» появляется кнопки-иконки , где по иконке с плюсом можно добавить кнопку:

# название кнопки;
# текст для отправки — это тот текст, который отправится на модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]], [[SEE. UPS руководство по работе с интерфейсом|SEE]]).

Чтобы внести изменения в созданную кнопку, кликните по ней левой клавишей мыши (ЛКМ) и в открывшемся меню можно редактировать или удалить эту кнопку.

Интерфейс позволяет гибко управлять расположением кнопок с помощью переносов на новую строку.

Чтобы настроить порядок кнопок:

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

Этот инструмент позволяет визуально сгруппировать кнопки и организовать интерфейс максимально удобно для пользователя.

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

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

''Переменные'' — служат для хранения данных, полученных из API или по каналам, запущенным извне. Например, это может быть ID пользователя в Telegram или CID из телефонного канала, то есть определившийся номер телефона.<blockquote>'''Переменные, как и данные, можно выбирать из выпадающего списка.''' Доступны все названия и значения, которые использовались ранее. Если вам нужно создать новую переменную и значение, просто введите их с клавиатуры. После этого они также будут предлагаться вам в дальнейшем.</blockquote>''Данные'' — элемент данных, полученный от моделей SMC или SEE.

''Интервал'' — период времени, в который запускается это действие. У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.
''Подтвердить'' — запуск действия в зависимости от наличия подтверждения от абонента.
[[Файл:Уведомление дублей.png|мини|''Рис. 9. Уведомление об одинаковых блоках ИЛИ в условиях запуска действий'']]
В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»'' (рис. 9)''.''<blockquote>'''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.</blockquote>

Также при сохранении настроек в окне "Условий запуска" если были обнаружены одинаковые блоки условий "ИЛИ", то будет соответствующее оповещение с выделением повторяющихся блоков ''(Рис. 9''.)

Пример использования условий запуска действий в конечной точке ''«Проверка статуса»:''<blockquote>
'''Ситуация 1.'''

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

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

'''Ситуация 2.'''

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

1. Определить элемент данных, который отвечает за отслеживание цифр (код). В нашем случае это модель SEE number и элемент данных «Код заявления».

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

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

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

==== Добавление и настройка элементов данных ====
[[Файл:Снимок экрана 2025-07-16 154838.png|мини|''Рис. 10. Массовое добавление элементов данных'']]
[[Файл:2025-12-11 11-15-27.png|мини|''Рис. 10.1. Бланк настройки элемента данных'']]
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку '''«Добавить элемент»'''. В появившемся диалоговом окне возможны два варианта добавления: '''"Одиночное"''' и '''"Массовое"'''.

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

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

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

'''Контейнер''' — составной элемент данных, который собирает необходимые данные, чтобы отправить их во внешнюю БД по API с помощью скриптов интеграции.

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

===== Настройка элемента данных =====
[[Файл:2025-04-23 14-43-07.png|мини|''Рис. 11 Проверка модели в ЭД'']]
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (''Рис. 10.1'').

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

'''«Вес»''' — это параметр, который определяет приоритет этого элемент данных в спорных ситуациях. По умолчанию установлено значение 3. Также вес ЭД отображается в [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчике]] и, если у вас активировано [[SES. UPS руководство по работе с интерфейсом#Панель управления SES|табличное представление сценария]], то и в самой таблице. <blockquote>Совет по работе с весом ЭД.

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

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

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

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

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

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

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

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

Рядом с комментарием находится кнопка '''Исключения''' [[Файл:Исключения .png|безрамки|20x20пкс]]. По нажатию на эту кнопку можно для определенных элементов данных настроить нестандартные исключения, то есть исключения, отличные от общих настроек (рис.12). <blockquote>
Например, для ЭД «Название филиала». [[SES. UPS руководство по работе с интерфейсом#Вкладка «Настройки»|В общих настройках]] робота МФЦ указано, что количество исключений для события «Нет данных» равно 3 (в счетчик входит и первое обращение к роботу, если там не было нужной информации). Однако мы хотим, чтобы, если с первого раза филиал не был найден, робот больше не запрашивал у абонента его название. Вместо этого робот должен показать заглушку с предложением поискать нужный филиал на сайте. Для таких случаев можно настроить '''нестандартное исключение.''' </blockquote>Настройка нестандартного исключения:

# выберете нужный элемент данных,
# кликните на значок исключения [[Файл:Исключения .png|безрамки|20x20пкс]],
# в появившемся окне активируйте флаг «включить нестандартные исключения»,
# заполните тип исключения Нет данных,
# установите максимальное кол-во исключений подряд (если хотите уточнять один раз, то макс.кол-во устанавливайте равным 2),
# установите канал связи при необходимости,
# и выберете действие на случай, если исключение наступило.
[[Файл:Постобработка ЭД.png|мини|''Рис. 12.1. Постобработка данных'']]
Далее находится кнопка '''«Постобработка»''' [[Файл:Postprocessing.png|безрамки]]'''.''' При нажатии на нее появится всплывающее окно с редактором кода, где можно написать функцию, которая будет срабатывать после того как ЭД был получен (Рис. 12.1). Установите галочку '''«Включить постобработку»''' и в редакторе отобразится функция-обработчик, которая принимает на вход три параметра: ''значение ЭД, текст последнего сообщения, канал'', и возвращает значение ЭД и опционально текст сообщения.<blockquote>'''Пример:'''

<code>def handler(value, message, channel):</code>

<code> if value == 'старый' and message == 'старый' and channel == 'voice':</code>

<code> return 'новый', {'text':'новый'}</code>

<code> elif value == 'новый' and message == 'новый' and channel == 'voice':</code>

<code> return 'старый', {'text':'старый'}</code>

<code> return value, {'text': 'не тот канал'}</code></blockquote>

'''Тестирование скриптов в ЭД'''

Процесс тестирования скриптов в ЭД аналогичен тестированию скриптов во вкладке "Скрипты", с учетом того, что скрипты находятся непосредственно в самих ЭД.

Важное отличие:

* Для ЭД типа «Класс» или «Сущность» - поле «Значение» обязательно для заполнения.
* Для ЭД типа [[SES. UPS руководство по работе с интерфейсом#Произвольный элемент данных|«Произвольный»]] - поле «Значение» заполняется по необходимости (опционально).

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

'''Работает только в условиях запуска. Если ЭД с этим флагом стоит на входе в КТ, то фраг игнорируется.'''</blockquote><blockquote>'''Пример: Запись на прием'''

1. Процесс взаимодействия с пользователем

Пользователь хочет записаться на прием. Для этого необходимо собрать следующие данные:

* Намерение (цель обращения).
* Адрес (куда хочет попасть пользователь).
* ФИО.
* Номер телефона.

2. Работа моделей в КТ "Запись на прием"

* Все модели, отвечающие за обработку запроса, работают в фоновом режиме.
* На любом этапе диалога они могут «выхватывать» сущности (например, извлекать ФИО, адрес и т. д.).

3. Проблема ложного срабатывания

Модель может ошибочно извлечь данные, если:

* Пользователь вводит информацию, которая частично совпадает с искомой сущностью (например, город ''"Владимир"'' может быть ошибочно принят за имя).
* Это приводит к некорректной обработке данных до завершения сценария.

4. Решение: ограничение работы модели

Чтобы избежать ложных срабатываний:

* Активируйте галочку '''«Получать только прямым запросом»''' в настройках ЭД.
* Если галочка активна, модель (например, извлечение ФИО) сработает только когда:
** Сценарий диалога дошел до запроса ФИО.
** Пользователь явно отвечает на вопрос о недостающих данных по ФИО.

Таким образом, '''система не будет обрабатывать случайные упоминания имен или других сущностей вне контекста запроса.'''</blockquote>Флажок '''«Подставлять ответ модели в запрос к ЧаВО»''' предназначен для работы с типами ЭД «Сущность». Его основная функция — подставлять в запросы пользователей ответ от модели (название тэга) SEE вместо исходного текста абонента, на который среагировала модель.<blockquote>'''Пример использования'''

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

# Создаем модель SEE с тегами:
#* <code>до 14 лет</code>
#* <code>с 14 лет до 18 лет</code>
#* <code>с 18 лет</code> ''(Теги формируются на основе предоставленной документации.)''
# Добавляем ЭД в качестве недостающего элемента в настройки КТ.
# Когда сценарий доходит до дозапроса этого ЭД или абонент сам предоставляет данные, система отправляет запрос в QAS. Например, абонент отвечает, что ему 44 года, но в документах нет такого варианта. В них информация сгруппирована <code>до 14 лет</code>, <code>с 14 лет до 18 лет</code> и <code>с 18 лет.</code> Соответственно система не найдет похожую информацию.
# Решение:
#* Если флажок активирован, система подставит ближайший подходящий тег (в данном случае — <code>с 18 лет</code>).
#* Это поможет QAS корректно находить информацию в документации.
'''Важно:''' если ваша модель SEE '''не отдаст ответ''', то настройка '''не сработает'''. Проверьте и при необходимости дообучите модель.</blockquote>

Флаг '''«Удалять сущность из запроса к ЧаВО»''' предназначен для типов «ЭД Сущность» и работает наоборот: он удаляет из запроса пользователя слова или фразы, которые распознала модель.

Флажок '''«Режим долгого ожидания»''' Открывает дополнительное меню с триггерами окончания ожидания. Это данные, при получении которых мы прекращаем ждать именно этот элемент данных (ЭД). Например, если получили его же или другие данные, например, просьбу позвать оператора.<blockquote>'''Обратите внимание:''' чтобы этот режим работал правильно, создайте нестандартное исключение для ЭД (описание выше). Иначе система будет ориентироваться на общие настройки количества исключений.</blockquote>

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

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

===== События элемента данных =====

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

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

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

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

'''Тип события''' '''«Элемент получен».''' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).

'''Тип события''' '''«Тишина»''' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек молчит.[[Файл:Уведомление об отсутствующем классе.png|мини|''Рис. 14. Уведомление об отсутствующем классе'']]<blockquote>
Например, если робот спрашивает у абонента, какой паспорт ему нужен, а человек молчит, можно через некоторое время повторить вопрос или сказать: «Говорите громче, не слышно».</blockquote>

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

В таблице элементов данных предусмотрено уведомление ''(Рис. 14)'' об отсутствующей модели на сервере, которую использует элемент данных, а также об отсутствующем классе/группе в выбранной модели. При таких случаях слева от элемента данных расположен значок [[Файл:Warning.png|безрамки]], при наведении курсора мыши на который появляется соответствующее сообщение.

===== Произвольный элемент данных =====
Элемент данных типа «Произвольный» предназначен для обработки произвольных текстовых данных от пользователя, таких как:

- Нажатия кнопок (текста на кнопках),

- Точные текстовые фразы,

- Данные, присваиваемые через скрипты.

''Простая настройка:''

- Текст: текст от пользователя (например, текст на кнопке или точная фраза), который нужно «отловить».

- Значение элемента данных: присваиваемое значение этому элементу данных (param).

''Универсальное применение:''

- Обработка различных кнопок в одном элементе данных.

- Возможность скриптового присвоения любых значений.

- Замена использования элемента-заглушки со скриптами.

- Пользоваться таким ЭД можно точно так же как и другими элементами. Вести в разные действия и категории исходя из значения произвольного ЭД.<blockquote>''Пример использования''

Сценарий: Обработка различных текстов с кнопок БЕЗ обработки моделями, то есть модель может «не знать» этих фраз:

- Текст: "Поддержка участников СВО" → Значение ЭД: «Поддержка СВО»

- Текст: "Льготы для пенсионеров" → Значение ЭД: «Социальные услуги»

Таким образом, один произвольный элемент данных может обрабатывать множество различных вариантов ввода.</blockquote>[[SES. UPS руководство по работе с интерфейсом#События элемента данных|События]] на этом элементе аналогичные как и на обычных ЭД.

[[Файл:2025-10-06 13-10-56.png|мини|''Рис. 15 Интерфейс контейнерного ЭД'' ]]

===== Элемент данных типа «Контейнер» =====
Контейнер — это составной элемент данных, который объединяет несколько дочерних элементов для последующей обработки. Его основная функция — сбор необходимых данных и их отправка во внешнюю базу данных через API с использованием скриптов интеграции.

Доступ к редактору скриптов:

# Перейдите в карточку элемента данных «Контейнер»
# Нажмите на кнопку вызова редактора скриптов [[Файл:Postprocessing.png|безрамки]]
# ''Важно:'' Если скрипт не заполнен, кнопка будет подсвечиваться красным цветом

Создание функции обработки:

* При нажатии на кнопку открывается всплывающее окно с редактором кода
* Функция выполняется после получения всех данных элемента
* Для активации установите галочку «Включить скрипт обработки»

Функция принимает три входных параметра:

# <code>value</code> — значение текущего элемента данных
# <code>message</code> — текст последнего сообщения от пользователя
# <code>chanel</code> — идентификатор канала взаимодействия

Функция возвращает:

* Обязательно: обработанное значение элемента данных (value и записывает его в значение ЭД param)
* Опционально: текст сообщения для пользователя

События контейнерного ЭД:

* ''«Элемент получен».'' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).
* ''«Нет данных»'' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек говорит что-то, но не ответ на вопрос.

==== Добавление и настройка конечных точек ====
[[Файл:2024-11-18 12-00-28.png|мини|''Рис. 16 Рабочая область SES'']]Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В верхней правой части рабочей области расположена кнопка '''«Добавить конечную точку»''' (рис. 16). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки образуют «облако конечных точек».

===== Настройка конечной точки =====
После того как вы ввели название конечной точки и нажали кнопку '''«Добавить»''', слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается ''название конечной точки'', при желании его можно сменить. Также доступен выпадающий список «Тип». Здесь можно выбрать один из четырёх вариантов:[[Файл:2025-03-28 14-57-55.png|мини|''Рис. 17 Типы входа в конечные точки'']]'''«Отчетный»''' — эта та, которая участвует в статистике, т.е. несет какую-то полезную для анализа информационную нагрузку.

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

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

'''«Завершение диалога»''' — конечная точка, которая ставит точку в общении с пользователем.[[Файл:2025-05-28 16-23-27.png|мини|''Рис. 18 Вход в КТ по условиям'']]

Также можно выбрать еще '''Тип входа в КТ''' может быть трех видов (рис. 17):

'''- по условиям''', когда попадаем в КТ при условии получения определенных данных, например, класс от SMC (рис. 18). На вкладках «Условия» доступна ''фильтрация по элементу данных.''

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

Абонент обратился за консультацией. Робот предоставил ответ. После консультации абонент бездействует, а сессия еще не закрыта. Можно настроить КТ Оценка качества обслуживания, которая по истечению указанного времени запросит оценку, после ответа абонента, завершит сессию.</blockquote>- '''по ручному запуску''', когда КТ нужно принудительного запустить, например для рассылки. Чтобы настроить вход в конечную точку нужно выбрать в меню Вход опцию «По ручному запуску». Интерфейс КТ по ручному запуску идентичен КТ со входом «По бездействию», за исключением поля «Время».

Такой вариант входа в КТ подходит для исходящих сообщений (обзвонов), например, чтобы отправить абоненту напоминание-подтверждение о предстоящей записи: «Уточните, пожалуйста, вы придете на прием?»

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

'''Настройка исключений для конечных точек'''

Вы можете настроить автоматическое реагирование на сбои в работе конечных точек. Исключения [[Файл:Исключения .png|безрамки|20x20пкс]] - это специальные действия, которые выполняются при нескольких последовательных неудачных запусках конечной точки.

Система отслеживает статус запусков. Когда количество неудачных попыток подряд достигает заданного вами значения (например, 3), автоматически выполняется указанное вами действие.

Пример настройки:

* Условие: 3 неуспешных запуска подряд.
* Действие: Перевести звонок оператору ''или'' Завершить диалог.

===== Условия входа и запуска конечных точек. Сбор информации =====
'''Типы условий для входа'''

Для настройки условий '''входа''' в системе доступны три основных типа:

1. ''Данные''. Проверка значений элементов данных.

2. ''Переменные''. Работа с системными и пользовательскими переменными.

3. ''Подтверждение''. Проверка статуса подтверждения от пользователя. Возможные значения:

* Получено (пользователь подтвердил действие)
* Не получено (пользователь отклонил действие)

Для '''условий запуска''' есть дополнительно 4-ое условие, помимо вышеперечисленных:

4. ''Интервалы.'' У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.

Для '''сбора информации''' есть только 2 варианта условий: данные и переменные.<blockquote>Применение: Эти типы условий позволяют гибко управлять логикой диалога, направляя пользователя по различным сценариям в зависимости от текущего контекста.</blockquote>

'''Условия входа (Вход).''' Для того чтобы попасть в конечную точку и выполнить определенные действия, нужно выполнить условия входа. Их может быть как один элемент данных, так и их сочетание.<blockquote>Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: ''«Загранпаспорт»'' (получена метка от [[SMC. UPS руководство по работе с интерфейсом|SMC]], соответствующая этому элементу данных). А также сочетание элементов данных: ''«Паспорт»'' (получаем, если тип паспорта не указан сразу) и ''«Тип паспорта-загран»'' (тег «Загран» получили после уточнения типа паспорта).</blockquote>Условия входа объединены в блоки, которые имеют логическое условие «И». Чтобы добавить новое условие, необходимо нажать на кнопку «Добавить условие» [[Файл:Добавить условие.png|безрамки|20x20пкс]]. Блоки с условиями «И» разделены логическим «ИЛИ».
Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:
* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* + (Прибавить) — для увеличения счетчика,
* - (Вычесть) — для уменьшения счетчика,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

[[Файл:Рис. 17 Условия запуска.png|мини|''Рис. 19 Условия запуска'']]
'''''Условия запуска и Сбор информации''.''' Вкладка ''Сбор информации'' и меню ''Условия запуска'' идентичны по своему назначению'''.'''

По нажатию на эту кнопку открывается окно, где нужно указать '''''все''''' случаи (данные и их комбинации), '''''при которых точка сработает''''' (см.рис. 19). В окне «Условия запуска» элементы данных разделяются логическим оператором «ИЛИ». В случае с комбинациями условий ЭД отделяются друг от друга логическим «И». Как в случае с элементами, разделёнными операторами «ИЛИ», так и с элементами, разделёнными «И», порядок элементов можно менять. Аналогично для вкладки Сбор информации.

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

Условия можно редактировать: добавлять и удалять. Окно можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.<blockquote>Например, конечная точка «Консультация» активируется, если будут получены метки «Апостиль» ИЛИ «Банкротство» ИЛИ «Загранпаспорт» и «Тип паспорта — загран».</blockquote>В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»''. '''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.

У условий есть параметр ''«Тип»'', принимающий два значения: данные или переменная. Параметр ''«Искать»'' имеет три варианта:

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

Далее идет поле «Название», где из выпадающего списка требуется выбрать нужный элемент данных. <blockquote>Если в выбранном элементе данных не заполнено событие «Недостающий элемент», то в правом верхнем углу будет расположен значок [[Файл:Warning.png|безрамки]] со всплывающим уведомлением при наведении на него.</blockquote>Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:

* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

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

===== Условия присвоения категорий =====
[[Файл:2025-07-07 12-42-57.png|мини|''Рис. 20 Вкладка Действия и Условия присвоения категорий'']]
'''''Условия присвоения категорий'''.'' По клику на эту кнопку раскрывается меню (рис. 20), в котором есть выпадающий список со всеми категориями из [[QAS. UPS руководство по работе с интерфейсом|QAS]], а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ». ''Окно с условиями категорий или условиями запуска можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.''<blockquote>На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ». </blockquote>Флажок '''«Запрос в QAS с учетом прошлого контекста»''' указывает системе, что перед отправкой запроса в QAS необходимо проанализировать предыдущие сообщения пользователя. Это позволяет сохранять логику диалога и избегать необоснованной смены тематики.<blockquote>'''Пример работы'''

# Без включенной функции
#* Пользователь спрашивает: ''"Какие документы нужны для оформления СНИЛС?"'' → система направляет запрос в категорию СНИЛС.
#* Затем пользователь уточняет: ''"А сколько это стоит?"'' → система определяет метку Госпошлина и перенаправляет запрос в соответствующую категорию, теряя контекст СНИЛС.
# С включенной функцией
#* Если флажок активен (например, для категории ''Госпошлина''), система:
#** Проверяет предыдущие сообщения.
#** Если диалог начался в другой категории (например, СНИЛС), запросы объединяются (''"склеиваются"'').
#** Если контекст отсутствует, тематика меняется, но поиск ответа ведется сразу по обеим категориям (СНИЛС + Госпошлина).

'''Когда использовать'''

Активируйте эту настройку для категорий, которые могут:

* Быть частью более широкого запроса (например, ''Госпошлина'' как дополнение к ''СНИЛС'').
* Требовать сохранения контекста диалога.

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

===== Индикация удаленных категорий =====
Система визуально выделяет удаленные категории для привлечения вашего внимания:

# Конечные точки с недействительными категориями в табличном представлении: помечаются специальным значком и выделяются красным цветом. При наведении на значок сообщение: ''«Используются несуществующие категории в канала: [название_канала](кол-во)»''
# В облаке конечных точек: КТ с недействительными категориями также отображаются красным цветом, но без значка.
# В условиях присвоения категорий: Если используется удалённая категория, система отобразит предупреждающее уведомление ''«Используются несуществующие категории: [кол-во]»''.

Это позволяет быстро находить и корректировать объекты, которые зависят от неактуальных данных. А так же это важно для экспорта и импорта роботов (см. разд. Панель управления).

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

==== Связанная фильтрация ЭД и КТ ====
В интерфейсе реализована связанная фильтрация между таблицами Элементов Данных (ЭД) и Контрольных Точках (КТ). Это позволяет автоматически находить взаимосвязанные объекты.

'''Принцип работы:'''

* Фильтрация по ЭД: При вводе названия в фильтр таблицы Элементов Данных:
** В таблице ЭД отображаются только те элементы, названия которых соответствуют фильтру.
** Одновременно в таблице КТ автоматически отображаются только те Контрольные Точки, в которых используются отфильтрованные ЭД.

* Фильтрация по КТ: При вводе названия в фильтр таблицы Контрольных Точек:
** В таблице КТ отображаются только те точки, названия которых соответствуют фильтру,
** Одновременно в таблице ЭД автоматически отображаются только те Элементы Данных, которые используются в отфильтрованных КТ.

<blockquote>'''Важно''':

Система учитывает использование Элементов Данных во всех типах Контрольных Точек:

1. Входные данные (вход).

2. Собираемая информация (условия запуска/сбор информации).

3. Условия запуска действий.</blockquote>

==== Тестирование робота ====
[[Файл:2025-10-06 11-49-26.png|мини|307x307пкс|''Рис. 21 Окно чата для тестирования робота'']]
В интерфейсе SES есть чат с отладчиком (рис. 21), где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок [[Файл:Чат.png|безрамки|20x20px]] в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка '''«Перезапустить сессию»''' [[Файл:Обновить данные вопроса.png|безрамки|20x20px]], которая сбрасывает всю переписку и данные отладчика. А слева — кнопка '''«Данные сессии»''' [[Файл:Кнопка отладчик без полей.png|безрамки|20x20px]], предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS и не только, подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Данные сессии|Данные сессии]]. И кнопка '''«Тестирование скрипта»''' [[Файл:Пробирки.png|безрамки|20x20пкс]], подробнее [[SES. UPS руководство по работе с интерфейсом#Тестирование скриптом|тут]]. Есть возможность отправлять в чат файлы нажав на [[Файл:Скрепка.png|безрамки|20x20пкс]] и выбрав файл (в любом формате).

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

Режим отладки (дебаг):

* В режиме отладки появилась панель логов.
* Логи автоматически обновляются после каждого ответа от робота.
* Вместе с логами также обновляются данные текущей сессии.

Настройки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] чата позволяют выбрать настройки аудиоответов, а так же установить переменные, например, номер телефона.

Еще в меню настроек можно выбрать КТ по ручному запуску, чтобы протестировать работу КТ и сценария (рис. 22).
[[Файл:2025-10-20 10-56-18.png|мини|300x300пкс|''Рис. 22 Выбор конечной точки для тестирования.'']]

===== Тестирование в текстовых каналах =====

===== Данные сессии =====
Раскрыв данные сессии можете увидеть, все данные о текущем диалоге с роботом. Разберем по порядку, ниже представлены некоторые данные из ключа root, они нужны не все, разберем только нужные:<blockquote>
"started":"2025-06-10 09:46:05" — ''время начала сессии''

"modified":"2025-06-10 09:49:08" — ''когда произошли изменения последние (пришел запрос/изменилась тематика)''
"robot":"ffeaa99a-13d2-4bff-b458-1231c884f8ee" — ''id робота, у продовой версии будет приписка _prod''

"session":"beefb6a2-dc08-47d4-9e02-2495329173ec" — ''id сессии''

"channel":"default" — ''активный канал, в котором происходит тестирование''

"connector":"web"

"unknown":false.
</blockquote>
[[Файл:2025-10-06 12-45-38.png|мини|''Рис. 23 Пример работы с отладчиком'']]
Далее идет самая интересная для аналитиков часть - <code>"current"</code> . Раскрыв этот ключ можно посмотреть в какую конечную точку привёл сценарий, и была ли запросу присвоена какая-либо категория. А так же параметр ''data'', раскрыв который можно увидеть все классы (рис. 23 и 23.1), которые пришли от модели [[SMC. UPS руководство по работе с интерфейсом|SMC]] и/или модели [[SEE. UPS руководство по работе с интерфейсом|SEE]] и их достоверность и вес. Раскрыв в ''data'' параметр ''reply -'' увидеть данные ответа от робота. Имея все эти данные можно отладить работу сценария.
[[Файл:2025-10-06 12-47-26.png|мини|''Рис. 23.1 Работа с отладчиком. Просмотр параметра data и логов'' ]]
<blockquote>"current":{

"id":"Консультация ЧаВО" — конечная точка, в которую привел сценарий,

"qas":"оформить снилс" — запрос, который отправился в QAS.

}<blockquote>'''Обратите внимание:''' если параметр QAS в отладчике пустой, это значит, что ваш запрос не был передан в QAS. Если же в этом параметре отображается ваш запрос, но робот просит вас перефразировать его, то, вероятно, в базе данных не хватает формулировки с ответом или на ответе отсутствует пометка «проверено». Это может происходить, когда в настройках КТ, отвечающей за консультирование из базы данных QAS, установлен параметр «Использовать кэш ответов» в режиме «Только проверенные ответы». </blockquote>'''Отработка склеек и удержания контекста''': в QAS летит вообще вся история сообщений в рамках одного контекста общения '''через разделитель «|»'''. Модель генерации будет отвечать на последний вопрос в цепочке с учетом ранее написанных сообщений в этом контексте.

"answered":true — был ли ответ true/false
"category":[0:"МФЦ НСО СНИЛС"] — отображается список категорий, в которые попал вопрос (их может быть больше одной).

"nearest":NULL

''Следующий кусок ключа current проще объяснить на примере запроса "оформить паспорт":''

"entry":"entry":[0:"Паспорт, вес 3" ] — зашли в КТ по метке «Паспорт», запросили тип паспорта (загран), старый/новый образец и дошли до возраста получателя:

"missingRunData":[

0:"Возраст заявителя для заграна, вес 3"] — тут отображаются ЭД, которые нужны для «пропуска» дальше в действия.

"passedRunData":[ ] — список условий AND, который выполнился.

"waitingRunData":

"Возраст заявителя для заграна, вес 3" — отображается ЭД, который запросили и ждем получения.

"border":0 — отражает границу, от которой система смотрит на данные. Например, при border:1 - система будет смотреть от 2-го ЭД в списке data и ниже. При border:0 - с первого.

"preborder":0

}</blockquote><blockquote>"models":[...] — раскрыв список, можно посмотреть все модели, которые отработали за сессию.

"scripts":[] — отображает список скриптов, которые отработали за сессию.

"data":[...] — раскрыв data, можно увидеть параметр "message" — фраза-сообщение пользователя. И под каждым message, есть своя data, где находятся все метки и все тэги, пришедшие от моделей SMC и SEE на эту фразу.

"timers":[...]

"variables":{} — тут отображаются пришедшие переменные, если есть.

"error":"" — выводит ошибку при отработке скрипта.

"events":{ — параметр отображает счетчики событий за сессию (не найдено/нет данных/тишина).

"not found":{...}

"no data":{...}

"silence":{...}

}</blockquote>

[[Файл:2025-06-10 16-15-43.png|мини|''Рис. 24 Окно автотестирования скриптов'']]

===== Тестирование скриптом =====
[[Файл:2025-06-10 16-22-59.png|мини|''Рис. 25 Добавление скрипта для тестирования'']]
[[Файл:Тестирование скриптов.png|мини|''Рис. 26 Интерфейс окна «Тестирование скриптов»'']]
Теперь вы можете автоматически тестировать робота с помощью скриптов. Например, если у вас возникли сложности с маршрутизацией и нет желания каждый раз вручную воспроизводить весь диалог при отладке сценария, вы можете сохранить его для последующего тестирования. Для этого кликните на кнопку [[Файл:Пробирки.png|безрамки|20x20пкс]] справа от чата появится окно. Добавить скрипт можно путем '''''импорта из файла''''' [[Файл:Импорт нов.png|безрамки|20x20пкс]], если есть данные '''в формате txt''' или '''''импортировать диалог''''' из текущей сессии. Нажмите на иконку импорта или выберите ''«Скрипт»'' в выпадающем меню и нажмите '''''«Добавить скрипт»''''' (рис. 24). Появится диалоговое окно «''Добавление скрипта»''. Введите название скрипта, выберите файл и нажмите ''«Добавить»''. Если у вас уже открыта сессия, отметьте в окне добавления скрипта опцию '''''«Импорт из чата»'''.'' Если у вас несколько скриптов, переключаться между ними можно через выпадающий список ''«Скрипт».''

Правее него находятся иконки ''импорт'' [[Файл:Импорт нов.png|безрамки|20x20пкс]], ''экспорт'' [[Файл:Экспорт нов.png|безрамки|20x20пкс]] и ''удалить'' [[Файл:Удаление документа.png|безрамки|20x20пкс]]. Импорт был описан ранее. '''''Экспорт''''' позволяет выгрузить скрипт в формате txt. Кнопка '''''удалить''''' - удаляет весь скрипт.

Файл для импорта и экспорта - это простой текстовый файл, в котором все запросы к роботу, каждый с новой строки.

Галочки обозначают точки останова (рис. 25). Когда они стоят, автотест останавливается и ждет, пока вы нажмете кнопку «Дальше». параллельно можно открыть отладчик и смотреть, что происходит на каждом этапе теста.

У тестирования есть два основных режима:

# Полный тест:
#* Все галочки сняты
#* Тест выполняется автоматически от начала до конца, без остановок
# Пошаговый режим:
#* Тест останавливается на каждом шаге
#* Для продолжения нужно нажимать "Дальше"

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

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

Последняя отправленная фраза будет выделена голубым цветом.

===== Просмотр данных сессии =====
Эта функция позволяет вам в реальном времени отслеживать диалоги и данные сессии у другого пользователя в '''рамках одного бота'''.

'''Подключение к отслеживанию'''

# Нажмите на иконку «Просмотр сессии» [[Файл:2025-10-22 12-54-24 (1).png|безрамки|20x20пкс]] . Введите название переменной, за которой хотите следить и ее значение (если требуется, например, номер телефона абонента) в соответствующие поля.
# Нажмите кнопку «Подключиться».
# Меню закроется, и вы увидите всплывающее уведомление с подтверждением успешного подключения.
# В основном интерфейсе индикатор отслеживания (иконка «Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]) изменит свой вид: он будет зачеркнут и периодически мигать. Это сигнализирует о том, что соединение активно и система ожидает данные.
Как поступают данные:

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

'''Отключение от отслеживания'''

Чтобы прекратить отслеживание, выполните одно из следующих действий:

* Нажмите на индикатор отслеживания («Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]), который активен в режиме подключения.
* Выполните команду «Сброс сессии» [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]].

Любое из этих действий разорвет соединение для отслеживания, и индикатор вернется в обычное состояние.

'''Пример настройки просмотра сессии'''

Пользователь, за чьим диалогом будет наблюдение, должен создать у себя переменную (любую) и ее значение:

* <code>variable = за мной следят</code>

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

Пользователь, который хочет подключиться для просмотра, должен в своем разделе ''просмотра сессии'' создать точно такую же переменную:

* <code>variable = за мной следят</code>

И после того, как начнется диалог, в режиме реального времени наблюдатель будет видеть все данные сессии того, кто ведет диалог с роботом.<blockquote>'''Функция для пользователей UPS'''

Для более удобного отслеживания вы можете использовать уникальный <code>id пользователя UPS</code> , который передается в переменные сессии.

* Вместо того чтобы указывать одинаковые переменные у обоих пользователей, вы можете напрямую указать <code>id пользователя</code>, за которым хотите следить.
* Это позволяет вам следить за конкретным пользователем, при этом ему не обязательно вручную задавать у себя переменную.
</blockquote>

===== Тестирование голосовыми сообщениями и в голосовом канале =====
[[Файл:2025-06-10 12-44-58.png|мини|''Рис. 27 Тестирование робота с помощью микрофона.'']]
Робота можно протестировать, задавая вопросы голосом и/или вводя переменные. Например, можно проверить, как робот отправляет в разные конечные точки, получая одинаковые метки от SMC и номера телефонов различных ведомств. Например, метка «Мобилизация» от SMC в сочетании с номером телефона МФЦ приводит в КТ Консультация ЧаВО, а «Мобилизация» и номер единого контактного центра (ЕКЦ) — в КТ Перевод на оператора. Чтобы провести тестирование робота с переменными раскройте меню, кликнув на иконку шестеренки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] и заполните поля:

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

- Значение: укажите значение этой переменной..
[[Файл:2025-10-06 11-51-58.png|мини|''Рис. 28 Иллюстрация тестирования канала voice.'']]
В этом же меню вы можете настроить параметры аудиоответов и автовоспроизведения.

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

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

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

В дебаггере есть функция, позволяющая протестировать '''голосовой канал - voice''' (рис. 28), то есть ''имитировать звонок''. Чтобы запустить процесс, достаточно нажать на кнопку «Начать разговор» [[Файл:Начать разговор.png|безрамки|20x20пкс]] . Пока разговор активен, кнопка изменится на «Закончить разговор» [[Файл:Закончить разговор.png|безрамки|20x20пкс]] . Переменные задаются в меню, как и в текстовом канале. Для этого нажмите на иконку шестерёнки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] (рис. 21).

=== Архив диалогов ===
[[Файл:Архив диалогов нов.png|мини|''Рис. 29 Интерфейс архива диалогов'']]
После тестирования робота в любом канале можно заглянуть в Архив диалогов (рис. 29), чтобы изучить данные сессии. Для этого необходимо кликнуть на одноименную кнопку на панели инструментов рядом с кнопками версий робота [[Файл:Архив диалогов.png|безрамки|20x20пкс]]. Интерфейс архива содержит:

* Список доступных роботов слева на экране.
* Блок с фильтрацией диалогов.
* До момента пока вы не выберете диалог из списка справа будет пустой блок с текстом «Выберете диалог». После того как диалог выбран вы увидите отображение аналогичное рисунку 29.
* Информационные вкладки (см. в разделе [[SES. UPS руководство по работе с интерфейсом#Настройка робота|«Настройка робота»]]).

==== Работа с архивом диалога ====
Архив диалогов поддерживает версионность робота, то есть можно просмотреть диалоги одной из трех версий: черновик, прод или архивной. Для этого кликните по кнопке с нужной версией находясь уже в Архиве либо предварительно выбрав ее и перейдя в архив. Диалоги в архиве фильтруются по дате и времени, для этого кликните на иконку календаря [[Файл:Календарик с фоном.jpg|безрамки|20x20пкс]] в поле «Начало» и «Конец», чтобы выбрать дату. И время, кликнув на иконку часов ''(по умолчанию дата и время выставляются за текущие сутки)''. Выберите нужную дату и время, добавьте необходимые фильтры. Также можно отфильтровать звонки по:

# каналам связи:
* default,
* telegram,
* web,
* voice,
* vkontakte.
2. элементам данных — при нажатии на это поле открывается перечень всех элементов данных из сценария текущего робота.

3. номеру телефона,

4. ID диалога берется из отладчика — это значение атрибута <code>session</code>. В архиве диалогов предусмотрено копирование ID: при нажатии на иконку копирования она загорается зеленым, что означает успешное копирование в буфер обмена.

5. по названию и значению переменной,

3. либо тексту, либо ключевым словам, которые могут быть в искомом диалоге.

После настройки система, по нажатию кнопки «Поиск», отобразит все диалоги с роботом, учитывая выбранные фильтры (рис. 27). На самом верху над диалогом можно просмотреть его ID. В архиве диалоги сгруппированы по принципу «запрос от пользователя — ответ робота». При выборе каждой пары открывается отладчик, где можно увидеть метки и теги, полученные от моделей, копия [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчика]] из тестирования робота. Этот отладчик аналогичен тому, что используется в сценарной машине. Для голосового канала есть возможность прослушивания аудио диалога помимо текстового просмотра. Также есть возможность импортировать запросы диалога в скрипт тестирования в чат-отладчик по кнопке '''«Добавить в скрипт тестирования»''' снизу диалога и в появившемся окне введите название скрипта тестирования. После чего он появится в списке скриптов тестирования сценария.

Для вашего удобства во время ''активного'' диалога в архиве доступна кнопка '''«Следить за диалогом»'''. Нажмите кнопку «Следить за диалогом» во время просмотра архива ''активного'' диалога. Система начнёт автоматически обновлять список реплик, подгружая новые сообщения. Обновление происходит каждые 5 секунд, обеспечивая актуальный вид беседы без необходимости обновлять страницу вручную. Позволяет в реальном времени следить за развитием ещё не завершённого диалога, например, во время тестирования или активного общения с роботом.

===== Синхронизация текста и аудио в архиве диалогов =====
В архиве диалогов реализована условная синхронизация текстовой расшифровки с аудиозаписью на основе временных меток (datetime).

* При воспроизведении аудио: В текстовой расшифровке автоматически подсвечивается реплика (вопрос/ответ), которая звучит в данный момент.
* При клике на текст реплики: Воспроизведение аудио автоматически перематывается на тот момент записи, когда эта реплика абонента была произнесена.

Результат: Вы можете быстро находить нужные фрагменты разговора и удобно анализировать диалоги.

Чтобы '''выйти из Архива диалогов''' в сценарий нужно снова кликнуть на иконку [[Файл:Архив диалогов.png|безрамки|20x20пкс]].

=== Пользовательские справочники ===
[[Файл:Photo 2025-05-14 17-30-31.jpg|мини|''Рис. 30 Добавление пользовательского справочника'']]

Для доступа к справочнику нажмите на значок «Пользовательский справочник» [[Файл:Справочник (1).png|безрамки|20x20пкс]] на панели инструментов справа от архива диалогов. Чтобы создать новый справочник, нажмите кнопку '''«Добавить справочник»''' (рис. 30). В открывшемся окне заполните обязательные поля: название справочника и его структуру — наименования колонок. При необходимости задайте значения по умолчанию для каждой колонки. Эти значения будут автоматически заполнять новые строки. Затем нажмите '''«Добавить»'''.

Если значения по умолчанию не указаны, справочник будет пустым. Заполнять таблицу можно вручную.

Справочники можно переименовывать и удалять. Чтобы переименовать или удалить справочник, наведите курсор на его название. Появится две иконки: карандаш для переименования и корзинка для удаления. <blockquote>'''Перед переименованием справочника ''обязательно'' сохраните внесенные изменения, иначе они будут удалены.'''</blockquote>[[Файл:2025-05-20 14-45-35.png|мини|''Рис. 31 Удаление записей из пользовательского словаря'']]
При нажатии на карандаш откроется окно '''«Редактирование структуры».''' Важно помнить: изменения можно внести только в название справочника или в значения по умолчанию (если предыдущие значения были, они будут автоматически обновлены). ''Переименовать столбцы нельзя.'' После сохранения изменений нажмите кнопку '''«Сохранить»''', расположенную внизу под таблицей (рис. 31). <blockquote>'''Внимание! Справочники зависят от версии робота.''' Если вы вносите изменения в структуру справочника в черновой версии [[Файл:Черновик.png|безрамки|20x20пкс]], то для применения этих изменений в продовой версии нужно применить робота в прод.

'''Важно:''' переносится '''только структура справочника'''. Данные не дублируются. Их можно перенести вручную, экспортировав [[Файл:Экспорт нов.png|безрамки|20x20пкс]] из черновика и импортировав [[Файл:Импорт нов.png|безрамки|20x20пкс]] в прод. </blockquote>Вы можете фильтровать записи по содержанию любой колонки. Выделите галочками несколько записей сразу и удалите их. В правом нижнем углу появится иконка корзины, как только вы выберете хотя бы одну запись (рис. 31).

Справочники можно ''экспортировать'' и ''импортировать''. Экспорт и импорт осуществляются в формате JSON.
[[Файл:Снимок экрана 2025-07-16 175752.png|мини|''Рис. 32 Импорт пользовательского словаря'']]

''При импорте структуры импортируемого файла и справочника в интерфейсе должны совпадать''. Если они не совпадают, то заполнятся только совпадающие поля. Есть возможность ''импорта'' с дополнением новых данных, либо полной заменой (''Рис. 32''). Структура экспорта:<blockquote>
[

{"колонка1":"значение 1","колонка2":"значение 2","колонка3":"значение 3","id":"58845671-1150-4ae2-9c46-e8aeb2553c57"},

{"колонка1":"значение 2","колонка2":"значение 2","колонка3":"значение 3","id":"2e0a7f8e-6d64-4df9-a3ce-5862f8eb441c"}

]
</blockquote>Структура json-файла для импорта:<blockquote>[

{"колонка1":"значение 4","колонка2":"значение 5","колонка3":"значение 6"},

{"колонка1":"значение 2","колонка2":"значение 3","колонка3":""}

]

При импорте не обязательно указывать id.</blockquote>Чтобы '''выйти из Пользовательских справочников''' в сценарий нужно снова кликнуть на иконку [[Файл:Справочник (1).png|безрамки|20x20пкс]].

=== Панель управления SES ===
Панель управления SES включает в себя 8 кнопок: импорт, экспорт, обнуление черновика рабочей версией, применение робота, восстановление робота, применение настроек робота, массовая замена моделей в элементах данных и меню пользователя.

{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления''
!'''Иконка кнопки'''
!'''Название иконки'''
!'''Описание'''
|-
|[[Файл:Export.png|центр|безрамки|40x40пкс]]
|Экспорт
|Для создания резервной копии или переноса робота выполните его экспорт в ZIP-архив. В архив будут включены все настройки робота: элементы данных, конечные точки, скрипты, структуры пользовательских справочников (''но не включая сами данные''), а также связанные модели и базы данных QAS.<blockquote>'''Внимание!''' Перед экспортом убедитесь, что категории и модели актуальны. В противном случае экспорт может завершиться ошибкой, и робот не будет экспортирован.</blockquote>
|-
|[[Файл:ImportRobot.png|центр|безрамки|40x40пкс]]
|Импорт
|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''.|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''. Аналогично экспорту, доступен и импорт робота с моделями SMC, SEE и QAS в различные наборы данных.
<blockquote>'''Как работает импорт:'''

* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.
'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>
|-
|[[Файл:Стрелка.png|безрамки|40x40px|центр]]
|Обнулить черновик рабочей версией
|Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Применить.png|безрамки|40x40px|центр]]
|Применить
|По нажатию на эту кнопку черновая версия робота становится рабочей ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Откат.png|центр|безрамки|40x40px]]
|Восстановить
|С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной ''(кнопка активна только в архивной версии)''.
|-
|[[Файл:Разетка.png|центр|безрамки|40x40px]]
|Применить настройки робота
|Применяет сохранённые настройки робота и начинает работать в соответствии с ними, что аналогично перезагрузке программного обеспечения, но без необходимости самой перезагрузки.
После нажатия на кнопку система переносит эти настройки в настройки прода, но НЕ ПРИМЕНЯЕТ, на случай, если ошиблись.

Робот в любой версии начинает работать с новыми настройками только после нажатия на кнопку. Если вы нажали на кнопку, находясь в черновике, будут применены настройки черновика. Если же вы нажали на кнопку, работая в рабочей версии, то будут применены настройки рабочей версии, которые вы только что перенесли из черновика. <blockquote>Обратите внимание: после внесения каких-либо изменений кнопка будет красной [[Файл:Красная вилка (1).png|безрамки|20x20пкс]] и пульсировать, напоминая о необходимости применить настройки. </blockquote>
|-
|[[Файл:Смена моделей.png|центр|безрамки|40x40пкс]]
|Массовая замена моделей в элементах данных
|[[Файл:Замена моделей в ЭД.png|мини|''Рис. 33. Массовая замена моделей в элементах данных'']]Эта функция позволяет массово менять модели в элементах данных. После нажатия на кнопку появляется форма ''(Рис. 33)'', в которой необходимо указать тип элемента данных ''(Класс / Сущность)''. Затем в поле '''"Заменяемая модель"''' выбрать модель из списка моделей, используемых в уже существующих элементах данных ''(снизу будет указано количество элементов данных, использующих выбранную модель)'', и в поле '''"Заменяющая модель"''' выбрать доступную модель для замены. После нажатия на кнопку '''"Заменить"''' будет произведена замена выбранной модели в тех элементах данных, в которых она используется.
|-
|[[Файл:Меню пользователя new.png|безрамки|40x40px|центр]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, убрать/показать фон, выход из системы), а также возможность переключить ''отображение рабочей области с табличного на облачный вид и наоборот''.
В меню пользователя добавлена функция ''выбора набора данных*.''

При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

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

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

2025-12-24T09:57:25Z

E.Elagina: /* Работа с архивом диалога */

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

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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# SES Сценарная машина,
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]],
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]].
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2).
[[Файл:2025-06-09 14-33-48.png|мини|''Рис. 2 Рабочая область SES'']]

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

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

==== Добавление и настройка робота ====
Чтобы добавить нового робота, нажмите кнопку '''«Добавить робота»'''. В появившемся диалоговом окне введите название и нажмите '''«Добавить»'''. В нижнем правом углу экрана появится сообщение «Добавлено!». По умолчанию робот создается с предварительными настройками. В нем сразу есть текстовки для исключений и событий, ознакомиться и поправить их можно, перейдя на вкладку [[SES. UPS руководство по работе с интерфейсом|«Настройки»]]. Робот может быть 3х версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
{| class="wikitable"
|+''Табл. 1 Версии робота.''
!'''Иконка версии'''
!'''Наименование версии робота'''
!'''Описание'''
|-
|[[Файл:Черновик.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]], если вы планируете предоставлять консультации.

Здесь представлен общий перечень необходимых сервисов. В зависимости от специфики проекта некоторые из них могут отсутствовать.
[[Файл:2025-07-04 17-15-25.png|мини|''Рис. 3 Интерфейс вкладки Скрипты'']]

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

У скриптов есть параметр '''''«Область действия»''''', в котором есть 5 опций:

- ''конечные точки'', позволяет подключать скрипт в действиях конечных точек;

- ''элементы данных'', позволяет подключать скрипт в действиях элементов данных и контейнеров;

Скриптов на ЭД и КТ может быть несколько. Остальные скрипты общие и доступны только по одному на каждый тип:

- ''завершение сессии'' — скрипты, которые могут выполняться после завершения диалога, если скрипт указать в настройках в действиях на событии «Завершение диалога»;

- ''перед каждым вопросом'' — для случаев, когда нужно актуализировать какую-то информацию постоянно и использовать ее в условиях.<blockquote>

Скриптом «перед каждым вопросом» можно выставить, например, сегодняшнюю дату - ${custom.today}, а потом ее в сравнении дат использовать в условиях получения данных. Для случаев записи на прием проверять, '''что дата точно больше сегодняшней.'''

'''Скрипт проверки пишется админом.''' </blockquote>

- ''после каждого ответа'' — для случаев, где требуется пошагово после каждого ответа передавать информацию во внешнюю систему.

- ''передача диалога,'' скрипты для передачи диалогов.

- ''старт диалога.''

====== Дефолтные скрипты ======
В системе реализованы шаблоны скриптов по умолчанию:

Назначение:

* Автоматическое создание базовой функции при создании нового скрипта
* Возможность последующего редактирования

Расположение и настройка:

* Файлы находятся в переводчике по пути: <code>lang\ru.json</code>
* Реализовано для гибкости - администратор может изменять настройки
* Не зашито в код системы

Типы дефолтных скриптов:

* <code>_defaultScriptContainer</code> - для ЭД типа "Контейнер" (скрипты обработки)
* <code>_defaultScriptData</code> - для ЭД (скрипты постобработки)
* <code>_defaultScriptAction</code> - для действий в ЭД/КТ

[[Файл:Scrirts.png|мини|''Рис. 4 Отладка скриптов интеграции'']]
Есть '''режим отладки скриптов интеграций''' с функцией извлечения данных из сессии (рис. 4). То есть можно [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|тестировать робота в чате отладчика]] и, в случае если отработка некорректна или нужно проверить внесенные изменения в скрипт, то можно открыть вкладку «Скрипты» -> выбрать нужный скрипт -> кликнуть на закладку «Проверка» (слева откроется дополнительное окно) и нажать на кнопку «Вставить данные сессии». Тогда в открывшемся окне появятся все данные из текущей сессии из чата отладчика. По нажатию на кнопку «Тест», появится окно с результатом отработки скрипта.

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

[[Файл:2025-11-01 09-55-26.png|мини|''Рис. 5 Интерфейс вкладки «Интервалы»'']]

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

====== Группировка интервалов рабочего времени ======
Для удобства настройки сложных и переменных графиков работы в системе предусмотрена возможность объединять интервалы времени в группы. Это позволяет избежать создания громоздких условий в Контрольных Точках (КТ), когда рабочие часы оператора меняются каждый день или разбиты на несколько промежутков.

Для того, чтобы создать группу интервалов кликните на '''+''' справа от вкладки под номером '''1'''. Группа разделена на вкладки (табы), что позволяет удобно структурировать разные периоды.

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

* На одной вкладке настроить график для будних дней. Или для каждого дня отдельно.
* На другой вкладке — график для выходных.
* На третьей — особый график для праздников.

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

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

* '''события''' — действия, которые выполнит робот при наступлении определенного условия в диалоге, например «Не найдено» (см. раздел «События» ниже);
* '''исключения''' — это действия, которые выполняются, если событие повторяется указанное число раз подряд (см. раздел «Исключения» ниже);
* '''данные''';
* '''модели''' — настройка моделей, если требуется использовать параметры, отличные от параметров по умолчанию;
* '''коннекторы'''.

'''События''' есть 10-ти типов и прописываются для каждого канала связи отдельно:
[[Файл:2025-10-06 16-01-17.png|мини|''Рис. 6 Интерфейс вкладки «Настройки»'']]
# Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
# Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
# Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
# Запрос повтора — действия на случай, если абонент запросил повтор информации. Если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.
# Тишина — добавляем действие в моменты, когда от человека нет ответа, то есть тишина.
# Перебивание — событие доступно ''только для голосовых каналов (например, voice)''. Она позволяет настроить реакцию на прерывание речи.
# Задержка ответа — событие доступно ''только для голосовых каналов (например, voice)''. Это действия, которые появляются, когда идет генерация. Например, можно написать: «Секундочку, выясняю». Это нужно, чтобы человек понимал, что робот не просто молчит.
# Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя, то есть настройка действий если это событие произошло. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
# Нет данных — это событие происходит, когда система пытается получить конкретный недостающий элемент данных, например название филиала, и ей это не удалось.
# Ошибка.

'''При наступлении события система выполнит указанное в канале действие. Если действие для этого события в канале не задано, то ничего не произойдет.'''

Вы можете настроить реакции робота на определённые события. Более подробную информацию о них вы найдёте в разделе «Исключения».

'''Исключения''' есть трех типов '''Тишина''', '''Не найдено''' и '''Нет данных'''.

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

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

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

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

На вкладке можно настроить параметры голосового канала. Вот что там можно сделать:

* Выбрать голос, которым будет говорить робот.

* Установить основную модель распознавания (рекомендуем оставлять common).

* Определить фоновую модель распознавания (рекомендуем background).

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

* '''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)
* '''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
* '''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
* либо коррекция может '''Отсутствовать'''.

[[Файл:2025-10-06 16-47-09.png|мини|''Рис.7 Вкладка настроек коннектора telegram'']]

===== Вкладка «Коннекторы» =====
Позволяет настроить связь робота по одному из каналов: ''freeswitch'', ''max'', ''telegram'', ''vk'', ''web, nats.''

Для мессенджеров, таких как '''max''', '''telegram''', '''vk''', характерны следующие настройки:

* ''токен'',
* ''группа'' ''(для vk),''
* ''название бота'',
* ''обслуживающий сервер'' - имя сервера SES, который обслуживает данный коннектор,
* ''периодичность обновления'' - время периодичности запроса в api для получения новых сообщений,
* ''фразы-активаторы'' - список фраз, на которые будет реагировать робот в общих чатах, и считать, что сообщение адресовано ему,
* ''переменные,''
* ''фраза сброса сессии,''
* ''доступы'' - список пользователей, которые могут писать роботу. Если пустой, то могут все.

Для канала '''web,''' в частности, для встраивания чат-виджетов ''(рис 7.1).'' Данный коннектор предназначен для встраивания интерактивного виджета на ваш сайт. Доступно два типа виджета: '''Чат и Ассистент (Суфлер)'''.
[[Файл:2025-11-14 11-16-35.png|мини|''Рис. 7.1 Вкладка настроек коннектора web'']]
'''Общие параметры (для обоих типов)'''

Следующие настройки являются общими независимо от выбранного типа виджета.

* Домен: Укажите домен вашего сайта, на который будет встраиваться виджет. Это необходимо для безопасности, чтобы виджет мог работать только на указанном сайте.
* Токен: Уникальный идентификатор, который указан в теге <code>[[SES. Руководство администратора#Настройка виджета для сайта|<script>]]</code> для встраивания виджета на сайт.
* Акцентный цвет: Основной цвет интерфейса виджета (кнопки, заголовки, выделение). Используется для согласования с фирменным стилем вашего сайта.
* Заголовок виджета: Текст, который отображается в шапке открытого окна чата.
* Приветственное сообщение: Первое сообщение, которое видит пользователь при открытии чата.
* WebSocket-серверы: Технический параметр для установки соединения. Обычно заполняется автоматически и изменяется только по указанию технической поддержки.
* Язык: можно указать язык для виджета. Если не указывать, то будет дефолтный из конфига UPS.
<blockquote>Мультиязычность настраивается в настройках пользователя.</blockquote>'''Функциональные возможности'''

Эти опции позволяют включить или отключить определенные функции виджета.

* Голосовые ответы: Пользователь может прослушивать ответы от робота в аудиоформате.
* Отправка аудиосообщений: Пользователь может записывать и отправлять голосовые сообщения.
* Отправка файлов: Пользователь имеет возможность прикреплять и отправлять файлы.
* Аудиозвонок: Пользователь может инициировать голосовой звонок.
[[Файл:Ассистент.jpg|мини|''Рис. 7.2 Настройка переменных для режима "Ассистент"'']]
'''Выбор типа виджета'''

Перед сохранением конфигурации необходимо выбрать тип виджета, так как это влияет на доступность дополнительных параметров.

''Тип: "Чат"''

Стандартный режим для интерактивного общения с пользователем. Все "Функциональные возможности" и "Общие параметры" доступны для настройки. Также доступен блок "Переменные".

''Тип: "Ассистент" (Суфлер)''

Режим, предназначенный для подсказок оператору во время разговора с абонентом. Все переменные, необходимые для работы ассистента, настраиваются и передаются отдельно в личном кабинете пользователя. Сначала нужно авторизоваться в системе UPS ''(рис. 7.2)'', и дальше суфлер подключится сразу ко внутреннему номеру, который указан в настройках пользователя, там же можно переопределить цветовую схему под каждого пользователя.

Для канала '''freeswitch''' (телефонная линия):

* ''название коннектора,''
* ''режим обслуживания:''
** Режим «Как робот»
*** <code>Внутренний номер</code>: Указывается внутренний номер этого робота.
*** Опция ассистента: Дополнительно настраивается параметр, который определяет, будет ли ассистент (суфлер) работать после перевода звонка на оператора.
** Режим «Как ассистент»
*** <code>Внутренний номер</code>: Указывается внутренний номер робота-ассистента (суфлера).
*** <code>Номер для перевода звонка</code>: Указывается номер, на который будет переключаться звонок (номер колл-центра или конкретного оператора).
Работа ''суфлера после перевода звонка'' на оператора возможна ''в двух режимах'':

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

Флаг '''"Автостарт ассистента"''' при активации этой опции, ассистент запускается автоматически.

Настройки канала '''''nats''''':

* название коннектора,
* адрес серверов,
* канал входящих сообщений,
* канал исходящих,
* обработчик.

Принцип работы:

* Отправитель (канал исходящих сообщений) отправляет сообщение в определенный subject.
* Получатели (канал входящих сообщений), которые проявили интерес к этому subject, получают сообщение.
* Subject выступает в роли классификатора, позволяя разделять различные потоки сообщений для разных задач и сервисов.

Для работы коннектора необходимо указать адрес сервера NATS и топики (Subjects) для отправки и получения сообщений.

[[Файл:Функционал действий.png|мини|''Рис. 8 Функционал Действий'']]

==== Виды действий в роботе и работа с ними ====
'''1. Основные действия'''

Доступны следующие типы действий:

* '''Сказать'''

Настройте текстовые ответы робота. Это может быть простая фраза-заглушка, ответ, сгенерированный AI (LLM), или ответ из базы знаний (QAS). Типы ответов «Сказать» подробно описаны в разделе 2.

<blockquote>При наведении мыши на поле «Фраза» появляется кнопки-иконки [[Файл:Управление фразой действия.png|безрамки|64x64пкс]], где можно выбрать одно из действий:
# Добавить кнопку (подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Добавление кнопок в действия|«Добавление кнопок в действия»]]). Доступно пользовательское расположение кнопок, которые регулируются переносами на новые строки.
# Перефразировать. Если нужно добавить вариации фразы (рис. 8). Предложенные фразы можно отредактировать или удалить, кликнув по иконке корзинки напротив нужной фразы и добавить в список фраз.
# Удалить лишнюю фразу можно, если она не единственная.
</blockquote>

* '''Подтвердить'''

Настраивается фраза для подтверждения.

* '''Отправить файл'''

Позволяет отправить файл в ответ на запрос пользователя.

* '''Остановить выполнение действий'''

Немедленно прекращает выполнение всех последующих действий в текущем сценарии и сбрасывает точку выполнения диалога.

* '''Передача диалога'''

Переводит разговор, например, на оператора или в другой отдел. Для настройки необходимо указать ''Назначение'' передачи.

* '''Забыть данные'''

Позволяет стереть определенные данные, введенные пользователем, чтобы запросить их заново. При активации опции ''Перезапросить'' система автоматически сформирует запрос на ввод недостающих данных.

* '''Завершить диалог'''

Завершает текущий разговор с пользователем и закрывает сессию.

У некоторых действий есть опции:
* ''Считать действие успешным прохождением точки'' — этот флаг устанавливается на действия, которые означают, что сервис выполнился. В основном для отчетности.
* ''Прерываемое'' — этот флаг активируется для голосового канала и говорит о том, что допускается прерывание (перебивание) робота в момент синтеза ответа. Если он активен, робот будет реагировать на стоп-слова, в противном случае — нет.
* '''Установка переменной'''
позволяет задать или изменить значение переменной после выполнения определенного события в сценарии. Это мощный инструмент для создания сложной логики, например, для подсчета количества попыток входа в сервис и последующих действий в зависимости от этого значения.

* '''Принудительно перейти в КТ'''

позволяет принудительно отправить диалог в выбранную конечную точку.

'''2. Типы ответов для действия «Сказать»'''

При использовании действия «Сказать» вы можете выбрать один из четырех типов ответа:

1. ''Последовательно''

Робот будет выдавать вопросы и информацию по порядку, строго следуя списку, указанному в поле «Фразы».

2. ''Случайная фраза''

Робот выберет и произнесет одну случайную фразу из заданного списка.

3. ''Из внутреннего источника (недоступно для действий в элементах данных)''

Ответ формируется из Системы ответов на вопросы (QAS) для ответа из ''QAS документация'' нужно настроить'':''

* Условия присвоения категорий: Определяет правила, при которых система может направить запрос в эту категорию QAS для поиска ответа.

* Условия вывода ответа: Настройте параметры, такие как использование кеша ответов, генерация ответа и кеширование формулировок и [[QAS. UPS руководство по работе с интерфейсом#%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%20%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B8%20%C2%AB%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D1%8B%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2%C2%BB|выбрать шаблон запроса]]. Подробности [[QAS. UPS руководство по работе с интерфейсом|тут]].<blockquote>'''Обратите внимание:''' если вам нужно изменить шаблон запроса для определенной категории, это делается путем добавления отдельного действия. Настройка этого действия аналогична основному, но с выбором нужного шаблона. В Условиях запуска указываете данные, которые запустят это действие с шаблоном-исключением. </blockquote>

''QAS-чат'': Ответы генерируются AI-моделью (LLM) по умолчанию или другой моделью, добавленной администратором.

4. ''Из внешнего источника''

Позволяет подключить скрипты интеграций для выполнения специальных действий, если таковые имеются. Для действия «Сказать» с типом «Из внешнего источника» нажмите на специальную кнопку, расположенную рядом с полем выбора скрипта [[Файл:Postprocessing.png|безрамки]]. Откроется вкладка с выбранным скриптом, где вы можете:

* Просматривать код текущего скрипта,
* Редактировать существующий скрипт,
* Создавать новый скрипт.

<blockquote>Редактирование и создание скриптов не влияют на сохранение ЭД/КТ, т.к. они ссылаются только на id скрипта. Если вы выбираете другой скрипт для действия, обязательно сохраните изменения.</blockquote>'''3. Управление действиями'''

Для каждого действия доступны три опции управления (обычно отображаются в виде значков [[Файл:Для действий.png|безрамки|72x72пкс]]):

1. ''Копировать''

Чтобы скопировать действие в другой канал, нажмите эту кнопку и в открывшемся окне выберите целевой канал из списка.

2. ''Переместить''

Чтобы переместить действие в другой канал, выполните те же шаги, что и для копирования. <blockquote>'''Внимание:''' При перемещении действие будет удалено из исходного канала.</blockquote>3. ''Удалить действие''

Чтобы удалить действие, нажмите на кнопку в виде корзины.

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

===== Добавление кнопок в действия =====
В сценарной машине предусмотрена возможность добавления кнопок.

При наведении мыши на поле «Фраза» появляется кнопки-иконки , где по иконке с плюсом можно добавить кнопку:

# название кнопки;
# текст для отправки — это тот текст, который отправится на модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]], [[SEE. UPS руководство по работе с интерфейсом|SEE]]).

Чтобы внести изменения в созданную кнопку, кликните по ней левой клавишей мыши (ЛКМ) и в открывшемся меню можно редактировать или удалить эту кнопку.

Интерфейс позволяет гибко управлять расположением кнопок с помощью переносов на новую строку.

Чтобы настроить порядок кнопок:

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

Этот инструмент позволяет визуально сгруппировать кнопки и организовать интерфейс максимально удобно для пользователя.

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

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

''Переменные'' — служат для хранения данных, полученных из API или по каналам, запущенным извне. Например, это может быть ID пользователя в Telegram или CID из телефонного канала, то есть определившийся номер телефона.<blockquote>'''Переменные, как и данные, можно выбирать из выпадающего списка.''' Доступны все названия и значения, которые использовались ранее. Если вам нужно создать новую переменную и значение, просто введите их с клавиатуры. После этого они также будут предлагаться вам в дальнейшем.</blockquote>''Данные'' — элемент данных, полученный от моделей SMC или SEE.

''Интервал'' — период времени, в который запускается это действие. У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.
''Подтвердить'' — запуск действия в зависимости от наличия подтверждения от абонента.
[[Файл:Уведомление дублей.png|мини|''Рис. 9. Уведомление об одинаковых блоках ИЛИ в условиях запуска действий'']]
В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»'' (рис. 9)''.''<blockquote>'''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.</blockquote>

Также при сохранении настроек в окне "Условий запуска" если были обнаружены одинаковые блоки условий "ИЛИ", то будет соответствующее оповещение с выделением повторяющихся блоков ''(Рис. 9''.)

Пример использования условий запуска действий в конечной точке ''«Проверка статуса»:''<blockquote>
'''Ситуация 1.'''

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

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

'''Ситуация 2.'''

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

1. Определить элемент данных, который отвечает за отслеживание цифр (код). В нашем случае это модель SEE number и элемент данных «Код заявления».

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

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

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

==== Добавление и настройка элементов данных ====
[[Файл:Снимок экрана 2025-07-16 154838.png|мини|''Рис. 10. Массовое добавление элементов данных'']]
[[Файл:2025-12-11 11-15-27.png|мини|''Рис. 10.1. Бланк настройки элемента данных'']]
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку '''«Добавить элемент»'''. В появившемся диалоговом окне возможны два варианта добавления: '''"Одиночное"''' и '''"Массовое"'''.

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

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

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

'''Контейнер''' — составной элемент данных, который собирает необходимые данные, чтобы отправить их во внешнюю БД по API с помощью скриптов интеграции.

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

===== Настройка элемента данных =====
[[Файл:2025-04-23 14-43-07.png|мини|''Рис. 11 Проверка модели в ЭД'']]
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (''Рис. 10.1'').

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

'''«Вес»''' — это параметр, который определяет приоритет этого элемент данных в спорных ситуациях. По умолчанию установлено значение 3. Также вес ЭД отображается в [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчике]] и, если у вас активировано [[SES. UPS руководство по работе с интерфейсом#Панель управления SES|табличное представление сценария]], то и в самой таблице. <blockquote>Совет по работе с весом ЭД.

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

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

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

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

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

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

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

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

Рядом с комментарием находится кнопка '''Исключения''' [[Файл:Исключения .png|безрамки|20x20пкс]]. По нажатию на эту кнопку можно для определенных элементов данных настроить нестандартные исключения, то есть исключения, отличные от общих настроек (рис.12). <blockquote>
Например, для ЭД «Название филиала». [[SES. UPS руководство по работе с интерфейсом#Вкладка «Настройки»|В общих настройках]] робота МФЦ указано, что количество исключений для события «Нет данных» равно 3 (в счетчик входит и первое обращение к роботу, если там не было нужной информации). Однако мы хотим, чтобы, если с первого раза филиал не был найден, робот больше не запрашивал у абонента его название. Вместо этого робот должен показать заглушку с предложением поискать нужный филиал на сайте. Для таких случаев можно настроить '''нестандартное исключение.''' </blockquote>Настройка нестандартного исключения:

# выберете нужный элемент данных,
# кликните на значок исключения [[Файл:Исключения .png|безрамки|20x20пкс]],
# в появившемся окне активируйте флаг «включить нестандартные исключения»,
# заполните тип исключения Нет данных,
# установите максимальное кол-во исключений подряд (если хотите уточнять один раз, то макс.кол-во устанавливайте равным 2),
# установите канал связи при необходимости,
# и выберете действие на случай, если исключение наступило.
[[Файл:Постобработка ЭД.png|мини|''Рис. 12.1. Постобработка данных'']]
Далее находится кнопка '''«Постобработка»''' [[Файл:Postprocessing.png|безрамки]]'''.''' При нажатии на нее появится всплывающее окно с редактором кода, где можно написать функцию, которая будет срабатывать после того как ЭД был получен (Рис. 12.1). Установите галочку '''«Включить постобработку»''' и в редакторе отобразится функция-обработчик, которая принимает на вход три параметра: ''значение ЭД, текст последнего сообщения, канал'', и возвращает значение ЭД и опционально текст сообщения.<blockquote>'''Пример:'''

<code>def handler(value, message, channel):</code>

<code> if value == 'старый' and message == 'старый' and channel == 'voice':</code>

<code> return 'новый', {'text':'новый'}</code>

<code> elif value == 'новый' and message == 'новый' and channel == 'voice':</code>

<code> return 'старый', {'text':'старый'}</code>

<code> return value, {'text': 'не тот канал'}</code></blockquote>

'''Тестирование скриптов в ЭД'''

Процесс тестирования скриптов в ЭД аналогичен тестированию скриптов во вкладке "Скрипты", с учетом того, что скрипты находятся непосредственно в самих ЭД.

Важное отличие:

* Для ЭД типа «Класс» или «Сущность» - поле «Значение» обязательно для заполнения.
* Для ЭД типа [[SES. UPS руководство по работе с интерфейсом#Произвольный элемент данных|«Произвольный»]] - поле «Значение» заполняется по необходимости (опционально).

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

'''Работает только в условиях запуска. Если ЭД с этим флагом стоит на входе в КТ, то фраг игнорируется.'''</blockquote><blockquote>'''Пример: Запись на прием'''

1. Процесс взаимодействия с пользователем

Пользователь хочет записаться на прием. Для этого необходимо собрать следующие данные:

* Намерение (цель обращения).
* Адрес (куда хочет попасть пользователь).
* ФИО.
* Номер телефона.

2. Работа моделей в КТ "Запись на прием"

* Все модели, отвечающие за обработку запроса, работают в фоновом режиме.
* На любом этапе диалога они могут «выхватывать» сущности (например, извлекать ФИО, адрес и т. д.).

3. Проблема ложного срабатывания

Модель может ошибочно извлечь данные, если:

* Пользователь вводит информацию, которая частично совпадает с искомой сущностью (например, город ''"Владимир"'' может быть ошибочно принят за имя).
* Это приводит к некорректной обработке данных до завершения сценария.

4. Решение: ограничение работы модели

Чтобы избежать ложных срабатываний:

* Активируйте галочку '''«Получать только прямым запросом»''' в настройках ЭД.
* Если галочка активна, модель (например, извлечение ФИО) сработает только когда:
** Сценарий диалога дошел до запроса ФИО.
** Пользователь явно отвечает на вопрос о недостающих данных по ФИО.

Таким образом, '''система не будет обрабатывать случайные упоминания имен или других сущностей вне контекста запроса.'''</blockquote>Флажок '''«Подставлять ответ модели в запрос к ЧаВО»''' предназначен для работы с типами ЭД «Сущность». Его основная функция — подставлять в запросы пользователей ответ от модели (название тэга) SEE вместо исходного текста абонента, на который среагировала модель.<blockquote>'''Пример использования'''

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

# Создаем модель SEE с тегами:
#* <code>до 14 лет</code>
#* <code>с 14 лет до 18 лет</code>
#* <code>с 18 лет</code> ''(Теги формируются на основе предоставленной документации.)''
# Добавляем ЭД в качестве недостающего элемента в настройки КТ.
# Когда сценарий доходит до дозапроса этого ЭД или абонент сам предоставляет данные, система отправляет запрос в QAS. Например, абонент отвечает, что ему 44 года, но в документах нет такого варианта. В них информация сгруппирована <code>до 14 лет</code>, <code>с 14 лет до 18 лет</code> и <code>с 18 лет.</code> Соответственно система не найдет похожую информацию.
# Решение:
#* Если флажок активирован, система подставит ближайший подходящий тег (в данном случае — <code>с 18 лет</code>).
#* Это поможет QAS корректно находить информацию в документации.
'''Важно:''' если ваша модель SEE '''не отдаст ответ''', то настройка '''не сработает'''. Проверьте и при необходимости дообучите модель.</blockquote>

Флаг '''«Удалять сущность из запроса к ЧаВО»''' предназначен для типов «ЭД Сущность» и работает наоборот: он удаляет из запроса пользователя слова или фразы, которые распознала модель.

Флажок '''«Режим долгого ожидания»''' Открывает дополнительное меню с триггерами окончания ожидания. Это данные, при получении которых мы прекращаем ждать именно этот элемент данных (ЭД). Например, если получили его же или другие данные, например, просьбу позвать оператора.<blockquote>'''Обратите внимание:''' чтобы этот режим работал правильно, создайте нестандартное исключение для ЭД (описание выше). Иначе система будет ориентироваться на общие настройки количества исключений.</blockquote>

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

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

===== События элемента данных =====

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

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

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

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

'''Тип события''' '''«Элемент получен».''' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).

'''Тип события''' '''«Тишина»''' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек молчит.[[Файл:Уведомление об отсутствующем классе.png|мини|''Рис. 14. Уведомление об отсутствующем классе'']]<blockquote>
Например, если робот спрашивает у абонента, какой паспорт ему нужен, а человек молчит, можно через некоторое время повторить вопрос или сказать: «Говорите громче, не слышно».</blockquote>

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

В таблице элементов данных предусмотрено уведомление ''(Рис. 14)'' об отсутствующей модели на сервере, которую использует элемент данных, а также об отсутствующем классе/группе в выбранной модели. При таких случаях слева от элемента данных расположен значок [[Файл:Warning.png|безрамки]], при наведении курсора мыши на который появляется соответствующее сообщение.

===== Произвольный элемент данных =====
Элемент данных типа «Произвольный» предназначен для обработки произвольных текстовых данных от пользователя, таких как:

- Нажатия кнопок (текста на кнопках),

- Точные текстовые фразы,

- Данные, присваиваемые через скрипты.

''Простая настройка:''

- Текст: текст от пользователя (например, текст на кнопке или точная фраза), который нужно «отловить».

- Значение элемента данных: присваиваемое значение этому элементу данных (param).

''Универсальное применение:''

- Обработка различных кнопок в одном элементе данных.

- Возможность скриптового присвоения любых значений.

- Замена использования элемента-заглушки со скриптами.

- Пользоваться таким ЭД можно точно так же как и другими элементами. Вести в разные действия и категории исходя из значения произвольного ЭД.<blockquote>''Пример использования''

Сценарий: Обработка различных текстов с кнопок БЕЗ обработки моделями, то есть модель может «не знать» этих фраз:

- Текст: "Поддержка участников СВО" → Значение ЭД: «Поддержка СВО»

- Текст: "Льготы для пенсионеров" → Значение ЭД: «Социальные услуги»

Таким образом, один произвольный элемент данных может обрабатывать множество различных вариантов ввода.</blockquote>[[SES. UPS руководство по работе с интерфейсом#События элемента данных|События]] на этом элементе аналогичные как и на обычных ЭД.

[[Файл:2025-10-06 13-10-56.png|мини|''Рис. 15 Интерфейс контейнерного ЭД'' ]]

===== Элемент данных типа «Контейнер» =====
Контейнер — это составной элемент данных, который объединяет несколько дочерних элементов для последующей обработки. Его основная функция — сбор необходимых данных и их отправка во внешнюю базу данных через API с использованием скриптов интеграции.

Доступ к редактору скриптов:

# Перейдите в карточку элемента данных «Контейнер»
# Нажмите на кнопку вызова редактора скриптов [[Файл:Postprocessing.png|безрамки]]
# ''Важно:'' Если скрипт не заполнен, кнопка будет подсвечиваться красным цветом

Создание функции обработки:

* При нажатии на кнопку открывается всплывающее окно с редактором кода
* Функция выполняется после получения всех данных элемента
* Для активации установите галочку «Включить скрипт обработки»

Функция принимает три входных параметра:

# <code>value</code> — значение текущего элемента данных
# <code>message</code> — текст последнего сообщения от пользователя
# <code>chanel</code> — идентификатор канала взаимодействия

Функция возвращает:

* Обязательно: обработанное значение элемента данных (value и записывает его в значение ЭД param)
* Опционально: текст сообщения для пользователя

События контейнерного ЭД:

* ''«Элемент получен».'' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).
* ''«Нет данных»'' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек говорит что-то, но не ответ на вопрос.

==== Добавление и настройка конечных точек ====
[[Файл:2024-11-18 12-00-28.png|мини|''Рис. 16 Рабочая область SES'']]Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В верхней правой части рабочей области расположена кнопка '''«Добавить конечную точку»''' (рис. 16). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки образуют «облако конечных точек».

===== Настройка конечной точки =====
После того как вы ввели название конечной точки и нажали кнопку '''«Добавить»''', слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается ''название конечной точки'', при желании его можно сменить. Также доступен выпадающий список «Тип». Здесь можно выбрать один из четырёх вариантов:[[Файл:2025-03-28 14-57-55.png|мини|''Рис. 17 Типы входа в конечные точки'']]'''«Отчетный»''' — эта та, которая участвует в статистике, т.е. несет какую-то полезную для анализа информационную нагрузку.

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

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

'''«Завершение диалога»''' — конечная точка, которая ставит точку в общении с пользователем.[[Файл:2025-05-28 16-23-27.png|мини|''Рис. 18 Вход в КТ по условиям'']]

Также можно выбрать еще '''Тип входа в КТ''' может быть трех видов (рис. 17):

'''- по условиям''', когда попадаем в КТ при условии получения определенных данных, например, класс от SMC (рис. 18). На вкладках «Условия» доступна ''фильтрация по элементу данных.''

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

Абонент обратился за консультацией. Робот предоставил ответ. После консультации абонент бездействует, а сессия еще не закрыта. Можно настроить КТ Оценка качества обслуживания, которая по истечению указанного времени запросит оценку, после ответа абонента, завершит сессию.</blockquote>- '''по ручному запуску''', когда КТ нужно принудительного запустить, например для рассылки. Чтобы настроить вход в конечную точку нужно выбрать в меню Вход опцию «По ручному запуску». Интерфейс КТ по ручному запуску идентичен КТ со входом «По бездействию», за исключением поля «Время».

Такой вариант входа в КТ подходит для исходящих сообщений (обзвонов), например, чтобы отправить абоненту напоминание-подтверждение о предстоящей записи: «Уточните, пожалуйста, вы придете на прием?»

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

'''Настройка исключений для конечных точек'''

Вы можете настроить автоматическое реагирование на сбои в работе конечных точек. Исключения [[Файл:Исключения .png|безрамки|20x20пкс]] - это специальные действия, которые выполняются при нескольких последовательных неудачных запусках конечной точки.

Система отслеживает статус запусков. Когда количество неудачных попыток подряд достигает заданного вами значения (например, 3), автоматически выполняется указанное вами действие.

Пример настройки:

* Условие: 3 неуспешных запуска подряд.
* Действие: Перевести звонок оператору ''или'' Завершить диалог.

===== Условия входа и запуска конечных точек. Сбор информации =====
'''Типы условий для входа'''

Для настройки условий '''входа''' в системе доступны три основных типа:

1. ''Данные''. Проверка значений элементов данных.

2. ''Переменные''. Работа с системными и пользовательскими переменными.

3. ''Подтверждение''. Проверка статуса подтверждения от пользователя. Возможные значения:

* Получено (пользователь подтвердил действие)
* Не получено (пользователь отклонил действие)

Для '''условий запуска''' есть дополнительно 4-ое условие, помимо вышеперечисленных:

4. ''Интервалы.'' У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.

Для '''сбора информации''' есть только 2 варианта условий: данные и переменные.<blockquote>Применение: Эти типы условий позволяют гибко управлять логикой диалога, направляя пользователя по различным сценариям в зависимости от текущего контекста.</blockquote>

'''Условия входа (Вход).''' Для того чтобы попасть в конечную точку и выполнить определенные действия, нужно выполнить условия входа. Их может быть как один элемент данных, так и их сочетание.<blockquote>Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: ''«Загранпаспорт»'' (получена метка от [[SMC. UPS руководство по работе с интерфейсом|SMC]], соответствующая этому элементу данных). А также сочетание элементов данных: ''«Паспорт»'' (получаем, если тип паспорта не указан сразу) и ''«Тип паспорта-загран»'' (тег «Загран» получили после уточнения типа паспорта).</blockquote>Условия входа объединены в блоки, которые имеют логическое условие «И». Чтобы добавить новое условие, необходимо нажать на кнопку «Добавить условие» [[Файл:Добавить условие.png|безрамки|20x20пкс]]. Блоки с условиями «И» разделены логическим «ИЛИ».
Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:
* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* + (Прибавить) — для увеличения счетчика,
* - (Вычесть) — для уменьшения счетчика,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

[[Файл:Рис. 17 Условия запуска.png|мини|''Рис. 19 Условия запуска'']]
'''''Условия запуска и Сбор информации''.''' Вкладка ''Сбор информации'' и меню ''Условия запуска'' идентичны по своему назначению'''.'''

По нажатию на эту кнопку открывается окно, где нужно указать '''''все''''' случаи (данные и их комбинации), '''''при которых точка сработает''''' (см.рис. 19). В окне «Условия запуска» элементы данных разделяются логическим оператором «ИЛИ». В случае с комбинациями условий ЭД отделяются друг от друга логическим «И». Как в случае с элементами, разделёнными операторами «ИЛИ», так и с элементами, разделёнными «И», порядок элементов можно менять. Аналогично для вкладки Сбор информации.

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

Условия можно редактировать: добавлять и удалять. Окно можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.<blockquote>Например, конечная точка «Консультация» активируется, если будут получены метки «Апостиль» ИЛИ «Банкротство» ИЛИ «Загранпаспорт» и «Тип паспорта — загран».</blockquote>В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»''. '''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.

У условий есть параметр ''«Тип»'', принимающий два значения: данные или переменная. Параметр ''«Искать»'' имеет три варианта:

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

Далее идет поле «Название», где из выпадающего списка требуется выбрать нужный элемент данных. <blockquote>Если в выбранном элементе данных не заполнено событие «Недостающий элемент», то в правом верхнем углу будет расположен значок [[Файл:Warning.png|безрамки]] со всплывающим уведомлением при наведении на него.</blockquote>Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:

* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

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

===== Условия присвоения категорий =====
[[Файл:2025-07-07 12-42-57.png|мини|''Рис. 20 Вкладка Действия и Условия присвоения категорий'']]
'''''Условия присвоения категорий'''.'' По клику на эту кнопку раскрывается меню (рис. 20), в котором есть выпадающий список со всеми категориями из [[QAS. UPS руководство по работе с интерфейсом|QAS]], а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ». ''Окно с условиями категорий или условиями запуска можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.''<blockquote>На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ». </blockquote>Флажок '''«Запрос в QAS с учетом прошлого контекста»''' указывает системе, что перед отправкой запроса в QAS необходимо проанализировать предыдущие сообщения пользователя. Это позволяет сохранять логику диалога и избегать необоснованной смены тематики.<blockquote>'''Пример работы'''

# Без включенной функции
#* Пользователь спрашивает: ''"Какие документы нужны для оформления СНИЛС?"'' → система направляет запрос в категорию СНИЛС.
#* Затем пользователь уточняет: ''"А сколько это стоит?"'' → система определяет метку Госпошлина и перенаправляет запрос в соответствующую категорию, теряя контекст СНИЛС.
# С включенной функцией
#* Если флажок активен (например, для категории ''Госпошлина''), система:
#** Проверяет предыдущие сообщения.
#** Если диалог начался в другой категории (например, СНИЛС), запросы объединяются (''"склеиваются"'').
#** Если контекст отсутствует, тематика меняется, но поиск ответа ведется сразу по обеим категориям (СНИЛС + Госпошлина).

'''Когда использовать'''

Активируйте эту настройку для категорий, которые могут:

* Быть частью более широкого запроса (например, ''Госпошлина'' как дополнение к ''СНИЛС'').
* Требовать сохранения контекста диалога.

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

===== Индикация удаленных категорий =====
Система визуально выделяет удаленные категории для привлечения вашего внимания:

# Конечные точки с недействительными категориями в табличном представлении: помечаются специальным значком и выделяются красным цветом. При наведении на значок сообщение: ''«Используются несуществующие категории в канала: [название_канала](кол-во)»''
# В облаке конечных точек: КТ с недействительными категориями также отображаются красным цветом, но без значка.
# В условиях присвоения категорий: Если используется удалённая категория, система отобразит предупреждающее уведомление ''«Используются несуществующие категории: [кол-во]»''.

Это позволяет быстро находить и корректировать объекты, которые зависят от неактуальных данных. А так же это важно для экспорта и импорта роботов (см. разд. Панель управления).

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

==== Связанная фильтрация ЭД и КТ ====
В интерфейсе реализована связанная фильтрация между таблицами Элементов Данных (ЭД) и Контрольных Точках (КТ). Это позволяет автоматически находить взаимосвязанные объекты.

'''Принцип работы:'''

* Фильтрация по ЭД: При вводе названия в фильтр таблицы Элементов Данных:
** В таблице ЭД отображаются только те элементы, названия которых соответствуют фильтру.
** Одновременно в таблице КТ автоматически отображаются только те Контрольные Точки, в которых используются отфильтрованные ЭД.

* Фильтрация по КТ: При вводе названия в фильтр таблицы Контрольных Точек:
** В таблице КТ отображаются только те точки, названия которых соответствуют фильтру,
** Одновременно в таблице ЭД автоматически отображаются только те Элементы Данных, которые используются в отфильтрованных КТ.

<blockquote>'''Важно''':

Система учитывает использование Элементов Данных во всех типах Контрольных Точек:

1. Входные данные (вход).

2. Собираемая информация (условия запуска/сбор информации).

3. Условия запуска действий.</blockquote>

==== Тестирование робота ====
[[Файл:2025-10-06 11-49-26.png|мини|307x307пкс|''Рис. 21 Окно чата для тестирования робота'']]
В интерфейсе SES есть чат с отладчиком (рис. 21), где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок [[Файл:Чат.png|безрамки|20x20px]] в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка '''«Перезапустить сессию»''' [[Файл:Обновить данные вопроса.png|безрамки|20x20px]], которая сбрасывает всю переписку и данные отладчика. А слева — кнопка '''«Данные сессии»''' [[Файл:Кнопка отладчик без полей.png|безрамки|20x20px]], предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS и не только, подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Данные сессии|Данные сессии]]. И кнопка '''«Тестирование скрипта»''' [[Файл:Пробирки.png|безрамки|20x20пкс]], подробнее [[SES. UPS руководство по работе с интерфейсом#Тестирование скриптом|тут]]. Есть возможность отправлять в чат файлы нажав на [[Файл:Скрепка.png|безрамки|20x20пкс]] и выбрав файл (в любом формате).

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

Режим отладки (дебаг):

* В режиме отладки появилась панель логов.
* Логи автоматически обновляются после каждого ответа от робота.
* Вместе с логами также обновляются данные текущей сессии.

Настройки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] чата позволяют выбрать настройки аудиоответов, а так же установить переменные, например, номер телефона.

Еще в меню настроек можно выбрать КТ по ручному запуску, чтобы протестировать работу КТ и сценария (рис. 22).
[[Файл:2025-10-20 10-56-18.png|мини|300x300пкс|''Рис. 22 Выбор конечной точки для тестирования.'']]

===== Тестирование в текстовых каналах =====

===== Данные сессии =====
Раскрыв данные сессии можете увидеть, все данные о текущем диалоге с роботом. Разберем по порядку, ниже представлены некоторые данные из ключа root, они нужны не все, разберем только нужные:<blockquote>
"started":"2025-06-10 09:46:05" — ''время начала сессии''

"modified":"2025-06-10 09:49:08" — ''когда произошли изменения последние (пришел запрос/изменилась тематика)''
"robot":"ffeaa99a-13d2-4bff-b458-1231c884f8ee" — ''id робота, у продовой версии будет приписка _prod''

"session":"beefb6a2-dc08-47d4-9e02-2495329173ec" — ''id сессии''

"channel":"default" — ''активный канал, в котором происходит тестирование''

"connector":"web"

"unknown":false.
</blockquote>
[[Файл:2025-10-06 12-45-38.png|мини|''Рис. 23 Пример работы с отладчиком'']]
Далее идет самая интересная для аналитиков часть - <code>"current"</code> . Раскрыв этот ключ можно посмотреть в какую конечную точку привёл сценарий, и была ли запросу присвоена какая-либо категория. А так же параметр ''data'', раскрыв который можно увидеть все классы (рис. 23 и 23.1), которые пришли от модели [[SMC. UPS руководство по работе с интерфейсом|SMC]] и/или модели [[SEE. UPS руководство по работе с интерфейсом|SEE]] и их достоверность и вес. Раскрыв в ''data'' параметр ''reply -'' увидеть данные ответа от робота. Имея все эти данные можно отладить работу сценария.
[[Файл:2025-10-06 12-47-26.png|мини|''Рис. 23.1 Работа с отладчиком. Просмотр параметра data и логов'' ]]
<blockquote>"current":{

"id":"Консультация ЧаВО" — конечная точка, в которую привел сценарий,

"qas":"оформить снилс" — запрос, который отправился в QAS.

}<blockquote>'''Обратите внимание:''' если параметр QAS в отладчике пустой, это значит, что ваш запрос не был передан в QAS. Если же в этом параметре отображается ваш запрос, но робот просит вас перефразировать его, то, вероятно, в базе данных не хватает формулировки с ответом или на ответе отсутствует пометка «проверено». Это может происходить, когда в настройках КТ, отвечающей за консультирование из базы данных QAS, установлен параметр «Использовать кэш ответов» в режиме «Только проверенные ответы». </blockquote>'''Отработка склеек и удержания контекста''': в QAS летит вообще вся история сообщений в рамках одного контекста общения '''через разделитель «|»'''. Модель генерации будет отвечать на последний вопрос в цепочке с учетом ранее написанных сообщений в этом контексте.

"answered":true — был ли ответ true/false
"category":[0:"МФЦ НСО СНИЛС"] — отображается список категорий, в которые попал вопрос (их может быть больше одной).

"nearest":NULL

''Следующий кусок ключа current проще объяснить на примере запроса "оформить паспорт":''

"entry":"entry":[0:"Паспорт, вес 3" ] — зашли в КТ по метке «Паспорт», запросили тип паспорта (загран), старый/новый образец и дошли до возраста получателя:

"missingRunData":[

0:"Возраст заявителя для заграна, вес 3"] — тут отображаются ЭД, которые нужны для «пропуска» дальше в действия.

"passedRunData":[ ] — список условий AND, который выполнился.

"waitingRunData":

"Возраст заявителя для заграна, вес 3" — отображается ЭД, который запросили и ждем получения.

"border":0 — отражает границу, от которой система смотрит на данные. Например, при border:1 - система будет смотреть от 2-го ЭД в списке data и ниже. При border:0 - с первого.

"preborder":0

}</blockquote><blockquote>"models":[...] — раскрыв список, можно посмотреть все модели, которые отработали за сессию.

"scripts":[] — отображает список скриптов, которые отработали за сессию.

"data":[...] — раскрыв data, можно увидеть параметр "message" — фраза-сообщение пользователя. И под каждым message, есть своя data, где находятся все метки и все тэги, пришедшие от моделей SMC и SEE на эту фразу.

"timers":[...]

"variables":{} — тут отображаются пришедшие переменные, если есть.

"error":"" — выводит ошибку при отработке скрипта.

"events":{ — параметр отображает счетчики событий за сессию (не найдено/нет данных/тишина).

"not found":{...}

"no data":{...}

"silence":{...}

}</blockquote>

[[Файл:2025-06-10 16-15-43.png|мини|''Рис. 24 Окно автотестирования скриптов'']]

===== Тестирование скриптом =====
[[Файл:2025-06-10 16-22-59.png|мини|''Рис. 25 Добавление скрипта для тестирования'']]
[[Файл:Тестирование скриптов.png|мини|''Рис. 26 Интерфейс окна «Тестирование скриптов»'']]
Теперь вы можете автоматически тестировать робота с помощью скриптов. Например, если у вас возникли сложности с маршрутизацией и нет желания каждый раз вручную воспроизводить весь диалог при отладке сценария, вы можете сохранить его для последующего тестирования. Для этого кликните на кнопку [[Файл:Пробирки.png|безрамки|20x20пкс]] справа от чата появится окно. Добавить скрипт можно путем '''''импорта из файла''''' [[Файл:Импорт нов.png|безрамки|20x20пкс]], если есть данные '''в формате txt''' или '''''импортировать диалог''''' из текущей сессии. Нажмите на иконку импорта или выберите ''«Скрипт»'' в выпадающем меню и нажмите '''''«Добавить скрипт»''''' (рис. 24). Появится диалоговое окно «''Добавление скрипта»''. Введите название скрипта, выберите файл и нажмите ''«Добавить»''. Если у вас уже открыта сессия, отметьте в окне добавления скрипта опцию '''''«Импорт из чата»'''.'' Если у вас несколько скриптов, переключаться между ними можно через выпадающий список ''«Скрипт».''

Правее него находятся иконки ''импорт'' [[Файл:Импорт нов.png|безрамки|20x20пкс]], ''экспорт'' [[Файл:Экспорт нов.png|безрамки|20x20пкс]] и ''удалить'' [[Файл:Удаление документа.png|безрамки|20x20пкс]]. Импорт был описан ранее. '''''Экспорт''''' позволяет выгрузить скрипт в формате txt. Кнопка '''''удалить''''' - удаляет весь скрипт.

Файл для импорта и экспорта - это простой текстовый файл, в котором все запросы к роботу, каждый с новой строки.

Галочки обозначают точки останова (рис. 25). Когда они стоят, автотест останавливается и ждет, пока вы нажмете кнопку «Дальше». параллельно можно открыть отладчик и смотреть, что происходит на каждом этапе теста.

У тестирования есть два основных режима:

# Полный тест:
#* Все галочки сняты
#* Тест выполняется автоматически от начала до конца, без остановок
# Пошаговый режим:
#* Тест останавливается на каждом шаге
#* Для продолжения нужно нажимать "Дальше"

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

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

Последняя отправленная фраза будет выделена голубым цветом.

===== Просмотр данных сессии =====
Эта функция позволяет вам в реальном времени отслеживать диалоги и данные сессии у другого пользователя в '''рамках одного бота'''.

'''Подключение к отслеживанию'''

# Нажмите на иконку «Просмотр сессии» [[Файл:2025-10-22 12-54-24 (1).png|безрамки|20x20пкс]] . Введите название переменной, за которой хотите следить и ее значение (если требуется, например, номер телефона абонента) в соответствующие поля.
# Нажмите кнопку «Подключиться».
# Меню закроется, и вы увидите всплывающее уведомление с подтверждением успешного подключения.
# В основном интерфейсе индикатор отслеживания (иконка «Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]) изменит свой вид: он будет зачеркнут и периодически мигать. Это сигнализирует о том, что соединение активно и система ожидает данные.
Как поступают данные:

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

'''Отключение от отслеживания'''

Чтобы прекратить отслеживание, выполните одно из следующих действий:

* Нажмите на индикатор отслеживания («Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]), который активен в режиме подключения.
* Выполните команду «Сброс сессии» [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]].

Любое из этих действий разорвет соединение для отслеживания, и индикатор вернется в обычное состояние.

'''Пример настройки просмотра сессии'''

Пользователь, за чьим диалогом будет наблюдение, должен создать у себя переменную (любую) и ее значение:

* <code>variable = за мной следят</code>

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

Пользователь, который хочет подключиться для просмотра, должен в своем разделе ''просмотра сессии'' создать точно такую же переменную:

* <code>variable = за мной следят</code>

И после того, как начнется диалог, в режиме реального времени наблюдатель будет видеть все данные сессии того, кто ведет диалог с роботом.<blockquote>'''Функция для пользователей UPS'''

Для более удобного отслеживания вы можете использовать уникальный <code>id пользователя UPS</code> , который передается в переменные сессии.

* Вместо того чтобы указывать одинаковые переменные у обоих пользователей, вы можете напрямую указать <code>id пользователя</code>, за которым хотите следить.
* Это позволяет вам следить за конкретным пользователем, при этом ему не обязательно вручную задавать у себя переменную.
</blockquote>

===== Тестирование голосовыми сообщениями и в голосовом канале =====
[[Файл:2025-06-10 12-44-58.png|мини|''Рис. 27 Тестирование робота с помощью микрофона.'']]
Робота можно протестировать, задавая вопросы голосом и/или вводя переменные. Например, можно проверить, как робот отправляет в разные конечные точки, получая одинаковые метки от SMC и номера телефонов различных ведомств. Например, метка «Мобилизация» от SMC в сочетании с номером телефона МФЦ приводит в КТ Консультация ЧаВО, а «Мобилизация» и номер единого контактного центра (ЕКЦ) — в КТ Перевод на оператора. Чтобы провести тестирование робота с переменными раскройте меню, кликнув на иконку шестеренки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] и заполните поля:

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

- Значение: укажите значение этой переменной..
[[Файл:2025-10-06 11-51-58.png|мини|''Рис. 28 Иллюстрация тестирования канала voice.'']]
В этом же меню вы можете настроить параметры аудиоответов и автовоспроизведения.

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

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

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

В дебаггере есть функция, позволяющая протестировать '''голосовой канал - voice''' (рис. 28), то есть ''имитировать звонок''. Чтобы запустить процесс, достаточно нажать на кнопку «Начать разговор» [[Файл:Начать разговор.png|безрамки|20x20пкс]] . Пока разговор активен, кнопка изменится на «Закончить разговор» [[Файл:Закончить разговор.png|безрамки|20x20пкс]] . Переменные задаются в меню, как и в текстовом канале. Для этого нажмите на иконку шестерёнки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] (рис. 21).

=== Архив диалогов ===
[[Файл:Архив диалогов нов.png|мини|''Рис. 29 Интерфейс архива диалогов'']]
После тестирования робота в любом канале можно заглянуть в Архив диалогов (рис. 29), чтобы изучить данные сессии. Для этого необходимо кликнуть на одноименную кнопку на панели инструментов рядом с кнопками версий робота [[Файл:Архив диалогов.png|безрамки|20x20пкс]]. Интерфейс архива содержит:

* Список доступных роботов слева на экране.
* Блок с фильтрацией диалогов.
* До момента пока вы не выберете диалог из списка справа будет пустой блок с текстом «Выберете диалог». После того как диалог выбран вы увидите отображение аналогичное рисунку 29.
* Информационные вкладки (см. в разделе [[SES. UPS руководство по работе с интерфейсом#Настройка робота|«Настройка робота»]]).

==== Работа с архивом диалога ====
Архив диалогов поддерживает версионность робота, то есть можно просмотреть диалоги одной из трех версий: черновик, прод или архивной. Для этого кликните по кнопке с нужной версией находясь уже в Архиве либо предварительно выбрав ее и перейдя в архив. Диалоги в архиве фильтруются по дате и времени, для этого кликните на иконку календаря [[Файл:Календарик с фоном.jpg|безрамки|20x20пкс]] в поле «Начало» и «Конец», чтобы выбрать дату. И время, кликнув на иконку часов ''(по умолчанию дата и время выставляются за текущие сутки)''. Выберите нужную дату и время, добавьте необходимые фильтры. Также можно отфильтровать звонки по:

# каналам связи:
* default,
* telegram,
* web,
* voice,
* vkontakte.
2. элементам данных — при нажатии на это поле открывается перечень всех элементов данных из сценария текущего робота.

3. номеру телефона,

4. ID диалога берется из отладчика — это значение атрибута <code>session</code>. В архиве диалогов предусмотрено копирование ID: при нажатии на иконку копирования она загорается зеленым, что означает успешное копирование в буфер обмена.

5. по названию и значению переменной,

3. либо тексту, либо ключевым словам, которые могут быть в искомом диалоге.

После настройки система, по нажатию кнопки «Поиск», отобразит все диалоги с роботом, учитывая выбранные фильтры (рис. 27). На самом верху над диалогом можно просмотреть его ID. В архиве диалоги сгруппированы по принципу «запрос от пользователя — ответ робота». При выборе каждой пары открывается отладчик, где можно увидеть метки и теги, полученные от моделей, копия [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчика]] из тестирования робота. Этот отладчик аналогичен тому, что используется в сценарной машине. Для голосового канала есть возможность прослушивания аудио диалога помимо текстового просмотра. Также есть возможность импортировать запросы диалога в скрипт тестирования в чат-отладчик по кнопке '''«Добавить в скрипт тестирования»''' снизу диалога и в появившемся окне введите название скрипта тестирования. После чего он появится в списке скриптов тестирования сценария.

Для вашего удобства во время ''активного'' диалога в архиве доступна кнопка '''«Следить за диалогом»'''. Нажмите кнопку «Следить за диалогом» во время просмотра архива ''активного'' диалога. Система начнёт автоматически обновлять список реплик, подгружая новые сообщения. Обновление происходит каждые 5 секунд, обеспечивая актуальный вид беседы без необходимости обновлять страницу вручную. Позволяет в реальном времени следить за развитием ещё не завершённого диалога, например, во время тестирования или активного общения с роботом.

===== Синхронизация текста и аудио в архиве диалогов =====
В архиве диалогов реализована условная синхронизация текстовой расшифровки с аудиозаписью на основе временных меток (datetime).

* При воспроизведении аудио: В текстовой расшифровке автоматически подсвечивается реплика (вопрос/ответ), которая звучит в данный момент.
* При клике на текст реплики: Воспроизведение аудио автоматически перематывается на тот момент записи, когда эта реплика абонента была произнесена.

Результат: Вы можете быстро находить нужные фрагменты разговора и удобно анализировать диалоги.

Чтобы '''выйти из Архива диалогов''' в сценарий нужно снова кликнуть на иконку [[Файл:Архив диалогов.png|безрамки|20x20пкс]].

=== Пользовательские справочники ===
[[Файл:Photo 2025-05-14 17-30-31.jpg|мини|''Рис. 30 Добавление пользовательского справочника'']]

Для доступа к справочнику нажмите на значок «Пользовательский справочник» [[Файл:Справочник (1).png|безрамки|20x20пкс]] на панели инструментов справа от архива диалогов. Чтобы создать новый справочник, нажмите кнопку '''«Добавить справочник»''' (рис. 30). В открывшемся окне заполните обязательные поля: название справочника и его структуру — наименования колонок. При необходимости задайте значения по умолчанию для каждой колонки. Эти значения будут автоматически заполнять новые строки. Затем нажмите '''«Добавить»'''.

Если значения по умолчанию не указаны, справочник будет пустым. Заполнять таблицу можно вручную.

Справочники можно переименовывать и удалять. Чтобы переименовать или удалить справочник, наведите курсор на его название. Появится две иконки: карандаш для переименования и корзинка для удаления. <blockquote>'''Перед переименованием справочника ''обязательно'' сохраните внесенные изменения, иначе они будут удалены.'''</blockquote>[[Файл:2025-05-20 14-45-35.png|мини|''Рис. 31 Удаление записей из пользовательского словаря'']]
При нажатии на карандаш откроется окно '''«Редактирование структуры».''' Важно помнить: изменения можно внести только в название справочника или в значения по умолчанию (если предыдущие значения были, они будут автоматически обновлены). ''Переименовать столбцы нельзя.'' После сохранения изменений нажмите кнопку '''«Сохранить»''', расположенную внизу под таблицей (рис. 31). <blockquote>'''Внимание! Справочники зависят от версии робота.''' Если вы вносите изменения в структуру справочника в черновой версии [[Файл:Черновик.png|безрамки|20x20пкс]], то для применения этих изменений в продовой версии нужно применить робота в прод.

'''Важно:''' переносится '''только структура справочника'''. Данные не дублируются. Их можно перенести вручную, экспортировав [[Файл:Экспорт нов.png|безрамки|20x20пкс]] из черновика и импортировав [[Файл:Импорт нов.png|безрамки|20x20пкс]] в прод. </blockquote>Вы можете фильтровать записи по содержанию любой колонки. Выделите галочками несколько записей сразу и удалите их. В правом нижнем углу появится иконка корзины, как только вы выберете хотя бы одну запись (рис. 31).

Справочники можно ''экспортировать'' и ''импортировать''. Экспорт и импорт осуществляются в формате JSON.
[[Файл:Снимок экрана 2025-07-16 175752.png|мини|''Рис. 32 Импорт пользовательского словаря'']]

''При импорте структуры импортируемого файла и справочника в интерфейсе должны совпадать''. Если они не совпадают, то заполнятся только совпадающие поля. Есть возможность ''импорта'' с дополнением новых данных, либо полной заменой (''Рис. 32''). Структура экспорта:<blockquote>
[

{"колонка1":"значение 1","колонка2":"значение 2","колонка3":"значение 3","id":"58845671-1150-4ae2-9c46-e8aeb2553c57"},

{"колонка1":"значение 2","колонка2":"значение 2","колонка3":"значение 3","id":"2e0a7f8e-6d64-4df9-a3ce-5862f8eb441c"}

]
</blockquote>Структура json-файла для импорта:<blockquote>[

{"колонка1":"значение 4","колонка2":"значение 5","колонка3":"значение 6"},

{"колонка1":"значение 2","колонка2":"значение 3","колонка3":""}

]

При импорте не обязательно указывать id.</blockquote>Чтобы '''выйти из Пользовательских справочников''' в сценарий нужно снова кликнуть на иконку [[Файл:Справочник (1).png|безрамки|20x20пкс]].

=== Панель управления SES ===
Панель управления SES включает в себя 8 кнопок: импорт, экспорт, обнуление черновика рабочей версией, применение робота, восстановление робота, применение настроек робота, массовая замена моделей в элементах данных и меню пользователя.

{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления''
!'''Иконка кнопки'''
!'''Название иконки'''
!'''Описание'''
|-
|[[Файл:Export.png|центр|безрамки|40x40пкс]]
|Экспорт
|Для создания резервной копии или переноса робота выполните его экспорт в ZIP-архив. В архив будут включены все настройки робота: элементы данных, конечные точки, скрипты, структуры пользовательских справочников (''но не включая сами данные''), а также связанные модели и базы данных QAS.<blockquote>'''Внимание!''' Перед экспортом убедитесь, что категории и модели актуальны. В противном случае экспорт может завершиться ошибкой, и робот не будет экспортирован.</blockquote>
|-
|[[Файл:ImportRobot.png|центр|безрамки|40x40пкс]]
|Импорт
|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''.|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''. Аналогично экспорту, доступен и импорт робота с моделями SMC, SEE и QAS в различные наборы данных.
<blockquote>'''Как работает импорт:'''

* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.
'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>
|-
|[[Файл:Стрелка.png|безрамки|40x40px|центр]]
|Обнулить черновик рабочей версией
|Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Применить.png|безрамки|40x40px|центр]]
|Применить
|По нажатию на эту кнопку черновая версия робота становится рабочей ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Откат.png|центр|безрамки|40x40px]]
|Восстановить
|С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной ''(кнопка активна только в архивной версии)''.
|-
|[[Файл:Разетка.png|центр|безрамки|40x40px]]
|Применить настройки робота
|Применяет сохранённые настройки робота и начинает работать в соответствии с ними, что аналогично перезагрузке программного обеспечения, но без необходимости самой перезагрузки.
После нажатия на кнопку система переносит эти настройки в настройки прода, но НЕ ПРИМЕНЯЕТ, на случай, если ошиблись.

Робот в любой версии начинает работать с новыми настройками только после нажатия на кнопку. Если вы нажали на кнопку, находясь в черновике, будут применены настройки черновика. Если же вы нажали на кнопку, работая в рабочей версии, то будут применены настройки рабочей версии, которые вы только что перенесли из черновика. <blockquote>Обратите внимание: после внесения каких-либо изменений кнопка будет красной [[Файл:Красная вилка (1).png|безрамки|20x20пкс]] и пульсировать, напоминая о необходимости применить настройки. </blockquote>
|-
|[[Файл:Смена моделей.png|центр|безрамки|40x40пкс]]
|Массовая замена моделей в элементах данных
|[[Файл:Замена моделей в ЭД.png|мини|''Рис. 33. Массовая замена моделей в элементах данных'']]Эта функция позволяет массово менять модели в элементах данных. После нажатия на кнопку появляется форма ''(Рис. 33)'', в которой необходимо указать тип элемента данных ''(Класс / Сущность)''. Затем в поле '''"Заменяемая модель"''' выбрать модель из списка моделей, используемых в уже существующих элементах данных ''(снизу будет указано количество элементов данных, использующих выбранную модель)'', и в поле '''"Заменяющая модель"''' выбрать доступную модель для замены. После нажатия на кнопку '''"Заменить"''' будет произведена замена выбранной модели в тех элементах данных, в которых она используется.
|-
|[[Файл:Меню пользователя new.png|безрамки|40x40px|центр]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, убрать/показать фон, выход из системы), а также возможность переключить ''отображение рабочей области с табличного на облачный вид и наоборот''.
В меню пользователя добавлена функция ''выбора набора данных*.''

При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

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

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

2025-12-24T09:54:25Z

E.Elagina: /* Архив диалогов */

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

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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# SES Сценарная машина,
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]],
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]].
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2).
[[Файл:2025-06-09 14-33-48.png|мини|''Рис. 2 Рабочая область SES'']]

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

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

==== Добавление и настройка робота ====
Чтобы добавить нового робота, нажмите кнопку '''«Добавить робота»'''. В появившемся диалоговом окне введите название и нажмите '''«Добавить»'''. В нижнем правом углу экрана появится сообщение «Добавлено!». По умолчанию робот создается с предварительными настройками. В нем сразу есть текстовки для исключений и событий, ознакомиться и поправить их можно, перейдя на вкладку [[SES. UPS руководство по работе с интерфейсом|«Настройки»]]. Робот может быть 3х версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
{| class="wikitable"
|+''Табл. 1 Версии робота.''
!'''Иконка версии'''
!'''Наименование версии робота'''
!'''Описание'''
|-
|[[Файл:Черновик.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]], если вы планируете предоставлять консультации.

Здесь представлен общий перечень необходимых сервисов. В зависимости от специфики проекта некоторые из них могут отсутствовать.
[[Файл:2025-07-04 17-15-25.png|мини|''Рис. 3 Интерфейс вкладки Скрипты'']]

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

У скриптов есть параметр '''''«Область действия»''''', в котором есть 5 опций:

- ''конечные точки'', позволяет подключать скрипт в действиях конечных точек;

- ''элементы данных'', позволяет подключать скрипт в действиях элементов данных и контейнеров;

Скриптов на ЭД и КТ может быть несколько. Остальные скрипты общие и доступны только по одному на каждый тип:

- ''завершение сессии'' — скрипты, которые могут выполняться после завершения диалога, если скрипт указать в настройках в действиях на событии «Завершение диалога»;

- ''перед каждым вопросом'' — для случаев, когда нужно актуализировать какую-то информацию постоянно и использовать ее в условиях.<blockquote>

Скриптом «перед каждым вопросом» можно выставить, например, сегодняшнюю дату - ${custom.today}, а потом ее в сравнении дат использовать в условиях получения данных. Для случаев записи на прием проверять, '''что дата точно больше сегодняшней.'''

'''Скрипт проверки пишется админом.''' </blockquote>

- ''после каждого ответа'' — для случаев, где требуется пошагово после каждого ответа передавать информацию во внешнюю систему.

- ''передача диалога,'' скрипты для передачи диалогов.

- ''старт диалога.''

====== Дефолтные скрипты ======
В системе реализованы шаблоны скриптов по умолчанию:

Назначение:

* Автоматическое создание базовой функции при создании нового скрипта
* Возможность последующего редактирования

Расположение и настройка:

* Файлы находятся в переводчике по пути: <code>lang\ru.json</code>
* Реализовано для гибкости - администратор может изменять настройки
* Не зашито в код системы

Типы дефолтных скриптов:

* <code>_defaultScriptContainer</code> - для ЭД типа "Контейнер" (скрипты обработки)
* <code>_defaultScriptData</code> - для ЭД (скрипты постобработки)
* <code>_defaultScriptAction</code> - для действий в ЭД/КТ

[[Файл:Scrirts.png|мини|''Рис. 4 Отладка скриптов интеграции'']]
Есть '''режим отладки скриптов интеграций''' с функцией извлечения данных из сессии (рис. 4). То есть можно [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|тестировать робота в чате отладчика]] и, в случае если отработка некорректна или нужно проверить внесенные изменения в скрипт, то можно открыть вкладку «Скрипты» -> выбрать нужный скрипт -> кликнуть на закладку «Проверка» (слева откроется дополнительное окно) и нажать на кнопку «Вставить данные сессии». Тогда в открывшемся окне появятся все данные из текущей сессии из чата отладчика. По нажатию на кнопку «Тест», появится окно с результатом отработки скрипта.

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

[[Файл:2025-11-01 09-55-26.png|мини|''Рис. 5 Интерфейс вкладки «Интервалы»'']]

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

====== Группировка интервалов рабочего времени ======
Для удобства настройки сложных и переменных графиков работы в системе предусмотрена возможность объединять интервалы времени в группы. Это позволяет избежать создания громоздких условий в Контрольных Точках (КТ), когда рабочие часы оператора меняются каждый день или разбиты на несколько промежутков.

Для того, чтобы создать группу интервалов кликните на '''+''' справа от вкладки под номером '''1'''. Группа разделена на вкладки (табы), что позволяет удобно структурировать разные периоды.

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

* На одной вкладке настроить график для будних дней. Или для каждого дня отдельно.
* На другой вкладке — график для выходных.
* На третьей — особый график для праздников.

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

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

* '''события''' — действия, которые выполнит робот при наступлении определенного условия в диалоге, например «Не найдено» (см. раздел «События» ниже);
* '''исключения''' — это действия, которые выполняются, если событие повторяется указанное число раз подряд (см. раздел «Исключения» ниже);
* '''данные''';
* '''модели''' — настройка моделей, если требуется использовать параметры, отличные от параметров по умолчанию;
* '''коннекторы'''.

'''События''' есть 10-ти типов и прописываются для каждого канала связи отдельно:
[[Файл:2025-10-06 16-01-17.png|мини|''Рис. 6 Интерфейс вкладки «Настройки»'']]
# Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
# Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
# Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
# Запрос повтора — действия на случай, если абонент запросил повтор информации. Если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.
# Тишина — добавляем действие в моменты, когда от человека нет ответа, то есть тишина.
# Перебивание — событие доступно ''только для голосовых каналов (например, voice)''. Она позволяет настроить реакцию на прерывание речи.
# Задержка ответа — событие доступно ''только для голосовых каналов (например, voice)''. Это действия, которые появляются, когда идет генерация. Например, можно написать: «Секундочку, выясняю». Это нужно, чтобы человек понимал, что робот не просто молчит.
# Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя, то есть настройка действий если это событие произошло. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
# Нет данных — это событие происходит, когда система пытается получить конкретный недостающий элемент данных, например название филиала, и ей это не удалось.
# Ошибка.

'''При наступлении события система выполнит указанное в канале действие. Если действие для этого события в канале не задано, то ничего не произойдет.'''

Вы можете настроить реакции робота на определённые события. Более подробную информацию о них вы найдёте в разделе «Исключения».

'''Исключения''' есть трех типов '''Тишина''', '''Не найдено''' и '''Нет данных'''.

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

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

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

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

На вкладке можно настроить параметры голосового канала. Вот что там можно сделать:

* Выбрать голос, которым будет говорить робот.

* Установить основную модель распознавания (рекомендуем оставлять common).

* Определить фоновую модель распознавания (рекомендуем background).

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

* '''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)
* '''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
* '''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
* либо коррекция может '''Отсутствовать'''.

[[Файл:2025-10-06 16-47-09.png|мини|''Рис.7 Вкладка настроек коннектора telegram'']]

===== Вкладка «Коннекторы» =====
Позволяет настроить связь робота по одному из каналов: ''freeswitch'', ''max'', ''telegram'', ''vk'', ''web, nats.''

Для мессенджеров, таких как '''max''', '''telegram''', '''vk''', характерны следующие настройки:

* ''токен'',
* ''группа'' ''(для vk),''
* ''название бота'',
* ''обслуживающий сервер'' - имя сервера SES, который обслуживает данный коннектор,
* ''периодичность обновления'' - время периодичности запроса в api для получения новых сообщений,
* ''фразы-активаторы'' - список фраз, на которые будет реагировать робот в общих чатах, и считать, что сообщение адресовано ему,
* ''переменные,''
* ''фраза сброса сессии,''
* ''доступы'' - список пользователей, которые могут писать роботу. Если пустой, то могут все.

Для канала '''web,''' в частности, для встраивания чат-виджетов ''(рис 7.1).'' Данный коннектор предназначен для встраивания интерактивного виджета на ваш сайт. Доступно два типа виджета: '''Чат и Ассистент (Суфлер)'''.
[[Файл:2025-11-14 11-16-35.png|мини|''Рис. 7.1 Вкладка настроек коннектора web'']]
'''Общие параметры (для обоих типов)'''

Следующие настройки являются общими независимо от выбранного типа виджета.

* Домен: Укажите домен вашего сайта, на который будет встраиваться виджет. Это необходимо для безопасности, чтобы виджет мог работать только на указанном сайте.
* Токен: Уникальный идентификатор, который указан в теге <code>[[SES. Руководство администратора#Настройка виджета для сайта|<script>]]</code> для встраивания виджета на сайт.
* Акцентный цвет: Основной цвет интерфейса виджета (кнопки, заголовки, выделение). Используется для согласования с фирменным стилем вашего сайта.
* Заголовок виджета: Текст, который отображается в шапке открытого окна чата.
* Приветственное сообщение: Первое сообщение, которое видит пользователь при открытии чата.
* WebSocket-серверы: Технический параметр для установки соединения. Обычно заполняется автоматически и изменяется только по указанию технической поддержки.
* Язык: можно указать язык для виджета. Если не указывать, то будет дефолтный из конфига UPS.
<blockquote>Мультиязычность настраивается в настройках пользователя.</blockquote>'''Функциональные возможности'''

Эти опции позволяют включить или отключить определенные функции виджета.

* Голосовые ответы: Пользователь может прослушивать ответы от робота в аудиоформате.
* Отправка аудиосообщений: Пользователь может записывать и отправлять голосовые сообщения.
* Отправка файлов: Пользователь имеет возможность прикреплять и отправлять файлы.
* Аудиозвонок: Пользователь может инициировать голосовой звонок.
[[Файл:Ассистент.jpg|мини|''Рис. 7.2 Настройка переменных для режима "Ассистент"'']]
'''Выбор типа виджета'''

Перед сохранением конфигурации необходимо выбрать тип виджета, так как это влияет на доступность дополнительных параметров.

''Тип: "Чат"''

Стандартный режим для интерактивного общения с пользователем. Все "Функциональные возможности" и "Общие параметры" доступны для настройки. Также доступен блок "Переменные".

''Тип: "Ассистент" (Суфлер)''

Режим, предназначенный для подсказок оператору во время разговора с абонентом. Все переменные, необходимые для работы ассистента, настраиваются и передаются отдельно в личном кабинете пользователя. Сначала нужно авторизоваться в системе UPS ''(рис. 7.2)'', и дальше суфлер подключится сразу ко внутреннему номеру, который указан в настройках пользователя, там же можно переопределить цветовую схему под каждого пользователя.

Для канала '''freeswitch''' (телефонная линия):

* ''название коннектора,''
* ''режим обслуживания:''
** Режим «Как робот»
*** <code>Внутренний номер</code>: Указывается внутренний номер этого робота.
*** Опция ассистента: Дополнительно настраивается параметр, который определяет, будет ли ассистент (суфлер) работать после перевода звонка на оператора.
** Режим «Как ассистент»
*** <code>Внутренний номер</code>: Указывается внутренний номер робота-ассистента (суфлера).
*** <code>Номер для перевода звонка</code>: Указывается номер, на который будет переключаться звонок (номер колл-центра или конкретного оператора).
Работа ''суфлера после перевода звонка'' на оператора возможна ''в двух режимах'':

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

Флаг '''"Автостарт ассистента"''' при активации этой опции, ассистент запускается автоматически.

Настройки канала '''''nats''''':

* название коннектора,
* адрес серверов,
* канал входящих сообщений,
* канал исходящих,
* обработчик.

Принцип работы:

* Отправитель (канал исходящих сообщений) отправляет сообщение в определенный subject.
* Получатели (канал входящих сообщений), которые проявили интерес к этому subject, получают сообщение.
* Subject выступает в роли классификатора, позволяя разделять различные потоки сообщений для разных задач и сервисов.

Для работы коннектора необходимо указать адрес сервера NATS и топики (Subjects) для отправки и получения сообщений.

[[Файл:Функционал действий.png|мини|''Рис. 8 Функционал Действий'']]

==== Виды действий в роботе и работа с ними ====
'''1. Основные действия'''

Доступны следующие типы действий:

* '''Сказать'''

Настройте текстовые ответы робота. Это может быть простая фраза-заглушка, ответ, сгенерированный AI (LLM), или ответ из базы знаний (QAS). Типы ответов «Сказать» подробно описаны в разделе 2.

<blockquote>При наведении мыши на поле «Фраза» появляется кнопки-иконки [[Файл:Управление фразой действия.png|безрамки|64x64пкс]], где можно выбрать одно из действий:
# Добавить кнопку (подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Добавление кнопок в действия|«Добавление кнопок в действия»]]). Доступно пользовательское расположение кнопок, которые регулируются переносами на новые строки.
# Перефразировать. Если нужно добавить вариации фразы (рис. 8). Предложенные фразы можно отредактировать или удалить, кликнув по иконке корзинки напротив нужной фразы и добавить в список фраз.
# Удалить лишнюю фразу можно, если она не единственная.
</blockquote>

* '''Подтвердить'''

Настраивается фраза для подтверждения.

* '''Отправить файл'''

Позволяет отправить файл в ответ на запрос пользователя.

* '''Остановить выполнение действий'''

Немедленно прекращает выполнение всех последующих действий в текущем сценарии и сбрасывает точку выполнения диалога.

* '''Передача диалога'''

Переводит разговор, например, на оператора или в другой отдел. Для настройки необходимо указать ''Назначение'' передачи.

* '''Забыть данные'''

Позволяет стереть определенные данные, введенные пользователем, чтобы запросить их заново. При активации опции ''Перезапросить'' система автоматически сформирует запрос на ввод недостающих данных.

* '''Завершить диалог'''

Завершает текущий разговор с пользователем и закрывает сессию.

У некоторых действий есть опции:
* ''Считать действие успешным прохождением точки'' — этот флаг устанавливается на действия, которые означают, что сервис выполнился. В основном для отчетности.
* ''Прерываемое'' — этот флаг активируется для голосового канала и говорит о том, что допускается прерывание (перебивание) робота в момент синтеза ответа. Если он активен, робот будет реагировать на стоп-слова, в противном случае — нет.
* '''Установка переменной'''
позволяет задать или изменить значение переменной после выполнения определенного события в сценарии. Это мощный инструмент для создания сложной логики, например, для подсчета количества попыток входа в сервис и последующих действий в зависимости от этого значения.

* '''Принудительно перейти в КТ'''

позволяет принудительно отправить диалог в выбранную конечную точку.

'''2. Типы ответов для действия «Сказать»'''

При использовании действия «Сказать» вы можете выбрать один из четырех типов ответа:

1. ''Последовательно''

Робот будет выдавать вопросы и информацию по порядку, строго следуя списку, указанному в поле «Фразы».

2. ''Случайная фраза''

Робот выберет и произнесет одну случайную фразу из заданного списка.

3. ''Из внутреннего источника (недоступно для действий в элементах данных)''

Ответ формируется из Системы ответов на вопросы (QAS) для ответа из ''QAS документация'' нужно настроить'':''

* Условия присвоения категорий: Определяет правила, при которых система может направить запрос в эту категорию QAS для поиска ответа.

* Условия вывода ответа: Настройте параметры, такие как использование кеша ответов, генерация ответа и кеширование формулировок и [[QAS. UPS руководство по работе с интерфейсом#%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%20%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B8%20%C2%AB%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D1%8B%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2%C2%BB|выбрать шаблон запроса]]. Подробности [[QAS. UPS руководство по работе с интерфейсом|тут]].<blockquote>'''Обратите внимание:''' если вам нужно изменить шаблон запроса для определенной категории, это делается путем добавления отдельного действия. Настройка этого действия аналогична основному, но с выбором нужного шаблона. В Условиях запуска указываете данные, которые запустят это действие с шаблоном-исключением. </blockquote>

''QAS-чат'': Ответы генерируются AI-моделью (LLM) по умолчанию или другой моделью, добавленной администратором.

4. ''Из внешнего источника''

Позволяет подключить скрипты интеграций для выполнения специальных действий, если таковые имеются. Для действия «Сказать» с типом «Из внешнего источника» нажмите на специальную кнопку, расположенную рядом с полем выбора скрипта [[Файл:Postprocessing.png|безрамки]]. Откроется вкладка с выбранным скриптом, где вы можете:

* Просматривать код текущего скрипта,
* Редактировать существующий скрипт,
* Создавать новый скрипт.

<blockquote>Редактирование и создание скриптов не влияют на сохранение ЭД/КТ, т.к. они ссылаются только на id скрипта. Если вы выбираете другой скрипт для действия, обязательно сохраните изменения.</blockquote>'''3. Управление действиями'''

Для каждого действия доступны три опции управления (обычно отображаются в виде значков [[Файл:Для действий.png|безрамки|72x72пкс]]):

1. ''Копировать''

Чтобы скопировать действие в другой канал, нажмите эту кнопку и в открывшемся окне выберите целевой канал из списка.

2. ''Переместить''

Чтобы переместить действие в другой канал, выполните те же шаги, что и для копирования. <blockquote>'''Внимание:''' При перемещении действие будет удалено из исходного канала.</blockquote>3. ''Удалить действие''

Чтобы удалить действие, нажмите на кнопку в виде корзины.

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

===== Добавление кнопок в действия =====
В сценарной машине предусмотрена возможность добавления кнопок.

При наведении мыши на поле «Фраза» появляется кнопки-иконки , где по иконке с плюсом можно добавить кнопку:

# название кнопки;
# текст для отправки — это тот текст, который отправится на модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]], [[SEE. UPS руководство по работе с интерфейсом|SEE]]).

Чтобы внести изменения в созданную кнопку, кликните по ней левой клавишей мыши (ЛКМ) и в открывшемся меню можно редактировать или удалить эту кнопку.

Интерфейс позволяет гибко управлять расположением кнопок с помощью переносов на новую строку.

Чтобы настроить порядок кнопок:

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

Этот инструмент позволяет визуально сгруппировать кнопки и организовать интерфейс максимально удобно для пользователя.

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

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

''Переменные'' — служат для хранения данных, полученных из API или по каналам, запущенным извне. Например, это может быть ID пользователя в Telegram или CID из телефонного канала, то есть определившийся номер телефона.<blockquote>'''Переменные, как и данные, можно выбирать из выпадающего списка.''' Доступны все названия и значения, которые использовались ранее. Если вам нужно создать новую переменную и значение, просто введите их с клавиатуры. После этого они также будут предлагаться вам в дальнейшем.</blockquote>''Данные'' — элемент данных, полученный от моделей SMC или SEE.

''Интервал'' — период времени, в который запускается это действие. У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.
''Подтвердить'' — запуск действия в зависимости от наличия подтверждения от абонента.
[[Файл:Уведомление дублей.png|мини|''Рис. 9. Уведомление об одинаковых блоках ИЛИ в условиях запуска действий'']]
В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»'' (рис. 9)''.''<blockquote>'''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.</blockquote>

Также при сохранении настроек в окне "Условий запуска" если были обнаружены одинаковые блоки условий "ИЛИ", то будет соответствующее оповещение с выделением повторяющихся блоков ''(Рис. 9''.)

Пример использования условий запуска действий в конечной точке ''«Проверка статуса»:''<blockquote>
'''Ситуация 1.'''

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

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

'''Ситуация 2.'''

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

1. Определить элемент данных, который отвечает за отслеживание цифр (код). В нашем случае это модель SEE number и элемент данных «Код заявления».

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

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

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

==== Добавление и настройка элементов данных ====
[[Файл:Снимок экрана 2025-07-16 154838.png|мини|''Рис. 10. Массовое добавление элементов данных'']]
[[Файл:2025-12-11 11-15-27.png|мини|''Рис. 10.1. Бланк настройки элемента данных'']]
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку '''«Добавить элемент»'''. В появившемся диалоговом окне возможны два варианта добавления: '''"Одиночное"''' и '''"Массовое"'''.

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

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

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

'''Контейнер''' — составной элемент данных, который собирает необходимые данные, чтобы отправить их во внешнюю БД по API с помощью скриптов интеграции.

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

===== Настройка элемента данных =====
[[Файл:2025-04-23 14-43-07.png|мини|''Рис. 11 Проверка модели в ЭД'']]
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (''Рис. 10.1'').

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

'''«Вес»''' — это параметр, который определяет приоритет этого элемент данных в спорных ситуациях. По умолчанию установлено значение 3. Также вес ЭД отображается в [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчике]] и, если у вас активировано [[SES. UPS руководство по работе с интерфейсом#Панель управления SES|табличное представление сценария]], то и в самой таблице. <blockquote>Совет по работе с весом ЭД.

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

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

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

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

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

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

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

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

Рядом с комментарием находится кнопка '''Исключения''' [[Файл:Исключения .png|безрамки|20x20пкс]]. По нажатию на эту кнопку можно для определенных элементов данных настроить нестандартные исключения, то есть исключения, отличные от общих настроек (рис.12). <blockquote>
Например, для ЭД «Название филиала». [[SES. UPS руководство по работе с интерфейсом#Вкладка «Настройки»|В общих настройках]] робота МФЦ указано, что количество исключений для события «Нет данных» равно 3 (в счетчик входит и первое обращение к роботу, если там не было нужной информации). Однако мы хотим, чтобы, если с первого раза филиал не был найден, робот больше не запрашивал у абонента его название. Вместо этого робот должен показать заглушку с предложением поискать нужный филиал на сайте. Для таких случаев можно настроить '''нестандартное исключение.''' </blockquote>Настройка нестандартного исключения:

# выберете нужный элемент данных,
# кликните на значок исключения [[Файл:Исключения .png|безрамки|20x20пкс]],
# в появившемся окне активируйте флаг «включить нестандартные исключения»,
# заполните тип исключения Нет данных,
# установите максимальное кол-во исключений подряд (если хотите уточнять один раз, то макс.кол-во устанавливайте равным 2),
# установите канал связи при необходимости,
# и выберете действие на случай, если исключение наступило.
[[Файл:Постобработка ЭД.png|мини|''Рис. 12.1. Постобработка данных'']]
Далее находится кнопка '''«Постобработка»''' [[Файл:Postprocessing.png|безрамки]]'''.''' При нажатии на нее появится всплывающее окно с редактором кода, где можно написать функцию, которая будет срабатывать после того как ЭД был получен (Рис. 12.1). Установите галочку '''«Включить постобработку»''' и в редакторе отобразится функция-обработчик, которая принимает на вход три параметра: ''значение ЭД, текст последнего сообщения, канал'', и возвращает значение ЭД и опционально текст сообщения.<blockquote>'''Пример:'''

<code>def handler(value, message, channel):</code>

<code> if value == 'старый' and message == 'старый' and channel == 'voice':</code>

<code> return 'новый', {'text':'новый'}</code>

<code> elif value == 'новый' and message == 'новый' and channel == 'voice':</code>

<code> return 'старый', {'text':'старый'}</code>

<code> return value, {'text': 'не тот канал'}</code></blockquote>

'''Тестирование скриптов в ЭД'''

Процесс тестирования скриптов в ЭД аналогичен тестированию скриптов во вкладке "Скрипты", с учетом того, что скрипты находятся непосредственно в самих ЭД.

Важное отличие:

* Для ЭД типа «Класс» или «Сущность» - поле «Значение» обязательно для заполнения.
* Для ЭД типа [[SES. UPS руководство по работе с интерфейсом#Произвольный элемент данных|«Произвольный»]] - поле «Значение» заполняется по необходимости (опционально).

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

'''Работает только в условиях запуска. Если ЭД с этим флагом стоит на входе в КТ, то фраг игнорируется.'''</blockquote><blockquote>'''Пример: Запись на прием'''

1. Процесс взаимодействия с пользователем

Пользователь хочет записаться на прием. Для этого необходимо собрать следующие данные:

* Намерение (цель обращения).
* Адрес (куда хочет попасть пользователь).
* ФИО.
* Номер телефона.

2. Работа моделей в КТ "Запись на прием"

* Все модели, отвечающие за обработку запроса, работают в фоновом режиме.
* На любом этапе диалога они могут «выхватывать» сущности (например, извлекать ФИО, адрес и т. д.).

3. Проблема ложного срабатывания

Модель может ошибочно извлечь данные, если:

* Пользователь вводит информацию, которая частично совпадает с искомой сущностью (например, город ''"Владимир"'' может быть ошибочно принят за имя).
* Это приводит к некорректной обработке данных до завершения сценария.

4. Решение: ограничение работы модели

Чтобы избежать ложных срабатываний:

* Активируйте галочку '''«Получать только прямым запросом»''' в настройках ЭД.
* Если галочка активна, модель (например, извлечение ФИО) сработает только когда:
** Сценарий диалога дошел до запроса ФИО.
** Пользователь явно отвечает на вопрос о недостающих данных по ФИО.

Таким образом, '''система не будет обрабатывать случайные упоминания имен или других сущностей вне контекста запроса.'''</blockquote>Флажок '''«Подставлять ответ модели в запрос к ЧаВО»''' предназначен для работы с типами ЭД «Сущность». Его основная функция — подставлять в запросы пользователей ответ от модели (название тэга) SEE вместо исходного текста абонента, на который среагировала модель.<blockquote>'''Пример использования'''

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

# Создаем модель SEE с тегами:
#* <code>до 14 лет</code>
#* <code>с 14 лет до 18 лет</code>
#* <code>с 18 лет</code> ''(Теги формируются на основе предоставленной документации.)''
# Добавляем ЭД в качестве недостающего элемента в настройки КТ.
# Когда сценарий доходит до дозапроса этого ЭД или абонент сам предоставляет данные, система отправляет запрос в QAS. Например, абонент отвечает, что ему 44 года, но в документах нет такого варианта. В них информация сгруппирована <code>до 14 лет</code>, <code>с 14 лет до 18 лет</code> и <code>с 18 лет.</code> Соответственно система не найдет похожую информацию.
# Решение:
#* Если флажок активирован, система подставит ближайший подходящий тег (в данном случае — <code>с 18 лет</code>).
#* Это поможет QAS корректно находить информацию в документации.
'''Важно:''' если ваша модель SEE '''не отдаст ответ''', то настройка '''не сработает'''. Проверьте и при необходимости дообучите модель.</blockquote>

Флаг '''«Удалять сущность из запроса к ЧаВО»''' предназначен для типов «ЭД Сущность» и работает наоборот: он удаляет из запроса пользователя слова или фразы, которые распознала модель.

Флажок '''«Режим долгого ожидания»''' Открывает дополнительное меню с триггерами окончания ожидания. Это данные, при получении которых мы прекращаем ждать именно этот элемент данных (ЭД). Например, если получили его же или другие данные, например, просьбу позвать оператора.<blockquote>'''Обратите внимание:''' чтобы этот режим работал правильно, создайте нестандартное исключение для ЭД (описание выше). Иначе система будет ориентироваться на общие настройки количества исключений.</blockquote>

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

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

===== События элемента данных =====

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

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

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

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

'''Тип события''' '''«Элемент получен».''' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).

'''Тип события''' '''«Тишина»''' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек молчит.[[Файл:Уведомление об отсутствующем классе.png|мини|''Рис. 14. Уведомление об отсутствующем классе'']]<blockquote>
Например, если робот спрашивает у абонента, какой паспорт ему нужен, а человек молчит, можно через некоторое время повторить вопрос или сказать: «Говорите громче, не слышно».</blockquote>

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

В таблице элементов данных предусмотрено уведомление ''(Рис. 14)'' об отсутствующей модели на сервере, которую использует элемент данных, а также об отсутствующем классе/группе в выбранной модели. При таких случаях слева от элемента данных расположен значок [[Файл:Warning.png|безрамки]], при наведении курсора мыши на который появляется соответствующее сообщение.

===== Произвольный элемент данных =====
Элемент данных типа «Произвольный» предназначен для обработки произвольных текстовых данных от пользователя, таких как:

- Нажатия кнопок (текста на кнопках),

- Точные текстовые фразы,

- Данные, присваиваемые через скрипты.

''Простая настройка:''

- Текст: текст от пользователя (например, текст на кнопке или точная фраза), который нужно «отловить».

- Значение элемента данных: присваиваемое значение этому элементу данных (param).

''Универсальное применение:''

- Обработка различных кнопок в одном элементе данных.

- Возможность скриптового присвоения любых значений.

- Замена использования элемента-заглушки со скриптами.

- Пользоваться таким ЭД можно точно так же как и другими элементами. Вести в разные действия и категории исходя из значения произвольного ЭД.<blockquote>''Пример использования''

Сценарий: Обработка различных текстов с кнопок БЕЗ обработки моделями, то есть модель может «не знать» этих фраз:

- Текст: "Поддержка участников СВО" → Значение ЭД: «Поддержка СВО»

- Текст: "Льготы для пенсионеров" → Значение ЭД: «Социальные услуги»

Таким образом, один произвольный элемент данных может обрабатывать множество различных вариантов ввода.</blockquote>[[SES. UPS руководство по работе с интерфейсом#События элемента данных|События]] на этом элементе аналогичные как и на обычных ЭД.

[[Файл:2025-10-06 13-10-56.png|мини|''Рис. 15 Интерфейс контейнерного ЭД'' ]]

===== Элемент данных типа «Контейнер» =====
Контейнер — это составной элемент данных, который объединяет несколько дочерних элементов для последующей обработки. Его основная функция — сбор необходимых данных и их отправка во внешнюю базу данных через API с использованием скриптов интеграции.

Доступ к редактору скриптов:

# Перейдите в карточку элемента данных «Контейнер»
# Нажмите на кнопку вызова редактора скриптов [[Файл:Postprocessing.png|безрамки]]
# ''Важно:'' Если скрипт не заполнен, кнопка будет подсвечиваться красным цветом

Создание функции обработки:

* При нажатии на кнопку открывается всплывающее окно с редактором кода
* Функция выполняется после получения всех данных элемента
* Для активации установите галочку «Включить скрипт обработки»

Функция принимает три входных параметра:

# <code>value</code> — значение текущего элемента данных
# <code>message</code> — текст последнего сообщения от пользователя
# <code>chanel</code> — идентификатор канала взаимодействия

Функция возвращает:

* Обязательно: обработанное значение элемента данных (value и записывает его в значение ЭД param)
* Опционально: текст сообщения для пользователя

События контейнерного ЭД:

* ''«Элемент получен».'' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).
* ''«Нет данных»'' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек говорит что-то, но не ответ на вопрос.

==== Добавление и настройка конечных точек ====
[[Файл:2024-11-18 12-00-28.png|мини|''Рис. 16 Рабочая область SES'']]Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В верхней правой части рабочей области расположена кнопка '''«Добавить конечную точку»''' (рис. 16). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки образуют «облако конечных точек».

===== Настройка конечной точки =====
После того как вы ввели название конечной точки и нажали кнопку '''«Добавить»''', слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается ''название конечной точки'', при желании его можно сменить. Также доступен выпадающий список «Тип». Здесь можно выбрать один из четырёх вариантов:[[Файл:2025-03-28 14-57-55.png|мини|''Рис. 17 Типы входа в конечные точки'']]'''«Отчетный»''' — эта та, которая участвует в статистике, т.е. несет какую-то полезную для анализа информационную нагрузку.

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

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

'''«Завершение диалога»''' — конечная точка, которая ставит точку в общении с пользователем.[[Файл:2025-05-28 16-23-27.png|мини|''Рис. 18 Вход в КТ по условиям'']]

Также можно выбрать еще '''Тип входа в КТ''' может быть трех видов (рис. 17):

'''- по условиям''', когда попадаем в КТ при условии получения определенных данных, например, класс от SMC (рис. 18). На вкладках «Условия» доступна ''фильтрация по элементу данных.''

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

Абонент обратился за консультацией. Робот предоставил ответ. После консультации абонент бездействует, а сессия еще не закрыта. Можно настроить КТ Оценка качества обслуживания, которая по истечению указанного времени запросит оценку, после ответа абонента, завершит сессию.</blockquote>- '''по ручному запуску''', когда КТ нужно принудительного запустить, например для рассылки. Чтобы настроить вход в конечную точку нужно выбрать в меню Вход опцию «По ручному запуску». Интерфейс КТ по ручному запуску идентичен КТ со входом «По бездействию», за исключением поля «Время».

Такой вариант входа в КТ подходит для исходящих сообщений (обзвонов), например, чтобы отправить абоненту напоминание-подтверждение о предстоящей записи: «Уточните, пожалуйста, вы придете на прием?»

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

'''Настройка исключений для конечных точек'''

Вы можете настроить автоматическое реагирование на сбои в работе конечных точек. Исключения [[Файл:Исключения .png|безрамки|20x20пкс]] - это специальные действия, которые выполняются при нескольких последовательных неудачных запусках конечной точки.

Система отслеживает статус запусков. Когда количество неудачных попыток подряд достигает заданного вами значения (например, 3), автоматически выполняется указанное вами действие.

Пример настройки:

* Условие: 3 неуспешных запуска подряд.
* Действие: Перевести звонок оператору ''или'' Завершить диалог.

===== Условия входа и запуска конечных точек. Сбор информации =====
'''Типы условий для входа'''

Для настройки условий '''входа''' в системе доступны три основных типа:

1. ''Данные''. Проверка значений элементов данных.

2. ''Переменные''. Работа с системными и пользовательскими переменными.

3. ''Подтверждение''. Проверка статуса подтверждения от пользователя. Возможные значения:

* Получено (пользователь подтвердил действие)
* Не получено (пользователь отклонил действие)

Для '''условий запуска''' есть дополнительно 4-ое условие, помимо вышеперечисленных:

4. ''Интервалы.'' У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.

Для '''сбора информации''' есть только 2 варианта условий: данные и переменные.<blockquote>Применение: Эти типы условий позволяют гибко управлять логикой диалога, направляя пользователя по различным сценариям в зависимости от текущего контекста.</blockquote>

'''Условия входа (Вход).''' Для того чтобы попасть в конечную точку и выполнить определенные действия, нужно выполнить условия входа. Их может быть как один элемент данных, так и их сочетание.<blockquote>Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: ''«Загранпаспорт»'' (получена метка от [[SMC. UPS руководство по работе с интерфейсом|SMC]], соответствующая этому элементу данных). А также сочетание элементов данных: ''«Паспорт»'' (получаем, если тип паспорта не указан сразу) и ''«Тип паспорта-загран»'' (тег «Загран» получили после уточнения типа паспорта).</blockquote>Условия входа объединены в блоки, которые имеют логическое условие «И». Чтобы добавить новое условие, необходимо нажать на кнопку «Добавить условие» [[Файл:Добавить условие.png|безрамки|20x20пкс]]. Блоки с условиями «И» разделены логическим «ИЛИ».
Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:
* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* + (Прибавить) — для увеличения счетчика,
* - (Вычесть) — для уменьшения счетчика,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

[[Файл:Рис. 17 Условия запуска.png|мини|''Рис. 19 Условия запуска'']]
'''''Условия запуска и Сбор информации''.''' Вкладка ''Сбор информации'' и меню ''Условия запуска'' идентичны по своему назначению'''.'''

По нажатию на эту кнопку открывается окно, где нужно указать '''''все''''' случаи (данные и их комбинации), '''''при которых точка сработает''''' (см.рис. 19). В окне «Условия запуска» элементы данных разделяются логическим оператором «ИЛИ». В случае с комбинациями условий ЭД отделяются друг от друга логическим «И». Как в случае с элементами, разделёнными операторами «ИЛИ», так и с элементами, разделёнными «И», порядок элементов можно менять. Аналогично для вкладки Сбор информации.

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

Условия можно редактировать: добавлять и удалять. Окно можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.<blockquote>Например, конечная точка «Консультация» активируется, если будут получены метки «Апостиль» ИЛИ «Банкротство» ИЛИ «Загранпаспорт» и «Тип паспорта — загран».</blockquote>В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»''. '''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.

У условий есть параметр ''«Тип»'', принимающий два значения: данные или переменная. Параметр ''«Искать»'' имеет три варианта:

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

Далее идет поле «Название», где из выпадающего списка требуется выбрать нужный элемент данных. <blockquote>Если в выбранном элементе данных не заполнено событие «Недостающий элемент», то в правом верхнем углу будет расположен значок [[Файл:Warning.png|безрамки]] со всплывающим уведомлением при наведении на него.</blockquote>Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:

* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

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

===== Условия присвоения категорий =====
[[Файл:2025-07-07 12-42-57.png|мини|''Рис. 20 Вкладка Действия и Условия присвоения категорий'']]
'''''Условия присвоения категорий'''.'' По клику на эту кнопку раскрывается меню (рис. 20), в котором есть выпадающий список со всеми категориями из [[QAS. UPS руководство по работе с интерфейсом|QAS]], а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ». ''Окно с условиями категорий или условиями запуска можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.''<blockquote>На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ». </blockquote>Флажок '''«Запрос в QAS с учетом прошлого контекста»''' указывает системе, что перед отправкой запроса в QAS необходимо проанализировать предыдущие сообщения пользователя. Это позволяет сохранять логику диалога и избегать необоснованной смены тематики.<blockquote>'''Пример работы'''

# Без включенной функции
#* Пользователь спрашивает: ''"Какие документы нужны для оформления СНИЛС?"'' → система направляет запрос в категорию СНИЛС.
#* Затем пользователь уточняет: ''"А сколько это стоит?"'' → система определяет метку Госпошлина и перенаправляет запрос в соответствующую категорию, теряя контекст СНИЛС.
# С включенной функцией
#* Если флажок активен (например, для категории ''Госпошлина''), система:
#** Проверяет предыдущие сообщения.
#** Если диалог начался в другой категории (например, СНИЛС), запросы объединяются (''"склеиваются"'').
#** Если контекст отсутствует, тематика меняется, но поиск ответа ведется сразу по обеим категориям (СНИЛС + Госпошлина).

'''Когда использовать'''

Активируйте эту настройку для категорий, которые могут:

* Быть частью более широкого запроса (например, ''Госпошлина'' как дополнение к ''СНИЛС'').
* Требовать сохранения контекста диалога.

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

===== Индикация удаленных категорий =====
Система визуально выделяет удаленные категории для привлечения вашего внимания:

# Конечные точки с недействительными категориями в табличном представлении: помечаются специальным значком и выделяются красным цветом. При наведении на значок сообщение: ''«Используются несуществующие категории в канала: [название_канала](кол-во)»''
# В облаке конечных точек: КТ с недействительными категориями также отображаются красным цветом, но без значка.
# В условиях присвоения категорий: Если используется удалённая категория, система отобразит предупреждающее уведомление ''«Используются несуществующие категории: [кол-во]»''.

Это позволяет быстро находить и корректировать объекты, которые зависят от неактуальных данных. А так же это важно для экспорта и импорта роботов (см. разд. Панель управления).

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

==== Связанная фильтрация ЭД и КТ ====
В интерфейсе реализована связанная фильтрация между таблицами Элементов Данных (ЭД) и Контрольных Точках (КТ). Это позволяет автоматически находить взаимосвязанные объекты.

'''Принцип работы:'''

* Фильтрация по ЭД: При вводе названия в фильтр таблицы Элементов Данных:
** В таблице ЭД отображаются только те элементы, названия которых соответствуют фильтру.
** Одновременно в таблице КТ автоматически отображаются только те Контрольные Точки, в которых используются отфильтрованные ЭД.

* Фильтрация по КТ: При вводе названия в фильтр таблицы Контрольных Точек:
** В таблице КТ отображаются только те точки, названия которых соответствуют фильтру,
** Одновременно в таблице ЭД автоматически отображаются только те Элементы Данных, которые используются в отфильтрованных КТ.

<blockquote>'''Важно''':

Система учитывает использование Элементов Данных во всех типах Контрольных Точек:

1. Входные данные (вход).

2. Собираемая информация (условия запуска/сбор информации).

3. Условия запуска действий.</blockquote>

==== Тестирование робота ====
[[Файл:2025-10-06 11-49-26.png|мини|307x307пкс|''Рис. 21 Окно чата для тестирования робота'']]
В интерфейсе SES есть чат с отладчиком (рис. 21), где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок [[Файл:Чат.png|безрамки|20x20px]] в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка '''«Перезапустить сессию»''' [[Файл:Обновить данные вопроса.png|безрамки|20x20px]], которая сбрасывает всю переписку и данные отладчика. А слева — кнопка '''«Данные сессии»''' [[Файл:Кнопка отладчик без полей.png|безрамки|20x20px]], предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS и не только, подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Данные сессии|Данные сессии]]. И кнопка '''«Тестирование скрипта»''' [[Файл:Пробирки.png|безрамки|20x20пкс]], подробнее [[SES. UPS руководство по работе с интерфейсом#Тестирование скриптом|тут]]. Есть возможность отправлять в чат файлы нажав на [[Файл:Скрепка.png|безрамки|20x20пкс]] и выбрав файл (в любом формате).

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

Режим отладки (дебаг):

* В режиме отладки появилась панель логов.
* Логи автоматически обновляются после каждого ответа от робота.
* Вместе с логами также обновляются данные текущей сессии.

Настройки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] чата позволяют выбрать настройки аудиоответов, а так же установить переменные, например, номер телефона.

Еще в меню настроек можно выбрать КТ по ручному запуску, чтобы протестировать работу КТ и сценария (рис. 22).
[[Файл:2025-10-20 10-56-18.png|мини|300x300пкс|''Рис. 22 Выбор конечной точки для тестирования.'']]

===== Тестирование в текстовых каналах =====

===== Данные сессии =====
Раскрыв данные сессии можете увидеть, все данные о текущем диалоге с роботом. Разберем по порядку, ниже представлены некоторые данные из ключа root, они нужны не все, разберем только нужные:<blockquote>
"started":"2025-06-10 09:46:05" — ''время начала сессии''

"modified":"2025-06-10 09:49:08" — ''когда произошли изменения последние (пришел запрос/изменилась тематика)''
"robot":"ffeaa99a-13d2-4bff-b458-1231c884f8ee" — ''id робота, у продовой версии будет приписка _prod''

"session":"beefb6a2-dc08-47d4-9e02-2495329173ec" — ''id сессии''

"channel":"default" — ''активный канал, в котором происходит тестирование''

"connector":"web"

"unknown":false.
</blockquote>
[[Файл:2025-10-06 12-45-38.png|мини|''Рис. 23 Пример работы с отладчиком'']]
Далее идет самая интересная для аналитиков часть - <code>"current"</code> . Раскрыв этот ключ можно посмотреть в какую конечную точку привёл сценарий, и была ли запросу присвоена какая-либо категория. А так же параметр ''data'', раскрыв который можно увидеть все классы (рис. 23 и 23.1), которые пришли от модели [[SMC. UPS руководство по работе с интерфейсом|SMC]] и/или модели [[SEE. UPS руководство по работе с интерфейсом|SEE]] и их достоверность и вес. Раскрыв в ''data'' параметр ''reply -'' увидеть данные ответа от робота. Имея все эти данные можно отладить работу сценария.
[[Файл:2025-10-06 12-47-26.png|мини|''Рис. 23.1 Работа с отладчиком. Просмотр параметра data и логов'' ]]
<blockquote>"current":{

"id":"Консультация ЧаВО" — конечная точка, в которую привел сценарий,

"qas":"оформить снилс" — запрос, который отправился в QAS.

}<blockquote>'''Обратите внимание:''' если параметр QAS в отладчике пустой, это значит, что ваш запрос не был передан в QAS. Если же в этом параметре отображается ваш запрос, но робот просит вас перефразировать его, то, вероятно, в базе данных не хватает формулировки с ответом или на ответе отсутствует пометка «проверено». Это может происходить, когда в настройках КТ, отвечающей за консультирование из базы данных QAS, установлен параметр «Использовать кэш ответов» в режиме «Только проверенные ответы». </blockquote>'''Отработка склеек и удержания контекста''': в QAS летит вообще вся история сообщений в рамках одного контекста общения '''через разделитель «|»'''. Модель генерации будет отвечать на последний вопрос в цепочке с учетом ранее написанных сообщений в этом контексте.

"answered":true — был ли ответ true/false
"category":[0:"МФЦ НСО СНИЛС"] — отображается список категорий, в которые попал вопрос (их может быть больше одной).

"nearest":NULL

''Следующий кусок ключа current проще объяснить на примере запроса "оформить паспорт":''

"entry":"entry":[0:"Паспорт, вес 3" ] — зашли в КТ по метке «Паспорт», запросили тип паспорта (загран), старый/новый образец и дошли до возраста получателя:

"missingRunData":[

0:"Возраст заявителя для заграна, вес 3"] — тут отображаются ЭД, которые нужны для «пропуска» дальше в действия.

"passedRunData":[ ] — список условий AND, который выполнился.

"waitingRunData":

"Возраст заявителя для заграна, вес 3" — отображается ЭД, который запросили и ждем получения.

"border":0 — отражает границу, от которой система смотрит на данные. Например, при border:1 - система будет смотреть от 2-го ЭД в списке data и ниже. При border:0 - с первого.

"preborder":0

}</blockquote><blockquote>"models":[...] — раскрыв список, можно посмотреть все модели, которые отработали за сессию.

"scripts":[] — отображает список скриптов, которые отработали за сессию.

"data":[...] — раскрыв data, можно увидеть параметр "message" — фраза-сообщение пользователя. И под каждым message, есть своя data, где находятся все метки и все тэги, пришедшие от моделей SMC и SEE на эту фразу.

"timers":[...]

"variables":{} — тут отображаются пришедшие переменные, если есть.

"error":"" — выводит ошибку при отработке скрипта.

"events":{ — параметр отображает счетчики событий за сессию (не найдено/нет данных/тишина).

"not found":{...}

"no data":{...}

"silence":{...}

}</blockquote>

[[Файл:2025-06-10 16-15-43.png|мини|''Рис. 24 Окно автотестирования скриптов'']]

===== Тестирование скриптом =====
[[Файл:2025-06-10 16-22-59.png|мини|''Рис. 25 Добавление скрипта для тестирования'']]
[[Файл:Тестирование скриптов.png|мини|''Рис. 26 Интерфейс окна «Тестирование скриптов»'']]
Теперь вы можете автоматически тестировать робота с помощью скриптов. Например, если у вас возникли сложности с маршрутизацией и нет желания каждый раз вручную воспроизводить весь диалог при отладке сценария, вы можете сохранить его для последующего тестирования. Для этого кликните на кнопку [[Файл:Пробирки.png|безрамки|20x20пкс]] справа от чата появится окно. Добавить скрипт можно путем '''''импорта из файла''''' [[Файл:Импорт нов.png|безрамки|20x20пкс]], если есть данные '''в формате txt''' или '''''импортировать диалог''''' из текущей сессии. Нажмите на иконку импорта или выберите ''«Скрипт»'' в выпадающем меню и нажмите '''''«Добавить скрипт»''''' (рис. 24). Появится диалоговое окно «''Добавление скрипта»''. Введите название скрипта, выберите файл и нажмите ''«Добавить»''. Если у вас уже открыта сессия, отметьте в окне добавления скрипта опцию '''''«Импорт из чата»'''.'' Если у вас несколько скриптов, переключаться между ними можно через выпадающий список ''«Скрипт».''

Правее него находятся иконки ''импорт'' [[Файл:Импорт нов.png|безрамки|20x20пкс]], ''экспорт'' [[Файл:Экспорт нов.png|безрамки|20x20пкс]] и ''удалить'' [[Файл:Удаление документа.png|безрамки|20x20пкс]]. Импорт был описан ранее. '''''Экспорт''''' позволяет выгрузить скрипт в формате txt. Кнопка '''''удалить''''' - удаляет весь скрипт.

Файл для импорта и экспорта - это простой текстовый файл, в котором все запросы к роботу, каждый с новой строки.

Галочки обозначают точки останова (рис. 25). Когда они стоят, автотест останавливается и ждет, пока вы нажмете кнопку «Дальше». параллельно можно открыть отладчик и смотреть, что происходит на каждом этапе теста.

У тестирования есть два основных режима:

# Полный тест:
#* Все галочки сняты
#* Тест выполняется автоматически от начала до конца, без остановок
# Пошаговый режим:
#* Тест останавливается на каждом шаге
#* Для продолжения нужно нажимать "Дальше"

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

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

Последняя отправленная фраза будет выделена голубым цветом.

===== Просмотр данных сессии =====
Эта функция позволяет вам в реальном времени отслеживать диалоги и данные сессии у другого пользователя в '''рамках одного бота'''.

'''Подключение к отслеживанию'''

# Нажмите на иконку «Просмотр сессии» [[Файл:2025-10-22 12-54-24 (1).png|безрамки|20x20пкс]] . Введите название переменной, за которой хотите следить и ее значение (если требуется, например, номер телефона абонента) в соответствующие поля.
# Нажмите кнопку «Подключиться».
# Меню закроется, и вы увидите всплывающее уведомление с подтверждением успешного подключения.
# В основном интерфейсе индикатор отслеживания (иконка «Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]) изменит свой вид: он будет зачеркнут и периодически мигать. Это сигнализирует о том, что соединение активно и система ожидает данные.
Как поступают данные:

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

'''Отключение от отслеживания'''

Чтобы прекратить отслеживание, выполните одно из следующих действий:

* Нажмите на индикатор отслеживания («Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]), который активен в режиме подключения.
* Выполните команду «Сброс сессии» [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]].

Любое из этих действий разорвет соединение для отслеживания, и индикатор вернется в обычное состояние.

'''Пример настройки просмотра сессии'''

Пользователь, за чьим диалогом будет наблюдение, должен создать у себя переменную (любую) и ее значение:

* <code>variable = за мной следят</code>

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

Пользователь, который хочет подключиться для просмотра, должен в своем разделе ''просмотра сессии'' создать точно такую же переменную:

* <code>variable = за мной следят</code>

И после того, как начнется диалог, в режиме реального времени наблюдатель будет видеть все данные сессии того, кто ведет диалог с роботом.<blockquote>'''Функция для пользователей UPS'''

Для более удобного отслеживания вы можете использовать уникальный <code>id пользователя UPS</code> , который передается в переменные сессии.

* Вместо того чтобы указывать одинаковые переменные у обоих пользователей, вы можете напрямую указать <code>id пользователя</code>, за которым хотите следить.
* Это позволяет вам следить за конкретным пользователем, при этом ему не обязательно вручную задавать у себя переменную.
</blockquote>

===== Тестирование голосовыми сообщениями и в голосовом канале =====
[[Файл:2025-06-10 12-44-58.png|мини|''Рис. 27 Тестирование робота с помощью микрофона.'']]
Робота можно протестировать, задавая вопросы голосом и/или вводя переменные. Например, можно проверить, как робот отправляет в разные конечные точки, получая одинаковые метки от SMC и номера телефонов различных ведомств. Например, метка «Мобилизация» от SMC в сочетании с номером телефона МФЦ приводит в КТ Консультация ЧаВО, а «Мобилизация» и номер единого контактного центра (ЕКЦ) — в КТ Перевод на оператора. Чтобы провести тестирование робота с переменными раскройте меню, кликнув на иконку шестеренки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] и заполните поля:

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

- Значение: укажите значение этой переменной..
[[Файл:2025-10-06 11-51-58.png|мини|''Рис. 28 Иллюстрация тестирования канала voice.'']]
В этом же меню вы можете настроить параметры аудиоответов и автовоспроизведения.

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

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

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

В дебаггере есть функция, позволяющая протестировать '''голосовой канал - voice''' (рис. 28), то есть ''имитировать звонок''. Чтобы запустить процесс, достаточно нажать на кнопку «Начать разговор» [[Файл:Начать разговор.png|безрамки|20x20пкс]] . Пока разговор активен, кнопка изменится на «Закончить разговор» [[Файл:Закончить разговор.png|безрамки|20x20пкс]] . Переменные задаются в меню, как и в текстовом канале. Для этого нажмите на иконку шестерёнки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] (рис. 21).

=== Архив диалогов ===
[[Файл:Архив диалогов нов.png|мини|''Рис. 29 Интерфейс архива диалогов'']]
После тестирования робота в любом канале можно заглянуть в Архив диалогов (рис. 29), чтобы изучить данные сессии. Для этого необходимо кликнуть на одноименную кнопку на панели инструментов рядом с кнопками версий робота [[Файл:Архив диалогов.png|безрамки|20x20пкс]]. Интерфейс архива содержит:

* Список доступных роботов слева на экране.
* Блок с фильтрацией диалогов.
* До момента пока вы не выберете диалог из списка справа будет пустой блок с текстом «Выберете диалог». После того как диалог выбран вы увидите отображение аналогичное рисунку 29.
* Информационные вкладки (см. в разделе [[SES. UPS руководство по работе с интерфейсом#Настройка робота|«Настройка робота»]]).

==== Работа с архивом диалога ====
Архив диалогов поддерживает версионность робота, то есть можно просмотреть диалоги одной из трех версий: черновик, прод или архивной. Для этого кликните по кнопке с нужной версией находясь уже в Архиве либо предварительно выбрав ее и перейдя в архив. Диалоги в архиве фильтруются по дате и времени, для этого кликните на иконку календаря [[Файл:Календарик с фоном.jpg|безрамки|20x20пкс]] в поле «Начало» и «Конец», чтобы выбрать дату. И время, кликнув на иконку часов ''(по умолчанию дата и время выставляются за текущие сутки)''. Выберите нужную дату и время, добавьте необходимые фильтры. Также можно отфильтровать звонки по:

# каналам связи:
* default,
* telegram,
* web,
* voice,
* vkontakte.
2. элементам данных — при нажатии на это поле открывается перечень всех элементов данных из сценария текущего робота.

3. номеру телефона,

4. ID диалога, берется из отладчика - значение атрибута session,

5. по названию и значению переменной,

3. либо тексту, либо ключевым словам, которые могут быть в искомом диалоге.

После настройки система, по нажатию кнопки «Поиск», отобразит все диалоги с роботом, учитывая выбранные фильтры (рис. 27). На самом верху над диалогом можно просмотреть его ID. В архиве диалоги сгруппированы по принципу «запрос от пользователя — ответ робота». При выборе каждой пары открывается отладчик, где можно увидеть метки и теги, полученные от моделей, копия [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчика]] из тестирования робота. Этот отладчик аналогичен тому, что используется в сценарной машине. Для голосового канала есть возможность прослушивания аудио диалога помимо текстового просмотра. Также есть возможность импортировать запросы диалога в скрипт тестирования в чат-отладчик по кнопке '''«Добавить в скрипт тестирования»''' снизу диалога и в появившемся окне введите название скрипта тестирования. После чего он появится в списке скриптов тестирования сценария.

Для вашего удобства во время ''активного'' диалога в архиве доступна кнопка '''«Следить за диалогом»'''. Нажмите кнопку «Следить за диалогом» во время просмотра архива ''активного'' диалога. Система начнёт автоматически обновлять список реплик, подгружая новые сообщения. Обновление происходит каждые 5 секунд, обеспечивая актуальный вид беседы без необходимости обновлять страницу вручную. Позволяет в реальном времени следить за развитием ещё не завершённого диалога, например, во время тестирования или активного общения с роботом.

===== Синхронизация текста и аудио в архиве диалогов =====
В архиве диалогов реализована условная синхронизация текстовой расшифровки с аудиозаписью на основе временных меток (datetime).

* При воспроизведении аудио: В текстовой расшифровке автоматически подсвечивается реплика (вопрос/ответ), которая звучит в данный момент.
* При клике на текст реплики: Воспроизведение аудио автоматически перематывается на тот момент записи, когда эта реплика абонента была произнесена.

Результат: Вы можете быстро находить нужные фрагменты разговора и удобно анализировать диалоги.

Чтобы '''выйти из Архива диалогов''' в сценарий нужно снова кликнуть на иконку [[Файл:Архив диалогов.png|безрамки|20x20пкс]].

=== Пользовательские справочники ===
[[Файл:Photo 2025-05-14 17-30-31.jpg|мини|''Рис. 30 Добавление пользовательского справочника'']]

Для доступа к справочнику нажмите на значок «Пользовательский справочник» [[Файл:Справочник (1).png|безрамки|20x20пкс]] на панели инструментов справа от архива диалогов. Чтобы создать новый справочник, нажмите кнопку '''«Добавить справочник»''' (рис. 30). В открывшемся окне заполните обязательные поля: название справочника и его структуру — наименования колонок. При необходимости задайте значения по умолчанию для каждой колонки. Эти значения будут автоматически заполнять новые строки. Затем нажмите '''«Добавить»'''.

Если значения по умолчанию не указаны, справочник будет пустым. Заполнять таблицу можно вручную.

Справочники можно переименовывать и удалять. Чтобы переименовать или удалить справочник, наведите курсор на его название. Появится две иконки: карандаш для переименования и корзинка для удаления. <blockquote>'''Перед переименованием справочника ''обязательно'' сохраните внесенные изменения, иначе они будут удалены.'''</blockquote>[[Файл:2025-05-20 14-45-35.png|мини|''Рис. 31 Удаление записей из пользовательского словаря'']]
При нажатии на карандаш откроется окно '''«Редактирование структуры».''' Важно помнить: изменения можно внести только в название справочника или в значения по умолчанию (если предыдущие значения были, они будут автоматически обновлены). ''Переименовать столбцы нельзя.'' После сохранения изменений нажмите кнопку '''«Сохранить»''', расположенную внизу под таблицей (рис. 31). <blockquote>'''Внимание! Справочники зависят от версии робота.''' Если вы вносите изменения в структуру справочника в черновой версии [[Файл:Черновик.png|безрамки|20x20пкс]], то для применения этих изменений в продовой версии нужно применить робота в прод.

'''Важно:''' переносится '''только структура справочника'''. Данные не дублируются. Их можно перенести вручную, экспортировав [[Файл:Экспорт нов.png|безрамки|20x20пкс]] из черновика и импортировав [[Файл:Импорт нов.png|безрамки|20x20пкс]] в прод. </blockquote>Вы можете фильтровать записи по содержанию любой колонки. Выделите галочками несколько записей сразу и удалите их. В правом нижнем углу появится иконка корзины, как только вы выберете хотя бы одну запись (рис. 31).

Справочники можно ''экспортировать'' и ''импортировать''. Экспорт и импорт осуществляются в формате JSON.
[[Файл:Снимок экрана 2025-07-16 175752.png|мини|''Рис. 32 Импорт пользовательского словаря'']]

''При импорте структуры импортируемого файла и справочника в интерфейсе должны совпадать''. Если они не совпадают, то заполнятся только совпадающие поля. Есть возможность ''импорта'' с дополнением новых данных, либо полной заменой (''Рис. 32''). Структура экспорта:<blockquote>
[

{"колонка1":"значение 1","колонка2":"значение 2","колонка3":"значение 3","id":"58845671-1150-4ae2-9c46-e8aeb2553c57"},

{"колонка1":"значение 2","колонка2":"значение 2","колонка3":"значение 3","id":"2e0a7f8e-6d64-4df9-a3ce-5862f8eb441c"}

]
</blockquote>Структура json-файла для импорта:<blockquote>[

{"колонка1":"значение 4","колонка2":"значение 5","колонка3":"значение 6"},

{"колонка1":"значение 2","колонка2":"значение 3","колонка3":""}

]

При импорте не обязательно указывать id.</blockquote>Чтобы '''выйти из Пользовательских справочников''' в сценарий нужно снова кликнуть на иконку [[Файл:Справочник (1).png|безрамки|20x20пкс]].

=== Панель управления SES ===
Панель управления SES включает в себя 8 кнопок: импорт, экспорт, обнуление черновика рабочей версией, применение робота, восстановление робота, применение настроек робота, массовая замена моделей в элементах данных и меню пользователя.

{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления''
!'''Иконка кнопки'''
!'''Название иконки'''
!'''Описание'''
|-
|[[Файл:Export.png|центр|безрамки|40x40пкс]]
|Экспорт
|Для создания резервной копии или переноса робота выполните его экспорт в ZIP-архив. В архив будут включены все настройки робота: элементы данных, конечные точки, скрипты, структуры пользовательских справочников (''но не включая сами данные''), а также связанные модели и базы данных QAS.<blockquote>'''Внимание!''' Перед экспортом убедитесь, что категории и модели актуальны. В противном случае экспорт может завершиться ошибкой, и робот не будет экспортирован.</blockquote>
|-
|[[Файл:ImportRobot.png|центр|безрамки|40x40пкс]]
|Импорт
|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''.|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''. Аналогично экспорту, доступен и импорт робота с моделями SMC, SEE и QAS в различные наборы данных.
<blockquote>'''Как работает импорт:'''

* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.
'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>
|-
|[[Файл:Стрелка.png|безрамки|40x40px|центр]]
|Обнулить черновик рабочей версией
|Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Применить.png|безрамки|40x40px|центр]]
|Применить
|По нажатию на эту кнопку черновая версия робота становится рабочей ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Откат.png|центр|безрамки|40x40px]]
|Восстановить
|С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной ''(кнопка активна только в архивной версии)''.
|-
|[[Файл:Разетка.png|центр|безрамки|40x40px]]
|Применить настройки робота
|Применяет сохранённые настройки робота и начинает работать в соответствии с ними, что аналогично перезагрузке программного обеспечения, но без необходимости самой перезагрузки.
После нажатия на кнопку система переносит эти настройки в настройки прода, но НЕ ПРИМЕНЯЕТ, на случай, если ошиблись.

Робот в любой версии начинает работать с новыми настройками только после нажатия на кнопку. Если вы нажали на кнопку, находясь в черновике, будут применены настройки черновика. Если же вы нажали на кнопку, работая в рабочей версии, то будут применены настройки рабочей версии, которые вы только что перенесли из черновика. <blockquote>Обратите внимание: после внесения каких-либо изменений кнопка будет красной [[Файл:Красная вилка (1).png|безрамки|20x20пкс]] и пульсировать, напоминая о необходимости применить настройки. </blockquote>
|-
|[[Файл:Смена моделей.png|центр|безрамки|40x40пкс]]
|Массовая замена моделей в элементах данных
|[[Файл:Замена моделей в ЭД.png|мини|''Рис. 33. Массовая замена моделей в элементах данных'']]Эта функция позволяет массово менять модели в элементах данных. После нажатия на кнопку появляется форма ''(Рис. 33)'', в которой необходимо указать тип элемента данных ''(Класс / Сущность)''. Затем в поле '''"Заменяемая модель"''' выбрать модель из списка моделей, используемых в уже существующих элементах данных ''(снизу будет указано количество элементов данных, использующих выбранную модель)'', и в поле '''"Заменяющая модель"''' выбрать доступную модель для замены. После нажатия на кнопку '''"Заменить"''' будет произведена замена выбранной модели в тех элементах данных, в которых она используется.
|-
|[[Файл:Меню пользователя new.png|безрамки|40x40px|центр]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, убрать/показать фон, выход из системы), а также возможность переключить ''отображение рабочей области с табличного на облачный вид и наоборот''.
В меню пользователя добавлена функция ''выбора набора данных*.''

При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

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

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

2025-12-24T09:43:40Z

E.Elagina: /* TTS Синтез */

=='''TTS Синтез'''==
[[Файл:TTS UPS.png|мини|''Рис.1 Главный экран UPS'']]
В главном меню UPS (Universal Proxy Server) расположены кнопки для перехода в блоки (см. рис. 1):

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# TTS Синтез,
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# [[SES. UPS руководство по работе с интерфейсом|SES Сценарная машина]],
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]],
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]] .
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2).[[Файл:TTS + искажение.png|мини|''Рис. 2 Интерфейс TTS Синтез'']]

Сервис предназначен для конвертации текста в речь. Он принимает на вход текст, а затем преобразует его в аудиофайл формата *.wav. Перейти в раздел '''«Синтез»''' можно кликнув по соответствующей кнопке на главном экране UPS (см.рис. 1).

Интерфейс раздела включает в себя (см.рис. 2):
*блок с моделями - позволяет выбрать модель для синтеза, находится слева на рабочей области;
*[[TTS. UPS руководство по работе с интерфейсом#Блок «Синтез речи»|блок синтеза речи]];
*блок с моделью искажения голоса;
*[[TTS. UPS руководство по работе с интерфейсом#Блок «Словарь ударений для синтеза»|блок словаря ударений для синтеза]];
*и [[TTS. UPS руководство по работе с интерфейсом#Панель управления сервиса Синтез|панель управления]].
===Панель управления сервиса Синтез===

Панель управления находится в правом верхнем углу экрана и содержит 2 кнопки: ''переход на главный экран'' и ''пользовательское меню''. Подробное описание каждой функции можно найти в таблице 1.
{| class="wikitable"
|+''Табл.1 Описание функционала панели управления''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Экспорт_нов.png|центр|безрамки|40x40пкс]]
|Экспорт
|экспортирует словарь ударений в формате csv
|-
|[[Файл:Импорт_нов.png|центр|безрамки|40x40пкс]]
|Импорт
|импортирует готовый словарь ударений в формате csv
|-
|[[Файл:Сохранить.png|безрамки|40x40px|центр]]
|Сохранить
|отправляет на главный экран (рис. 1).
|-
|[[Файл:Меню пользователя.png|безрамки|41x41px|центр]]
|Меню пользователя
|отображает меню пользователя (имя, смена пароля, выход из системы). Есть возможность выбора набора данных*, но данная опция не затрагивает функциональность приложения.
*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}
[[Файл:2025-02-12 14-26-50.png|мини|''Рис. 3 Интерфейс блока синтез речи'']]

===Блок «Синтез речи»===
Блок синтеза речи позволяет синтезировать речь и выгрузить результат в формате wav файла. Для этого необходимо:
#выбрать модель для синтеза;
#ввести текст;
#задать параметры для синтеза: скорость, тональность, громкость и частота;
#если необходимо, перед синтезом вы можете воспользоваться кнопкой '''«Нормализовать»'''. Эта кнопка преобразует цифровой ввод в буквенный (номера телефонов, даты, время), с правильным ударением, например, ''115 → ст+о пятн+адцать.'' Эта функция также может быть полезна для аббревиатур. Она позволяет привести аббревиатуру в нормализованный вид и, если есть необходимость, исправить её транскрипцию, чтобы ударение и произношение были правильными.
<blockquote>Например, если ввести аббревиатуру СЗФО и нажать на кнопку «Нормализовать», система предложит следующую транскрипцию: «+эсъ-з+э-ф-+о». Однако это произношение неверно. В таких случаях можно скорректировать произношение и добавить его как исключение в словарь ударений: «с+э-зэ-фэ-+о».</blockquote>5. нажать кнопку '''Синтезировать'''.<blockquote>Расшифровки узкоспециализированных терминов следует либо включить в словарь, либо отправить текст на синтез вместе с расшифровками.</blockquote>'''Преобразование текста в фонемы'''

Функция позволяет автоматически конвертировать обычный текст в фонемную запись.

Как использовать:

# Введите или вставьте нужный текст в соответствующее поле.
# Нажмите кнопку «'''Преобразовать в фонемы'''».
# Исходный текст в поле будет автоматически заменён на его фонемное представление.

<blockquote>Примечание: Процесс аналогичен работе функции нормализации — выполняется мгновенно по нажатию одной кнопки с заменой содержимого поля.</blockquote>Результатом отработки будет – wav файл с возможностью его прослушать и выгрузить (рис. 3).

[[Файл:Блок Словарь для синтеза.png|мини|''Рис. 4. Интерфейс блока «Словарь для синтеза речи».'']]
===Блок «Словарь ударений для синтеза»===
В этом разделе вы можете настроить произношение определенных слов с помощью моделей синтеза речи. Есть только '''один общий словарь''' для всех моделей.

Если вы столкнулись с проблемами в произношении определенных слов, вы можете добавить их в словарь (рис. 4) для коррекции синтезированной речи:
#в поле '''Фраза''' внести нужное слово или фразу,
#в поле '''Измененная фраза''' – вариант корректного проговаривания,
#нажать кнопку '''Добавить,'''
#зайти в блок '''Синтеза речи,'''
#внести слово добавленное в словарь,
#проверить результат исправления.
В словаре синтеза – есть возможность отфильтровать по фразе, по измененной фразе.

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

2025-12-24T09:41:13Z

E.Elagina: /* Индикация удаленных категорий */

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

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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# [[QAS. UPS руководство по работе с интерфейсом|QAS ЧаВО]],
# SES Сценарная машина,
# [[CLS. UPS руководство по работе с интерфейсом#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0%20%D1%81%20%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BE%D0%BC%20%D0%B8%D1%81%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D1%85%20%D0%BE%D0%B1%D0%B7%D0%B2%D0%BE%D0%BD%D0%BE%D0%B2%20%C2%AB%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%82%D0%BE%D1%80%C2%BB|CLS Информатор]],
# Выход.

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

# Воспользоваться кнопкой на панели управления «На главную» [[Файл:Меню пользователя new.png|безрамки|20x20px]].
# Воспользоваться кнопкой в виде линии, которая находится снизу в центе экрана (см. рис. 2).
[[Файл:2025-06-09 14-33-48.png|мини|''Рис. 2 Рабочая область SES'']]

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

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

==== Добавление и настройка робота ====
Чтобы добавить нового робота, нажмите кнопку '''«Добавить робота»'''. В появившемся диалоговом окне введите название и нажмите '''«Добавить»'''. В нижнем правом углу экрана появится сообщение «Добавлено!». По умолчанию робот создается с предварительными настройками. В нем сразу есть текстовки для исключений и событий, ознакомиться и поправить их можно, перейдя на вкладку [[SES. UPS руководство по работе с интерфейсом|«Настройки»]]. Робот может быть 3х версий: черновик, рабочий и архивный, подробная информация о версиях представлена в таблице 1.
{| class="wikitable"
|+''Табл. 1 Версии робота.''
!'''Иконка версии'''
!'''Наименование версии робота'''
!'''Описание'''
|-
|[[Файл:Черновик.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]], если вы планируете предоставлять консультации.

Здесь представлен общий перечень необходимых сервисов. В зависимости от специфики проекта некоторые из них могут отсутствовать.
[[Файл:2025-07-04 17-15-25.png|мини|''Рис. 3 Интерфейс вкладки Скрипты'']]

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

У скриптов есть параметр '''''«Область действия»''''', в котором есть 5 опций:

- ''конечные точки'', позволяет подключать скрипт в действиях конечных точек;

- ''элементы данных'', позволяет подключать скрипт в действиях элементов данных и контейнеров;

Скриптов на ЭД и КТ может быть несколько. Остальные скрипты общие и доступны только по одному на каждый тип:

- ''завершение сессии'' — скрипты, которые могут выполняться после завершения диалога, если скрипт указать в настройках в действиях на событии «Завершение диалога»;

- ''перед каждым вопросом'' — для случаев, когда нужно актуализировать какую-то информацию постоянно и использовать ее в условиях.<blockquote>

Скриптом «перед каждым вопросом» можно выставить, например, сегодняшнюю дату - ${custom.today}, а потом ее в сравнении дат использовать в условиях получения данных. Для случаев записи на прием проверять, '''что дата точно больше сегодняшней.'''

'''Скрипт проверки пишется админом.''' </blockquote>

- ''после каждого ответа'' — для случаев, где требуется пошагово после каждого ответа передавать информацию во внешнюю систему.

- ''передача диалога,'' скрипты для передачи диалогов.

- ''старт диалога.''

====== Дефолтные скрипты ======
В системе реализованы шаблоны скриптов по умолчанию:

Назначение:

* Автоматическое создание базовой функции при создании нового скрипта
* Возможность последующего редактирования

Расположение и настройка:

* Файлы находятся в переводчике по пути: <code>lang\ru.json</code>
* Реализовано для гибкости - администратор может изменять настройки
* Не зашито в код системы

Типы дефолтных скриптов:

* <code>_defaultScriptContainer</code> - для ЭД типа "Контейнер" (скрипты обработки)
* <code>_defaultScriptData</code> - для ЭД (скрипты постобработки)
* <code>_defaultScriptAction</code> - для действий в ЭД/КТ

[[Файл:Scrirts.png|мини|''Рис. 4 Отладка скриптов интеграции'']]
Есть '''режим отладки скриптов интеграций''' с функцией извлечения данных из сессии (рис. 4). То есть можно [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|тестировать робота в чате отладчика]] и, в случае если отработка некорректна или нужно проверить внесенные изменения в скрипт, то можно открыть вкладку «Скрипты» -> выбрать нужный скрипт -> кликнуть на закладку «Проверка» (слева откроется дополнительное окно) и нажать на кнопку «Вставить данные сессии». Тогда в открывшемся окне появятся все данные из текущей сессии из чата отладчика. По нажатию на кнопку «Тест», появится окно с результатом отработки скрипта.

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

[[Файл:2025-11-01 09-55-26.png|мини|''Рис. 5 Интерфейс вкладки «Интервалы»'']]

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

====== Группировка интервалов рабочего времени ======
Для удобства настройки сложных и переменных графиков работы в системе предусмотрена возможность объединять интервалы времени в группы. Это позволяет избежать создания громоздких условий в Контрольных Точках (КТ), когда рабочие часы оператора меняются каждый день или разбиты на несколько промежутков.

Для того, чтобы создать группу интервалов кликните на '''+''' справа от вкладки под номером '''1'''. Группа разделена на вкладки (табы), что позволяет удобно структурировать разные периоды.

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

* На одной вкладке настроить график для будних дней. Или для каждого дня отдельно.
* На другой вкладке — график для выходных.
* На третьей — особый график для праздников.

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

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

* '''события''' — действия, которые выполнит робот при наступлении определенного условия в диалоге, например «Не найдено» (см. раздел «События» ниже);
* '''исключения''' — это действия, которые выполняются, если событие повторяется указанное число раз подряд (см. раздел «Исключения» ниже);
* '''данные''';
* '''модели''' — настройка моделей, если требуется использовать параметры, отличные от параметров по умолчанию;
* '''коннекторы'''.

'''События''' есть 10-ти типов и прописываются для каждого канала связи отдельно:
[[Файл:2025-10-06 16-01-17.png|мини|''Рис. 6 Интерфейс вкладки «Настройки»'']]
# Старт — старт новой сессии — это когда робот приветствует пользователя и представляется. Это событие срабатывает, если человек впервые начинает общение с ботом. Также полное приветствие необходимо при начале разговора по телефону.
# Горячий старт — это событие настраивается для случаев, если диалог был приостановлен. То есть, при горячем старте бот не станет снова представляться абоненту, а просто поприветствует его в зависимости от времени суток (настроенных интервалов) и ответит на его вопросы.
# Возврат на старт — это действие, которое должен выполнить бот, чтобы вернуться к началу разговора. Например, в диалоге в голосовом чате можно спросить у пользователя: «Чем я могу вам ещё помочь?»
# Запрос повтора — действия на случай, если абонент запросил повтор информации. Если пользователь не расслышал информацию в голосовом канале, он может запросить её повторение. В этом разделе можно настроить функцию повтора последнего или двух последних ответов.
# Тишина — добавляем действие в моменты, когда от человека нет ответа, то есть тишина.
# Перебивание — событие доступно ''только для голосовых каналов (например, voice)''. Она позволяет настроить реакцию на прерывание речи.
# Задержка ответа — событие доступно ''только для голосовых каналов (например, voice)''. Это действия, которые появляются, когда идет генерация. Например, можно написать: «Секундочку, выясняю». Это нужно, чтобы человек понимал, что робот не просто молчит.
# Не найдено — здесь указывается действие, которое должен выполнить робот, если он не смог найти ответ на вопрос пользователя, то есть настройка действий если это событие произошло. Например, можно предложить пользователю попробовать переформулировать свой вопрос.
# Нет данных — это событие происходит, когда система пытается получить конкретный недостающий элемент данных, например название филиала, и ей это не удалось.
# Ошибка.

'''При наступлении события система выполнит указанное в канале действие. Если действие для этого события в канале не задано, то ничего не произойдет.'''

Вы можете настроить реакции робота на определённые события. Более подробную информацию о них вы найдёте в разделе «Исключения».

'''Исключения''' есть трех типов '''Тишина''', '''Не найдено''' и '''Нет данных'''.

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

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

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

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

На вкладке можно настроить параметры голосового канала. Вот что там можно сделать:

* Выбрать голос, которым будет говорить робот.

* Установить основную модель распознавания (рекомендуем оставлять common).

* Определить фоновую модель распознавания (рекомендуем background).

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

* '''Базовая''': исправляет только слова с минимальными опечатками (1-2 ошибки для коротких слов, макс. 1 ошибка)
* '''Расширенная''': допускает больше исправлений для сложных случаев (добавляет +1 ошибку к базовому порогу, макс. 2 ошибки).
* '''Агрессивная''': корректирует даже сильно искажённые слова (добавляет +2 ошибки к базовому порогу, макс. 3 ошибки).
* либо коррекция может '''Отсутствовать'''.

[[Файл:2025-10-06 16-47-09.png|мини|''Рис.7 Вкладка настроек коннектора telegram'']]

===== Вкладка «Коннекторы» =====
Позволяет настроить связь робота по одному из каналов: ''freeswitch'', ''max'', ''telegram'', ''vk'', ''web, nats.''

Для мессенджеров, таких как '''max''', '''telegram''', '''vk''', характерны следующие настройки:

* ''токен'',
* ''группа'' ''(для vk),''
* ''название бота'',
* ''обслуживающий сервер'' - имя сервера SES, который обслуживает данный коннектор,
* ''периодичность обновления'' - время периодичности запроса в api для получения новых сообщений,
* ''фразы-активаторы'' - список фраз, на которые будет реагировать робот в общих чатах, и считать, что сообщение адресовано ему,
* ''переменные,''
* ''фраза сброса сессии,''
* ''доступы'' - список пользователей, которые могут писать роботу. Если пустой, то могут все.

Для канала '''web,''' в частности, для встраивания чат-виджетов ''(рис 7.1).'' Данный коннектор предназначен для встраивания интерактивного виджета на ваш сайт. Доступно два типа виджета: '''Чат и Ассистент (Суфлер)'''.
[[Файл:2025-11-14 11-16-35.png|мини|''Рис. 7.1 Вкладка настроек коннектора web'']]
'''Общие параметры (для обоих типов)'''

Следующие настройки являются общими независимо от выбранного типа виджета.

* Домен: Укажите домен вашего сайта, на который будет встраиваться виджет. Это необходимо для безопасности, чтобы виджет мог работать только на указанном сайте.
* Токен: Уникальный идентификатор, который указан в теге <code>[[SES. Руководство администратора#Настройка виджета для сайта|<script>]]</code> для встраивания виджета на сайт.
* Акцентный цвет: Основной цвет интерфейса виджета (кнопки, заголовки, выделение). Используется для согласования с фирменным стилем вашего сайта.
* Заголовок виджета: Текст, который отображается в шапке открытого окна чата.
* Приветственное сообщение: Первое сообщение, которое видит пользователь при открытии чата.
* WebSocket-серверы: Технический параметр для установки соединения. Обычно заполняется автоматически и изменяется только по указанию технической поддержки.
* Язык: можно указать язык для виджета. Если не указывать, то будет дефолтный из конфига UPS.
<blockquote>Мультиязычность настраивается в настройках пользователя.</blockquote>'''Функциональные возможности'''

Эти опции позволяют включить или отключить определенные функции виджета.

* Голосовые ответы: Пользователь может прослушивать ответы от робота в аудиоформате.
* Отправка аудиосообщений: Пользователь может записывать и отправлять голосовые сообщения.
* Отправка файлов: Пользователь имеет возможность прикреплять и отправлять файлы.
* Аудиозвонок: Пользователь может инициировать голосовой звонок.
[[Файл:Ассистент.jpg|мини|''Рис. 7.2 Настройка переменных для режима "Ассистент"'']]
'''Выбор типа виджета'''

Перед сохранением конфигурации необходимо выбрать тип виджета, так как это влияет на доступность дополнительных параметров.

''Тип: "Чат"''

Стандартный режим для интерактивного общения с пользователем. Все "Функциональные возможности" и "Общие параметры" доступны для настройки. Также доступен блок "Переменные".

''Тип: "Ассистент" (Суфлер)''

Режим, предназначенный для подсказок оператору во время разговора с абонентом. Все переменные, необходимые для работы ассистента, настраиваются и передаются отдельно в личном кабинете пользователя. Сначала нужно авторизоваться в системе UPS ''(рис. 7.2)'', и дальше суфлер подключится сразу ко внутреннему номеру, который указан в настройках пользователя, там же можно переопределить цветовую схему под каждого пользователя.

Для канала '''freeswitch''' (телефонная линия):

* ''название коннектора,''
* ''режим обслуживания:''
** Режим «Как робот»
*** <code>Внутренний номер</code>: Указывается внутренний номер этого робота.
*** Опция ассистента: Дополнительно настраивается параметр, который определяет, будет ли ассистент (суфлер) работать после перевода звонка на оператора.
** Режим «Как ассистент»
*** <code>Внутренний номер</code>: Указывается внутренний номер робота-ассистента (суфлера).
*** <code>Номер для перевода звонка</code>: Указывается номер, на который будет переключаться звонок (номер колл-центра или конкретного оператора).
Работа ''суфлера после перевода звонка'' на оператора возможна ''в двух режимах'':

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

Флаг '''"Автостарт ассистента"''' при активации этой опции, ассистент запускается автоматически.

Настройки канала '''''nats''''':

* название коннектора,
* адрес серверов,
* канал входящих сообщений,
* канал исходящих,
* обработчик.

Принцип работы:

* Отправитель (канал исходящих сообщений) отправляет сообщение в определенный subject.
* Получатели (канал входящих сообщений), которые проявили интерес к этому subject, получают сообщение.
* Subject выступает в роли классификатора, позволяя разделять различные потоки сообщений для разных задач и сервисов.

Для работы коннектора необходимо указать адрес сервера NATS и топики (Subjects) для отправки и получения сообщений.

[[Файл:Функционал действий.png|мини|''Рис. 8 Функционал Действий'']]

==== Виды действий в роботе и работа с ними ====
'''1. Основные действия'''

Доступны следующие типы действий:

* '''Сказать'''

Настройте текстовые ответы робота. Это может быть простая фраза-заглушка, ответ, сгенерированный AI (LLM), или ответ из базы знаний (QAS). Типы ответов «Сказать» подробно описаны в разделе 2.

<blockquote>При наведении мыши на поле «Фраза» появляется кнопки-иконки [[Файл:Управление фразой действия.png|безрамки|64x64пкс]], где можно выбрать одно из действий:
# Добавить кнопку (подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Добавление кнопок в действия|«Добавление кнопок в действия»]]). Доступно пользовательское расположение кнопок, которые регулируются переносами на новые строки.
# Перефразировать. Если нужно добавить вариации фразы (рис. 8). Предложенные фразы можно отредактировать или удалить, кликнув по иконке корзинки напротив нужной фразы и добавить в список фраз.
# Удалить лишнюю фразу можно, если она не единственная.
</blockquote>

* '''Подтвердить'''

Настраивается фраза для подтверждения.

* '''Отправить файл'''

Позволяет отправить файл в ответ на запрос пользователя.

* '''Остановить выполнение действий'''

Немедленно прекращает выполнение всех последующих действий в текущем сценарии и сбрасывает точку выполнения диалога.

* '''Передача диалога'''

Переводит разговор, например, на оператора или в другой отдел. Для настройки необходимо указать ''Назначение'' передачи.

* '''Забыть данные'''

Позволяет стереть определенные данные, введенные пользователем, чтобы запросить их заново. При активации опции ''Перезапросить'' система автоматически сформирует запрос на ввод недостающих данных.

* '''Завершить диалог'''

Завершает текущий разговор с пользователем и закрывает сессию.

У некоторых действий есть опции:
* ''Считать действие успешным прохождением точки'' — этот флаг устанавливается на действия, которые означают, что сервис выполнился. В основном для отчетности.
* ''Прерываемое'' — этот флаг активируется для голосового канала и говорит о том, что допускается прерывание (перебивание) робота в момент синтеза ответа. Если он активен, робот будет реагировать на стоп-слова, в противном случае — нет.
* '''Установка переменной'''
позволяет задать или изменить значение переменной после выполнения определенного события в сценарии. Это мощный инструмент для создания сложной логики, например, для подсчета количества попыток входа в сервис и последующих действий в зависимости от этого значения.

* '''Принудительно перейти в КТ'''

позволяет принудительно отправить диалог в выбранную конечную точку.

'''2. Типы ответов для действия «Сказать»'''

При использовании действия «Сказать» вы можете выбрать один из четырех типов ответа:

1. ''Последовательно''

Робот будет выдавать вопросы и информацию по порядку, строго следуя списку, указанному в поле «Фразы».

2. ''Случайная фраза''

Робот выберет и произнесет одну случайную фразу из заданного списка.

3. ''Из внутреннего источника (недоступно для действий в элементах данных)''

Ответ формируется из Системы ответов на вопросы (QAS) для ответа из ''QAS документация'' нужно настроить'':''

* Условия присвоения категорий: Определяет правила, при которых система может направить запрос в эту категорию QAS для поиска ответа.

* Условия вывода ответа: Настройте параметры, такие как использование кеша ответов, генерация ответа и кеширование формулировок и [[QAS. UPS руководство по работе с интерфейсом#%D0%A4%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%BE%D0%BD%D0%B0%D0%BB%20%D0%B2%D0%BA%D0%BB%D0%B0%D0%B4%D0%BA%D0%B8%20%C2%AB%D0%A8%D0%B0%D0%B1%D0%BB%D0%BE%D0%BD%D1%8B%20%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2%C2%BB|выбрать шаблон запроса]]. Подробности [[QAS. UPS руководство по работе с интерфейсом|тут]].<blockquote>'''Обратите внимание:''' если вам нужно изменить шаблон запроса для определенной категории, это делается путем добавления отдельного действия. Настройка этого действия аналогична основному, но с выбором нужного шаблона. В Условиях запуска указываете данные, которые запустят это действие с шаблоном-исключением. </blockquote>

''QAS-чат'': Ответы генерируются AI-моделью (LLM) по умолчанию или другой моделью, добавленной администратором.

4. ''Из внешнего источника''

Позволяет подключить скрипты интеграций для выполнения специальных действий, если таковые имеются. Для действия «Сказать» с типом «Из внешнего источника» нажмите на специальную кнопку, расположенную рядом с полем выбора скрипта [[Файл:Postprocessing.png|безрамки]]. Откроется вкладка с выбранным скриптом, где вы можете:

* Просматривать код текущего скрипта,
* Редактировать существующий скрипт,
* Создавать новый скрипт.

<blockquote>Редактирование и создание скриптов не влияют на сохранение ЭД/КТ, т.к. они ссылаются только на id скрипта. Если вы выбираете другой скрипт для действия, обязательно сохраните изменения.</blockquote>'''3. Управление действиями'''

Для каждого действия доступны три опции управления (обычно отображаются в виде значков [[Файл:Для действий.png|безрамки|72x72пкс]]):

1. ''Копировать''

Чтобы скопировать действие в другой канал, нажмите эту кнопку и в открывшемся окне выберите целевой канал из списка.

2. ''Переместить''

Чтобы переместить действие в другой канал, выполните те же шаги, что и для копирования. <blockquote>'''Внимание:''' При перемещении действие будет удалено из исходного канала.</blockquote>3. ''Удалить действие''

Чтобы удалить действие, нажмите на кнопку в виде корзины.

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

===== Добавление кнопок в действия =====
В сценарной машине предусмотрена возможность добавления кнопок.

При наведении мыши на поле «Фраза» появляется кнопки-иконки , где по иконке с плюсом можно добавить кнопку:

# название кнопки;
# текст для отправки — это тот текст, который отправится на модели ([[SMC. UPS руководство по работе с интерфейсом|SMC]], [[SEE. UPS руководство по работе с интерфейсом|SEE]]).

Чтобы внести изменения в созданную кнопку, кликните по ней левой клавишей мыши (ЛКМ) и в открывшемся меню можно редактировать или удалить эту кнопку.

Интерфейс позволяет гибко управлять расположением кнопок с помощью переносов на новую строку.

Чтобы настроить порядок кнопок:

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

Этот инструмент позволяет визуально сгруппировать кнопки и организовать интерфейс максимально удобно для пользователя.

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

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

''Переменные'' — служат для хранения данных, полученных из API или по каналам, запущенным извне. Например, это может быть ID пользователя в Telegram или CID из телефонного канала, то есть определившийся номер телефона.<blockquote>'''Переменные, как и данные, можно выбирать из выпадающего списка.''' Доступны все названия и значения, которые использовались ранее. Если вам нужно создать новую переменную и значение, просто введите их с клавиатуры. После этого они также будут предлагаться вам в дальнейшем.</blockquote>''Данные'' — элемент данных, полученный от моделей SMC или SEE.

''Интервал'' — период времени, в который запускается это действие. У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.
''Подтвердить'' — запуск действия в зависимости от наличия подтверждения от абонента.
[[Файл:Уведомление дублей.png|мини|''Рис. 9. Уведомление об одинаковых блоках ИЛИ в условиях запуска действий'']]
В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»'' (рис. 9)''.''<blockquote>'''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.</blockquote>

Также при сохранении настроек в окне "Условий запуска" если были обнаружены одинаковые блоки условий "ИЛИ", то будет соответствующее оповещение с выделением повторяющихся блоков ''(Рис. 9''.)

Пример использования условий запуска действий в конечной точке ''«Проверка статуса»:''<blockquote>
'''Ситуация 1.'''

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

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

'''Ситуация 2.'''

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

1. Определить элемент данных, который отвечает за отслеживание цифр (код). В нашем случае это модель SEE number и элемент данных «Код заявления».

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

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

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

==== Добавление и настройка элементов данных ====
[[Файл:Снимок экрана 2025-07-16 154838.png|мини|''Рис. 10. Массовое добавление элементов данных'']]
[[Файл:2025-12-11 11-15-27.png|мини|''Рис. 10.1. Бланк настройки элемента данных'']]
После того как вы добавили робота нужно добавить элементы данных, нажав на кнопку '''«Добавить элемент»'''. В появившемся диалоговом окне возможны два варианта добавления: '''"Одиночное"''' и '''"Массовое"'''.

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

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

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

'''Контейнер''' — составной элемент данных, который собирает необходимые данные, чтобы отправить их во внешнюю БД по API с помощью скриптов интеграции.

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

===== Настройка элемента данных =====
[[Файл:2025-04-23 14-43-07.png|мини|''Рис. 11 Проверка модели в ЭД'']]
На предыдущем этапе вы добавили новый элемент. После этого откроется окно, в котором необходимо настроить новый элемент данных (''Рис. 10.1'').

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

'''«Вес»''' — это параметр, который определяет приоритет этого элемент данных в спорных ситуациях. По умолчанию установлено значение 3. Также вес ЭД отображается в [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчике]] и, если у вас активировано [[SES. UPS руководство по работе с интерфейсом#Панель управления SES|табличное представление сценария]], то и в самой таблице. <blockquote>Совет по работе с весом ЭД.

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

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

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

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

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

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

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

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

Рядом с комментарием находится кнопка '''Исключения''' [[Файл:Исключения .png|безрамки|20x20пкс]]. По нажатию на эту кнопку можно для определенных элементов данных настроить нестандартные исключения, то есть исключения, отличные от общих настроек (рис.12). <blockquote>
Например, для ЭД «Название филиала». [[SES. UPS руководство по работе с интерфейсом#Вкладка «Настройки»|В общих настройках]] робота МФЦ указано, что количество исключений для события «Нет данных» равно 3 (в счетчик входит и первое обращение к роботу, если там не было нужной информации). Однако мы хотим, чтобы, если с первого раза филиал не был найден, робот больше не запрашивал у абонента его название. Вместо этого робот должен показать заглушку с предложением поискать нужный филиал на сайте. Для таких случаев можно настроить '''нестандартное исключение.''' </blockquote>Настройка нестандартного исключения:

# выберете нужный элемент данных,
# кликните на значок исключения [[Файл:Исключения .png|безрамки|20x20пкс]],
# в появившемся окне активируйте флаг «включить нестандартные исключения»,
# заполните тип исключения Нет данных,
# установите максимальное кол-во исключений подряд (если хотите уточнять один раз, то макс.кол-во устанавливайте равным 2),
# установите канал связи при необходимости,
# и выберете действие на случай, если исключение наступило.
[[Файл:Постобработка ЭД.png|мини|''Рис. 12.1. Постобработка данных'']]
Далее находится кнопка '''«Постобработка»''' [[Файл:Postprocessing.png|безрамки]]'''.''' При нажатии на нее появится всплывающее окно с редактором кода, где можно написать функцию, которая будет срабатывать после того как ЭД был получен (Рис. 12.1). Установите галочку '''«Включить постобработку»''' и в редакторе отобразится функция-обработчик, которая принимает на вход три параметра: ''значение ЭД, текст последнего сообщения, канал'', и возвращает значение ЭД и опционально текст сообщения.<blockquote>'''Пример:'''

<code>def handler(value, message, channel):</code>

<code> if value == 'старый' and message == 'старый' and channel == 'voice':</code>

<code> return 'новый', {'text':'новый'}</code>

<code> elif value == 'новый' and message == 'новый' and channel == 'voice':</code>

<code> return 'старый', {'text':'старый'}</code>

<code> return value, {'text': 'не тот канал'}</code></blockquote>

'''Тестирование скриптов в ЭД'''

Процесс тестирования скриптов в ЭД аналогичен тестированию скриптов во вкладке "Скрипты", с учетом того, что скрипты находятся непосредственно в самих ЭД.

Важное отличие:

* Для ЭД типа «Класс» или «Сущность» - поле «Значение» обязательно для заполнения.
* Для ЭД типа [[SES. UPS руководство по работе с интерфейсом#Произвольный элемент данных|«Произвольный»]] - поле «Значение» заполняется по необходимости (опционально).

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

'''Работает только в условиях запуска. Если ЭД с этим флагом стоит на входе в КТ, то фраг игнорируется.'''</blockquote><blockquote>'''Пример: Запись на прием'''

1. Процесс взаимодействия с пользователем

Пользователь хочет записаться на прием. Для этого необходимо собрать следующие данные:

* Намерение (цель обращения).
* Адрес (куда хочет попасть пользователь).
* ФИО.
* Номер телефона.

2. Работа моделей в КТ "Запись на прием"

* Все модели, отвечающие за обработку запроса, работают в фоновом режиме.
* На любом этапе диалога они могут «выхватывать» сущности (например, извлекать ФИО, адрес и т. д.).

3. Проблема ложного срабатывания

Модель может ошибочно извлечь данные, если:

* Пользователь вводит информацию, которая частично совпадает с искомой сущностью (например, город ''"Владимир"'' может быть ошибочно принят за имя).
* Это приводит к некорректной обработке данных до завершения сценария.

4. Решение: ограничение работы модели

Чтобы избежать ложных срабатываний:

* Активируйте галочку '''«Получать только прямым запросом»''' в настройках ЭД.
* Если галочка активна, модель (например, извлечение ФИО) сработает только когда:
** Сценарий диалога дошел до запроса ФИО.
** Пользователь явно отвечает на вопрос о недостающих данных по ФИО.

Таким образом, '''система не будет обрабатывать случайные упоминания имен или других сущностей вне контекста запроса.'''</blockquote>Флажок '''«Подставлять ответ модели в запрос к ЧаВО»''' предназначен для работы с типами ЭД «Сущность». Его основная функция — подставлять в запросы пользователей ответ от модели (название тэга) SEE вместо исходного текста абонента, на который среагировала модель.<blockquote>'''Пример использования'''

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

# Создаем модель SEE с тегами:
#* <code>до 14 лет</code>
#* <code>с 14 лет до 18 лет</code>
#* <code>с 18 лет</code> ''(Теги формируются на основе предоставленной документации.)''
# Добавляем ЭД в качестве недостающего элемента в настройки КТ.
# Когда сценарий доходит до дозапроса этого ЭД или абонент сам предоставляет данные, система отправляет запрос в QAS. Например, абонент отвечает, что ему 44 года, но в документах нет такого варианта. В них информация сгруппирована <code>до 14 лет</code>, <code>с 14 лет до 18 лет</code> и <code>с 18 лет.</code> Соответственно система не найдет похожую информацию.
# Решение:
#* Если флажок активирован, система подставит ближайший подходящий тег (в данном случае — <code>с 18 лет</code>).
#* Это поможет QAS корректно находить информацию в документации.
'''Важно:''' если ваша модель SEE '''не отдаст ответ''', то настройка '''не сработает'''. Проверьте и при необходимости дообучите модель.</blockquote>

Флаг '''«Удалять сущность из запроса к ЧаВО»''' предназначен для типов «ЭД Сущность» и работает наоборот: он удаляет из запроса пользователя слова или фразы, которые распознала модель.

Флажок '''«Режим долгого ожидания»''' Открывает дополнительное меню с триггерами окончания ожидания. Это данные, при получении которых мы прекращаем ждать именно этот элемент данных (ЭД). Например, если получили его же или другие данные, например, просьбу позвать оператора.<blockquote>'''Обратите внимание:''' чтобы этот режим работал правильно, создайте нестандартное исключение для ЭД (описание выше). Иначе система будет ориентироваться на общие настройки количества исключений.</blockquote>

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

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

===== События элемента данных =====

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

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

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

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

'''Тип события''' '''«Элемент получен».''' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).

'''Тип события''' '''«Тишина»''' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек молчит.[[Файл:Уведомление об отсутствующем классе.png|мини|''Рис. 14. Уведомление об отсутствующем классе'']]<blockquote>
Например, если робот спрашивает у абонента, какой паспорт ему нужен, а человек молчит, можно через некоторое время повторить вопрос или сказать: «Говорите громче, не слышно».</blockquote>

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

В таблице элементов данных предусмотрено уведомление ''(Рис. 14)'' об отсутствующей модели на сервере, которую использует элемент данных, а также об отсутствующем классе/группе в выбранной модели. При таких случаях слева от элемента данных расположен значок [[Файл:Warning.png|безрамки]], при наведении курсора мыши на который появляется соответствующее сообщение.

===== Произвольный элемент данных =====
Элемент данных типа «Произвольный» предназначен для обработки произвольных текстовых данных от пользователя, таких как:

- Нажатия кнопок (текста на кнопках),

- Точные текстовые фразы,

- Данные, присваиваемые через скрипты.

''Простая настройка:''

- Текст: текст от пользователя (например, текст на кнопке или точная фраза), который нужно «отловить».

- Значение элемента данных: присваиваемое значение этому элементу данных (param).

''Универсальное применение:''

- Обработка различных кнопок в одном элементе данных.

- Возможность скриптового присвоения любых значений.

- Замена использования элемента-заглушки со скриптами.

- Пользоваться таким ЭД можно точно так же как и другими элементами. Вести в разные действия и категории исходя из значения произвольного ЭД.<blockquote>''Пример использования''

Сценарий: Обработка различных текстов с кнопок БЕЗ обработки моделями, то есть модель может «не знать» этих фраз:

- Текст: "Поддержка участников СВО" → Значение ЭД: «Поддержка СВО»

- Текст: "Льготы для пенсионеров" → Значение ЭД: «Социальные услуги»

Таким образом, один произвольный элемент данных может обрабатывать множество различных вариантов ввода.</blockquote>[[SES. UPS руководство по работе с интерфейсом#События элемента данных|События]] на этом элементе аналогичные как и на обычных ЭД.

[[Файл:2025-10-06 13-10-56.png|мини|''Рис. 15 Интерфейс контейнерного ЭД'' ]]

===== Элемент данных типа «Контейнер» =====
Контейнер — это составной элемент данных, который объединяет несколько дочерних элементов для последующей обработки. Его основная функция — сбор необходимых данных и их отправка во внешнюю базу данных через API с использованием скриптов интеграции.

Доступ к редактору скриптов:

# Перейдите в карточку элемента данных «Контейнер»
# Нажмите на кнопку вызова редактора скриптов [[Файл:Postprocessing.png|безрамки]]
# ''Важно:'' Если скрипт не заполнен, кнопка будет подсвечиваться красным цветом

Создание функции обработки:

* При нажатии на кнопку открывается всплывающее окно с редактором кода
* Функция выполняется после получения всех данных элемента
* Для активации установите галочку «Включить скрипт обработки»

Функция принимает три входных параметра:

# <code>value</code> — значение текущего элемента данных
# <code>message</code> — текст последнего сообщения от пользователя
# <code>chanel</code> — идентификатор канала взаимодействия

Функция возвращает:

* Обязательно: обработанное значение элемента данных (value и записывает его в значение ЭД param)
* Опционально: текст сообщения для пользователя

События контейнерного ЭД:

* ''«Элемент получен».'' Данный тип события позволяет задать действие, которое будет автоматически выполняться в тот момент, когда система получает от пользователя этот элемент данных (например, ФИО, номер телефона, адрес и т.д.).
* ''«Нет данных»'' настраивается на каждом элементе данных при необходимости, чаще это нужно для недостающего элемента, который мы запрашиваем. Тут можно прописать действия на случай, если в ответ на вопрос от робота человек говорит что-то, но не ответ на вопрос.

==== Добавление и настройка конечных точек ====
[[Файл:2024-11-18 12-00-28.png|мини|''Рис. 16 Рабочая область SES'']]Конечная точка — это то, что выполняет определённое действие, например, предоставляет консультацию, завершает диалог и так далее. Процесс добавления конечной точки похож на добавление элемента данных. В верхней правой части рабочей области расположена кнопка '''«Добавить конечную точку»''' (рис. 16). Нажав на неё и заполнив поле с названием, вы создадите новую конечную точку. Все созданные точки образуют «облако конечных точек».

===== Настройка конечной точки =====
После того как вы ввели название конечной точки и нажали кнопку '''«Добавить»''', слева на рабочей панели появится окно для настройки конечной точки. В самом верху этого окна отображается ''название конечной точки'', при желании его можно сменить. Также доступен выпадающий список «Тип». Здесь можно выбрать один из четырёх вариантов:[[Файл:2025-03-28 14-57-55.png|мини|''Рис. 17 Типы входа в конечные точки'']]'''«Отчетный»''' — эта та, которая участвует в статистике, т.е. несет какую-то полезную для анализа информационную нагрузку.

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

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

'''«Завершение диалога»''' — конечная точка, которая ставит точку в общении с пользователем.[[Файл:2025-05-28 16-23-27.png|мини|''Рис. 18 Вход в КТ по условиям'']]

Также можно выбрать еще '''Тип входа в КТ''' может быть трех видов (рис. 17):

'''- по условиям''', когда попадаем в КТ при условии получения определенных данных, например, класс от SMC (рис. 18). На вкладках «Условия» доступна ''фильтрация по элементу данных.''

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

Абонент обратился за консультацией. Робот предоставил ответ. После консультации абонент бездействует, а сессия еще не закрыта. Можно настроить КТ Оценка качества обслуживания, которая по истечению указанного времени запросит оценку, после ответа абонента, завершит сессию.</blockquote>- '''по ручному запуску''', когда КТ нужно принудительного запустить, например для рассылки. Чтобы настроить вход в конечную точку нужно выбрать в меню Вход опцию «По ручному запуску». Интерфейс КТ по ручному запуску идентичен КТ со входом «По бездействию», за исключением поля «Время».

Такой вариант входа в КТ подходит для исходящих сообщений (обзвонов), например, чтобы отправить абоненту напоминание-подтверждение о предстоящей записи: «Уточните, пожалуйста, вы придете на прием?»

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

'''Настройка исключений для конечных точек'''

Вы можете настроить автоматическое реагирование на сбои в работе конечных точек. Исключения [[Файл:Исключения .png|безрамки|20x20пкс]] - это специальные действия, которые выполняются при нескольких последовательных неудачных запусках конечной точки.

Система отслеживает статус запусков. Когда количество неудачных попыток подряд достигает заданного вами значения (например, 3), автоматически выполняется указанное вами действие.

Пример настройки:

* Условие: 3 неуспешных запуска подряд.
* Действие: Перевести звонок оператору ''или'' Завершить диалог.

===== Условия входа и запуска конечных точек. Сбор информации =====
'''Типы условий для входа'''

Для настройки условий '''входа''' в системе доступны три основных типа:

1. ''Данные''. Проверка значений элементов данных.

2. ''Переменные''. Работа с системными и пользовательскими переменными.

3. ''Подтверждение''. Проверка статуса подтверждения от пользователя. Возможные значения:

* Получено (пользователь подтвердил действие)
* Не получено (пользователь отклонил действие)

Для '''условий запуска''' есть дополнительно 4-ое условие, помимо вышеперечисленных:

4. ''Интервалы.'' У Интервалов есть дополнительный флаг: '''''Не''''':

* если "не" выключено - то работает по этому интервалу,
* если "НЕ" включено - то наоборот, когда не равно этому интервалу.

Для '''сбора информации''' есть только 2 варианта условий: данные и переменные.<blockquote>Применение: Эти типы условий позволяют гибко управлять логикой диалога, направляя пользователя по различным сценариям в зависимости от текущего контекста.</blockquote>

'''Условия входа (Вход).''' Для того чтобы попасть в конечную точку и выполнить определенные действия, нужно выполнить условия входа. Их может быть как один элемент данных, так и их сочетание.<blockquote>Пример: У нас есть конечная точка «Загранпаспорт». И в эту конечную точку приводят элемент данных: ''«Загранпаспорт»'' (получена метка от [[SMC. UPS руководство по работе с интерфейсом|SMC]], соответствующая этому элементу данных). А также сочетание элементов данных: ''«Паспорт»'' (получаем, если тип паспорта не указан сразу) и ''«Тип паспорта-загран»'' (тег «Загран» получили после уточнения типа паспорта).</blockquote>Условия входа объединены в блоки, которые имеют логическое условие «И». Чтобы добавить новое условие, необходимо нажать на кнопку «Добавить условие» [[Файл:Добавить условие.png|безрамки|20x20пкс]]. Блоки с условиями «И» разделены логическим «ИЛИ».
Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:
* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* + (Прибавить) — для увеличения счетчика,
* - (Вычесть) — для уменьшения счетчика,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

[[Файл:Рис. 17 Условия запуска.png|мини|''Рис. 19 Условия запуска'']]
'''''Условия запуска и Сбор информации''.''' Вкладка ''Сбор информации'' и меню ''Условия запуска'' идентичны по своему назначению'''.'''

По нажатию на эту кнопку открывается окно, где нужно указать '''''все''''' случаи (данные и их комбинации), '''''при которых точка сработает''''' (см.рис. 19). В окне «Условия запуска» элементы данных разделяются логическим оператором «ИЛИ». В случае с комбинациями условий ЭД отделяются друг от друга логическим «И». Как в случае с элементами, разделёнными операторами «ИЛИ», так и с элементами, разделёнными «И», порядок элементов можно менять. Аналогично для вкладки Сбор информации.

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

Условия можно редактировать: добавлять и удалять. Окно можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.<blockquote>Например, конечная точка «Консультация» активируется, если будут получены метки «Апостиль» ИЛИ «Банкротство» ИЛИ «Загранпаспорт» и «Тип паспорта — загран».</blockquote>В меню условий запуска есть повторяющиеся кнопки ''«Сохранить»'' и ''«Закрыть»''. '''Обратите внимание:''' при нажатии на кнопку «Сохранить» '''сохраняются''' не только текущие условия запуска, но и '''все настройки КТ'''. При нажатии на кнопку «Закрыть» '''без сохранения изменения теряются'''.

У условий есть параметр ''«Тип»'', принимающий два значения: данные или переменная. Параметр ''«Искать»'' имеет три варианта:

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

Далее идет поле «Название», где из выпадающего списка требуется выбрать нужный элемент данных. <blockquote>Если в выбранном элементе данных не заполнено событие «Недостающий элемент», то в правом верхнем углу будет расположен значок [[Файл:Warning.png|безрамки]] со всплывающим уведомлением при наведении на него.</blockquote>Справа от поля «Название» из выпадающего списка можно выбрать один из операторов:

* Существует — это любое значение этого элемента данных, то есть важно просто наличие этого элемента данных,
* Не существует — означает, что значение этого ЭД отсутствует,
* != — не равно,
* = — равно,
* < — меньше,
* > — больше,
* <= — меньше или равно,
* => — больше или равно,
* Длина равна — длина ответа абонента равна определенному значению, которое указывается в поле «Значение». Например, когда абонент вводит код для проверки статуса заявления, который должен быть равен 7 знакам,
* Длина меньше — длина ответа абонента меньше определенного значения, указанного в поле «Значение»,
* Длина больше — длина ответа абонента больше определенного значения, указанного в поле «Значение».

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

===== Условия присвоения категорий =====
[[Файл:2025-07-07 12-42-57.png|мини|''Рис. 20 Вкладка Действия и Условия присвоения категорий'']]
'''''Условия присвоения категорий'''.'' По клику на эту кнопку раскрывается меню (рис. 20), в котором есть выпадающий список со всеми категориями из [[QAS. UPS руководство по работе с интерфейсом|QAS]], а ниже область для настройки условий. Условие может включать в себя как один элемент данных, так и несколько, которые связаны между собой логическим выражением «И». Также возможно наличие нескольких условий, которые соединены логическим выражением «ИЛИ». ''Окно с условиями категорий или условиями запуска можно двигать как удобно, достаточно просто зажать левую клавишу мыши и перетащить как нужно.''<blockquote>На примере категории «Паспорт РФ» можно увидеть, что эту категорию мы присваиваем, если получаем элементы данных «Паспорт» и «Тип паспорта — РФ» (значение «РФ») или только элемент данных «Паспорт РФ». </blockquote>Флажок '''«Запрос в QAS с учетом прошлого контекста»''' указывает системе, что перед отправкой запроса в QAS необходимо проанализировать предыдущие сообщения пользователя. Это позволяет сохранять логику диалога и избегать необоснованной смены тематики.<blockquote>'''Пример работы'''

# Без включенной функции
#* Пользователь спрашивает: ''"Какие документы нужны для оформления СНИЛС?"'' → система направляет запрос в категорию СНИЛС.
#* Затем пользователь уточняет: ''"А сколько это стоит?"'' → система определяет метку Госпошлина и перенаправляет запрос в соответствующую категорию, теряя контекст СНИЛС.
# С включенной функцией
#* Если флажок активен (например, для категории ''Госпошлина''), система:
#** Проверяет предыдущие сообщения.
#** Если диалог начался в другой категории (например, СНИЛС), запросы объединяются (''"склеиваются"'').
#** Если контекст отсутствует, тематика меняется, но поиск ответа ведется сразу по обеим категориям (СНИЛС + Госпошлина).

'''Когда использовать'''

Активируйте эту настройку для категорий, которые могут:

* Быть частью более широкого запроса (например, ''Госпошлина'' как дополнение к ''СНИЛС'').
* Требовать сохранения контекста диалога.

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

===== Индикация удаленных категорий =====
Система визуально выделяет удаленные категории для привлечения вашего внимания:

# Конечные точки с недействительными категориями в табличном представлении: помечаются специальным значком и выделяются красным цветом. При наведении на значок сообщение: ''«Используются несуществующие категории в канала: [название_канала](кол-во)»''
# В облаке конечных точек: КТ с недействительными категориями также отображаются красным цветом, но без значка.
# В условиях присвоения категорий: Если используется удалённая категория, система отобразит предупреждающее уведомление ''«Используются несуществующие категории: [кол-во]»''.

Это позволяет быстро находить и корректировать объекты, которые зависят от неактуальных данных. А так же это важно для экспорта и импорта роботов (см. разд. Панель управления).

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

==== Связанная фильтрация ЭД и КТ ====
В интерфейсе реализована связанная фильтрация между таблицами Элементов Данных (ЭД) и Контрольных Точках (КТ). Это позволяет автоматически находить взаимосвязанные объекты.

'''Принцип работы:'''

* Фильтрация по ЭД: При вводе названия в фильтр таблицы Элементов Данных:
** В таблице ЭД отображаются только те элементы, названия которых соответствуют фильтру.
** Одновременно в таблице КТ автоматически отображаются только те Контрольные Точки, в которых используются отфильтрованные ЭД.

* Фильтрация по КТ: При вводе названия в фильтр таблицы Контрольных Точек:
** В таблице КТ отображаются только те точки, названия которых соответствуют фильтру,
** Одновременно в таблице ЭД автоматически отображаются только те Элементы Данных, которые используются в отфильтрованных КТ.

<blockquote>'''Важно''':

Система учитывает использование Элементов Данных во всех типах Контрольных Точек:

1. Входные данные (вход).

2. Собираемая информация (условия запуска/сбор информации).

3. Условия запуска действий.</blockquote>

==== Тестирование робота ====
[[Файл:2025-10-06 11-49-26.png|мини|307x307пкс|''Рис. 21 Окно чата для тестирования робота'']]
В интерфейсе SES есть чат с отладчиком (рис. 21), где вы можете протестировать работу сценарной машины. Чтобы открыть чат-отладчик, нажмите на значок [[Файл:Чат.png|безрамки|20x20px]] в правом нижнем углу рабочей области. В самом верху располагается выпадающий список с каналами связи. Справа от списка — кнопка '''«Перезапустить сессию»''' [[Файл:Обновить данные вопроса.png|безрамки|20x20px]], которая сбрасывает всю переписку и данные отладчика. А слева — кнопка '''«Данные сессии»''' [[Файл:Кнопка отладчик без полей.png|безрамки|20x20px]], предоставляет возможность в режиме отладки увидеть все данные, полученные от моделей. В окне отладчика есть параметр qas, где отображается запрос, который отправился в QAS и не только, подробнее см. раздел [[SES. UPS руководство по работе с интерфейсом#Данные сессии|Данные сессии]]. И кнопка '''«Тестирование скрипта»''' [[Файл:Пробирки.png|безрамки|20x20пкс]], подробнее [[SES. UPS руководство по работе с интерфейсом#Тестирование скриптом|тут]]. Есть возможность отправлять в чат файлы нажав на [[Файл:Скрепка.png|безрамки|20x20пкс]] и выбрав файл (в любом формате).

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

Режим отладки (дебаг):

* В режиме отладки появилась панель логов.
* Логи автоматически обновляются после каждого ответа от робота.
* Вместе с логами также обновляются данные текущей сессии.

Настройки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] чата позволяют выбрать настройки аудиоответов, а так же установить переменные, например, номер телефона.

Еще в меню настроек можно выбрать КТ по ручному запуску, чтобы протестировать работу КТ и сценария (рис. 22).
[[Файл:2025-10-20 10-56-18.png|мини|300x300пкс|''Рис. 22 Выбор конечной точки для тестирования.'']]

===== Тестирование в текстовых каналах =====

===== Данные сессии =====
Раскрыв данные сессии можете увидеть, все данные о текущем диалоге с роботом. Разберем по порядку, ниже представлены некоторые данные из ключа root, они нужны не все, разберем только нужные:<blockquote>
"started":"2025-06-10 09:46:05" — ''время начала сессии''

"modified":"2025-06-10 09:49:08" — ''когда произошли изменения последние (пришел запрос/изменилась тематика)''
"robot":"ffeaa99a-13d2-4bff-b458-1231c884f8ee" — ''id робота, у продовой версии будет приписка _prod''

"session":"beefb6a2-dc08-47d4-9e02-2495329173ec" — ''id сессии''

"channel":"default" — ''активный канал, в котором происходит тестирование''

"connector":"web"

"unknown":false.
</blockquote>
[[Файл:2025-10-06 12-45-38.png|мини|''Рис. 23 Пример работы с отладчиком'']]
Далее идет самая интересная для аналитиков часть - <code>"current"</code> . Раскрыв этот ключ можно посмотреть в какую конечную точку привёл сценарий, и была ли запросу присвоена какая-либо категория. А так же параметр ''data'', раскрыв который можно увидеть все классы (рис. 23 и 23.1), которые пришли от модели [[SMC. UPS руководство по работе с интерфейсом|SMC]] и/или модели [[SEE. UPS руководство по работе с интерфейсом|SEE]] и их достоверность и вес. Раскрыв в ''data'' параметр ''reply -'' увидеть данные ответа от робота. Имея все эти данные можно отладить работу сценария.
[[Файл:2025-10-06 12-47-26.png|мини|''Рис. 23.1 Работа с отладчиком. Просмотр параметра data и логов'' ]]
<blockquote>"current":{

"id":"Консультация ЧаВО" — конечная точка, в которую привел сценарий,

"qas":"оформить снилс" — запрос, который отправился в QAS.

}<blockquote>'''Обратите внимание:''' если параметр QAS в отладчике пустой, это значит, что ваш запрос не был передан в QAS. Если же в этом параметре отображается ваш запрос, но робот просит вас перефразировать его, то, вероятно, в базе данных не хватает формулировки с ответом или на ответе отсутствует пометка «проверено». Это может происходить, когда в настройках КТ, отвечающей за консультирование из базы данных QAS, установлен параметр «Использовать кэш ответов» в режиме «Только проверенные ответы». </blockquote>'''Отработка склеек и удержания контекста''': в QAS летит вообще вся история сообщений в рамках одного контекста общения '''через разделитель «|»'''. Модель генерации будет отвечать на последний вопрос в цепочке с учетом ранее написанных сообщений в этом контексте.

"answered":true — был ли ответ true/false
"category":[0:"МФЦ НСО СНИЛС"] — отображается список категорий, в которые попал вопрос (их может быть больше одной).

"nearest":NULL

''Следующий кусок ключа current проще объяснить на примере запроса "оформить паспорт":''

"entry":"entry":[0:"Паспорт, вес 3" ] — зашли в КТ по метке «Паспорт», запросили тип паспорта (загран), старый/новый образец и дошли до возраста получателя:

"missingRunData":[

0:"Возраст заявителя для заграна, вес 3"] — тут отображаются ЭД, которые нужны для «пропуска» дальше в действия.

"passedRunData":[ ] — список условий AND, который выполнился.

"waitingRunData":

"Возраст заявителя для заграна, вес 3" — отображается ЭД, который запросили и ждем получения.

"border":0 — отражает границу, от которой система смотрит на данные. Например, при border:1 - система будет смотреть от 2-го ЭД в списке data и ниже. При border:0 - с первого.

"preborder":0

}</blockquote><blockquote>"models":[...] — раскрыв список, можно посмотреть все модели, которые отработали за сессию.

"scripts":[] — отображает список скриптов, которые отработали за сессию.

"data":[...] — раскрыв data, можно увидеть параметр "message" — фраза-сообщение пользователя. И под каждым message, есть своя data, где находятся все метки и все тэги, пришедшие от моделей SMC и SEE на эту фразу.

"timers":[...]

"variables":{} — тут отображаются пришедшие переменные, если есть.

"error":"" — выводит ошибку при отработке скрипта.

"events":{ — параметр отображает счетчики событий за сессию (не найдено/нет данных/тишина).

"not found":{...}

"no data":{...}

"silence":{...}

}</blockquote>

[[Файл:2025-06-10 16-15-43.png|мини|''Рис. 24 Окно автотестирования скриптов'']]

===== Тестирование скриптом =====
[[Файл:2025-06-10 16-22-59.png|мини|''Рис. 25 Добавление скрипта для тестирования'']]
[[Файл:Тестирование скриптов.png|мини|''Рис. 26 Интерфейс окна «Тестирование скриптов»'']]
Теперь вы можете автоматически тестировать робота с помощью скриптов. Например, если у вас возникли сложности с маршрутизацией и нет желания каждый раз вручную воспроизводить весь диалог при отладке сценария, вы можете сохранить его для последующего тестирования. Для этого кликните на кнопку [[Файл:Пробирки.png|безрамки|20x20пкс]] справа от чата появится окно. Добавить скрипт можно путем '''''импорта из файла''''' [[Файл:Импорт нов.png|безрамки|20x20пкс]], если есть данные '''в формате txt''' или '''''импортировать диалог''''' из текущей сессии. Нажмите на иконку импорта или выберите ''«Скрипт»'' в выпадающем меню и нажмите '''''«Добавить скрипт»''''' (рис. 24). Появится диалоговое окно «''Добавление скрипта»''. Введите название скрипта, выберите файл и нажмите ''«Добавить»''. Если у вас уже открыта сессия, отметьте в окне добавления скрипта опцию '''''«Импорт из чата»'''.'' Если у вас несколько скриптов, переключаться между ними можно через выпадающий список ''«Скрипт».''

Правее него находятся иконки ''импорт'' [[Файл:Импорт нов.png|безрамки|20x20пкс]], ''экспорт'' [[Файл:Экспорт нов.png|безрамки|20x20пкс]] и ''удалить'' [[Файл:Удаление документа.png|безрамки|20x20пкс]]. Импорт был описан ранее. '''''Экспорт''''' позволяет выгрузить скрипт в формате txt. Кнопка '''''удалить''''' - удаляет весь скрипт.

Файл для импорта и экспорта - это простой текстовый файл, в котором все запросы к роботу, каждый с новой строки.

Галочки обозначают точки останова (рис. 25). Когда они стоят, автотест останавливается и ждет, пока вы нажмете кнопку «Дальше». параллельно можно открыть отладчик и смотреть, что происходит на каждом этапе теста.

У тестирования есть два основных режима:

# Полный тест:
#* Все галочки сняты
#* Тест выполняется автоматически от начала до конца, без остановок
# Пошаговый режим:
#* Тест останавливается на каждом шаге
#* Для продолжения нужно нажимать "Дальше"

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

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

Последняя отправленная фраза будет выделена голубым цветом.

===== Просмотр данных сессии =====
Эта функция позволяет вам в реальном времени отслеживать диалоги и данные сессии у другого пользователя в '''рамках одного бота'''.

'''Подключение к отслеживанию'''

# Нажмите на иконку «Просмотр сессии» [[Файл:2025-10-22 12-54-24 (1).png|безрамки|20x20пкс]] . Введите название переменной, за которой хотите следить и ее значение (если требуется, например, номер телефона абонента) в соответствующие поля.
# Нажмите кнопку «Подключиться».
# Меню закроется, и вы увидите всплывающее уведомление с подтверждением успешного подключения.
# В основном интерфейсе индикатор отслеживания (иконка «Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]) изменит свой вид: он будет зачеркнут и периодически мигать. Это сигнализирует о том, что соединение активно и система ожидает данные.
Как поступают данные:

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

'''Отключение от отслеживания'''

Чтобы прекратить отслеживание, выполните одно из следующих действий:

* Нажмите на индикатор отслеживания («Отключиться от сессии» [[Файл:2025-10-22 13-12-08 (1).png|безрамки|21x21пкс]]), который активен в режиме подключения.
* Выполните команду «Сброс сессии» [[Файл:Обновить данные вопроса.png|безрамки|20x20пкс]].

Любое из этих действий разорвет соединение для отслеживания, и индикатор вернется в обычное состояние.

'''Пример настройки просмотра сессии'''

Пользователь, за чьим диалогом будет наблюдение, должен создать у себя переменную (любую) и ее значение:

* <code>variable = за мной следят</code>

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

Пользователь, который хочет подключиться для просмотра, должен в своем разделе ''просмотра сессии'' создать точно такую же переменную:

* <code>variable = за мной следят</code>

И после того, как начнется диалог, в режиме реального времени наблюдатель будет видеть все данные сессии того, кто ведет диалог с роботом.<blockquote>'''Функция для пользователей UPS'''

Для более удобного отслеживания вы можете использовать уникальный <code>id пользователя UPS</code> , который передается в переменные сессии.

* Вместо того чтобы указывать одинаковые переменные у обоих пользователей, вы можете напрямую указать <code>id пользователя</code>, за которым хотите следить.
* Это позволяет вам следить за конкретным пользователем, при этом ему не обязательно вручную задавать у себя переменную.
</blockquote>

===== Тестирование голосовыми сообщениями и в голосовом канале =====
[[Файл:2025-06-10 12-44-58.png|мини|''Рис. 27 Тестирование робота с помощью микрофона.'']]
Робота можно протестировать, задавая вопросы голосом и/или вводя переменные. Например, можно проверить, как робот отправляет в разные конечные точки, получая одинаковые метки от SMC и номера телефонов различных ведомств. Например, метка «Мобилизация» от SMC в сочетании с номером телефона МФЦ приводит в КТ Консультация ЧаВО, а «Мобилизация» и номер единого контактного центра (ЕКЦ) — в КТ Перевод на оператора. Чтобы провести тестирование робота с переменными раскройте меню, кликнув на иконку шестеренки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] и заполните поля:

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

- Значение: укажите значение этой переменной..
[[Файл:2025-10-06 11-51-58.png|мини|''Рис. 28 Иллюстрация тестирования канала voice.'']]
В этом же меню вы можете настроить параметры аудиоответов и автовоспроизведения.

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

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

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

В дебаггере есть функция, позволяющая протестировать '''голосовой канал - voice''' (рис. 28), то есть ''имитировать звонок''. Чтобы запустить процесс, достаточно нажать на кнопку «Начать разговор» [[Файл:Начать разговор.png|безрамки|20x20пкс]] . Пока разговор активен, кнопка изменится на «Закончить разговор» [[Файл:Закончить разговор.png|безрамки|20x20пкс]] . Переменные задаются в меню, как и в текстовом канале. Для этого нажмите на иконку шестерёнки [[Файл:2025-10-06 11-48-13.png|безрамки|20x20пкс]] (рис. 21).

=== Архив диалогов ===
[[Файл:Архив диалогов нов.png|мини|''Рис. 29 Интерфейс архива диалогов'']]
После тестирования робота в любом канале можно заглянуть в Архив диалогов (рис. 29), чтобы изучить данные сессии. Для этого необходимо кликнуть на одноименную кнопку на панели инструментов рядом с кнопками версий робота [[Файл:Архив диалогов.png|безрамки|20x20пкс]]. Интерфейс архива содержит:

* Список доступных роботов слева на экране.
* Блок с фильтрацией диалогов.
* До момента пока вы не выберете диалог из списка справа будет пустой блок с текстом «Выберете диалог». После того как диалог выбран вы увидите отображение аналогичное рисунку 29.
* Информационные вкладки (см. в разделе [[SES. UPS руководство по работе с интерфейсом#Настройка робота|«Настройка робота»]]).

==== Работа с архивом диалога ====
Архив диалогов поддерживает версионность робота, то есть можно просмотреть диалоги одной из трех версий: черновик, прод или архивной. Для этого кликните по кнопке с нужной версией находясь уже в Архиве либо предварительно выбрав ее и перейдя в архив. Диалоги в архиве фильтруются по дате и времени, для этого кликните на иконку календаря [[Файл:Календарик с фоном.jpg|безрамки|20x20пкс]] в поле «Начало» и «Конец», чтобы выбрать дату. И время, кликнув на иконку часов ''(по умолчанию дата и время выставляются за текущие сутки)''. Выберите нужную дату и время, добавьте необходимые фильтры. Также можно отфильтровать звонки по:

# каналам связи:
* default,
* telegram,
* web,
* voice,
* vkontakte.
2. элементам данных — при нажатии на это поле открывается перечень всех элементов данных из сценария текущего робота.

3. номеру телефона,

4. ID диалога, берется из отладчика - значение атрибута session,

5. по названию и значению переменной,

3. либо тексту, либо ключевым словам, которые могут быть в искомом диалоге.

После настройки система, по нажатию кнопки «Поиск», отобразит все диалоги с роботом, учитывая выбранные фильтры (рис. 27). На самом верху над диалогом можно просмотреть его ID. В архиве диалоги сгруппированы по принципу «запрос от пользователя — ответ робота». При выборе каждой пары открывается отладчик, где можно увидеть метки и теги, полученные от моделей, копия [[SES. UPS руководство по работе с интерфейсом#Тестирование робота|отладчика]] из тестирования робота. Этот отладчик аналогичен тому, что используется в сценарной машине. Для голосового канала есть возможность прослушивания аудио диалога помимо текстового просмотра. Также есть возможность импортировать запросы диалога в скрипт тестирования в чат-отладчик по кнопке '''«Добавить в скрипт тестирования»''' снизу диалога и в появившемся окне введите название скрипта тестирования. После чего он появится в списке скриптов тестирования сценария.

Для вашего удобства во время ''активного'' диалога в архиве доступна кнопка '''«Следить за диалогом»'''. Нажмите кнопку «Следить за диалогом» во время просмотра архива ''активного'' диалога. Система начнёт автоматически обновлять список реплик, подгружая новые сообщения. Обновление происходит каждые 5 секунд, обеспечивая актуальный вид беседы без необходимости обновлять страницу вручную.

'''Назначение функции:''' Позволяет в реальном времени следить за развитием ещё не завершённого диалога, например, во время тестирования или активного общения с рогботом.

Чтобы '''выйти из Архива диалогов''' в сценарий нужно снова кликнуть на иконку [[Файл:Архив диалогов.png|безрамки|20x20пкс]].

=== Пользовательские справочники ===
[[Файл:Photo 2025-05-14 17-30-31.jpg|мини|''Рис. 30 Добавление пользовательского справочника'']]

Для доступа к справочнику нажмите на значок «Пользовательский справочник» [[Файл:Справочник (1).png|безрамки|20x20пкс]] на панели инструментов справа от архива диалогов. Чтобы создать новый справочник, нажмите кнопку '''«Добавить справочник»''' (рис. 30). В открывшемся окне заполните обязательные поля: название справочника и его структуру — наименования колонок. При необходимости задайте значения по умолчанию для каждой колонки. Эти значения будут автоматически заполнять новые строки. Затем нажмите '''«Добавить»'''.

Если значения по умолчанию не указаны, справочник будет пустым. Заполнять таблицу можно вручную.

Справочники можно переименовывать и удалять. Чтобы переименовать или удалить справочник, наведите курсор на его название. Появится две иконки: карандаш для переименования и корзинка для удаления. <blockquote>'''Перед переименованием справочника ''обязательно'' сохраните внесенные изменения, иначе они будут удалены.'''</blockquote>[[Файл:2025-05-20 14-45-35.png|мини|''Рис. 31 Удаление записей из пользовательского словаря'']]
При нажатии на карандаш откроется окно '''«Редактирование структуры».''' Важно помнить: изменения можно внести только в название справочника или в значения по умолчанию (если предыдущие значения были, они будут автоматически обновлены). ''Переименовать столбцы нельзя.'' После сохранения изменений нажмите кнопку '''«Сохранить»''', расположенную внизу под таблицей (рис. 31). <blockquote>'''Внимание! Справочники зависят от версии робота.''' Если вы вносите изменения в структуру справочника в черновой версии [[Файл:Черновик.png|безрамки|20x20пкс]], то для применения этих изменений в продовой версии нужно применить робота в прод.

'''Важно:''' переносится '''только структура справочника'''. Данные не дублируются. Их можно перенести вручную, экспортировав [[Файл:Экспорт нов.png|безрамки|20x20пкс]] из черновика и импортировав [[Файл:Импорт нов.png|безрамки|20x20пкс]] в прод. </blockquote>Вы можете фильтровать записи по содержанию любой колонки. Выделите галочками несколько записей сразу и удалите их. В правом нижнем углу появится иконка корзины, как только вы выберете хотя бы одну запись (рис. 31).

Справочники можно ''экспортировать'' и ''импортировать''. Экспорт и импорт осуществляются в формате JSON.
[[Файл:Снимок экрана 2025-07-16 175752.png|мини|''Рис. 32 Импорт пользовательского словаря'']]

''При импорте структуры импортируемого файла и справочника в интерфейсе должны совпадать''. Если они не совпадают, то заполнятся только совпадающие поля. Есть возможность ''импорта'' с дополнением новых данных, либо полной заменой (''Рис. 32''). Структура экспорта:<blockquote>
[

{"колонка1":"значение 1","колонка2":"значение 2","колонка3":"значение 3","id":"58845671-1150-4ae2-9c46-e8aeb2553c57"},

{"колонка1":"значение 2","колонка2":"значение 2","колонка3":"значение 3","id":"2e0a7f8e-6d64-4df9-a3ce-5862f8eb441c"}

]
</blockquote>Структура json-файла для импорта:<blockquote>[

{"колонка1":"значение 4","колонка2":"значение 5","колонка3":"значение 6"},

{"колонка1":"значение 2","колонка2":"значение 3","колонка3":""}

]

При импорте не обязательно указывать id.</blockquote>Чтобы '''выйти из Пользовательских справочников''' в сценарий нужно снова кликнуть на иконку [[Файл:Справочник (1).png|безрамки|20x20пкс]].

=== Панель управления SES ===
Панель управления SES включает в себя 8 кнопок: импорт, экспорт, обнуление черновика рабочей версией, применение робота, восстановление робота, применение настроек робота, массовая замена моделей в элементах данных и меню пользователя.

{| class="wikitable"
|+''Табл. 2 Описание функционала панели управления''
!'''Иконка кнопки'''
!'''Название иконки'''
!'''Описание'''
|-
|[[Файл:Export.png|центр|безрамки|40x40пкс]]
|Экспорт
|Для создания резервной копии или переноса робота выполните его экспорт в ZIP-архив. В архив будут включены все настройки робота: элементы данных, конечные точки, скрипты, структуры пользовательских справочников (''но не включая сами данные''), а также связанные модели и базы данных QAS.<blockquote>'''Внимание!''' Перед экспортом убедитесь, что категории и модели актуальны. В противном случае экспорт может завершиться ошибкой, и робот не будет экспортирован.</blockquote>
|-
|[[Файл:ImportRobot.png|центр|безрамки|40x40пкс]]
|Импорт
|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''.|Импорт .zip архива робота в систему ''(кнопка активна только в версии черновика)''. Аналогично экспорту, доступен и импорт робота с моделями SMC, SEE и QAS в различные наборы данных.
<blockquote>'''Как работает импорт:'''

* Автоматическая проверка: При импорте система сравнивает названия новых элементов с уже существующими в вашем наборе данных.
* Автозамена при совпадении: Если название элемента уже существует, происходит полная замена старого элемента новым, включая продовые модели SMC и SEE.
* '''Предупреждение:''' Перед заменой система покажет предупреждение.
'''Важные правила:'''

# Всегда создавайте копию данных перед импортом.
# Проверяйте, что и куда импортируете.
# '''Возможные последствия:''' импортированные данные '''перезапишут''' существующие с таким же названием.
</blockquote>
|-
|[[Файл:Стрелка.png|безрамки|40x40px|центр]]
|Обнулить черновик рабочей версией
|Эта функция позволяет заменить черновик рабочей версией. Она копирует текущую рабочую версию и сохраняет её как черновик, при этом сама рабочая версия остаётся без изменений ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Применить.png|безрамки|40x40px|центр]]
|Применить
|По нажатию на эту кнопку черновая версия робота становится рабочей ''(кнопка активна только в версии черновика)''.
|-
|[[Файл:Откат.png|центр|безрамки|40x40px]]
|Восстановить
|С помощью этой функции можно восстановить версию из архивной. При этом текущая рабочая версия становится архивной ''(кнопка активна только в архивной версии)''.
|-
|[[Файл:Разетка.png|центр|безрамки|40x40px]]
|Применить настройки робота
|Применяет сохранённые настройки робота и начинает работать в соответствии с ними, что аналогично перезагрузке программного обеспечения, но без необходимости самой перезагрузки.
После нажатия на кнопку система переносит эти настройки в настройки прода, но НЕ ПРИМЕНЯЕТ, на случай, если ошиблись.

Робот в любой версии начинает работать с новыми настройками только после нажатия на кнопку. Если вы нажали на кнопку, находясь в черновике, будут применены настройки черновика. Если же вы нажали на кнопку, работая в рабочей версии, то будут применены настройки рабочей версии, которые вы только что перенесли из черновика. <blockquote>Обратите внимание: после внесения каких-либо изменений кнопка будет красной [[Файл:Красная вилка (1).png|безрамки|20x20пкс]] и пульсировать, напоминая о необходимости применить настройки. </blockquote>
|-
|[[Файл:Смена моделей.png|центр|безрамки|40x40пкс]]
|Массовая замена моделей в элементах данных
|[[Файл:Замена моделей в ЭД.png|мини|''Рис. 33. Массовая замена моделей в элементах данных'']]Эта функция позволяет массово менять модели в элементах данных. После нажатия на кнопку появляется форма ''(Рис. 33)'', в которой необходимо указать тип элемента данных ''(Класс / Сущность)''. Затем в поле '''"Заменяемая модель"''' выбрать модель из списка моделей, используемых в уже существующих элементах данных ''(снизу будет указано количество элементов данных, использующих выбранную модель)'', и в поле '''"Заменяющая модель"''' выбрать доступную модель для замены. После нажатия на кнопку '''"Заменить"''' будет произведена замена выбранной модели в тех элементах данных, в которых она используется.
|-
|[[Файл:Меню пользователя new.png|безрамки|40x40px|центр]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, убрать/показать фон, выход из системы), а также возможность переключить ''отображение рабочей области с табличного на облачный вид и наоборот''.
В меню пользователя добавлена функция ''выбора набора данных*.''

При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе.

*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.
|}

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