Aller au contenu principal

Dalfred — Agent IA et Assistant IA pour Dolibarr

Dalfred est un agent IA intégré à Dolibarr. Il transforme votre ERP en assistant intelligent : posez vos questions, dictez vos tâches, créez vos documents et explorez vos données en langage naturel — sans naviguer dans les menus, sans construire de filtres complexes, sans formation.

Le widget Dalfred sur le tableau de bord Dolibarr

Sous le capot, Dalfred utilise le protocole MCP (Model Context Protocol) pour interroger votre ERP de manière sécurisée, et fonctionne avec votre fournisseur d'IA préféré : Anthropic, OpenAI, Mistral, Google ou Ollama (auto-hébergé).

Pourquoi Dalfred ?

  • Interrogez vos données comme vous parlez — "Quel est mon CA du dernier trimestre ?", "Liste mes 10 meilleurs clients"
  • Créez et gérez vos documents en dictant — Une phrase suffit pour créer une facture avec lignes, totaux et calculs
  • Smart Queries — Sauvegardez vos requêtes favorites, paramétrez-les, partagez-les avec votre équipe
  • Mémoire d'entreprise — Dalfred apprend votre contexte métier (marges, préférences clients, procédures)
  • Pièces jointes PDF — Envoyez un PDF de facture, Dalfred extrait les lignes et la crée automatiquement (v2.13)
  • Personnalisation white-label — Pour les revendeurs : marque, logo et couleurs entièrement personnalisables
  • MCP ouvert — Le serveur peut aussi être consommé par des clients externes (Claude Desktop, Cursor, ChatGPT Desktop, etc.)

Prérequis

Élément Version minimum
Dolibarr 16.0 à 23.x
PHP 8.1 ou supérieur (8.2 et 8.3 supportés)
Extensions PHP json, curl, mbstring, openssl
Module Dolibarr Api (activé)

Vous aurez également besoin d'une clé API auprès d'un fournisseur d'IA — ou d'une instance Ollama auto-hébergée (gratuit, vos données restent chez vous).

Note : Les coûts d'utilisation de l'API IA sont facturés directement par le fournisseur, indépendamment de la licence Dalfred. Avec Ollama, l'utilisation est entièrement gratuite.

Installation

Depuis le DoliStore

  1. Achetez Dalfred sur le DoliStore (299 € HT, achat unique, 1 an de mises à jour inclus)
  2. Téléchargez l'archive ZIP
  3. Décompressez l'archive dans le dossier htdocs/custom/ de votre installation Dolibarr
  4. Le dossier final doit être htdocs/custom/dalfred/

Activation

  1. Connectez-vous à Dolibarr en tant qu'administrateur
  2. Allez dans Accueil → Configuration → Modules/Applications
  3. Recherchez "Dalfred" et cliquez sur Activer

Une fois activé, le widget flottant apparaît dans la barre supérieure de chaque page Dolibarr, et un nouveau menu Dalfred est disponible.

Configuration

La configuration se fait à travers plusieurs pages d'administration, accessibles depuis Dalfred → Configuration.

Configuration générale

Page de configuration générale du module Dalfred

La page de configuration générale (setup.php) regroupe les paramètres de base :

  • Activation du serveur MCP — Active le serveur MCP intégré (utilisable par des clients externes)
  • Limitation de débit — Requêtes maximum par utilisateur et par heure (protection contre les abus)
  • Rétention des logs — Durée de conservation du journal d'activité (par défaut : 30 jours)
  • Mode debug — Active la journalisation détaillée pour diagnostic
  • Threads par utilisateur — Nombre maximum de fils de discussion par utilisateur

Configuration IA

Sélection du fournisseur IA et du modèle

La page ai_setup.php permet de configurer la connexion au fournisseur d'intelligence artificielle :

  1. Fournisseur IA — Choisissez parmi Anthropic, OpenAI, Mistral, Google (Gemini) ou Ollama
  2. Modèle — Sélectionnez le modèle à utiliser (Claude 4 Sonnet, GPT-4o, Mistral Large, Gemini 2.5 Pro, Llama, etc.)
  3. Clé API — Saisissez votre clé d'API (chiffrée en base de données)
  4. URL personnalisée — Pour Ollama ou un endpoint compatible OpenAI sur mesure
  5. Tokens maximum — Taille maximale des réponses (par défaut : 16 384)
  6. Fenêtre de contexte — Tokens conservés pour l'historique de conversation (par défaut : 150 000)
  7. Prompt système personnalisé — Surcharge le prompt par défaut (laissez vide pour utiliser le prompt optimisé d'origine)

Cliquez sur Tester la connexion pour valider votre configuration.

Important : Le choix du modèle influence à la fois la qualité des réponses et le coût par requête. Les modèles les plus puissants (Claude Opus, GPT-4) sont plus coûteux mais traitent mieux les demandes complexes. Pour de la consultation simple, un modèle Haiku ou Mistral Small suffit largement.

Permissions des outils MCP

Permissions granulaires par groupe d'utilisateurs

Dalfred peut exécuter des actions via les outils MCP. La page toolkit_permissions.php permet un contrôle granulaire :

  • Outils de consultation — Lecture de tiers, factures, commandes, produits, paiements, etc.
  • Outils de création — Création de devis, factures, commandes
  • Outils de modification — Mise à jour, ajout/suppression de lignes, validation de documents
  • Outils SQL — Exécution de requêtes SQL en lecture seule (avec liste blanche de tables)
  • Outils de contenu — Génération de descriptions, emails, traductions

Pour chaque outil, vous pouvez définir :

  1. Activé/Désactivé au global
  2. Groupes Dolibarr autorisés — restreint l'accès à certains groupes d'utilisateurs

Conseil de sécurité : Activez uniquement les outils nécessaires. Restreignez les outils de modification (création de factures, modifications de fiches) aux utilisateurs de confiance.

Personnalisation white-label

Personnalisation : nom, logo, couleurs

La page branding.php permet aux intégrateurs et revendeurs de proposer Dalfred sous leur propre marque :

  • Nom de l'assistant — Remplacez "Dalfred" par le nom de votre choix
  • Logo et avatar — Téléversez votre logo et une image d'avatar personnalisée
  • Couleurs — Couleur primaire et couleur d'accent alignées avec votre charte graphique
  • Description — Texte affiché sur l'écran d'accueil du chat
  • Message d'accueil — Premier message de l'assistant

Toutes les surfaces visibles (widget, chat plein écran, page d'accueil) reflètent immédiatement votre branding.

Base de connaissances (mémoire d'entreprise)

Édition d'une entrée de mémoire d'entreprise

La page knowledge.php permet d'enrichir Dalfred avec vos informations métier :

  • Informations métier — "Notre marge cible est de 35% sur les prestations de consulting"
  • Préférences clients — "Le client Martin préfère toujours être facturé à 30 jours fin de mois"
  • Procédures — "Quand on crée une facture pour la Belgique, appliquer 21% de TVA"
  • Catégories — Organisez vos entrées pour faciliter la recherche
  • Visibilité — Privée (visible uniquement par vous) ou partagée (visible par toute l'équipe)

Dalfred consulte automatiquement la mémoire avant de répondre, pour des réponses toujours plus pertinentes au fil du temps.

Utilisation

Deux interfaces complémentaires

Dalfred s'utilise de deux manières :

Le widget flottant

Widget Dalfred ouvert sur une page facture

Un bouton discret est ajouté à la barre supérieure de Dolibarr. Un clic ouvre une fenêtre de chat compacte. Le widget connaît la page courante et adapte ses réponses au contexte (par exemple : ouvrir le widget sur une facture permet de poser des questions directement sur ce document).

La page de chat dédiée

Interface complète de chat Dalfred

Pour les sessions plus longues, accédez à Dalfred → Chat depuis le menu. L'interface plein écran offre :

  • L'historique complet des conversations dans la barre latérale
  • La gestion des fils de discussion (threads) — un fil par sujet
  • L'accès aux Smart Queries
  • L'accès à la mémoire d'entreprise

Multi-conversations (threads)

Liste des fils de discussion Dalfred

Chaque utilisateur peut maintenir plusieurs fils de discussion en parallèle :

  • Nouvelle conversation — Bouton "+" pour démarrer un fil sur un nouveau sujet
  • Reprise — Cliquez sur un fil existant pour reprendre la conversation avec son contexte
  • Renommage — Donnez un titre explicite à chaque fil
  • Suppression — Supprimez les conversations dont vous n'avez plus besoin

Chaque fil conserve son propre historique et son propre contexte (utile pour traiter plusieurs dossiers en parallèle sans mélanger les contextes).

Smart Queries — votre Business Intelligence intégrée

Les Smart Queries sont l'une des fonctionnalités les plus puissantes de Dalfred : transformez n'importe quelle question en requête sauvegardable, paramétrable et partageable.

Liste des Smart Queries sauvegardées

Créer une Smart Query

Posez une question à Dalfred dans le chat. Lorsqu'une requête SQL est exécutée et que le résultat vous intéresse, cliquez sur Sauvegarder en Smart Query :

Édition d'une Smart Query avec SQL transparent et paramètres

Vous pouvez ensuite :

  • Renommer la requête et lui donner une description claire
  • Définir des paramètres dynamiques (date de début, date de fin, client, commercial...)
  • Ajuster le SQL si nécessaire (le SQL est transparent, vous le voyez)
  • Marquer la requête comme partagée pour la rendre disponible à toute l'équipe

Exécuter une Smart Query

Saisie des paramètres avant exécution

Cliquez sur une Smart Query, saisissez les paramètres demandés, lancez l'exécution :

Résultat tabulaire — chiffre d'affaires mensuel

Le résultat s'affiche dans un tableau formaté, avec export CSV intégré pour Excel ou Google Sheets.

Résultat — ventes par produit

Cas d'usage typiques : tableau de bord commercial mensuel, rapport de marges par catégorie, état des encours fournisseurs par échéance, top clients par CA. Une fois la requête sauvegardée, vos collaborateurs peuvent la ré-exécuter en un clic — sans aucune connaissance SQL.

Les outils MCP

Lorsque Dalfred a besoin d'accéder à vos données ou d'effectuer une action, il utilise un outil MCP :

  1. Vous posez une question ou donnez une instruction
  2. Dalfred identifie le ou les outils nécessaires (lister, créer, modifier, calculer)
  3. Les outils sont exécutés (consultation, création, modification dans Dolibarr)
  4. Dalfred présente le résultat de manière lisible — tableau, résumé, ou message de confirmation

Plus de 12 outils MCP intégrés couvrent les entités principales de Dolibarr : tiers, contacts, produits, devis, commandes, factures (clients & fournisseurs), paiements, projets, expéditions, stocks, etc. Et Dalfred découvre automatiquement les API exposées par les modules tiers installés — un module RH ajouté ? Dalfred peut consulter les congés. Un module flotte ? Il peut lister les véhicules.

Note : Les outils disponibles dépendent des permissions configurées par l'administrateur (voir section Permissions des outils MCP).

Pièces jointes PDF (v2.13)

Création d'une facture à partir d'un PDF joint

Joignez un fichier PDF à un message et demandez à Dalfred d'en extraire les informations :

"Voici la facture fournisseur reçue par mail — crée la facture correspondante dans Dolibarr"

Comportement selon le fournisseur :

  • Anthropic, Google Gemini, OpenAI (modèles gpt-4o, gpt-4-turbo, gpt-4.1, o1, o3) — Le PDF est envoyé en natif au modèle, qui lit le contenu, l'OCR et les graphiques
  • Mistral, Ollama, autres — Le texte est extrait côté serveur (PdfParser) et injecté dans le prompt

Limites : 10 Mo par fichier, 5 fichiers par message, 50 KB de texte extrait pour les modèles sans support PDF natif.

Utilisation du MCP depuis un client externe

Le serveur MCP de Dalfred peut être utilisé depuis n'importe quel client compatible :

  • Claude Desktop — Dialogue avec votre Dolibarr depuis l'application Claude
  • Cursor / Windsurf — IDE qui peut consulter votre ERP pendant le développement
  • ChatGPT Desktop (via custom GPT) — Si vous préférez l'écosystème OpenAI
  • Tout autre client MCP — Le protocole est ouvert et standardisé

Pour configurer un client externe, récupérez l'URL du serveur MCP et la clé d'authentification depuis la configuration générale.

Multi-fournisseur IA

Dalfred fonctionne avec :

Fournisseur Modèles Hébergement
Anthropic Claude 4 Sonnet, Claude Opus, Claude Haiku Cloud (API)
OpenAI GPT-4o, GPT-4 Turbo, o1, o3 Cloud (API)
Mistral AI Mistral Large, Medium, Small Cloud (API, serveurs européens)
Google Gemini 2.5 Pro, Gemini 2.5 Flash Cloud (API)
Ollama Llama, Mistral, Phi, tout modèle open-source Auto-hébergé

Confidentialité maximale : Avec Ollama auto-hébergé, aucune donnée ne quitte votre infrastructure. Idéal pour les entreprises avec des contraintes RGPD strictes ou des exigences de souveraineté.

Sécurité

Permissions

Permissions granulaires

  • Permissions Dolibarr — Chaque utilisateur n'accède qu'aux données que ses droits Dolibarr autorisent (la même API, les mêmes restrictions)
  • Isolation par clé API — Chaque utilisateur dispose de sa propre clé API Dolibarr — pas de compte partagé
  • Permissions par groupe — L'administrateur définit quels outils sont disponibles pour quels groupes

Journal d'activité

Journal d'activité — qui a fait quoi, quand

La page activity_log.php enregistre chaque interaction avec Dalfred :

  • Qui — Utilisateur ayant émis la requête
  • Quand — Horodatage de la requête et de la réponse
  • Quoi — Question posée, outils MCP exécutés, tokens consommés
  • Coût — Estimation du coût en tokens (utile pour le suivi budgétaire)
  • Erreurs — Requêtes ayant échoué avec le détail de l'erreur

Filtrez par utilisateur, par période, par type d'outil. Exportez en CSV pour analyse.

Protections additionnelles

  • Chiffrement — Les clés API des fournisseurs IA sont stockées chiffrées dans la base Dolibarr
  • Limitation de débit — Protection automatique contre les abus (X requêtes par heure par utilisateur)
  • Liste blanche SQL — Seules les tables autorisées sont accessibles via les outils SQL (lecture seule)
  • Validation anti-spoofing — Les pièces jointes sont validées (un fichier nommé .pdf mais détecté en text/plain est rejeté)

Maintenance et diagnostic

La page maintenance.php permet de vérifier l'état de votre installation :

  • Connexion IA — Test de connectivité avec le fournisseur configuré
  • Serveur MCP — Vérification du bon fonctionnement
  • Extensions PHP — Validation des extensions requises
  • Permissions — Vérification des droits d'écriture sur les répertoires
  • Base de connaissances — Intégrité des données

Logs de debug

Quand le mode debug est activé (configuration générale) :

  1. Les logs détaillés sont écrits dans documents/dalfred/logs/
  2. Chaque interaction génère une entrée avec la requête, la réponse et les outils utilisés
  3. Les erreurs API sont enregistrées avec leur code et message complet

Problèmes courants

Dalfred ne répond pas ou retourne une erreur

  • Vérifiez votre clé API dans la configuration IA
  • Lancez le test de connexion depuis la page Maintenance
  • Vérifiez que votre serveur peut joindre l'API du fournisseur (pas de blocage pare-feu)
  • Avec Ollama : vérifiez que le service Ollama tourne et que l'URL est joignable

Les outils MCP ne fonctionnent pas

  • Vérifiez que les outils sont activés dans Permissions des outils
  • Vérifiez que l'utilisateur appartient à un groupe autorisé
  • Consultez le journal d'activité pour identifier l'erreur précise

Réponses lentes ou timeouts

  • Vérifiez la charge serveur et la connexion internet
  • Essayez un modèle plus léger (Claude Haiku, GPT-4 Mini, Mistral Small)
  • Augmentez le timeout PHP de votre serveur (max_execution_time)

Coûts API élevés

  • Consultez le journal d'activité pour identifier les utilisateurs les plus actifs
  • Réduisez les limites de débit par utilisateur
  • Basculez sur un modèle moins coûteux pour les tâches simples
  • Envisagez Ollama auto-hébergé (gratuit après l'investissement matériel)

Icônes manquantes après mise à jour (Bug corrigé en v2.13.2) Si vous voyez des carrés vides à la place des icônes après installation depuis le ZIP DoliStore, mettez à jour vers 2.13.2 ou supérieur.

FAQ

Quels fournisseurs d'IA sont supportés ?

Dalfred supporte Anthropic (Claude), OpenAI (GPT), Mistral AI, Google (Gemini) et Ollama (auto-hébergé). Vous pouvez basculer d'un fournisseur à l'autre sans réinstaller le module.

Mes données sont-elles envoyées au fournisseur d'IA ?

Avec un fournisseur cloud (Anthropic, OpenAI, Mistral, Google), oui — les données nécessaires pour répondre à votre question sont transmises via leur API. Consultez leurs politiques de confidentialité respectives.

Avec Ollama auto-hébergé, aucune donnée ne quitte votre infrastructure. C'est la solution recommandée pour les contraintes RGPD strictes ou les données sensibles.

Puis-je utiliser le MCP sans l'interface chat ?

Oui. Le serveur MCP de Dalfred est utilisable indépendamment depuis n'importe quel client MCP : Claude Desktop, Cursor, Windsurf, ou tout autre client compatible avec le protocole standard.

Combien coûte Dalfred ?

299 € HT — Achat unique, 1 an de mises à jour inclus. Pas d'abonnement au module. Seul le coût de l'API IA s'ajoute selon votre usage (ou gratuit avec Ollama).

Dalfred peut-il modifier des données dans Dolibarr ?

Oui, si les outils de modification sont activés dans les permissions. L'administrateur contrôle précisément quels outils sont disponibles et pour quels groupes. Par défaut, nous recommandons de n'activer que les outils de consultation, puis d'élargir progressivement.

Comment mettre à jour le module ?

  1. Téléchargez la nouvelle version depuis le DoliStore
  2. Remplacez les fichiers dans htdocs/custom/dalfred/
  3. Accédez à Dolibarr — le module détectera la mise à jour et appliquera les migrations automatiquement
  4. Vérifiez la page de Maintenance pour valider que tout fonctionne

Les Smart Queries sont-elles partageables ?

Oui. Lors de la création d'une Smart Query, vous pouvez la marquer comme partagée pour la rendre disponible à toute l'équipe. Idéal pour standardiser les rapports métier (CA mensuel, top clients, encours fournisseurs).

Dalfred fonctionne-t-il avec Multicompany ?

Oui. Chaque entité Dolibarr peut avoir sa propre configuration (fournisseur IA, branding, permissions). Les données restent strictement isolées entre entités.

Où trouver de l'aide ?