# Знания

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

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

<table id="bkmrk-%D0%A7%D1%82%D0%BE-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%B0%D0%B8%D0%B2%D0%B0%D0%B5%D1%82%D1%81%D1%8F-%D0%94%D0%BB"><thead><tr><th>Что настраивается</th><th>Для чего применяется</th></tr></thead><tbody><tr><td>**Набор документов**</td><td>Ограничить поиск нужной тематикой (например, только правила выдачи займов).</td></tr><tr><td>**Модель векторизации**</td><td>Выбрать алгоритм, по которому система находит подходящие фрагменты знаний.</td></tr><tr><td>**Порог уверенности**</td><td>Отсеять ответы, которые мало подходят по смыслу.</td></tr><tr><td>**Максимальное число фрагментов**</td><td>Ограничить объём «справки», передаваемой LLM: система вернёт не больше указанного количества наиболее подходящих кусочков текста. Чем число меньше, тем короче контекст и быстрее ответ; слишком большое значение — больше нагрузки и риск «размытого» ответа.</td></tr></tbody></table>

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/image.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/image.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/f0Vimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/f0Vimage.png)

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

- название;
- краткое описание;
- число подключённых документов;
- дату и время создания;
- ссылку **«Протестировать»**.

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

- строка поиска по названию;
- кнопка **«Добавить знание»** — открывает окно создания нового знания.

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

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

<table id="bkmrk-%D0%A8%D0%B0%D0%B3-%D0%94%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D1%8F-1.-%D0%9D%D0%B0%D0%B7%D0%B2" style="width: 100%;"><thead><tr><th style="width: 19.5424%;">Шаг</th><th style="width: 80.4576%;">Действия</th></tr></thead><tbody><tr><td style="width: 19.5424%;">**1. Название и описание**</td><td style="width: 80.4576%;">Укажите понятное название и коротко опишите назначение. При необходимости измените модель для векторизации (некоторые модели лучше работают для тех или иных задач, если не знаете, какую выбрать, оставьте модель по умолчанию). Нажмите **«Продолжить»**. [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/INjimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/INjimage.png)

</td></tr><tr><td style="width: 19.5424%;">**2. Выбор документов**</td><td style="width: 80.4576%;">Отметьте документы, которые следует включить в поиск. При необходимости используйте строку поиска. Нажмите **«Продолжить»**. [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/davimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/davimage.png)

</td></tr></tbody></table>

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/scaled-1680-/g1qimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-05/g1qimage.png)

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/gzTimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/gzTimage.png)

<table id="bkmrk-%D0%97%D0%BE%D0%BD%D0%B0-%D0%B8%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81%D0%B0-%D0%A1%D0%BE%D0%B4%D0%B5" style="width: 100%;"><thead><tr><th style="width: 19.5471%;">Зона интерфейса</th><th style="width: 38.8287%;">Содержимое</th><th style="width: 41.6242%;">Доступные действия</th></tr></thead><tbody><tr><td style="width: 19.5471%;">**Информация (верх)**</td><td style="width: 38.8287%;">название, описание, дата/время создания, количество документов</td><td style="width: 41.6242%;">—</td></tr><tr><td style="width: 19.5471%;">**Список документов (центр)**</td><td style="width: 38.8287%;">перечень подключённых файлов</td><td style="width: 41.6242%;">**«Управлять документами»** — открыть окно выбора/снятия галочек</td></tr><tr><td style="width: 19.5471%;">**Панель настроек (справа)**</td><td style="width: 38.8287%;">*Модель для векторизации* (выпадающий список) • *Порог уверенности* (ползунок) • *Максимальное число фрагментов* (счётчик)</td><td style="width: 41.6242%;">1) Измените параметры → **«Применить и переиндексировать»**. 2) **«Изменить название и описание»** — откроет модальное окно. 3) **«Удалить»** — удалит знание после подтверждения. 4) **«Протестировать»** — откроет страницу тестирования работы знания (поиск по подключённым документам).</td></tr></tbody></table>

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/ESQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/ESQimage.png)

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

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

[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/cZHimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/cZHimage.png)

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

- порядковый номер;
- уровень уверенности;
- название документа (ссылка);
- короткая цитата.

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

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

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

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

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

**<span class="_fadeIn_m1hgl_8">Как </span><span class="_fadeIn_m1hgl_8">подключить </span><span class="_fadeIn_m1hgl_8">базу </span><span class="_fadeIn_m1hgl_8">знаний </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">блоке «</span><span class="_fadeIn_m1hgl_8">Диалог </span><span class="_fadeIn_m1hgl_8">с </span><span class="_fadeIn_m1hgl_8">LLM»  
[![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/3hTimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/3hTimage.png)  
</span>**

1. <span class="_fadeIn_m1hgl_8">Откройте </span><span class="_fadeIn_m1hgl_8">свойства </span><span class="_fadeIn_m1hgl_8">блока </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Диалог </span><span class="_fadeIn_m1hgl_8">с </span><span class="_fadeIn_m1hgl_8">LLM»</span>**<span class="_fadeIn_m1hgl_8">.</span>
2. <span class="_fadeIn_m1hgl_8">В </span><span class="_fadeIn_m1hgl_8">поле </span>**<span class="_fadeIn_m1hgl_8">«Знания</span><span class="_fadeIn_m1hgl_8">»</span>** <span class="_fadeIn_m1hgl_8">выберите </span><span class="_fadeIn_m1hgl_8">нужное знание</span><span class="_fadeIn_m1hgl_8"> из списка добавленных.</span>
3. При необходимости уточните порог уверенности и максимальное число фрагментов.
4. <span class="_fadeIn_m1hgl_8">Сохраните </span><span class="_fadeIn_m1hgl_8">блок.</span>

<span class="_fadeIn_m1hgl_8">После </span><span class="_fadeIn_m1hgl_8">этого </span><span class="_fadeIn_m1hgl_8">модель </span><span class="_fadeIn_m1hgl_8">будет </span><span class="_fadeIn_m1hgl_8">опираться </span><span class="_fadeIn_m1hgl_8">на </span><span class="_fadeIn_m1hgl_8">документы </span><span class="_fadeIn_m1hgl_8">из </span><span class="_fadeIn_m1hgl_8">выбранного знания</span><span class="_fadeIn_m1hgl_8">:</span>

- <span class="_fadeIn_m1hgl_8">отвечать </span><span class="_fadeIn_m1hgl_8">по </span><span class="_fadeIn_m1hgl_8">их </span><span class="_fadeIn_m1hgl_8">содержанию;</span>
- <span class="_fadeIn_m1hgl_8">соблюдать </span><span class="_fadeIn_m1hgl_8">правила, </span><span class="_fadeIn_m1hgl_8">которые </span><span class="_fadeIn_m1hgl_8">там </span><span class="_fadeIn_m1hgl_8">описаны.</span>

<span class="_fadeIn_m1hgl_8">Что </span><span class="_fadeIn_m1hgl_8">именно </span><span class="_fadeIn_m1hgl_8">делать </span><span class="_fadeIn_m1hgl_8">с </span><span class="_fadeIn_m1hgl_8">этими </span><span class="_fadeIn_m1hgl_8">данными, </span><span class="_fadeIn_m1hgl_8">задаётся </span><span class="_fadeIn_m1hgl_8">в </span><span class="_fadeIn_m1hgl_8">промпте </span><span class="_fadeIn_m1hgl_8">блока:</span>

- <span class="_fadeIn_m1hgl_8">в </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Задаче»</span>** <span class="_fadeIn_m1hgl_8">коротко </span><span class="_fadeIn_m1hgl_8">опишите </span><span class="_fadeIn_m1hgl_8">требуемое </span><span class="_fadeIn_m1hgl_8">действие;</span>
- <span class="_fadeIn_m1hgl_8">в </span>**<span class="_fadeIn_m1hgl_8">«</span><span class="_fadeIn_m1hgl_8">Контексте»</span>** <span class="_fadeIn_m1hgl_8">при </span><span class="_fadeIn_m1hgl_8">необходимости </span><span class="_fadeIn_m1hgl_8">добавьте </span><span class="_fadeIn_m1hgl_8">подробности.</span>

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

1. Откройте нужное знание.
2. В правой панели нажмите **«Удалить»** и подтвердите действие.
    
    [![image.png](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/scaled-1680-/whQimage.png)](https://docs.ai-assistant.is74.ru/uploads/images/gallery/2025-07/whQimage.png)

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

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

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