feat: synchroniser la configuration IA active du dashboard
All checks were successful
Validation Dashboard / Tests backend et build frontend (push) Successful in 43s
All checks were successful
Validation Dashboard / Tests backend et build frontend (push) Successful in 43s
This commit is contained in:
16
docs/ai-infrastructure-workflow.mmd
Normal file
16
docs/ai-infrastructure-workflow.mmd
Normal file
@@ -0,0 +1,16 @@
|
||||
flowchart TD
|
||||
APP[Application cliente] --> REF[Référentiel IA Santinova]
|
||||
REF --> DEC{Mode de décision}
|
||||
DEC -->|Recommandation| REC[Meilleur moteur autorisé]
|
||||
DEC -->|Choix manuel| MAN[Moteur externe autorisé]
|
||||
DEC -->|Moteur IA local| LOCAL[Moteur IA local]
|
||||
LOCAL --> OLLAMA[Ollama : modèle disponible]
|
||||
OLLAMA -->|Disponible| LOCAL_RESPONSE[Réponse locale]
|
||||
OLLAMA -->|Indisponible + repli activé| FALLBACK[Moteur externe de repli autorisé]
|
||||
REC --> EXTERNAL[Passerelle fournisseur]
|
||||
MAN --> EXTERNAL
|
||||
FALLBACK --> EXTERNAL
|
||||
EXTERNAL --> EXTERNAL_RESPONSE[Réponse externe]
|
||||
REF --> BUDGETS[Budgets, plafonds et traçabilité]
|
||||
LOCAL_RESPONSE --> BUDGETS
|
||||
EXTERNAL_RESPONSE --> BUDGETS
|
||||
25
docs/ai-infrastructure.md
Normal file
25
docs/ai-infrastructure.md
Normal file
@@ -0,0 +1,25 @@
|
||||
# Architecture IA — Référentiel IA et Moteur IA local
|
||||
|
||||
## Finalité
|
||||
|
||||
Le dispositif IA de Santinova sépare la **décision de routage**, assurée par le Référentiel IA, de l’**exécution locale**, assurée par le projet Moteur IA local. Chaque application cliente utilise uniquement le contrat sécurisé du Référentiel IA : aucune clé fournisseur, URL Ollama privée ou information d’accès interne n’est exposée aux applications.
|
||||
|
||||
| Composant | Rôle | Informations exposées aux applications |
|
||||
|---|---|---|
|
||||
| Référentiel IA Santinova | Catalogue, recommandation, décision effective, budgets, limites et passerelle d’invocation. | Moteur retenu, modèle, règles d’usage et contrat d’appel sécurisé. |
|
||||
| Moteur IA local | Disponibilité du service local, modèle Ollama prêt et exécution privée des conversations. | Modèle et statut public uniquement. |
|
||||
| Fournisseurs externes | Exécution des appels explicitement autorisés par application. | Aucun secret n’est transmis par le Référentiel. |
|
||||
|
||||
## Décision appliquée par application
|
||||
|
||||
Le Référentiel IA applique l’un des trois modes définis par l’administrateur. En mode **Recommandation**, il retient le moteur le mieux adapté au cas d’usage, aux capacités demandées et aux règles de coût. En mode **Choix manuel**, il utilise exclusivement le moteur externe choisi parmi ceux autorisés pour l’application. En mode **Moteur IA local**, il utilise le modèle local disponible, actuellement `llama3.2:1b` en recette.
|
||||
|
||||
Le mode local peut comporter un repli externe. Ce repli est **désactivé par défaut**, doit être activé application par application et ne peut désigner qu’un moteur expressément autorisé. Lorsqu’il est déclenché, l’événement est journalisé comme un repli : l’administrateur peut distinguer les appels locaux des appels externes dans les compteurs et les plafonds.
|
||||
|
||||
## Contrôles de sécurité et de budget
|
||||
|
||||
Les budgets et limites externes restent indépendants des plafonds propres au moteur local. Une limite locale atteinte bloque l’appel local avec un retour contrôlé ; elle ne déclenche pas de repli automatique. Le repli est réservé à l’indisponibilité du service local. Les clés API externes restent chiffrées côté serveur et les communications entre le Référentiel IA et le Moteur IA local utilisent un jeton de service conservé uniquement dans les environnements serveur.
|
||||
|
||||
## Exploitation en recette
|
||||
|
||||
Les deux applications sont accessibles en environnement de recette : le **Référentiel IA Santinova** pilote la décision applicative et le **Moteur IA local** supervise Ollama ainsi que les modèles disponibles. Le dashboard d’infrastructure fournit la vue graphique de ce workflow, tandis que la page Applications du Référentiel IA permet d’ajuster le mode de décision, les autorisations, les plafonds et le moteur de repli de chaque application.
|
||||
Reference in New Issue
Block a user