Руководство арендатора

Пространства и знания

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

Пространства как граница приватности

Данные каждого конечного пользователя живут в пространствах. Пространство ограничивает три вещи: сессии чата, документы и долговременную память. Ограничение обеспечивает не код приложения, а row-level security в Postgres, поэтому переписка одного клиента физически не может попасть в контекст другого.

Агент участвует в пространстве только после того, как добавлен в него участником. Пустое пространство не отвечает никому — это сделано намеренно (принцип «пусто значит закрыто»).

Что из этого следует на практике:

  • Вернувшийся клиент продолжает с того места, где остановился: то же пространство, та же память.
  • Два клиента с одинаковыми вопросами получат ответы, окрашенные только их собственной историей.
  • Удаление пространства уносит с собой его сессии, документы и память.

Как работает поиск по базе знаний

Загруженные документы разбираются, делятся на фрагменты, векторизуются и сохраняются (текст фрагментов шифруется на уровне поля при хранении). В момент вопроса агент векторизует запрос и выполняет векторный поиск по вашим знаниям, опираясь в ответе на ваши документы, а не на открытый интернет.

База знаний тенанта и документы пространства

Поиск опирается на два слоя документов:

  1. База знаний тенанта — описания продуктов, FAQ и заготовленные ответы. Загружаются в консоли один раз и доступны всем агентам, к которым вы их подключили.
  2. Документы пространства — файлы, которые конкретный клиент присылает прямо в диалоге («вот мой договор»). Видны только внутри этого пространства.

Как сохранить точность поиска

  • Лучше несколько узких документов, чем один справочник на 200 страниц: границы фрагментов идут по структуре документа.
  • Давайте документам говорящие названия — заголовок сам по себе служит сигналом при поиске.
  • Обновляйте, а не дописывайте. Замените устаревший прайс-лист, а не кладите рядом вторую версию: две противоречащие редакции превращают поиск в лотерею.
  • Поддерживаемые форматы: PDF, Word (.docx), HTML и веб-страницы, обычный текст и Markdown.

Память

Помимо документов агенты ведут долговременную память в связке «пользователь + пространство»: высказанные предпочтения, важные факты, данные обещания. Память извлекается вместе со знаниями, и благодаря ей возвращение к клиенту выглядит продолжением разговора, а не допросом. Просмотреть и удалить записи памяти можно в консоли.