Руководство пользователя Платформа для создания умных поисковых ИИ-ассистентов «Инсайтстрим»

Содержание

Введение

Создание ассистента по документам и поиск по локальным файлам

Платформа для создания умных поисковых ИИ-ассистентов "ИнсайтСтрим" (далее Инсайтстрим) — это система локального поиска по вашим документам. Ниже приведена краткая структурированная инструкция: как создать ассистента по документам, где открыть веб-интерфейс и как эффективно формулировать запросы.

Термины

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

Доступ к веб-интерфейсу

  1. Откройте браузер
  2. Перейдите по адресу:
    http://<адрес_или_домен_сервера>:8080/indexui/
  3. При необходимости авторизуйтесь (обратитесь к администратору за учётной записью).

Создание ассистента: пошагово

Шаг 1: Заполнение информации об ассистенте

  • Ваш email: укажите уникальный email адрес (например, test@example.com). Письма отправляться не будут — адрес используется как идентификатор ассистента. Важно: один email = один ассистент, не используйте повторно.
  • Пользовательская история: кратко опишите, кто будет пользоваться ассистентом и для каких задач. Это влияет на качество индекса и релевантность ответов.

Шаг 2: Загрузка документов

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

  • PDF (.pdf)
  • Microsoft Word (.docx)
  • Текстовые файлы (.txt)
  • и другие форматы (зависит от настроек установки)

Шаг 3: Запуск индексации

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

Интерфейс поиска информации

После завершения индексации веб-интерфейс для запросов к ассистенту доступен по ссылке:

http://<адрес_или_домен_сервера>:8080/<ID_индекса>

ID_индекса выдаётся после завершения индексации.

Структура интерфейса

  • Поле ввода вопроса
  • Ответ ассистента (можно оценить)
  • Источники — документы и цитаты
  • Релевантные вопросы — подсказки для уточнения

Как формулировать запросы

Рекомендуется:

  • Задавать конкретный вопрос (одна тема за раз).
  • Указывать контекст, если он важен (например: «в контексте внутреннего портала»).
  • Уточнять термины, версии, даты и т. п., если это критично.

Не рекомендуется:

  • Объединять несколько тем в один запрос.
  • Задавать общие вопросы, не связанные с базой знаний ассистента.

Примеры

  • ✅ Как получить доступ к панели мониторинга?
  • ✅ Где посмотреть статус обработки документа?
  • ⛔ Расскажи всё про систему.
  • ⛔ Как работает вообще?
  • ⛔ Как завязать галстук? (не относится к базе знаний)

Оценка ответа

Каждый ответ можно оценить:

  • /палец вверх/ — положительная оценка
  • /палец вниз/ — отрицательная оценка (откроется форма выбора причины)

Когда ставить /палец вверх/

  • Ответ полный и соответствует запросу.
  • Факты достоверны.
  • Есть корректные ссылки на документы.
  • Стиль удобен для чтения.

Когда ставить /палец вниз/

  1. Фактическая ошибка — неверные данные, противоречие документации.
  2. Неполный ответ — пропущены важные детали.
  3. Не нравится стиль — трудно читать или неудобная структура.
  4. Неверный источник — нерелевантные документы.
  5. Должен знать, но не нашёл.
  6. Не понял вопрос — неверная интерпретация.
  7. Другое — свободное описание проблемы.

Краткие советы по качеству поиска

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