База знаний — поиск по загруженным файлам рабочего пространства. RAG (Retrieval-Augmented Generation — ответы с опорой на ваши файлы): фрагменты и источник остаются в контуре, если так настроено.
С базой знаний в Pailot вы можете:
- Искать похожие фрагменты по смыслу (векторное сходство), а не только по точным словам
- Фильтровать выдачу тегами
- Создавать документы и дописывать в них чанки (фрагменты текста)
- Помечать документы тегами
tag1–tag7или структурированными тегами
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. База знаний выбирается в настройках блока — это данные рабочего пространства, не внешний ключ.
Инструменты
knowledge_search
Поиск похожего содержимого в базе знаний по векторному сходству.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
knowledgeBaseId | string | Да | ID базы знаний для поиска |
query | string | Нет | Текст запроса (необязателен, если заданы фильтры по тегам) |
topK | number | Нет | Сколько наиболее похожих результатов вернуть (1–100) |
tagFilters | array | Нет | Фильтры тегов: объекты с полями tagName и tagValue |
items | object | Нет | Нет описания |
properties | string | Нет | Нет описания |
tagName | string | Нет | Нет описания |
tagValue | string | Нет | Нет описания |
Выход
| Параметр | Тип | Описание |
|---|---|---|
results | array | Результаты поиска в базе знаний |
↳ documentId | string | ID документа |
↳ documentName | string | Название документа |
↳ content | string | Текст фрагмента |
↳ chunkIndex | number | Номер чанка в документе |
↳ similarity | number | Оценка сходства |
↳ metadata | object | Метаданные результата, включая теги |
query | string | Выполненный поисковый запрос |
totalResults | number | Сколько результатов найдено |
cost | object | Стоимость операции поиска |
knowledge_upload_chunk
Добавить новый чанк в документ базы знаний.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
knowledgeBaseId | string | Да | ID базы знаний с документом |
documentId | string | Да | ID документа, в который пишется чанк |
content | string | Да | Текст чанка |
Выход
| Параметр | Тип | Описание |
|---|---|---|
data | object | Данные загруженного чанка |
↳ chunkId | string | ID чанка |
↳ chunkIndex | number | Номер чанка в документе |
↳ content | string | Текст чанка |
↳ contentLength | number | Длина текста в символах |
↳ tokenCount | number | Число токенов в чанке |
↳ enabled | boolean | Включён ли чанк |
↳ createdAt | string | Время создания |
↳ updatedAt | string | Время последнего обновления |
message | string | Сообщение об успехе или ошибке |
documentId | string | ID документа, в который добавлен чанк |
documentName | string | Название документа |
cost | object | Стоимость операции загрузки |
knowledge_create_document
Создать документ в базе знаний.
Вход
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
knowledgeBaseId | string | Да | ID базы знаний |
name | string | Да | Название документа |
content | string | Да | Текст документа |
tag1 | string | Нет | Значение тега 1 |
tag2 | string | Нет | Значение тега 2 |
tag3 | string | Нет | Значение тега 3 |
tag4 | string | Нет | Значение тега 4 |
tag5 | string | Нет | Значение тега 5 |
tag6 | string | Нет | Значение тега 6 |
tag7 | string | Нет | Значение тега 7 |
documentTagsData | array | Нет | Структурированные теги: имена, типы и значения |
items | object | Нет | Нет описания |
properties | string | Нет | Нет описания |
tagName | string | Нет | Нет описания |
tagValue | string | Нет | Нет описания |
tagType | string | Нет | Нет описания |
Выход
| Параметр | Тип | Описание |
|---|---|---|
data | object | Данные созданного документа |
↳ documentId | string | ID документа |
↳ documentName | string | Название документа |
↳ type | string | Тип документа |
↳ enabled | boolean | Включён ли документ |
↳ createdAt | string | Время создания |
↳ updatedAt | string | Время последнего обновления |
message | string | Сообщение об успехе или ошибке |
documentId | string | ID созданного документа |