Catalogue des paramètres exposables — Aurora Nexus
(depuis `ADMIN_SETTINGS_CATALOG.md`)
Note : le dépôt est historiquement nommé “Aurora RAG” dans le code, mais le nom produit est Aurora Nexus.
Ce document décrit les paramètres réellement configurables dans Aurora Nexus et où ils vivent (base vs .env), avec leurs impacts (redémarrage, ré‑indexation, coûts).
Pour la liste complète des variables d’infrastructure, voir docs/03_Configuration/10-ENV-Reference.md.
1) Où se configurent les paramètres ?
Aurora Nexus distingue deux niveaux :
A) Configuration “infra” (fichier .env)
Pour tout ce qui est connectivité, ports, secrets techniques et endpoints internes (Postgres/Qdrant/MinIO/Gateway/Redis).
Exemples :
DATABASE_URL,QDRANT_URL,S3_ENDPOINT,REDIS_URL,HOST_*LLM_CREDENTIALS_ENC_KEY(Fernet) etGATEWAY_INTERNAL_SECRET
Règle : ne pas versionner de secrets, seulement .env.example.
B) Configuration “métier” (Postgres via UI Admin)
Pour tout ce qui est pilotable sans redéployer (paramètres RAG, Docling, UX assistant, cache, observabilité).
Deux tables principales :
system_settings: paramètres globaux (catégorie + clé + valeur +requires_restart).cache_settings: politique cache LLM par tenant / pack (enabled,mode, TTL, seuils).
2) Paramètres “UI Admin → Paramètres” (system_settings)
Les clés ci‑dessous sont seedées à l’installation (à partir des variables d’environnement courantes) puis éditables en UI.
Général (category=general)
| Clé | Type | Défaut (wizard/env) | Redémarrage | Notes |
|---|---|---|---|---|
INSTANCE_LOCALE | string | fr-FR | Non | Langue par défaut de l’instance |
DATE_DISPLAY_FORMAT | string | DD/MM/YYYY | Non | Format dates UI |
COMPANY_NAME | string | Aurora Mind | Non | Branding UI |
COMPANY_ADDRESS | string | "" | Non | Branding UI |
COMPANY_CONTACT_EMAIL | string | contact@example.com | Non | Branding UI |
COMPANY_CONTACT_PHONE | string | "" | Non | Branding UI |
COMPANY_LOGO_URL | string | "" | Non | Branding UI |
RAG & retrieval (category=rag)
| Clé | Type | Défaut (wizard/env) | Redémarrage | Notes / Impact |
|---|---|---|---|---|
EMBEDDINGS_MODEL | string | text-embedding-3-large | Oui | ⚠️ nécessite ré‑indexation Qdrant (dimension dépend du modèle) |
LANGCHAIN_MODEL_NAME | string | openai/gpt-4o | Non | Modèle “par défaut” (si aucun override) |
RETRIEVE_K | number | 3 | Non | Top‑K final envoyé au LLM |
FETCH_K | number | 10 | Non | Candidats initiaux (MMR) |
MMR_LAMBDA | number | 0.5 | Non | 1.0=pertinence, 0.0=diversité |
MAX_LLM_TOKENS | number | 1024 | Non | Limite de tokens de réponse côté API |
Pipeline Ingestion (category=docling)
| Clé | Type | Défaut (wizard/env) | Redémarrage | Notes |
|---|---|---|---|---|
MAX_CHUNK_SIZE | number | 1000 | Oui | ⚠️ impacts chunking → ré‑indexation requise |
MAX_WORKERS | number | 3 | Oui | Concurrence ingestion (CPU/RAM) |
BATCH_MAX_FILES | number | 10 | Non | Limite recommandée UI (non bloquante en MVP) |
BATCH_MAX_FILE_MB | number | 20 | Non | Limite recommandée UI (non bloquante en MVP) |
BATCH_MAX_TOTAL_MB | number | 200 | Non | Limite recommandée UI (non bloquante en MVP) |
DOC_OCR | boolean | false | Non | OCR pour scans/images |
DOC_TABLE_STRUCTURE | boolean | false | Non | Extraction structure tableaux |
DOC_PICTURE_DESCRIPTION | boolean | false | Non | (optionnel) vision/description images |
DOC_PICTURE_CLASSIFICATION | boolean | false | Non | (optionnel) classification images |
DOC_FORMULA_ENRICHMENT | boolean | false | Non | (optionnel) formules |
DOC_GENERATE_PAGE_IMAGES | boolean | true | Non | Génération d’images de pages (utile OCR/diagnostic) |
OCR_REPROCESS_LAYOUT_THRESHOLD | number | 0.75 | Non | Seuil layout |
OCR_REPROCESS_LOW_THRESHOLD | number | 0.70 | Non | Seuil “low quality” |
OCR_REPROCESS_PARSE_THRESHOLD | number | 0.70 | Non | Seuil parsing |
KEYWORDS_MODE | string | pass0_only | Non | disabled / pass0_only / both |
KEYWORDS_TOPK | number | 12 | Non | Nombre de mots‑clés |
KEYWORDS_MINLEN | number | 3 | Non | Longueur min |
Assistant (category=assistant)
| Clé | Type | Défaut (wizard/env) | Redémarrage | Notes |
|---|---|---|---|---|
FEEDBACK_REQUIRED | boolean | false | Non | Force feedback Oui/Non avant nouvelle question |
ASSISTANT_SYSTEM_PROMPT | string | “You are Aurora RAG assistant…” | Non | ⚠️ Legacy / fallback : utilisé uniquement si le système de prompts versionnés est indisponible (migrations non jouées). Le prompt “runtime” recommandé est ASSISTANT_CORE (voir ci-dessous). |
Prompts système versionnés (recommandé)
Aurora Nexus gère le prompt système via des templates versionnés en base (tables prompt_templates / prompt_versions) :
ASSISTANT_CORE: prompt système global par défaut (utilisé si aucun prompt spécifique n’est défini pour un service).- Prompts par service : les services (
source_app) peuvent pointer vers unprompt_template_codevia un profil/service (ex : “Finance”, “Juridique”, etc.).
UI :
- Admin → Paramètres → Modèles IA → carte ASSISTANT_CORE (aperçu + édition/versionning).
Observabilité / qualité (category=cache)
| Clé | Type | Défaut (wizard/env) | Redémarrage | Notes |
|---|---|---|---|---|
RAGAS_MODEL_NAME | string | LANGCHAIN_MODEL_NAME ou openai/gpt-4o-mini | Non | Modèle utilisé pour les évaluations RAGAS |
Logs (minimisation / PII) (category=logging)
Objectif : contrôler ce qui est persisté dans queries_log (historique, conformité, volumétrie).
| Clé | Type | Défaut (wizard/env) | Notes |
|---|---|---|---|
QUERIES_LOG_STORE_QUESTION | boolean | true | Stocker la question |
QUERIES_LOG_STORE_ANSWER | boolean | true | Stocker la réponse |
QUERIES_LOG_MAX_QUESTION_CHARS | number | 0 | 0 = illimité (MVP) |
QUERIES_LOG_MAX_ANSWER_CHARS | number | 0 | 0 = illimité (MVP) |
QUERIES_LOG_MAX_CITATIONS | number | 20 | Limite nombre de citations loggées |
QUERIES_LOG_MAX_CITATIONS_BYTES | number | 20000 | Limite taille JSON citations |
QUERIES_LOG_MAX_CITATION_FIELD_CHARS | number | 512 | Limite taille champs (titre/uri/…) |
Rétention (category=retention)
Ces durées sont client‑dépendantes (RGPD/politique interne) et doivent être ajustées.
| Clé | Type | Défaut (wizard/env) |
|---|---|---|
QUERIES_LOG_RETENTION_DAYS | number | 730 |
OPENROUTER_USAGE_RETENTION_DAYS | number | 365 |
LLM_EVALUATION_RETENTION_DAYS | number | 90 |
EMBEDDINGS_LOG_RETENTION_DAYS | number | 365 |
OAUTH_LOGIN_CODES_RETENTION_DAYS | number | 7 |
3) Paramètres “UI Admin → Cache LLM” (cache_settings)
La politique cache est stockée par (tenant_id, pack_id) (pack nullable = valeurs globales tenant).
| Champ | Type | Défaut DB | Rôle |
|---|---|---|---|
enabled | boolean | true | Active/désactive le cache |
mode | string | mixed | exact / semantic / mixed / disabled |
ttl_seconds | number | 86400 | TTL des entrées |
semantic_threshold | number | NULL | Seuil similarité pour hit sémantique |
semantic_top_k | number | 5 | Candidats examinés (sémantique) |
max_hits | number | NULL | Limite de réutilisation (optionnel) |
4) Impacts “redémarrage” et “ré-indexation”
EMBEDDINGS_MODEL: changement = ré‑indexation Qdrant (dimension) + cohérence cache sémantique.MAX_CHUNK_SIZE: changement = ré‑ingestion / ré‑indexation (chunks différents).MAX_WORKERS: changement = redémarrage du service ingestion recommandé.
5) Références
- UI :
/{locale}/support/rag-parameters(explications contextuelles des paramètres) - API :
AURORA_NEXUS_API.md+openapi.json - Dépannage :
docs/05_Operations/30-Troubleshooting.md