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

E.Elagina: /* Функционал вкладки «Шаблоны запросов» */

2025-12-29T13:16:52Z

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

← Предыдущая версия		Версия от 16:16, 29 декабря 2025
Строка 544:		Строка 544:

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

			- Генерация якорей по документу

			- Аннотация документа

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

E.Elagina: /* Функционал меню «Дополнительно» */

2025-12-29T13:14:10Z

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

Внесённые изменения

E.Elagina: /* Вкладка «Документы» */

2025-12-29T12:44:50Z

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

← Предыдущая версия		Версия от 15:44, 29 декабря 2025
Строка 60:		Строка 60:


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

	===== <u>Добавление файла в список</u> =====		===== <u>Добавление файла в список</u> =====
Строка 77:		Строка 77:
	* .txt.		* .txt.

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

			'''Блок «Параметры поиска документа»'''

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

			Доступные опции:

			* Использовать начало документа — в поиск будет включен первый фрагмент текста.
			* Использовать аннотацию — при поиске система будет учитывать подготовленное краткое описание (аннотацию) документа. Аннотация генерируется автоматически на этапе векторизации при активном флаге.
			* Использовать заголовок документа — в поисковые данные добавляется название файла, которое указано в интерфейсе. Поэтому важно указывать название отражающее содержание документа.
			* Использовать якоря по содержимому — для индексации будут выделены ключевые смысловые блоки (якоря), автоматически определенные внутри документа.

			Затем нажмите на кнопку '''«Добавить».'''

E.Elagina: /* Поиск ответа */

2025-12-24T10:13:20Z

Поиск ответа

← Предыдущая версия		Версия от 13:13, 24 декабря 2025
Строка 280:		Строка 280:
	# поиск нужных фрагментов из документов в категории,		# поиск нужных фрагментов из документов в категории,
	# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.		# из найденных фрагментов формируется ответ, на базе самого похожего на запрос. Если в нем найден контекст вопроса.
	</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов.		</blockquote>Он включает в себя поле для ввода текста вашего вопроса, выпадающий список с категориями (если категория не указана, ответ будет сформулирован на основании всех документов в базе данных), список созданных каналов. <blockquote>Для запуска поиска есть горячие клавиши Ctrl+Enter или по кнопке Получить ответ. </blockquote>В выпадающем списке '''«Модель генерации»''' вы можете выбрать модель, которая будет создавать итоговый ответ. Чтобы в списке появились дополнительные модели, кроме стандартной, администратор должен их добавить. После этого они появятся в списке, и вы сможете использовать их вместо стандартной модели.

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

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

E.Elagina: /* Панель управления вкладки «Кэш» */

2025-12-24T10:09:52Z

Панель управления вкладки «Кэш»

← Предыдущая версия		Версия от 13:09, 24 декабря 2025
Строка 439:		Строка 439:
	* выбирать канал связи ''не нужно'',		* выбирать канал связи ''не нужно'',
	* параметр для использования кэша установить в режим ''Любые ответы'',		* параметр для использования кэша установить в режим ''Любые ответы'',
	* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и <u>если не активирован флаг «Использовать генерацию», функция работать не будет</u>.). Другие модели будут отображаться в списке только после того, как администратор добавит их.		* укажите модель генерации, ''если нужно сгенерировать еще и ответы'' (по умолчанию используется значение по умолчанию, и <u>если не активирован флаг «Использовать генерацию», функция работать не будет</u>). Другие модели будут отображаться в списке только после того, как администратор добавит их.
	* укажите ''количество документов [1, 10]'', в которых будет осуществляться поиск ответа, соответствующего вашему вопросу. Для случаев с генерацией ответов.<blockquote>Это число определяется интуитивно: чем больше вы выберете, тем меньший контекст будет извлечён из каждого документа. Однако, если в категории более четырёх документов, не рекомендуется устанавливать значение более четырёх.</blockquote>
	* а также активировать только флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа\|Поиск ответа]]''). Можно активировать остальные флаги для случаев, когда нужно помимо обработки нужно ''еще и сгенерировать ответы.''		* а также активировать только флаг ''Кэшировать формулировку вопроса'' остальные снять (подробнее см. разд. ''[[QAS. UPS руководство по работе с интерфейсом#Поиск ответа\|Поиск ответа]]''). Можно активировать остальные флаги для случаев, когда нужно помимо обработки нужно ''еще и сгенерировать ответы.''
	* а так же активировать опцию «Установить порог похожести,%». Если вы активируете её, то сможете выбрать значение по умолчанию — 90% или задать своё собственное.<blockquote>'''Важно:''' в файле могут быть вопросы '''только''' по одной тематике.</blockquote>Обработка вопросов осуществляется по следующей схеме: каждый новый вопрос сравнивается с предыдущими (и формулировками). Если обнаруживается вопрос, который кажется схожим по смыслу, то новый вопрос включается в список его возможных кандидатов. Если же не находится вопроса, который имеет семантическую близость с новым, то новый становится основным.<blockquote>'''''Совет:''' д''ля массовой обработки вопросов без генерации ответов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Любые ответы».</blockquote>Режим '''JSON'''[[Файл:JSON.png\|безрамки\|80x80пкс]].		* а так же активировать опцию «Установить порог похожести,%». Если вы активируете её, то сможете выбрать значение по умолчанию — 90% или задать своё собственное.<blockquote>'''Важно:''' в файле могут быть вопросы '''только''' по одной тематике.</blockquote>Обработка вопросов осуществляется по следующей схеме: каждый новый вопрос сравнивается с предыдущими (и формулировками). Если обнаруживается вопрос, который кажется схожим по смыслу, то новый вопрос включается в список его возможных кандидатов. Если же не находится вопроса, который имеет семантическую близость с новым, то новый становится основным.<blockquote>'''''Совет:''' д''ля массовой обработки вопросов без генерации ответов лучше снять флажок «Использовать генерацию» и установить параметр «Использовать кэш ответов» в состояние «Любые ответы».</blockquote>Режим '''JSON'''[[Файл:JSON.png\|безрамки\|80x80пкс]].

E.Elagina: /* Главное меню */

2025-12-24T10:06:51Z

Главное меню

← Предыдущая версия		Версия от 13:06, 24 декабря 2025
Строка 109:		Строка 109:

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

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

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

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

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


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

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

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

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

E.Elagina: /* Функционал вкладки «Шаблоны запросов» */

2025-12-24T09:07:42Z

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

← Предыдущая версия		Версия от 12:07, 24 декабря 2025
Строка 508:		Строка 508:
	[[Файл:Шаблоны запросов.png\|мини\|''<small>Рис. 17. Интерфейс вкладки Шаблоны запросов</small>'']]		[[Файл:Шаблоны запросов.png\|мини\|''<small>Рис. 17. Интерфейс вкладки Шаблоны запросов</small>'']]

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

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

E.Elagina: /* Панель управления вкладки «Кэш» */

2025-12-24T09:06:59Z

Панель управления вкладки «Кэш»

← Предыдущая версия		Версия от 12:06, 24 декабря 2025
Строка 422:		Строка 422:
	* ввести желаемое количество ''ответов'',		* ввести желаемое количество ''ответов'',
	* выбрать ''категорию'', для которой требуется генерация,		* выбрать ''категорию'', для которой требуется генерация,
			* выбрать ''канал'',
	* выбрать ''режим генерации'': по документам или перефразирование проверенных,		* выбрать ''режим генерации'': по документам или перефразирование проверенных,
	* указать, для каких вопросов нужно сгенерировать ответы: для всех или только для пустых,		* указать, для каких вопросов нужно сгенерировать ответы: для всех или только для пустых,

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

2025-12-24T09:06:11Z

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

← Предыдущая версия		Версия от 12:06, 24 декабря 2025
Строка 161:		Строка 161:
	* категорию вопросов для генерации;		* категорию вопросов для генерации;
	* если не нужно генерировать вопросы для всех документов, выберите нужный,		* если не нужно генерировать вопросы для всех документов, выберите нужный,
			* выберите канал,
	* выберете модель генерации (по умолчанию используется default), другие модели будут отображаться в списке только после того, как администратор добавит их,		* выберете модель генерации (по умолчанию используется default), другие модели будут отображаться в списке только после того, как администратор добавит их,
	* выберите шаблон запроса к LLM (по умолчанию используется шаблон "из коробки" типа "Генератор вопросов по тексту"),		* выберите шаблон запроса к LLM (по умолчанию используется шаблон "из коробки" типа "Генератор вопросов по тексту"),

E.Elagina: /* Вкладка «Интерактив» */

2025-12-24T09:05:15Z

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

← Предыдущая версия		Версия от 12:05, 24 декабря 2025
Строка 605:		Строка 605:


	'''В режиме «Чат»''' [[Файл:Чат (1).png\|безрамки\|20x20пкс]] можно в свободной форме пообщаться с LLM-моделью. Есть возможность обращаться к нескольким моделям. Рабочая область показана на рисунке 22. Слева на рисунке есть блок с выбором LLM-модели, "Шаблон запроса к LLM" типа "Чат" и опция «Глубина истории сообщений», которая варьируется в диапазоне [3, 10]. <blockquote>Внимание: варианты моделей появляются в интерфейсе после того, как администраторы их добавят. </blockquote>		'''В режиме «Чат»''' [[Файл:Чат (1).png\|безрамки\|20x20пкс]] можно в свободной форме пообщаться с LLM-моделью. Есть возможность обращаться к нескольким моделям. Рабочая область показана на рисунке 22. Слева на рисунке есть блок с выбором LLM-модели, "Шаблон запроса к LLM" типа "Чат" и опция «Глубина истории сообщений», которая варьируется в диапазоне [3, 10]. История сообщений в чате сохраняется с ориентиром на глубину.

			Функция '''«Размышление*»''' модели

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

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

			<small>*доступна только для больших «думающих» моделей.</small><blockquote>Внимание: варианты моделей появляются в интерфейсе после того, как администраторы их добавят. </blockquote>
	В центре экрана расположен сам чат. Внизу области расположено окно, в которое можно ввести свой запрос и отправить его по клику на кнопку «Отправить» [[Файл:Отправить.png\|безрамки\|20x20пкс]] . Очистить историю можно воспользовавшись одноименной кнопкой [[Файл:Обновить данные вопроса.png\|безрамки\|20x20пкс]]. Справа от чата блок с «Поиском ответов», подробнее о нем и его параметрах можно прочитать [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа\|тут]].		В центре экрана расположен сам чат. Внизу области расположено окно, в которое можно ввести свой запрос и отправить его по клику на кнопку «Отправить» [[Файл:Отправить.png\|безрамки\|20x20пкс]] . Очистить историю можно воспользовавшись одноименной кнопкой [[Файл:Обновить данные вопроса.png\|безрамки\|20x20пкс]]. Справа от чата блок с «Поиском ответов», подробнее о нем и его параметрах можно прочитать [[QAS. UPS руководство по работе с интерфейсом#Поиск ответа\|тут]].
	[[Файл:2025-05-28 16-48-05.png\|мини\|''<small>Рис. 23 Интерфейс вкладки Интерактив в режиме Очистка чата</small>'']]		[[Файл:2025-05-28 16-48-05.png\|мини\|''<small>Рис. 23 Интерфейс вкладки Интерактив в режиме Очистка чата</small>'']]