Vue système
Le chatbot est construit comme un ensemble de projets séparés. Dify orchestre les workflows et les appels IA, le chatbot UI affiche l'expérience client, le chatbot backend expose les API applicatives, et les services externes fournissent les données métier, la recherche, le stockage et l'observabilité.
Composants principaux
| Composant | Responsabilité |
|---|---|
| Dify code | Héberge les workflows, outils, providers IA, plugins et variables d'environnement du chatbot. |
| Chatbot UI | Interface conversationnelle intégrée au site e-commerce ou à l'espace client. |
| Chatbot backend | API applicative appelée par l'UI, Dify et les outils internes. |
| SI métier Menzzo / Logidav | Source métier utilisée par Menzzo pour les commandes, le SAV et les opérations existantes. |
| Recherche produit Menzzo | Recherche produit et recommandation via l'instance Typesense utilisée par Menzzo. |
Logidav et la recherche produit Typesense sont des dépendances du contexte Menzzo. Pour un autre client, ces briques doivent être remplacées par les sources métier équivalentes du marchand. Cette documentation couvre leur configuration côté chatbot lorsqu'elles sont utilisées.
Sources fiables de données
| Source | Données fiables | Utilisation |
|---|---|---|
| SI métier Menzzo / Logidav | Commandes, SAV, informations métier existantes | Vérifier ou enrichir les réponses liées aux commandes et demandes SAV dans le contexte Menzzo. |
| Base chatbot backend | Données propres au backend chatbot | Gérer les accès, états applicatifs et interactions nécessaires aux workflows. |
| Stockage local Dify | Configuration, workflows, fichiers et état interne Dify | Exécuter les workflows importés et conserver leur configuration. |
| Cloudflare D1 | Mémoire conversationnelle ou stockage structuré léger | Supporter les outils de mémoire et certains états conversationnels. |
| S3 | Images uploadées par les clients | Stocker les photos nécessaires aux demandes SAV. |
| Firecrawl | Contenu web collecté | Alimenter ou enrichir la connaissance issue du site cible. |
| Langfuse | Traces IA et observabilité | Suivre les conversations, prompts, réponses et erreurs. |
Responsabilités d'intégration
Pour un nouveau projet, l'intégrateur doit :
- Installer Dify, chatbot UI et chatbot backend.
- Importer les DSL Dify.
- Corriger les appels entre workflows importés.
- Configurer les providers IA et plugins Dify.
- Connecter Cloudflare D1, S3, Firecrawl, Langfuse et, pour Menzzo, la recherche produit Typesense.
- Créer un utilisateur backend dédié au chatbot.
- Synchroniser le workflow ID principal dans Dify, l'UI et le backend.
- Valider les parcours critiques : conversation simple, demande SAV, recommandation produit et upload image.
Point critique : IDs Dify
Les IDs de workflows changent après chaque import DSL dans une nouvelle instance Dify. Aucun appel entre workflows ne doit conserver une référence vers l'ancien environnement.
Relisez tous les noeuds qui appellent un autre workflow et remplacez-les par les workflows importés dans le nouvel environnement.