Settings — MiniRag

Настройки

LLM-ключи и конфигурация пайплайна

LLM-ключи (Gemini)

Включённые ключи используются round-robin на каждый запрос + failover на 429 (обход дневной квоты). Секрет хранится в БД, в UI — только маска.

Метка

API-ключ

Формат CSV: label,key (опц. третья колонка enabled); заголовок необязателен.

Метка	Ключ	Использован
gemini-1	`••••…DO4g`	27.06 07:03:01
gemini-2	`••••…2ctg`	27.06 07:03:02
gemini-3	`••••…MQzw`	27.06 07:03:02

Редактируемые настройки

Сохраняются в БД (app_settings), переопределяют appsettings без рестарта (Worker подхватывает ≤15с).

Chat

Модель /ask

Temperature (0–2)

Max output tokens

Фрагментов в контексте

Чанкинг

Размер чанка (символы)

Overlap (символы)

Чанкинг действует на новую индексацию; старые чанки — после reindex.

Гибридный поиск

Порог AND→OR (1–30)

Full-text сначала ищет по всем терминам (AND); если совпадений меньше порога — расширяет до «любого термина» (OR).

Embedding-модель

Смена размерности пересоздаёт колонку векторов и HNSW-индекс и стирает все эмбеддинги; поиск не работает, пока не завершится полный reindex. Embedding-квота тратится на переиндексацию всего корпуса.

Модель embedding

Размерность (64–2000)

Ниже — эффективная конфигурация пайплайна (из appsettings + app_settings + кода). Секреты маскируются.

Индексация

Размер чанка и overlap (символы). Подбираются на evaluation dataset.

Размер чанка	2800 симв.
Overlap	340 симв.

Embeddings (Gemini)

Векторизация чанков и запросов.

Модель	gemini-embedding-001
Размерность	768
Размер батча	90
Base URL	https://generativelanguage.googleapis.com/v1beta
Таймаут	120 с
API-ключ	(из env GEMINI_API_KEY)

Chat (Gemini)

Генерация ответа /ask и контекстуализация диалога.

Модель /ask	gemini-2.5-flash
Temperature	0.2
Max output tokens	2048
Фрагментов в контексте	6
Base URL	https://generativelanguage.googleapis.com/v1beta
Таймаут	120 с
API-ключ	(из env GEMINI_API_KEY)

Гибридный поиск (RRF)

Слияние vector + full-text. PerListLimit и RRF-k — код-константы; порог AND→OR редактируется.

Кандидатов на список	30
Константа RRF (k)	60
Порог AND→OR (FTS)	3 чанк(ов)
Списки	pgvector (cosine) + full-text (russian + english)

Tika

Извлечение текста и OCR из оригиналов.

Base URL	http://minirag-tika:9998
Таймаут	120 с

Хранилище (S3 / MinIO)

Оригиналы документов.

Endpoint	http://minirag-minio:9000
Bucket	minirag-documents
Region	us-east-1
Path-style	да
Presign TTL	15 мин
Access key	•••• (задан)
Secret key	•••• (задан)

RabbitMQ

Брокер пайплайна (MassTransit).

Host	minirag-rabbitmq
Port	5672
Virtual host	minirag
Username	minirag
Password	•••• (задан)

PostgreSQL

System of record + pgvector.

Connection string

Host=minirag-postgres;Port=5432;Database=minirag;Username=minirag;Password=••••