Agents IA
GovernIA intègre une couche d'agents IA configurable qui alimente toutes les fonctionnalités d'intelligence artificielle : génération de recommandations, analyse d'audit, OCR de documents, résumés et rapports automatisés.
Par défaut, la plateforme utilise Mistral AI. Vous pouvez la remplacer par n'importe quel provider compatible (format OpenAI) — OpenAI, Azure OpenAI, Groq, Ollama, vLLM, ou tout endpoint d'inférence self-hosted.
Pour connecter votre propre infrastructure IA par tenant (marque blanche / souveraineté des données), voir Infrastructure personnalisée.
Fonctionnalités IA
| Fonctionnalité | Description |
|---|---|
| Recommandations | Génération automatique d'actions de remédiation à partir des réponses au questionnaire |
| Rapports d'audit | Rédaction des sections de rapport (constats, conclusion, axes d'amélioration) |
| Analyse d'evidence | Évaluation IA des preuves de remédiation soumises |
| OCR | Extraction de texte depuis des documents scannés (PDF, images) |
| Enrichissement | Résumés et contextualisations des audits |
Configuration
Depuis Backoffice → Paramètres → Agents IA, renseignez la clé API, la Base URL du provider, les modèles et les tarifs. Les fonctions IA restent désactivées tant que la clé API et la Base URL ne sont pas configurées.
La configuration tenant (marque blanche) prend le dessus sur la configuration plateforme. Voir Infrastructure personnalisée.
Champs disponibles
| Champ | Description |
|---|---|
| Clé API | Clé API chez votre provider IA |
| Base URL | URL de base du provider (ex : https://api.mistral.ai, https://api.openai.com) |
| Modèle par défaut | Modèle utilisé pour toutes les tâches sauf override spécifique |
| Timeout (ms) | Délai max par requête — défaut 240 000 ms (4 min) |
| Prix input / output / OCR | Tarifs pour le suivi des coûts dans les analytics |
Modèles par tâche (optionnel)
| Tâche | Description |
|---|---|
| Questionnaire (draft) | Génération des réponses initiales |
| Rapport / analyse | Rédaction des sections de rapport |
| Recommandations | Génération des actions de remédiation |
| Enrichissement | Résumés et contextualisations |
| Résumé | Synthèses courtes |
| OCR | Analyse de documents scannés |
Si un champ est vide, le modèle par défaut est utilisé pour cette tâche.
Prompts IA configurables
Les prompts système peuvent être personnalisés depuis l'onglet Prompts. Chaque prompt est pré-rempli avec les valeurs par défaut de GovernIA et peut être adapté à votre contexte métier (terminologie sectorielle, niveau de détail, langue des rapports…).
Providers compatibles
GovernIA appelle {Base URL}/v1/chat/completions (texte) et {Base URL}/v1/ocr (OCR). Tout provider exposant cette interface est compatible.
| Provider | Base URL | Notes |
|---|---|---|
| Mistral AI | https://api.mistral.ai | Provider par défaut |
| OpenAI | https://api.openai.com | GPT-4o, GPT-4o mini… |
| Azure OpenAI | https://<resource>.openai.azure.com/openai/deployments/<deployment> | Déploiement Azure |
| Groq | https://api.groq.com/openai | Inférence rapide |
| Ollama (self-hosted) | http://localhost:11434/v1 | Modèles locaux |
| vLLM / LM Studio | URL de votre serveur | Self-hosted |
Si votre provider ne supporte pas l'OCR (
/v1/ocr), l'OCR Mistral de la plateforme est utilisé en fallback.
Fonctionnement technique
Chat completions
- Appels vers
POST {Base URL}/v1/chat/completions - Réponses structurées en JSON strict (JSON schema enforcement)
- Traçabilité complète :
userId,tenantId,auditId, famille d'audit, tokens consommés
OCR
- Appels vers
POST {Base URL}/v1/ocr - Deux modes :
STANDARD(extraction brute) etANNOTATION(analyse structurée) - Utilisé pour l'analyse des documents soumis comme preuves
Gestion des coûts
- Chaque appel loggue les tokens consommés (
prompt_tokens,completion_tokens) - Le coût estimé est calculé en euros et stocké en micro-euros dans la base de données
Dépannage
| Problème | Cause probable | Solution |
|---|---|---|
| Les recommandations ne se génèrent pas | Clé API ou Base URL manquante | Vérifier la configuration dans Paramètres → Agents IA |
| Timeout lors de la génération de rapport | Rapport très long | Augmenter le Timeout dans Paramètres → Agents IA |
| Erreur 429 (rate limit) | Quota dépassé chez le provider | Vérifier votre plan chez le provider |
| OCR sans résultat | Document illisible ou format non supporté | Vérifier que le fichier est un PDF ou une image claire |