Knowledge sources и RAG

Knowledge sources — это контролируемый context, который NaviBot может использовать при ответах. Они отделены от OpenAI account.

Откройте:

/app/knowledge-sources

Типы источников

Source	Когда использовать
Markdown / docs	Product docs, FAQ, onboarding text, pasted knowledge
Notion	Страницы или базы, которыми управляет клиент
SeaTable	Structured knowledge tables и operational records

Статусы документов

Только документы со статусом ready используются как OpenAI context.

Status	Значение
pending	загружен, но еще не готов
ready	может использоваться ассистентом
disabled	виден в UI, но не используется ассистентом
error	indexing failed

Notion setup

Используйте:

• NOTION_API_KEY
• NOTION_DATABASE_ID

API key должен храниться в encrypted integration credentials. В RAG source config должны оставаться только безопасные значения: database id, limit и integration_id.

Выбор файлов

После загрузки файлов из Notion или другого источника клиент должен выбрать, какие документы используются. Disabled files остаются видимыми, но не попадают в OpenAI context.

Текущее ограничение

Индексация сейчас синхронная. Для небольших источников это нормально. Большие Notion или SeaTable базы позже лучше вынести в background job queue.