Aller au contenu principal

Dalfred - Assistant IA pour Dolibarr

Dalfred est un module Dolibarr qui intègre un assistant intelligent (IA) directement dans votre ERP. Il vous permet de converser avec une IA pour interroger vos données, générer du contenu, exécuter des actions et automatiser des tâches courantes, le tout sans quitter Dolibarr. Dalfred s'appuie sur le protocole MCP (Model Context Protocol) pour interagir de manière sécurisée avec votre instance.

Introduction

Qu'est-ce que Dalfred ?

Dalfred est un assistant IA conversationnel conçu spécifiquement pour Dolibarr. Il comprend le contexte de votre ERP et peut accéder à vos données (clients, factures, commandes, produits, etc.) pour vous fournir des réponses pertinentes et exécuter des actions concrètes.

Pourquoi utiliser Dalfred ?

  • Gain de temps : Posez des questions en langage naturel au lieu de naviguer dans les menus ("Quel est le chiffre d'affaires du mois ?", "Liste les factures impayées de plus de 30 jours")
  • Exécution d'actions : Dalfred peut créer, modifier ou consulter des éléments dans Dolibarr via les outils MCP
  • Génération de contenu : Rédigez des emails, descriptions produits, rapports et autres contenus directement depuis le chat
  • Requêtes SQL : Interrogez votre base de données en langage naturel, Dalfred traduit en SQL sécurisé
  • Multi-conversations : Gérez plusieurs fils de discussion en parallèle, chacun avec son propre contexte
  • Base de connaissances : Enrichissez Dalfred avec vos propres documents et procédures internes
  • MCP ouvert : Le serveur MCP peut également être utilisé depuis des clients externes (Claude Desktop, OpenClaw, etc.)

Prérequis

Avant d'installer Dalfred, vérifiez que votre environnement remplit les conditions suivantes :

Élément Version minimum
Dolibarr 18.0 ou supérieur
PHP 8.1 ou supérieur
Extensions PHP json, curl, mbstring

Vous aurez également besoin d'une clé API auprès d'un fournisseur d'IA compatible :

  • Anthropic (Claude) - Recommandé
  • OpenAI (GPT)

Note : La clé API est utilisée pour communiquer avec le fournisseur d'IA. Les coûts d'utilisation de l'API sont facturés directement par le fournisseur, indépendamment de la licence Dalfred.

Installation

Depuis le DoliStore

  1. Rendez-vous sur le DoliStore et recherchez Dalfred
  2. Achetez le module (400 EUR, licence à vie) et 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 dans Dolibarr

  1. Connectez-vous à Dolibarr en tant qu'administrateur
  2. Allez dans Accueil -> Configuration -> Modules/Applications
  3. Recherchez "Dalfred" dans la liste des modules
  4. Cliquez sur le bouton Activer

Une fois le module activé, un nouveau menu Dalfred apparaît dans votre barre de navigation.

Configuration

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

Configuration générale (setup.php)

La page de configuration générale vous permet de définir les paramètres principaux du module :

  • Activation du MCP : Activer ou désactiver le serveur MCP intégré
  • Paramètres MCP : Configurer le comportement du serveur MCP (port, authentification, etc.)
  • Limitation de débit : Définir le nombre maximum de requêtes par utilisateur et par période
  • Journalisation : Activer les logs d'activité pour le suivi et le diagnostic

Astuce : Commencez avec les paramètres par défaut, puis ajustez selon vos besoins une fois que vous êtes familiarisé avec le module.

Configuration IA (ai_setup.php)

Cette page permet de configurer la connexion au fournisseur d'intelligence artificielle :

  1. Fournisseur IA : Sélectionnez votre fournisseur (Anthropic, OpenAI, etc.)
  2. Clé API : Saisissez votre clé API obtenue auprès du fournisseur choisi
  3. Modèle : Choisissez le modèle d'IA à utiliser (par exemple : Claude 3.5 Sonnet, GPT-4, etc.)
  4. Cliquez sur Enregistrer puis Tester la connexion pour valider

Important : Le choix du modèle influence la qualité des réponses et le coût par requête. Les modèles plus puissants sont plus coûteux mais fournissent de meilleures réponses.

Permissions des outils (toolkit_permissions.php)

Dalfred peut exécuter des actions dans Dolibarr via les outils MCP. Cette page vous permet de contrôler précisément quels outils sont disponibles :

  • Outils de consultation : Lecture de fiches clients, produits, factures, commandes, etc.
  • Outils de création : Création de nouveaux éléments dans Dolibarr
  • Outils de modification : Mise à jour d'éléments existants
  • Outils SQL : Exécution de requêtes SQL en lecture seule
  • Outils de contenu : Génération de textes, emails, descriptions

Pour chaque outil, vous pouvez définir :

  1. Activé/Désactivé : Autoriser ou interdire l'utilisation de l'outil
  2. Groupes autorisés : Restreindre l'accès à certains groupes d'utilisateurs Dolibarr

Conseil de sécurité : Activez uniquement les outils nécessaires et restreignez les outils de modification aux utilisateurs de confiance.

Base de connaissances (knowledge.php)

La base de connaissances permet d'enrichir Dalfred avec des informations spécifiques à votre entreprise :

  1. Accédez à Dalfred -> Configuration -> Base de connaissances
  2. Ajoutez des documents, procédures ou informations que Dalfred pourra consulter
  3. Organisez les entrées par catégories pour faciliter la recherche
  4. Dalfred utilisera ces informations pour contextualiser ses réponses

Les types de contenus supportés :

  • Texte libre : Procédures internes, FAQ, notes de service
  • Documents : Fichiers PDF, textes ou autres documents de référence
  • Instructions : Directives spécifiques sur le ton, le style ou le comportement de l'assistant

Utilisation

Le chat Dalfred

L'interface principale de Dalfred est un chat conversationnel accessible depuis le menu Dalfred :

  1. Cliquez sur Dalfred dans la barre de navigation
  2. Une fenêtre de chat s'ouvre
  3. Tapez votre question ou instruction en langage naturel
  4. Dalfred analyse votre demande, consulte vos données si nécessaire, et répond

Exemples de questions :

  • "Quel est le chiffre d'affaires du trimestre en cours ?"
  • "Liste les 10 dernières factures impayées"
  • "Résume la fiche du client Dupont SA"
  • "Rédige un email de relance pour la facture FA2401-0042"
  • "Combien de commandes ont été passées cette semaine ?"

Les outils MCP

Lorsque Dalfred a besoin d'accéder à vos données ou d'effectuer une action, il utilise les outils MCP. Ces outils sont exécutés de manière transparente :

  1. Vous posez une question ou donnez une instruction
  2. Dalfred identifie le ou les outils nécessaires
  3. Les outils sont exécutés (consultation, création, modification)
  4. Dalfred vous présente le résultat de manière lisible

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

Utilisation du MCP depuis un client externe

Le serveur MCP de Dalfred peut être utilisé depuis des applications externes compatibles MCP :

  • Claude Desktop : Connectez Claude Desktop à votre instance Dolibarr
  • OpenClaw : Utilisez OpenClaw pour interagir avec vos données Dolibarr
  • Autres clients MCP : Tout client compatible avec le protocole MCP

Pour configurer un client externe, vous aurez besoin de l'URL du serveur MCP et des identifiants d'authentification disponibles dans la page de configuration générale.

Gestion des conversations

Dalfred supporte les multi-conversations :

  • Nouvelle conversation : Cliquez sur le bouton "+" pour démarrer un nouveau fil
  • Historique : Retrouvez vos conversations précédentes dans la barre latérale
  • Contexte : Chaque conversation conserve son propre contexte et historique
  • Suppression : Supprimez les conversations dont vous n'avez plus besoin

Options avancées

Limitation de débit

La limitation de débit (rate limiting) protège contre une utilisation excessive de l'API :

  • Requêtes par minute : Nombre maximum de requêtes par utilisateur par minute
  • Requêtes par jour : Limite quotidienne par utilisateur
  • Limite globale : Nombre maximum de requêtes pour l'ensemble des utilisateurs

Journal d'activité (activity_log.php)

Le journal d'activité enregistre toutes les interactions avec Dalfred :

  • Requêtes utilisateurs : Qui a posé quelle question et quand
  • Outils exécutés : Quels outils MCP ont été utilisés
  • Tokens consommés : Nombre de tokens utilisés par requête (pour le suivi des coûts)
  • Erreurs : Requêtes ayant échoué avec le détail de l'erreur

Accédez au journal depuis Dalfred -> Journal d'activité.

Page À propos (about.php)

La page À propos affiche les informations de version, la licence et les crédits du module. Elle est accessible depuis Dalfred -> À propos.

Maintenance et diagnostic

La page de maintenance vous permet de vérifier l'état de votre installation et de diagnostiquer les problèmes éventuels.

Vérification de l'installation (maintenance.php)

Accédez à Dalfred -> Maintenance pour lancer une vérification automatique :

  • Connexion IA : Test de connectivité avec le fournisseur d'IA configuré
  • Serveur MCP : Vérification du bon fonctionnement du serveur MCP
  • Extensions PHP : Vérification des extensions requises
  • Permissions : Validation des permissions d'accès aux fichiers et répertoires
  • Base de connaissances : Vérification de l'intégrité de la base de connaissances

Logs et debug

Quand la journalisation est activée (voir Configuration générale) :

  1. Les logs détaillés sont écrits dans le répertoire documents/dalfred/logs/ de Dolibarr
  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 le code d'erreur et le message complet

Problèmes courants

Dalfred ne répond pas ou répond avec une erreur

  • Vérifiez votre clé API dans la configuration IA
  • Testez la connexion depuis la page Maintenance
  • Vérifiez que votre serveur peut accéder à l'API du fournisseur (pas de blocage pare-feu)

Les outils MCP ne fonctionnent pas

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

Réponses lentes ou timeouts

  • Vérifiez la charge de votre serveur et la connexion internet
  • Essayez un modèle IA plus léger (moins de tokens, réponse plus rapide)
  • Ajustez les paramètres de timeout dans la configuration générale

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
  • Utilisez un modèle moins coûteux pour les requêtes simples

FAQ

Quels fournisseurs d'IA sont supportés ?

Dalfred supporte actuellement Anthropic (Claude) et OpenAI (GPT). D'autres fournisseurs pourront être ajoutés dans de futures versions. Nous recommandons Anthropic Claude pour la meilleure expérience.

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

Oui, les données nécessaires pour répondre à votre question sont envoyées au fournisseur d'IA via son API. Consultez la politique de confidentialité de votre fournisseur (Anthropic, OpenAI) pour comprendre comment vos données sont traitées. Aucune donnée n'est stockée par Dalfred en dehors de votre serveur Dolibarr.

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

Oui, le serveur MCP de Dalfred peut être utilisé indépendamment de l'interface chat intégrée. Vous pouvez le connecter à des clients MCP externes comme Claude Desktop ou OpenClaw pour interagir avec vos données Dolibarr depuis d'autres applications.

Combien coûte Dalfred ?

La licence Dalfred est à 400 EUR (achat unique, licence à vie) disponible sur le DoliStore. Les coûts d'utilisation de l'API IA sont séparés et facturés directement par le fournisseur choisi (Anthropic, OpenAI).

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 d'utilisateurs. Par défaut, nous recommandons de n'activer que les outils de consultation.

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 nécessaires

Où trouver de l'aide ?