Центр знаний

База знаний

1. Назначение раздела

Раздел «База знаний» предназначен для хранения и организации документов, информация из которых используется интеллектуальными модулями платформы «Диалог».


2. Основной интерфейс

2.1 Документы

Элемент Описание Скриншот
Список документов Перечень загруженных файлов и созданных материалов.

 

image.png

 

Строка поиска Фильтрация списка по названию документа.

image.png

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

image.png

Загрузить документы Импорт готовых файлов в формате .txt, .docx, .md с локального компьютера (или перетаскиванием в область загрузки).

image.png

2.2 Папки

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

Создание — кнопка «Создать папку» (🗂 в верхней панели или кнопка «Создать папку» внутри уже открытой папки) → модалка «Создание папки» → укажите «Название папки».

image.png

Открыв папку, вы увидите её содержимое (карточка «Документы») и хлебные крошки «База знаний → {папка}» для навигации назад. Кнопки «Создать новый документ» и «Загрузить документы» создают/загружают файл в текущую открытую папку.

image.png

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

image.png


3. Добавление материалов

3.1 Загрузка существующего файла

image.png

  1. Нажмите кнопку «Загрузить документы».

  2. Укажите один или несколько файлов.

  3. Дождитесь появления выбранных элементов в списке.

3.2 Создание документа в интерфейсе

image.png

  1. Выберите «Создать новый документ».

  2. В списке появится пункт «Новый документ».

  3. Перейдите к документу одним щелчком.

  4. Введите или вставьте текст.

  5. Сохраните изменения кнопкой «Применить изменения».


4. Действия с документом

image.png

При наведении курсора на название открывается карточка с функциями:

Действие Назначение Скриншот
Переименовать Изменяет название файла.

image.png

Удалить Удаляет документ из базы знаний.

image.png

Открыть в новой вкладке Открывает документ на отдельной странице.

image.png

Щелчок по названию файла также открывает страницу просмотра и редактирования.


5. Страница редактирования

Левая область Правая область
Текст документа (редактируемый). «Фрагменты знаний» — логические части текста, используемые системой для работы «Знаний».

image.png

5.1 Сохранение правок

После внесения изменений нажмите «Применить изменения».

5.2 Индивидуальные настройки разбиения

Справа расположен переключатель «Задать кастомные настройки разбивки».

💡 Рекомендуемое минимальное значение — 100 токенов; максимум можно не ограничивать, но чем меньше фрагмент, тем точнее поиск.

После настройки нажмите «Применить изменения» для пересборки фрагментов.

5.3 Удаление документа

В боковой панели выберите «Удалить» и подтвердите действие.


6. Часто выполняемые задачи

Задача Действия
Найти документ Введите часть названия в строке поиска.
Исправить текст Откройте документ, внесите правки, нажмите «Применить изменения».
Обновить загруженный файл Загрузите новый файл с тем же названием; система заменит старую версию.
Настроить мелкие фрагменты Включите кастомные настройки, выберите «По предложениям».
Удалить документ Наведите курсор на название, кликните «Удалить».

7. Дополнительные сведения


Знания

Знание определяет, какие документы базы знаний и с какими правилами будут использованы поисковым модулем во время работы сценария.

Создав несколько отдельных знаний, вы сможете гибко управлять поиском:

Что настраивается Для чего применяется
Набор документов Ограничить поиск нужной тематикой (например, только правила выдачи займов).
Модель векторизации Выбрать алгоритм, по которому система находит подходящие фрагменты знаний.
Порог уверенности Отсеять ответы, которые мало подходят по смыслу.
Максимальное число фрагментов Ограничить объём «справки», передаваемой LLM: система вернёт не больше указанного количества наиболее подходящих кусочков текста. Чем число меньше, тем короче контекст и быстрее ответ; слишком большое значение — больше нагрузки и риск «размытого» ответа.

1. Переход в раздел

  1. Выберите пункт «Знания». В левом боковом меню
    На экране появится список всех знаний проекта.

image.png

2. Обзор списка

image.png

Карточка каждого знания показывает:

Дополнительно доступны:

3. Создание знания

Процесс создания состоит из трёх шагов.

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

image.png

2. Выбор документов Отметьте документы, которые следует включить в поиск. При необходимости используйте строку поиска. Нажмите «Продолжить».

image.png

После создания необходимо подтвердить индексацию документов - это нужно для того, чтобы LLM могла "считывать смысл" информации из документов. Более техническим языком - всем фрагментам знаний документов присваивается вектор, который в дальнейшем при использовании знания сравнивается с вектором пользовательского запроса. Длительность индексации зависит от объема документов.

image.png

4. Страница знания

image.png


Зона интерфейса Содержимое Доступные действия
Информация (верх) название, описание, дата/время создания, количество документов —
Список документов (центр) перечень подключённых файлов «Управлять документами» — открыть окно выбора/снятия галочек
Панель настроек (справа) Модель для векторизации (выпадающий список) • Порог уверенности (ползунок) • Максимальное число фрагментов (счётчик) 1) Измените параметры → «Применить и переиндексировать». 2) «Изменить название и описание» — откроет модальное окно. 3) «Удалить» — удалит знание после подтверждения. 4) «Протестировать» — откроет страницу тестирования работы знания (поиск по подключённым документам).

5. Тестирование знания

image.png

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

  1. Введите запрос в строку поиска.

  2. Нажмите «Найти» — система покажет подходящие фрагменты.

image.png

Для каждого фрагмента отображаются:

Справа можно настроить поля Порог уверенности и Максимальное число фрагментов.

Порог уверенности определяет, насколько точные по смыслу ответы стоит отображать - где 1 = 100% уверенность модели в том, что фрагмент подходит для ответа на запрос

Максимальное число фрагментов позволяет ограничить число фрагментов в выдаче.

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

6. Подключение знания в сценарий

Как подключить базу знаний в блоке «Диалог с LLM»
image.png

  1. Откройте свойства блока «Диалог с LLM».

  2. В поле «Знания» выберите нужное знание из списка добавленных.

  3. При необходимости уточните порог уверенности и максимальное число фрагментов.
  4. Сохраните блок.

После этого модель будет опираться на документы из выбранного знания:

Что именно делать с этими данными, задаётся в промпте блока:

7. Удаление знания

  1. Откройте нужное знание.

  2. В правой панели нажмите «Удалить» и подтвердите действие.

    image.png

Важно: если знание уже используется в сценариях, его удаление вызовет ошибку в этих блоках. Сначала исключите знание из сценариев.

8. Практические рекомендации

Нейроагенты

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

image.png


1. Просмотр и управление нейроагентами

  1. Откройте раздел Центр знаний → Нейроагенты.
    image.png

  2. На карточке каждого агента отображаются:

    image.png

    • Аватар (или градиент‑заглушка, если изображение не загружено).

    • Имя агента и модель.

    • Кнопки Настроить и Начать чат.

    • Бейдж По умолчанию для системного нейроагента. Системный нейроагент - это просто модель без дополнительных настроек, к нему можно обращаться за общими вопросами, он всегда добавляется в новые чаты. 

      image.png

  3. Старт чата из карточки Нейроагента по кнопке «Начать чат» создаёт шаблон беседы с двумя агентами:

    • Системным агентом (обязательный).

    • Выбранным агентом для общения (становится «по умолчанию» внутри чата). Если чат запущен с системным агентом — он будет единственным участником.

Обратите внимание, созданных нейроагентов могут видеть, редактировать и использовать все пользователи проекта


2. Создание нейроагента

Нажмите Создать нейроагента и пройдите четыре шага мастера.

Шаг 1. Общие параметры

image.png

Поле Описание Интерфейс
Название Обязательное. Отображается во всех интерфейсах.

image.png

Модель по умолчанию Выберите одну из доступных моделей

image.png

Аватар Необязательный. • Щёлкните по круглой заглушке и загрузите изображение.• Если загрузка не удалась — появится текст ошибки.• Без аватара в списках будет показан фирменный градиент.

image.png

temperature Регулирует случайность ответов модели: ближе к 0 — точнее и предсказуемее, ближе к 1 — разнообразнее.

image.png

Расширенные настройки модели Открывает окно с полным набором параметров генерации: Модель, temperature, top_p, max_new_tokens, stop sequences, Специализированные параметры (JSON) — тот же набор, что и у блока «Диалог с LLM».

image.png

Нажмите Далее — кнопка активируется, когда заполнено обязательное поле.

Шаг 2. Инструкции

image.png

Заполните системный промпт, который определяет «личность» и поведение агента.

Подсказка: используйте поля шаблона, приведённые в плейсхолдере, чтобы описать:• Кто ваш ИИ‑сотрудник? Кому помогает?• Что умеет делать и чего делать не должен?• Где работает и к какой информации имеет доступ?

Шаг 3. Подключённые знания

Добавьте знания, к которым агент получит доступ:

image.png

Параметр Описание Интерфейс
Выбор знаний Раскрывающийся список всех Знаний проекта.

 

image.png


 

Максимальное число возвращаемых фрагментов Лимит фрагментов текста, которые будут предложены модели для ответа (по умолчанию — 5). Чем больше число, тем больше информации получает модель. Обратите внимание, что слишком большое количество информации может запутать модель, из-за чего та будет давать некорректные ответы.

image.png

Порог уверенности Минимальный порог релевантности 0 – 1. Система сравнивает смысл запроса с фрагментами знаний и присваивает каждому оценку: 0 — почти нет совпадения, 1 — полное совпадение. Будут возвращены только фрагменты, у которых оценка не ниже заданного порога (по умолчанию 0.8).

image.png

Удалить / Добавить Кнопка крестик позволяет убрать добавленное знание.

image.png

Шаг 4. Инструменты

image.png

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

Нажмите Создать нейроагента для сохранения.

image.png


3. Редактирование

image.png

Нажмите «Настроить» на карточке агента. Далее:

  1. Откроется окно с вкладками: Общие параметры, Инструкции, Подключенные знания, Инструменты — по одной на каждый шаг мастера создания.
  2. Измените нужные параметры и нажмите «Сохранить выбор».
  3. Кнопка «Удалить нейроагента» — внизу вкладки «Общие параметры». Действие потребует подтверждения.

Важно: Если агент используется в Нейрочатах, удаление будет заблокировано.


4. Системный нейроагент

image.png

Платформа автоматически создаёт одного системного агента:


5. Рекомендации

Советы Пояснение
Используйте ясные имена «HR Интерсвязь» лучше, чем «Бот №3».
Держите промпт коротким 2–3 абзаца часто достаточно.
Разделяйте роли Создавайте отдельных агентов для разных задач: бухгалтерия, юристы, поддержка.
Тестируйте в Нейрочате Запустите беседу сразу после создания, чтобы проверить ответы.

Часто задаваемые вопросы

Q: Можно ли поменять модель у уже созданного агента?
A: Да. Откройте настройки агента и выберите другую модель в списке.

Q: Что будет, если удалить подключённые знания?
A: Агент перестанет обращаться к ним, но предыдущие ответы нейроагента с использованием этих знаний будут сохранены в нейрочатах.


Следующие шаги: ознакомьтесь с руководством «Нейрочаты», чтобы начать использовать ваших агентов в диалогах.

Нейрочаты

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

image.png

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


1. Что такое нейрочат

Нейрочат — это чат, в котором вы можете вести диалог с одним или несколькими нейроагентами.

image.png

Чат обязательно должен содержать хотя бы одного нейроагента.


2. Создание нового чата

image.png

  1. Перейдите в раздел Нейрочаты.

  2. Нажмите кнопку «Новый чат».

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

  4. Настраивайте чат под себя: добавляйте нейроагентов, меняйте аватар и название, изменяйте агентов по умолчанию.

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


3. Работа с агентами в чате

3.1. Агент по умолчанию

3.2. Обращение к конкретному агенту

3.3. Удаление агентов


4. Использование знаний

image.png

Если у нейроагента в чате есть доступ к знанию:


Нейрочаты — это удобный способ работы с несколькими нейроагентами в одном диалоге, с учётом их инструкций и знаний.

Настройки знаний

Общая информация о «Знаниях»

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

Настройки можно изменить на странице настройки знания или во время тестирования знания.
Интерфейсы различаются:


1. Как открыть настройки знания

image.png

  1. Перейдите в раздел Центр знаний → Знания.

  2. Выберите нужное знание из списка.

  3. В правом верхнем углу нажмите «Изменить настройки» или откройте вкладку «Настройки знания».

image.png

Вы попадёте на страницу с четырьмя блоками:

image.png

После внесения изменений нажмите «Сохранить настройки».


2. Настройки поиска

image.png

Этот блок определяет, как именно система ищет фрагменты знаний в подключённых документах.

Основные параметры


Дополнительные параметры

BM25 — поиск по ключевым словам

image.png

Включите, если хотите дополнить поиск по смыслу поиском по формулировкам.

Плюсы:

Минусы:


Reranking — повторная сортировка результатов

image.png

Опция улучшает качество поиска за счёт повторной проверки уже найденных фрагментов знаний.

При включении:

Дополнительные параметры:

image.png

Плюсы:

Минусы:


3. Настройки формирования контекста

Определяют, какую часть пользовательского диалога система использует для поиска по знаниям.

Доступны три режима:

Рекомендации:


4. Настройки результата

Определяют, в каком виде найденные данные передаются нейроагенту.

Плюсы:

Минусы:


5. Модель для векторизации

Определяет, какая модель используется для преобразования текста документов в векторное представление — то есть поиск по смыслу.

Во время пересчёта знание временно недоступно для использования.


6. Тестирование знания

После сохранения настроек можно проверить, как работает поиск.

  1. На странице тестирования знания введите запрос в строку поиска.

  2. Система покажет список найденных документов и фрагментов знаний.

  3. Результаты позволяют оценить, насколько хорошо работает текущая конфигурация.

Если результаты не удовлетворяют:


7. Применение и сохранение

После внесения изменений нажмите «Сохранить настройки» (на странице настройки)
или «Применить к знанию» (на странице тестирования).

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


💡 Сравнение методов

Метод Назначение Преимущества Ограничения
BM25 Поиск по ключевым словам Хорош при коротких или редких запросах Увеличивает время ответа, неэффективен при длинных запросах
Reranking Повторная сортировка найденных фрагментов знаний Повышает точность и качество ответов Увеличивает время отклика
Parent-child chunking Возврат целого документа с найденным фрагментом Сохраняет контекст, предотвращает искажения смысла Увеличивает объём данных и время обработки

Инструменты

Инструмент — это существующий SQL- или HTTP-запрос (см. страницы «SQL-запросы» и «HTTP-запросы»), обёрнутый в вызываемую функцию для нейроагента. Нейроагент сам решает, когда вызвать инструмент во время диалога — на основе описания, которое вы задаёте при создании.

Список инструментов

image.png

Центр знаний → Инструменты показывает таблицу всех инструментов проекта: тип запроса и название (иконка SQL/HTTP), и какие нейроагенты его используют («Не используется нейроагентами», если ни один агент не подключил). Строка поиска по названию, фильтр «Фильтровать инструменты», шестерёнка ⚙ у каждой строки — редактирование/удаление.

Создание инструмента

image.png

Кнопка «Создать инструмент»:

  1. Название — обязательное поле.
  2. SQL или HTTP-запрос — выбор уже существующего запроса из списка. Создать новый запрос отсюда нельзя — сначала создайте его на странице «SQL-запросы» или «HTTP-запросы».
  3. Описание — что умеет инструмент, какие входные параметры ожидает, дополнительный комментарий. По этому тексту нейроагент решает, когда и с какими параметрами вызвать инструмент.
  4. Обработка результата — что содержит результат запроса и в каком виде передать его нейроагенту.
  5. Кнопка «Создать инструмент» — активна только когда заполнены обязательные поля.

Подключение к нейроагенту

image.png

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