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

QAS (ЧаВО) Сервис ответов на вопросы

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

1. классификатор,
2. сущности,
3. распознавание,
4. биометрия,
5. синтез,
6. ЧаВО,
7. Сценарная машина,
8. Выход.

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

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

Перейти в раздел «ЧаВО» (QAS) можно кликнув по соответствующей кнопке на главном экране UPS (см.рисунок 1).

Рисунок 1 - Главный экран UPS

Описание интерфейса сервиса «ЧаВО» (QAS)

Рабочая область сервиса «ЧаВО» (QAS) (сервиса ответов на вопросы) включает в себя следующие блоки (рисунок 2):

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

Рисунок 2 - Рабочая область сервиса «ЧаВО»

Вкладка «Документы»

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

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

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

Добавление файла в список

В нижней части блока со списком файлов есть кнопка «Добавить файл». Если нажать на нее, то появится диалоговое окно, как на рисунке 3. Чтобы добавить файл, нужно заполнить все необходимые поля и выбрать нужный файл с компьютера (в формате .txt и кодировке Unicode UTF-8). Файл должен быть максимально кратким и ёмким, до 3000 символов. Затем нажмите на кнопку «Добавить файл». Если вы хотите добавить новую категорию при загрузке документа, вам нужно ввести название новой категории в соответствующее поле и нажать кнопку «Добавить новую категорию…». После этого загружаемый документ будет отнесён к новой категории, и файл успешно добавится в базу.

Рисунок 3 - Добавление нового файла

Функционал меню «Дополнительно»

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

• категорию к которой относиться документ,
• глоссарий, в котором укажите название объекта из документа, а также его синоним в соответствующих полях внизу страницы. Это поможет модели лучше понимать, о чём её спрашивают. Например, научить ее тому, что «госпошлина = пошлина», «загранник = загранпаспорту», «загранпаспорт = заграничному паспорту», а «загранпаспорт нового образца = загранпаспорту на 10 лет» и нажмите кнопку добавить. Предусмотрено массовое удаление синонимов, для этого выделите нужное галочками. Кликнув на поле с фразами вы можете отредактировать формулировку. После внесения изменений нажмите кнопку «Сохранить». Она станет активной сразу же после того, как вы внесете какие-либо изменения в документ. Эта кнопка является дубликатом кнопки «Сохранить» в блоке редактирования документа.
• есть кнопка для экспорта глоссария, если это необходимо в формате .csv.
• здесь же находится кнопка для удаления документа.

Рисунок 4 - Иллюстрация функций кнопки Дополнительно

Поиск фрагментов в документах

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

Рисунок 5 - Блок «Поиск фрагментов в базе»

Панель управления вкладки «Документы»

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

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

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

¹ По нажатию на кнопку «Задать вопрос», появляется диалоговое окно с полями: «Вопрос» - это область для ввода вопроса, а «Категория» - это выпадающий список с категориями в базе данных. Если вы выберете нужную категорию из списка, модель будет генерировать ответ (в свободной форме), основываясь на документах выбранной категории. В противном случае, ответ будет генерироваться на основе всех документов в базе данных (рисунок 5). Список созданных каналов связей и меню «Использовать кэш». В этом меню можно выбрать, использовать ли только проверенные ответы или любые. Также в блоке есть флажки «Использовать генерацию», «Творческий режим» и «Кэширование формулировки». Флажок «Творческий режим» нельзя активировать без флажка «Использовать генерацию». Если вы ставите активный флажок «Кэширование формулировки», то вопрос который вы задали будет направлен в кэш вопросов вместе с найденным ответом и будет доступен для редактирования на вкладке «Вопросы». Результат отработки метода отобразится после нажатия на кнопку «Получить ответ» внизу, Показатель «достоверность» отражает процент достоверности ответа, основываясь на всех найденных фрагментах. Вопросы, которые вы создаёте с помощью кнопки «Задать вопрос» (при активной галочке «Использовать генерацию»), отображаются в списке на вкладке «Вопросы» и становятся доступными для редактирования.

Рисунок 6 - Блок «Задать вопрос»

Вкладка «Вопросы»

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

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

Рисунок 7 - Рабочая область вкладки «Вопросы»

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

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

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

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

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

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

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

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

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

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

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

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

- добавление, удаление или перенос. Чтобы удалить формулировку, необходимо навести курсор на нужную фразу. После этого справа появятся две кнопки (см. рисунок 8). Одна из них в виде стрелочки предназначена для того, чтобы сделать эту формулировку основным вопросом. А кнопка в виде корзинки позволяет удалить выбранную фразу. Есть возможность удалять несколько формулировок, для этого нужно выбрать формулировки для удаления и нажать на кнопку Удалить, рядом с кнопкой Переместить.

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

Обращаем ваше внимание, что если вы указываете, что перемещение должно быть выполнено в кандидаты, то вам необходимо будет затем перейти и утвердить кандидата.

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

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

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

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

Рисунок 8 - Интерфейс вкладки «Дополнительно»

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

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

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

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

Поиск по вопросам и ответам. Фильтрация

В разделе «Вопросы» есть три вида поиска:

1. поиск по вопросам и их формулировкам;
2. поиск по ответам.

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

1. по категории;
2. по содержанию ответов: Все, Проверенные, Непроверенные, Пустые.

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

Рисунок 9 - Иллюстрация поиска по вопросам

Предусмотрен поиск по ответам, в поле «Ответ» можно ввести слово или фразу и система подсветит поля ответов, где искомое сочетание было найдено (рисунок 9). По умолчанию канал связи стоит в положении «не выбран» и выводятся все ответы из всех каналов, где найдено слово или фраза. Можно принудительно выбрать канал из списка, тогда отобразятся ответы выбранного канала и будут подсвечены те ответы, где найден искомый текст. Область ответа с искомым текстом будет подсвечена бледно-голубым (рисунок 10). Можно одновременно использовать два вида поиска. В результате будут отображены вопросы, в которых присутствует искомое значение – как в вопросах, так и в ответах (рисунок 11).

Рисунок 10 - Иллюстрация поиска по ответам

Рисунок 11 - Результат работы двух видов поиска одновременно

Поиск ответа

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

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

Рисунок 12 - Интерфейс блока «Поиск ответов»

Панель управления вкладки «Вопросы»

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

1. выбрать вопросы,
2. экспорт вопросов в формате корпуса,
3. обновить данные вопроса,
4. генерация ответов,
5. массовая обработка вопросов,
6. меню пользователя.

Подробное описание каждой кнопки можно найти в таблице 2.

Таблица 2 - Описание функционала панели управления вкладки «Вопросы»

Иконка кнопки	Наименование кнопки	Описание
	Выбрать вопросы	При нажатии на эту кнопку активируется режим, в котором можно выбрать несколько вопросов из списка для последующего перемещения или удаления. Сама кнопка подсвечивается красным цветом, показывая, что она активна. Нажав на неё второй раз, можно выключить режим и сбросить выбор. После того как вы отметили галочками вопросы, справа от кнопки появляется опции «Переместить вопросы» и «Удалить выбранные вопросы». Если вы собираетесь переместить вопросы, но в них уже есть проверенные ответы, в диалоговом окне появится предупреждение об этом. Если вы всё же решите переместить эти вопросы, ответы будут потеряны, а перемещаемые вопросы попадут в формулировки выбранного вопроса.
	Экспорт вопросов в формате корпуса	Эта кнопка позволяет экспортировать вопросы в формате CSV для классификатора. Структура файла выглядит следующим образом: Категория ⇥ Вопрос.
	Обновить данные вопроса	С помощью этой кнопки можно обновить данные текущего вопроса после генерации ответов, по нажатию на кнопку отобразятся все ответы, которые система сгенерировала на этот восгеиерировала ня ответов может быть для разных каналов связи, просмотреть их можно переключив канал в меню напротив основного вопроса.
	Генерация ответов	эта кнопка предназначена для генерации ответов. По нажатию на кнопку появляется диалоговое окно, в котором требуется ввести количество ответов, выбрать категорию, для которой нужна генерация, выбрать Режим генерации из выпадающего списка: генерация по документам или перефразирование проверенных, а так же генерацию для всех вопросов или только для пустых. Генерация может занимать достаточно продолжительное время. Помимо канала по умолчанию ответы генерируются и для других каналов, после окончания обновите данные вопроса и просмотрите все существующие каналы. Совет: лучше использовать сначала режим генерации ответов по документам, после чего проверить их правильность и запускать генерацию в режиме перефразирования ответов. Также перед тем, как сгенерировать ответы, обновите страницу. Убедитесь, что предыдущая генерация ответов не запущена , иначе кнопка не сработает, и вам нужно будет либо остановить предыдущую генерацию, либо подождать, пока она завершится. Для удобства отслеживания на иконке отображается прогресс генерации. Иконка выглядит так, если генерация запущена. При наведении на нее она меняется на Остановить генерацию ответов и вы можете принудительно остановить генерацию. Все ответы, которые успели сгенерироваться - останутся.
	Массовая обработка вопросов	нажав на кнопку появится меню, где требуется выбрать файл с вопросами с формате .csv для массового добавления вопросов и поиска ответов на них в документации. Интерфейс этого меню соответствуют блоку для поиска ответов, здесь тоже требуется выбрать категорию к которой относятся вопросы из файла, выбрать канал связи и параметр для использования кэша, а так же активировать флажки по необходимости (подробнее см. разд. Поиск ответа). Важно: в файле могут быть вопросы только по одной тематике. Совет: для массовой обработки вопросов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Не использовать».
	Меню пользователя	отображает меню пользователя (имя, смена пароля, выход из системы, убрать/показать фон)

Вкладка Кандидаты

Вкладка «Кандидаты» содержит перечень всех кандидатов. С левой стороны экрана представлен список вопросов из базы данных QAS. Этот список можно скрыть, нажав на стрелку «Скрыть боковую панель», которая появляется при наведении курсора на область между списком и таблицей на рабочей панели. В рабочей области находится таблица, в которой представлен список кандидатов, перечень основных вопросов, где эти кандидаты находятся, а также категория, присвоенная этим вопросам. Есть возможность фильтрации по каждой из колонок. При наведении на любую строку слева появляются две иконки:

1. Сделать основным — позволяет сделать кандидата основным вопросом. По нажатию на эту кнопку появляется диалоговое окно, где требуется подтвердить намерение сделать кандидата основным вопросом. После подтверждения нужно выбрать категорию, в которую хотели бы добавить вопрос и аналогично функционалу добавить новый вопрос (см. раздел Добавление новых и редактирование вопросов).
2. Утвердить — позволяет утвердить кандидата, в текущем вопросе, включая её в формулировку вопроса. Это означает, что кандидат подходит по смыслу к основному вопросу и его формулировкам.

Рисунок 13 - Интерфейс вкладки Кандидаты

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

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

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

Рисунок 14 - Работа с кандидатами

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

Совместная работа

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

Методика работы с QAS

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