Module AIRA BI (FR): Difference between revisions
(Version 1.4.3) |
(FR categories: TemplateDocUtil + Category:Modules complémentaires) |
||
| Line 5: | Line 5: | ||
<!-- END interlang links --> | <!-- END interlang links --> | ||
{{ | {{TemplateDocUtil}} | ||
{{TemplateModuleInfo | {{TemplateModuleInfo | ||
|modulename=AIRA BI | |modulename=AIRA BI | ||
| Line 120: | Line 120: | ||
* LinkedIn : [https://www.linkedin.com/in/mohamed-aggoubi/ Mohamed Aggoubi] | * LinkedIn : [https://www.linkedin.com/in/mohamed-aggoubi/ Mohamed Aggoubi] | ||
[[Category | [[Category:Modules complémentaires]] | ||
Latest revision as of 20:01, 12 November 2026
| Module name | AIRA BI |
| Editor / Editeur | Weglob - https://weglob.com |
| Download or buy page / Page achat ou téléchargement | External module - https://www.dolistore.com/product.php?id=2841 |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | Dolibarr 19.0+, PHP 8.0+, une clé API d'un fournisseur IA
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-11-12 |
| Note / Nota | ID module 500100 |
Module AIRA BI
| Nom | Valeur |
|---|---|
| Éditeur | Weglob |
| Statut | Stable |
| Version | 1.4.3 |
| ID module | 500100 |
| Compatibilité Dolibarr | 19.0 et plus |
| Licence | GPL v3 ou ultérieure |
| Langues | Français, anglais |
Description
AIRA BI est un assistant IA intégré à Dolibarr. Les utilisateurs posent leurs questions sur les données de l'ERP en langage naturel et obtiennent la réponse en texte, en tableau ou en graphique.
Exemples :
- ventes par mois sur 6 mois
- top 10 clients par chiffre d'affaires
- factures impayées par client
- solde des comptes bancaires
- état des projets par statut
Le moteur suit un circuit contrôlé : question → contexte du schéma → plan IA → validation → SQL en lecture seule → affichage dans le chat. C'est un assistant Dolibarr, pas un chatbot généraliste.
Fonctionnalités
- Réponse en texte, tableau ou graphique selon la question.
- Mémoire de conversation : questions de suivi, affiner un filtre, demander une autre vue.
- Conversations enregistrées par utilisateur et par entité, réouverture ou suppression depuis le panneau latéral.
- Liens vers les rapports natifs (customreports.php) quand le résultat correspond à un rapport Dolibarr.
- Suggestions d'accueil affichées seulement si l'utilisateur a les droits nécessaires.
- Aide à l'utilisation de Dolibarr (« comment créer une facture ? ») sans lecture de la base.
- Choix du fournisseur IA : OpenRouter (des centaines de modèles, dont des gratuits), OpenAI, Google Gemini, NVIDIA.
- Messages d'erreur clairs (fournisseur, modèle, erreur technique) si l'API IA échoue.
Sécurité
Chaque requête passe par un garde-fou SQL :
- SELECT uniquement, une seule instruction, sans commentaires ni variables.
- Aucune requête d'écriture, aucun export (INTO OUTFILE), aucun schéma système.
- Liste blanche des tables métier : chaque table exige le module Dolibarr correspondant et le droit de l'utilisateur (ex. factures : « Lire les factures »).
- Colonnes sensibles interdites (mots de passe, clés API, jetons).
- Filtre entity imposé (sûr en multi-société).
- Nombre de lignes et durée d'exécution plafonnés.
- Exécution dans une transaction en lecture seule, ou avec un utilisateur MySQL en lecture seule (recommandé).
Les clés API et le mot de passe MySQL lecture seule sont chiffrés en base et jamais réaffichés.
Confidentialité
Envoyé au fournisseur IA : la question, l'historique de la conversation et la description des tables autorisées. Les résultats des requêtes ne sont pas envoyés. Les offres gratuites (modèles OpenRouter :free, Gemini gratuit, crédits d'essai NVIDIA) peuvent conserver les requêtes : préférez une offre payante pour les données sensibles.
Captures d'écran
Écran d'accueil et suggestions
Réponse en graphique : ventes par mois
Configuration : choix du fournisseur IA
Installation
- Acheter et télécharger le zip du module sur DoliStore.
- Aller dans Accueil > Configuration > Modules/Applications > Déployer/installer un module externe et envoyer le zip.
- Ou le décompresser manuellement dans htdocs/custom/ pour obtenir htdocs/custom/aichat.
Configuration
- Activer le module AIRA BI.
- Ouvrir la page de configuration du module.
- Choisir le fournisseur : OpenRouter, OpenAI, Google Gemini ou NVIDIA.
- Saisir la clé API (le bouton « Obtenir une clé » ouvre la page du fournisseur).
- Choisir le modèle. Pour OpenRouter, la liste vient du catalogue en direct avec prix et taille de contexte ; un avertissement s'affiche si le modèle configuré a été retiré.
- Enregistrer.
- Optionnel mais recommandé : créer un utilisateur MySQL en lecture seule et le saisir dans la configuration :
CREATE USER 'dolibarr_ro'@'localhost' IDENTIFIED BY 'motdepasse'; GRANT SELECT ON dolibarr.* TO 'dolibarr_ro'@'localhost';
- Optionnel : activer la fonction BI / rapports de Dolibarr pour obtenir les liens customreports dans le chat.
Le serveur Dolibarr doit joindre l'API du fournisseur en HTTPS (paramètre PHP curl.cainfo renseigné avec les certificats racine).
FAQ
- L'assistant répond par une erreur IA
- Vérifier la clé API, le quota et que le modèle est toujours disponible. Le message indique le fournisseur et le modèle utilisés.
- « Aucune donnée trouvée »
- Aucun enregistrement Dolibarr ne correspond. Modifier la période ou le filtre.
- Un utilisateur ne voit pas certaines suggestions ou reçoit un refus
- Il n'a pas le droit Dolibarr sur le module concerné (factures, commandes, banque...). C'est voulu.
- Peut-il modifier mes données ?
- Non. Seules les requêtes SELECT en lecture seule sont autorisées.
Support
- E-mail : contact@weglob.com
- Site : weglob.com
- LinkedIn : Mohamed Aggoubi