База знаний
База знаний собирает то, что должны знать ваши агенты: процедуры, FAQ, условия, карточки продуктов, справочные документы. Она принадлежит вашей организации; agent обращается к ней в тот момент, когда это нужно, через инструмент, вместо того чтобы держать всё в своей миссии.
Что она содержит
Три типа записей:
| Тип | Содержимое |
|---|---|
| Карточка | Текст в Markdown, написанный прямо в панели администрирования |
| Документ | Загруженный файл, текст которого извлекается автоматически для агентов |
| Папка | Каталог для организации карточек и документов |
Поддерживаемые форматы документов: PDF, Word (.doc, .docx), Excel (.xls, .xlsx), PowerPoint (.ppt, .pptx), текст, Markdown, HTML, CSV и изображения — до 50 МБ на файл.
Извлечение читает текст офисных форматов и PDF. Для изображения или отсканированного PDF (почти без текста) оно использует мультимодальную модель (машинное зрение) вашей организации. Неудачное извлечение можно перезапустить из панели администрирования.
Каждая запись в базу журналируется. Для её изменения требуется доступ к разделу Знание и индексирование; чтение открыто для участников организации.
Как её используют ваши агенты
Два инструмента, которые подключаются к agent:
knowledge.search— поиск по ключевым словам с весами (метки, затем название, описание, содержимое). Возвращает наиболее релевантную запись.knowledge.semantic_search— семантический поиск (по смыслу, а не по точным словам). Возвращает фрагменты с указанием источника и оценки.
Результаты предъявляются агенту как исходный материал: он отвечает на языке пользователя и не должен утверждать больше, чем говорит источник.
Семантический поиск
Для семантического поиска карточки и извлечённый из документов текст разбиваются на фрагменты и индексируются в векторной базе (Qdrant). Эмбеддинги вычисляются моделью bge-m3, обслуживаемой Ollama внутри нашей инфраструктуры: текст вашей базы не отправляется стороннему поставщику эмбеддингов.
Синхронизация автоматическая: созданная или изменённая карточка переиндексируется, удалённая запись убирается из индекса, а неудачная индексация повторяется. Семантический поиск зависит от его включения на экземпляре; в противном случае инструмент направляет агента к knowledge.search.
Область видимости на уровне модели
По умолчанию модель ищет по всей базе своей организации. Вы можете ограничить то, что она видит, на вкладке База знаний модели:
- отметить папку — даёт доступ ко всему её содержимому, включая то, что будет добавлено позже;
- отметить карточку или документ — даёт доступ только к нему.
Одна и та же область видимости применяется к обоим поисковым инструментам. Это инструмент релевантности (HR-ассистенту незачем читать коммерческий FAQ); изоляция в целях безопасности обеспечивается на уровне организации: база одной организации никогда не доступна для чтения другой.
Публичный доступ к документу по ссылке
Карточку или документ можно опубликовать по ссылке (/shared/…) для партнёра или клиента, у которого нет учётной записи betool. Папки не публикуются.
- Пароль — по желанию; запрашивается также при скачивании файла.
- Срок действия — по желанию, от 1 дня до 5 лет; без срока ссылка действует до её отзыва.
- Отзыв — в любой момент; повторная публикация создаёт новую ссылку и отзывает старую; удаление записи отзывает её ссылку. Отозванная, просроченная или неизвестная ссылка возвращает одну и ту же страницу «не найдено».
- Отображение: PDF или изображение показывается на странице; документ Markdown отображается с форматированием; HTML-страница показывается в изолированном фрейме (без скриптов и удалённых ресурсов). Остальные форматы скачиваются, при этом показывается извлечённый текст, если он есть.
- Публичные страницы не индексируются поисковыми системами, а число просмотров отслеживается.
Обновление без смены ссылки
Замена файла документа сохраняет его идентификатор, а значит, и уже распространённую ссылку: она сразу отдаёт новую версию. Текст, который читают агенты, заново извлекается из нового файла, так что то, что читают ваши агенты, и то, что видит ваш партнёр, не могут расходиться.
Обновление через предложение
Agent (или приложение, подключённое по MCP) может предложить изменить базу, с подтверждением человеком:
knowledge_update— создать или обновить текстовую карточку (полная замена, замена раздела или добавление в конец).knowledge_document_replace— заменить файл документа на месте, с сохранением публичной ссылки.
Ничего не применяется без явного Принять.