На этой странице
Обзор и архитектура¶
ContextBase индексирует документы и возвращает найденные фрагменты или ответы с источниками. Модели, пайплайны и права доступа задаются для каждого пространства.
Контейнеры C4¶
Диаграмма контейнеров C4 ·
SVG в полном размере¶
Путь документа¶
ContextBase сохраняет оригинал, извлекает текст, разбивает его на фрагменты и записывает данные в поисковые индексы пространства. Встроенный декодер читает текстовые файлы в UTF-8. Для PDF, офисных документов и сканов API и воркеры могут отправлять файлы по HTTP в отдельный сервис ContextBase Extractor.
Обычная загрузка по REST выполняет обработку в запросе. В управляемом пространстве отдельная команда загрузки или замены оригинала ставит задачу в очередь. Воркеры Celery через брокер Redis получают задачи обработки документов, переиндексации и оценки.
Путь запроса¶
Веб-интерфейс, CLI и SDK обращаются к REST API на Django Modern REST.
MCP-клиент агента отправляет JSON-RPC по HTTP в маршрут /mcp того же
приложения Django.
Django проверяет доступ, запускает поисковый пайплайн пространства и возвращает ранжированные фрагменты с источниками. Для генерации ответа пайплайн передаёт вопрос и найденные фрагменты настроенной языковой модели.
Данные и хранилища¶
PostgreSQL хранит настройки, права и метаданные. Плотные векторы по умолчанию хранятся в PostgreSQL с pgvector. У пространства может быть другой векторный бэкенд, например Qdrant, Chroma или Weaviate.
Оригиналы хранятся в файловой системе или в S3-совместимом хранилище. Быстрый старт использует сервис
minioна образе Silo.Redis обслуживает очереди Celery и общий кэш Django в production. Для брокера и кэша по умолчанию используются отдельные логические базы.
С чего начать¶
Задача |
Руководство |
|---|---|
Получить первый результат по справочнику |
|
Подключить существующую векторную коллекцию |
|
Вызвать поиск из приложения или агента |
Интеграции по REST, SDK и MCP |
Настроить поиск на своих вопросах |