Пространства и знания
Как устроена изоляция данных и как организовать документы, чтобы поиск по базе знаний оставался точным.
Пространства как граница приватности
Данные каждого конечного пользователя живут в пространствах. Пространство ограничивает три вещи: сессии чата, документы и долговременную память. Ограничение обеспечивает не код приложения, а row-level security в Postgres, поэтому переписка одного клиента физически не может попасть в контекст другого.
Агент участвует в пространстве только после того, как добавлен в него участником. Пустое пространство не отвечает никому — это сделано намеренно (принцип «пусто значит закрыто»).
Что из этого следует на практике:
- Вернувшийся клиент продолжает с того места, где остановился: то же пространство, та же память.
- Два клиента с одинаковыми вопросами получат ответы, окрашенные только их собственной историей.
- Удаление пространства уносит с собой его сессии, документы и память.
Как работает поиск по базе знаний
Загруженные документы разбираются, делятся на фрагменты, векторизуются и сохраняются (текст фрагментов шифруется на уровне поля при хранении). В момент вопроса агент векторизует запрос и выполняет векторный поиск по вашим знаниям, опираясь в ответе на ваши документы, а не на открытый интернет.
База знаний тенанта и документы пространства
Поиск опирается на два слоя документов:
- База знаний тенанта — описания продуктов, FAQ и заготовленные ответы. Загружаются в консоли один раз и доступны всем агентам, к которым вы их подключили.
- Документы пространства — файлы, которые конкретный клиент присылает прямо в диалоге («вот мой договор»). Видны только внутри этого пространства.
Как сохранить точность поиска
- Лучше несколько узких документов, чем один справочник на 200 страниц: границы фрагментов идут по структуре документа.
- Давайте документам говорящие названия — заголовок сам по себе служит сигналом при поиске.
- Обновляйте, а не дописывайте. Замените устаревший прайс-лист, а не кладите рядом вторую версию: две противоречащие редакции превращают поиск в лотерею.
- Поддерживаемые форматы: PDF, Word (
.docx), HTML и веб-страницы, обычный текст и Markdown.
Память
Помимо документов агенты ведут долговременную память в связке «пользователь + пространство»: высказанные предпочтения, важные факты, данные обещания. Память извлекается вместе со знаниями, и благодаря ей возвращение к клиенту выглядит продолжением разговора, а не допросом. Просмотреть и удалить записи памяти можно в консоли.