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

Содержание

Введение

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

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

Термины

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

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

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

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

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

  • Ваш адрес электронной почты: укажите уникальный адрес электронной почты, например primer@primer.ru. Письма отправляться не будут — адрес используется как идентификатор ассистента. Важно: один адрес электронной почты — один ассистент; не используйте один и тот же адрес повторно.
  • Пользовательская история: кратко опишите, кто будет пользоваться ассистентом и для каких задач. Это влияет на качество индекса и смысловое соответствие ответов.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

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

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

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

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

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

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

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

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

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

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