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

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

# [[SMC. UPS руководство по работе с интерфейсом|SMC Классификатор]],
# [[SEE. UPS руководство по работе с интерфейсом|SEE Сущности]],
# [[SPR. UPS руководство по работе с интерфейсом|SPR Распознавание]],
# [[SBS. UPS руководство по работе с интерфейсом|SBS Биометрия]],
# [[TTS. UPS руководство по работе с интерфейсом|TTS Синтез]],
# QAS ЧаВО,
# [[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 руководство по работе с интерфейсом#Вкладка «Интерактив»|«Интерактив»]];'''
*вкладка '''«Каналы»''' содержит список всех созданных каналов, можно как редактировать уже существующие, так и добавлять новые;
*вкладка '''«Категории»''' содержит список всех созданных категорий, можно как редактировать уже существующие, так и добавлять новые. Есть фильтрация по названию;
*информационная вкладка '''«Серверы»''', которая отображает информацию о серверах и процессах, находится в правом нижнем углу рабочей области.
[[Файл:Photo 2025-05-21 12-43-54.jpg|мини|''<small>Рис. 2 Рабочая область сервиса «ЧаВО»</small>'']]

==== Вкладка «Документы» ====
Во вкладке «Документы» вы найдёте инструменты для работы с документами. Эта вкладка включает в себя следующие функциональные блоки (рис. 2):

* панель управления;
* блок со списком документов содержит поиск по названию и фильтрацию по категориям. При необходимости эту область можно скрыть, кликнув на стрелочку '''Спрятать боковую панель''' между списком документов и блоком для редактирования (появляется при наведении мыши на середину между блоками);
* добавление нового документа в базу;
[[Файл:Photo 2025-05-21 12-43-54 (2).jpg|мини|''<small>Рис. 3 Пример отработки кнопки «Очистить текст»</small>'']]
*блок '''«Редактирование документа»''' с полями: «Название», «Дополнительно» и текстом выбранного файла, который можно редактировать. Можно переименовывать файл, после чего нужно сохранить изменения. Кнопка сохранения становится активной как только будут внесены изменения. Чтобы сделать текст более читабельным, его можно очистить от лишнего. Для этого нажмите кнопку '''«Очистить текст»''', которая находится под основным блоком слева от '''«Сохранить»''', предварительно выбрав шаблон запроса, если требуется. Или воспользуйтесь кнопкой на [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Документы»|панели управления]] [[Файл:2025-10-08 15-19-11 (1).png|безрамки|20x20пкс]]. 
<blockquote>'''Важно:''' при уже запущенном процессе очистки кнопка остановит текущий процесс отчистки.</blockquote>После завершения очистки справа появится окно с изменениями. Кнопка, открывающая данные по очистке позволяет просмотреть так же:

* Прогресс выполнения (%)
* Позицию в очереди (правило '''«один аккаунт — одна операция очистки»''')
* Результаты обработки. Если находитесь в документе, для которого очистка запускалась, то внизу на вкладке будет кнопка '''«Заменить в документе»'''. В противном случае - '''«Открыть исходный документ»''' и, после того как перейдете в нужный документ, кнопка сменится на '''«Заменить в документе».'''

Вы сможете сравнить исходный и очищенный текст. Если нужно внести правки, их можно сделать прямо в блоке с очищенным документом. После проверки и внесения правок, если все устраивает, нажмите '''«Заменить в документе»''' под блоком с очищенным текстом. Изменения вступят в силу. ''Не забудьте сохранить документ.'' Рядом с этой кнопкой есть '''«Закрыть»'''. Она закрывает окно с очищенным текстом без сохранения изменений. 
<blockquote>Для очистки текста, ''который не загружен в базу данных'' QAS, используйте режим «Очистка текста» на вкладке «Интерактивный режим».</blockquote>
*блок поиска фрагментов по базе.


[[Файл:2025-10-08 15-24-58.png|мини|''<small>Рис.4. Добавление нового файла</small>'']]

===== <u>Добавление файла в список</u> =====
В нижней части блока со списком файлов есть кнопка '''«Добавить файл»'''. Если нажать на нее, то появится диалоговое окно, как показано на рисунке 4. Чтобы добавить файл, нужно заполнить все необходимые поля и выбрать нужный файл с компьютера, в кодировке '''Unicode UTF-8'''. 

Поддерживаемые '''форматы''':

* .odt
* .docx
* .doc
* .rtf
* .ods
* .xlsx
* .xls
* .pdf
* .txt.

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



===== <u>Функционал меню «Дополнительно»</u> =====
[[Файл:2025-05-23 17-11-07.png|мини|''<small>Рис. 5 Иллюстрация функций кнопки Дополнительно</small>'']]
На вкладке дополнительно вы можете посмотреть: 

* категорию к которой относиться документ,
* глоссарий, в котором укажите название объекта из документа (рис. 5), а также его синоним в соответствующих полях внизу страницы. Это поможет модели лучше понимать, о чём её спрашивают. Например, научить ее тому, что «госпошлина = пошлина», «загранник = загранпаспорту», «загранпаспорт = заграничному паспорту», а «загранпаспорт нового образца = загранпаспорту на 10 лет» и нажмите кнопку добавить. 
<blockquote>Поиск в базе работает '''на основе векторного анализа текста'''. Чтобы система точнее находила нужные документы, важно выделить ключевые термины и создать глоссарий.

Как это сделать:

# Внимательно изучите документ.
# Выпишите основные термины и их возможные синонимы.
# Внесите их в глоссарий в формате: ''основной термин = синоним''.

Пример:

Если в документе слово ''«апостиль»'' иногда называют «''услугой»,'' укажите в глоссарий:

<code>апостиль = услуга</code>.</blockquote>Предусмотрено массовое удаление синонимов, для этого выделите нужное галочками. Кликнув на поле с фразами вы можете отредактировать формулировку. После внесения изменений нажмите кнопку '''«Сохранить»'''. Она станет активной сразу же после того, как вы внесете какие-либо изменения в документ. Эта кнопка является дубликатом кнопки '''«Сохранить»''' в блоке редактирования документа.
* есть кнопка для экспорта глоссария, если это необходимо в формате .csv.
* а так же доступен импорт с тремя опциями: дополнить, заменить и отменить импорт.
* здесь же находится кнопка для удаления документа.


===== <u>Поиск фрагментов в документах</u> =====
Поиск фрагментов — это первый этап для ответа на вопрос. Система сначала ищет фрагмент (фрагменты) в документах, после отправляет их вместе с промптом на модель генерации.

Блок '''«Поиск фрагментов по базе»''' позволяет найти фрагменты, которые имеют векторную близость с вопросом, введенным в поле с названием '''«Вопрос»'''. Под этим полем находится выпадающий список '''«Категория»''', если выбрать нужную из списка, модель будет искать совпадения в документах этой категории, иначе – во всех документах в базе. Результат поиска отображается снизу после нажатия на кнопку «Поиск».
Теперь вы можете настроить '''количество документов''', в которых будет осуществляться поиск фрагмента, соответствующего вашему вопросу. Это число определяется интуитивно: ''чем больше вы выберете документов, тем меньший контекст будет извлечён из каждого документа'', что в свою очередь может привести к ошибочному ответу далее. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх. Также можно указать «'''Максимальное снижение порога»''' в процентах (по умолчанию 10%). Он определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов.<blockquote>МСП позволяет установить минимальный порог сходства для отбора релевантных фрагментов, исходя из наилучшего найденного результата.

'''Алгоритм:'''

* '''Задание параметра:''' Пользователь указывает значение '''«Максимальное снижение порога»''' (например, 15%).
* '''Определение максимума:''' Система находит фрагмент с ''наибольшим процентом сходства'' с вопросом (максимальное сходство).
* '''Расчет минимального порога:'''
** Вычисляется минимально допустимый уровень сходства по формуле:  '''Минимальный порог = Максимальный порог - Максимальное снижение порога'''
** Пример: Если максимальное сходство = 97%, а допустимое снижение = 15%, то минимальный порог будет равен 82%.

* '''Фильтрация:''' Система отбирает все фрагменты, процент сходства которых находится в диапазоне от '''рассчитанного минимального порога''' до '''максимального сходства'''. 

* '''Формирование ответа:''' Итоговый ответ генерируется на основе отфильтрованного набора фрагментов.   То есть для расчетов из примера фрагменты, на основе которых будет генерироваться ответ, должны находиться в диапазоне [82%;97].
</blockquote>



===== <u>Панель управления вкладки «Документы»</u> =====
В верхней части экрана располагается панель управления, на которой находятся кнопки: ''генерация ответов, экспорт документов, очистка документа, массовая обработка вопросов, задать вопрос'' и ''меню пользователя.''
{| class="wikitable"
|+<small>''Табл. 1 Описание функционала панели управления.''</small>
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл:Сохранить 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пкс]]
|Задать вопрос<sup>1</sup>
|генерирует ответ на вопрос на основе информации, содержащейся в одном или нескольких документах.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы, шаблоны)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
<small>*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.</small>
|}
[[Файл:Ask.png|мини|<small>Рис. 6 Блок «Задать вопрос»</small>|589x589пкс]]
<sup>1</sup> По нажатию на кнопку '''«Задать вопрос»''' (рис. 6), появляется диалоговое окно с полями:

'''«Вопрос»''' — это область для ввода вопроса.

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

'''«Канал»''' - список созданных каналов связей.

'''«Модель генерации»''' - список доступных моделей

'''«Шаблон запроса к LLM»''' - шаблон запроса (промпт) к модели генерации.

'''«Использовать кэш ответов»''' - в этом меню можно выбрать, использовать ли только проверенные ответы или любые.

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

'''«Максимальное снижение порога, %»''' - определяет допустимую разницу между максимальной и минимальной релевантностью фрагментов при фильтрации результатов.

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


===== <u>Добавление новых и редактирование вопросов</u> =====

''Вопросы в QAS могут быть трех видов:''

'''Кандидаты''' — это новые запросы к системе, которые, по мнению самой системы, являются семантически близкими к основному вопросу и его формулировкам. Чтобы перевести кандидата в формулировки, нужно ''утвердить'' их (подробнее см. [[QAS. UPS руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|разд. Режим работы "Утверждение кандидатов"]])

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

'''Основной вопрос''' — это новый вопрос, который ранее не существовал в базе данных QAS, а также не имел семантически близких аналогов. Каждому основному вопросу присваивается категория. Он может включать дополнительные формулировки и кандидатов.


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

* категорию вопроса;

* текст вопроса.

Чтобы ''отредактировать'' уже существующий вопрос, нужно выбрать его из списка. После этого его текст и ответы появятся в блоке для редактирования, который находится в середине страницы. Если вопрос слишком длинный и не помещается в одну строку, просто нажмите на него, и он будет развёрнут.    [[Файл:2024-10-14 15-55-53.png|мини|''<small>Рис. 8 Интерфейс вкладки «Дополнительно»</small>'']]


Меню '''«Дополнительно»''' включает в себя следующие опции:

- изменение формулировки основного вопроса,

- изменение категории вопроса (перенос в другую категорию) осуществляется путём выбора из списка доступных категорий, расположенного в верхней части окна (рис. 8). Вопрос будет перенесен без потерь со всеми ответами, кандидатами и формулировками.

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

Поэтому мы создаём короткие вопросы, помечаем их как «неполные» и добавляем уточняющие вопросы в ответ. Например: «Уточните, пожалуйста, что именно вы хотите узнать по поводу детского сада?» Получив такой вопрос, абонент должен будет уточнить свои потребности, а затем робот объединит оба запроса и выдаст ответ, если он есть в базе данных QAS.</blockquote>- добавление, удаление или перенос. Чтобы удалить формулировку, необходимо навести курсор на нужную фразу. После этого справа появятся две кнопки (см. рис. 8). Одна из них в виде ''стрелочки'' предназначена для того, чтобы сделать эту формулировку ''основным вопросом''. А кнопка в виде ''корзинки'' позволяет удалить выбранную фразу. Есть возможность удалять несколько формулировок, для этого нужно выбрать формулировки для удаления и нажать на кнопку ''Удалить,'' рядом с кнопкой ''Переместить.''

- есть возможность переместить формулировки и/или кандидатов в другой вопрос. Для этого поставьте галочку напротив нужной фразы и нажмите кнопку «Переместить». В появившемся диалоговом окне выберите нужный вопрос (вы можете предварительно отфильтровать вопросы по категориям). Выберите, из выпадающего списка куда следует переместить выбранные вопросы: в формулировки или в список кандидатов, — и нажмите кнопку «Переместить». После этого '''обязательно''' сохраните изменения в текущем вопросе. <blockquote>'''Обращаем ваше внимание,''' что если вы указываете, что перемещение должно быть выполнено <u>в кандидаты</u>, то вам необходимо будет затем перейти и ''утвердить'' кандидата.</blockquote>- так же вы можете ознакомиться со списком ''кандидатов'', который включает формулировки, близкие по смыслу к основному вопросу. Если среди них есть подходящие варианты, отметьте их галочкой и нажмите кнопку «Утвердить». После этого выбранные формулировки появятся в общем списке «Формулировки». ''Добавление большого количества разных формулировок необходимо, чтобы модель могла понимать суть вопроса, независимо от того, как его сформулирует человек, и выдавать один и тот же ответ на разные варианты этого вопроса.''

- ''удаление'' вопроса из базы на вкладке «Дополнительно» внизу будет кнопка ''Удалить вопрос полностью''.

'''<u>Внимание:</u>''' ''Нажимая на кнопку '''Удалить вопрос полностью''' в меню Дополнительно, вы удаляете <u>весь</u> вопрос, включая формулировки, ответы на него из всех каналов и всех кандидатов.''

- после того как вы внесете изменения, кнопка «Сохранить» станет активной в меню «Дополнительно» и на панели для редактирования ответов.



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

Каждый вопрос сопровождается флажком '''«Проверено»''', который отмечает ответы, проверенные пользователем. При наведении курсора мыши на ответ, вместо канала к которому принадлежит вопрос, появляются кнопки: 

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


===== <u>Поиск по вопросам и ответам. Фильтрация</u> =====
[[Файл:2024-08-06 16-23-15.png|мини|''<small>Рис. 9 Иллюстрация поиска по вопросам</small>'']]
В разделе '''«Кэш»''' есть три вида поиска:

# поиск по вопросам и их формулировкам, в том числе и кандидатам;
# поиск по ответам.
# поиск по категории

А так же два вида фильтрации:

# по содержанию ответов: ''Все'', ''Проверенные'', ''Непроверенные'', ''Пустые.''
# по полноте вопроса: ''Все, Полный, Неполный.''  К <u>полным</u> вопросам относятся вопросы с конкретикой. К <u>неполным</u> - короткие вопросы без конкретики. 

[[Файл:2024-08-06 16-38-29.png|мини|''<small>Рис. 10 Иллюстрация поиска по ответам</small>'']]С помощью '''поиска по вопросам и их формулировкам''' можно найти все вопросы или вопросы в определённой категории, которые содержат определённое слово или фразу в своей формулировке. Поиск работает как для основного вопроса, так и для дополнительных формулировок.  <blockquote>Например, на рисунке 9 в категории «Водительские права» мы ищем все вопросы, в которых есть сочетание букв «''замена''». Если открыть меню, внизу экрана, ''«Дополнительно»'', то можно увидеть, что это сочетание используется в альтернативных формулировках вопроса, найденные сочетания подсвечиваются.  </blockquote>Обращаем внимание, что если в основном вопросе нет искомого слова или сочетания букв, то система все равно выведет вопрос, если найдет совпадения в альтернативных формулировках. [[Файл:2024-08-06 16-24-00.png|мини|''<small>Рис. 11 Результат работы двух видов поиска одновременно</small>'']]
Предусмотрен ''поиск по ответам'', в поле '''«Ответ»''' можно ввести слово или фразу и система подсветит поля ответов, где искомое сочетание было найдено (рис. 10). По умолчанию канал связи стоит в положении «не выбран» и выводятся ''все'' ответы ''из всех каналов'', где найдено слово или фраза. Можно принудительно выбрать канал из списка, тогда отобразятся ответы выбранного канала и будут подсвечены те ответы, где найден искомый текст. Область ответа с искомым текстом будет подсвечена бледно-голубым (рис. 10). Можно одновременно использовать два вида поиска. В результате будут отображены вопросы, в которых присутствует искомое значение – как в вопросах, так и в ответах (рис. 11). 



===== <u>Поиск ответа</u> =====
[[Файл:2025-07-04 15-31-58.png|мини|''<small>Рис. 12 Интерфейс блока «Поиск ответов»</small>'']]
Блок '''«Поиск ответа»''' (рис. 12) работает так же, как кнопка '''«Задать вопрос»''' на вкладке '''«Документы»'''. <blockquote>Важно отметить, что поиск ответа происходит в два этапа: 

# поиск нужных фрагментов из документов в категории,
# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.
</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов.  

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

'''«Шаблон запроса к LLM»:''' здесь вы можете выбрать, какой промпт отправить на генеративную модель вместе с найденными фрагментами и вопросом. Если промпт не выбран, LLM будет использовать стандартный запрос. Подробнее о шаблонах запросов [[QAS. UPS руководство по работе с интерфейсом#Функционал вкладки «Шаблоны запросов»|тут]].  <blockquote>'''Для чего это нужно?''' 

Если стандартный промпт не работает так, как нужно для конкретной категории, или требуется что-то особенное, можно создать новый шаблон. Это делается без изменения стандартного промпта. </blockquote>Если выбираете шаблон, отличный от стандартного, то напротив выпадающего списка появится значок '''«Подсказка»''' [[Файл:Подсказка.jpg|безрамки|20x20пкс]], при наведении курсора на него вы увидите текст промпта этого шаблона.  

Меню '''«Использовать кэш»'''. В этом меню можно выбрать, использовать ли только проверенные ответы или любые. Кэш-память позволяет сервису быстрее отвечать на запросы пользователей. А опция '''«Только проверенные ответы»''' гарантирует, что ответы, которые получает пользователь, были отредактированы и проверены оператором. 

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

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


===== <u>Функционал режима «Проверка новых вопросов»</u> =====
Режим «Проверка новых вопросов» содержит перечень всех новых вопросов. В рабочей области находится таблица, в которой представлен список новых вопросов, ответы на них, категория, присвоенная этим вопросам, а также дата создания вопроса. Есть возможность фильтрации по каждой из колонок (рис. 13).
[[Файл:New questions mode.png|мини|''<small>Рис.13. Интерфейс режима утверждения новых вопросов</small>'']]
При наведении на любую строку слева появляются иконка и чекбокс:
# [[Файл: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|мини|''<small>Рис.13.1. Работа в режиме утверждения новых вопросов</small>'']]Данный режим позволяет как точено, так и массово проверять ответы и категорию на соответствие вопросу.
В таблице реализована возможность самостоятельной правки вопросов/ответов/категорий. Для этого надо кликнуть на интересующую вас ячейку и внести правки. Сразу после изменений в верхней правой части ячейки появится иконка для отката изменений [[Файл:Undo.png|безрамки|24x24пкс]] на '''начальное''' состояние. Если в строке произошли какие-то изменения, то <u>''строка автоматически переходит в состояние выбранной''</u> (рис. 13.1).

В таблице реализована клавиатурная доступность, которая позволяет перемещаться между ячейками и утверждать выбранные позиции в таблице. Для этого используются следующие комбинации клавиш: Ctrl + ⬆/⬇/⬅/➡/Enter.



===== <u>Функционал режима «Утверждение кандидатов»</u> =====
[[Файл:Рис. 13 Интерфейс режима Утверждения кандидатов.png|мини|''<small>Рис. 14. Интерфейс режима Утверждения кандидатов</small>'']]
Режим «Утверждение кандидатов» содержит перечень всех кандидатов. В рабочей области находится таблица, в которой представлен список кандидатов, перечень основных вопросов, где эти кандидаты находятся, а также категория, присвоенная этим вопросам (рис. 14). 

При наведении на любую строку слева появляются две иконки:
# [[Файл:Сделать основным без фона.png|безрамки|26x26px]] Сделать основным — позволяет сделать кандидата основным вопросом. По нажатию на эту кнопку появляется диалоговое окно, где требуется подтвердить намерение сделать кандидата основным вопросом. В форме подтверждения нужно выбрать категорию, в которую хотели бы добавить вопрос и аналогично функционалу добавить новый вопрос (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Добавление новых и редактирование вопросов|Добавление новых и редактирование вопросов]]).
# [[Файл:Утвердить.png|безрамки|26x26px]] Утвердить — позволяет утвердить кандидата, в текущем вопросе, включая её в формулировку вопроса. Это означает, что кандидат подходит по смыслу к основному вопросу и его формулировкам.[[Файл:Рис 14. Работа в режиме Утверждение кандидатов.jpg|мини|''<small>Рис.14.1. Работа в режиме Утверждение кандидатов</small>'']]

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

По умолчанию система предлагает утвердить выбранного кандидата или кандидатов в текущем вопросе. Однако если вы хотите перенести его в другой вопрос, просто начните вводить его название в поле поиска. Затем нажмите кнопку «Утвердить», расположенную в правом нижнем углу (рис. 14.1).

Если вы хотите ''удалить'' кандидата или кандидатов, выделите их и нажмите на иконку «Корзинка», которая находится над кнопкой «Утвердить».


===== <u>Функционал режима «Поиск несоответствий»</u> =====

Режим "Поиска несоответствий кэша ответов и документов" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Несоответствия"''''' и '''''"Ошибки"''.''' Чтобы запустить поиск несоответствий, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

[[Файл:Поиск несоответствий 1.png|мини|''<small>Рис.15. Работа в режиме Поиска несоответствий. Вкладка несоответствий</small>'']]
При активном табе '''"Несоответствия"''' показана таблица результатов поиска для работы с найденными ответами из кэша, которые не соответствуют фрагменту документа (рис.15). Таблица разделена на 4 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''фрагмент из документа'', по которому был дан текущий ответ,
* ''исправленный ответ'', на который предлагается заменить текущий.

Проанализировав предложенные ответы в столбце ''"Исправленный ответ"'', можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены предложенных ответов на ответы из кэша необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.

[[Файл:Поиск несоответствий 2.png|мини|''<small>Рис.15.1. Работа в режиме Поиска несоответствий. Вкладка Ошибок</small>'']]
При активном табе '''"Ошибки"''' показана таблица результатов поиска для работы с найденными ответами из кэша, по которым были выявлены ошибки, например, отсутствие информации (рис.15.1). Таблица разделена на 3 столбца:

* ''вопрос'',
* ''ответ'' из кэша,
* ''ошибка'' поиска''.''

Здесь можно скорректировать ответ из кэша, при необходимости (в ячейке таблицы), или удалить запись (строку). Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].

Далее, для замены исправленных ответов необходимо выделить их (строки) и нажать на кнопку ''"Заменить ответы"'' внизу таблицы.


===== <u>Функционал режима «Векторный поиск»</u> =====
[[Файл:Векторный поиск.png|мини|''<small>Рис.16. Работа в режиме Векторного поиска</small>'']]
Режим "Векторного поиска" представляет собой отображение двух таблиц, переключающихся табами слева: '''''"Документы"''''' и '''''"Ответы"''''' (рис.16). Он предназначен для поиска и замены ответов и фраз в документах, векторно похожих на текст запроса. Чтобы запустить векторный поиск, нажмите на иконку поиска [[Файл:Лупа.png|безрамки|30x30пкс]] на панели управления (см. раздел [[QAS. UPS руководство по работе с интерфейсом#Панель управления вкладки «Кэш»|Панель управления вкладки Кэш]]).

После окончания поиска будет отображена таблица, которая разделена на 3 столбца:
* ''документ / вопрос'' (в зависимости от выбранного таба),
* ''фраза / ответ'' (в зависимости от выбранного таба),
* ''сходство'', в процентах.
Проанализировав найденные фразы/ответы, можно их скорректировать (в ячейке таблицы) или удалить запись (строку), если она была дана неверно. Для удаления нескольких записей выберите их галочкой и снизу таблицы нажмите на иконку удаления [[Файл:Delete icon.png|безрамки|22x22пкс]].
[[Файл:Векторный поиск 2.png|мини|''<small>Рис.16.1. Замена информации в режиме векторного поиска</small>'']]


Затем слева от таблицы заполняем форму для того, чтобы модель генерации предложила варианты замены информации (фразы или ответа). Для этого заполняем недостающие поля: ''Текст замены'' и опционально ''Модель генерации'' (по умолчанию default) и ''Шаблон запроса к LLM'' типа "Векторная замена информации". После нажатия на кнопку ''"Показать варианты замены"'' запустится процесс подготовки предложений по замене информации: появится четвертый столбец ''"Измененная фраза" / "Измененный ответ"'' и в ней по очереди построчно будут заполнятся фразы/ответы (рис. 16.1).

После окончания обработки можно отредактировать или удалить предложенные варианты замены, выделить нужные и нажать внизу таблицы кнопку ''"Заменить фразы"'' / ''"Заменить ответы"'' для замены фраз в документе/ответов соответственно.


===== <u>Панель управления вкладки «Кэш»</u> =====
{| class="wikitable"
|+''<small>Табл. 2 Описание функционала панели управления вкладки «Кэш»</small>''
!'''Иконка кнопки'''
!'''Наименование кнопки'''
!'''Описание'''
|-
|[[Файл: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,
* выбрать категорию, к которой относятся вопросы из файла, 
* выбирать канал связи ''не нужно'',
* параметр для использования кэша установить в режим ''Любые ответы'', 
* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и <u>если не активирован флаг «Использовать генерацию», функция работать не будет</u>.). Другие модели будут отображаться в списке только после того, как администратор добавит их.
* укажите ''количество документов [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 руководство по работе с интерфейсом#Поиск ответа|Поиск ответа]]'').

Этот функционал позволяет создать основную базу. После того как пары вопросов и ответов будут добавлены, можно будет [https://wiki.connect2ai.net/index.php#Добавление_новых_и_редактирование_вопросов добавлять формулировки в вопросы]. Эта кнопка доступна только в режиме '''«Подробный»'''.
|-
|[[Файл:Лупа.png|центр|безрамки|50x50пкс]]
|Поиск несоответствий кэша ответов и документов / Векторный поиск
|Позволяет запустить поиск разного вида в зависимости от выбранного режима: '''«Поиск несоответствий»''' или '''«Векторный поиск»'''.



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

''1. "Вопрос по документации",''

''2.'' "Поиск несоответствий информации".

Поиск может занимать достаточно продолжительное время. Для удобства отслеживания на иконке отображается прогресс поиска. При наведении на нее она меняется на ''"Остановить поиск несоответствий кэша ответов и документов"'' [[Файл:Иконка ген. стоп.png|безрамки|20x20px]] и вы можете принудительно остановить поиск.


В режиме '''«Векторный поиск»''' при нажатии на кнопку появляется форма для поиска фрагментов, векторно похожих на фразу запроса. Для запуска в ней нужно указать ''Текст'' запроса, ''Категорию'' поиска и ''Порог схожести''. Далее будет выведена таблица с данными поиска с разделением на документы и ответы.
|-
|[[Файл:Меню_пользователя_new.png|центр|безрамки|40x40пкс]]
|Меню пользователя
|Отображает меню пользователя (имя, версия системы, смена пароля, отображение/скрытие фона, выход из системы). В меню пользователя добавлена функция ''выбора набора данных* (документы, вопросы)''. Это позволяет работать с различными изолированными группами данных в рамках одной учетной записи. При изменении активного набора данных система автоматически обновляет список пользовательских данных в сервисе. Это обеспечивает удобное переключение между разными проектами или рабочими пространствами без необходимости перезагрузки интерфейса.
<small>*права на создание наборов данных есть у администраторов или у ролей, где эти права прописаны.</small>
|}


[[Файл:Шаблоны запросов.png|мини|''<small>Рис. 17. Интерфейс вкладки Шаблоны запросов</small>'']]

===== <u>Функционал вкладки «Шаблоны запросов»</u> =====

Данный раздел позволяет управлять шаблонами промптов: создавать, редактировать, удалять и настраивать их использование ''(Рис. 17)''.  

'''1. Интерфейс вкладки'''

'''- ''Фильтрация по типу'''''

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

    - Чат

    - Запрос к документу

    - Очистка документа

    - Генератор синонимичных фраз

    - Перефразировка фрагмента текста

    - Суммаризация текста

    - Генератор вопросов по тексту

- Векторная замена информации

- Поиск несоответствий информации

Напротив каждого типа в скобках указано количество доступных шаблонов.

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

'''''- Список шаблонов'''''

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

'''''- Редактирование шаблона''''' 

  - ''Название шаблона'' – можно изменить в соответствующем поле.  
[[Файл:Сведение в единый.png|мини|''<small>Рис. 18.  Шаблон сведения ответа в единый</small>'']]
  - ''Текст шаблона'' – поддерживает параметры в квадратных скобках <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|мини|''<small>Рис. 19. Рабочая область вкладки «Интерактив».</small>'']]

==== Вкладка «Интерактив» ==== 

Вкладка '''«Интерактив»''' включает в себя три режима:

# режим протоколирования,
# чат,
# очистка текста.
[[Файл:Шаблон.png|мини|''<small>Рис.20. Блок редактирования и просмотра шаблона</small>'']]Чтобы '''переключиться между режимами''', просто нажмите на соответствующие иконки на панели управления. Активный режим выделяется красным контуром вокруг иконки.

'''Режим протоколирования''' [[Файл:Remove-bg.ai 1741353006272.png|безрамки|20x20пкс]] служит для создания протоколов — кратких резюме — на основе стенограмм. Она обладает двумя ключевыми функциями: позволяет создавать шаблоны для протоколов и создавать протоколы.
[[Файл:2025-07-04 17-06-57.png|мини|''<small>Рис. 21. Форма для загрузки файла для протоколирования.</small>'']]
[[Файл:2025-05-21 15-23-39.png|мини|''<small>Рис. 22. Интерфейс вкладки Интерактив в режиме Чат</small>'']]
Слева располагается список всех шаблонов, где вы можете найти подходящий или создать новый. Для добавления нового шаблона необходимо нажать на кнопку '''«Добавить шаблон»''' и заполнить все необходимые поля в появившемся окне: '''указать название шаблона''', а также '''наименования разделов''' и '''описать их содержание'''.
В центральной части экрана, вы можете редактировать шаблон. Здесь вы можете внести изменения и сохранить их, либо удалить, нажав соответствующие кнопки внизу блока (см. рис. 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|мини|''<small>Рис. 23 Интерфейс вкладки Интерактив в режиме Очистка чата</small>'']]



'''Режим «Очистка текста»''' [[Файл:Photo 2025-05-21 12-43-53.jpg|безрамки|20x20пкс]] этот инструмент помогает убрать из текста лишнее и сделать его более читабельным. Чтобы воспользоваться функцией, вставьте текст в поле «Чистка текста» (в центре рабочей области) и нажмите кнопку «Очистить». После завершения процесса справа от исходного текста появится очищенный вариант (рис. 23). В него нельзя вносить изменения, но можно скопировать с помощью клавиш Ctrl+C или экспортировать в виде документа [[Файл:Сохранить doc (1).png|безрамки|20x20пкс]] docx или txt на выбор.



===== <u>Панель управления вкладки «Интерактив»</u> =====
{| 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 руководство по работе с интерфейсом#Функционал режима «Утверждение кандидатов»|кандидатам]]. С его помощью можно увидеть, в какие категории и в какие вопросы поступают новые запросы, и сразу же внести изменения — поменять категорию или утвердить кандидатов. А также увидеть, каким запросам не присвоилась категория вообще.