Installation

Cette page explique comment redéployer le chatbot SAV pour une nouvelle entreprise. Elle s'adresse à un développeur intégrateur qui doit installer les projets, importer les workflows Dify, connecter les services externes, puis valider que le chatbot peut répondre et appeler le backend.

Vue d'ensemble des projets

Le système est séparé en cinq projets ou services principaux :

Projet	Rôle	Installation dans ce runbook
Dify code	Moteur d'orchestration des workflows, modèles IA, outils et plugins	Oui
Chatbot UI	Interface visible par le client final	Oui
Chatbot backend	API entre l'UI, Dify, les services métier et les bases	Oui
SI métier Menzzo / Logidav	Source métier utilisée par Menzzo pour commandes, SAV et données opérationnelles	Non, dépendance à configurer dans le contexte Menzzo
Recherche produit Menzzo	Instance Typesense utilisée par Menzzo pour la recherche produit et la recommandation	Non, dépendance à configurer si le parcours recommandation est activé

Le setup détaillé du SI métier Menzzo / Logidav et de la recherche produit Menzzo sera documenté séparément. Dans ce runbook, ils sont traités comme des dépendances déjà disponibles lorsqu'elles sont utilisées. Pour un autre client, ces briques doivent être remplacées par les sources métier équivalentes.

Préparer les dépôts

Remplacez les placeholders par les URLs privées avant publication ou exécution :

Dépôt	Placeholder
Dify code	<DIFY_REPO_URL>
Chatbot UI	<CHATBOT_UI_REPO_URL>
Chatbot backend	<CHATBOT_BACKEND_REPO_URL>

Clonez les trois dépôts nécessaires :

git clone <DIFY_REPO_URL> dify
git clone <CHATBOT_UI_REPO_URL> chatbot-ui
git clone <CHATBOT_BACKEND_REPO_URL> chatbot-backend

Installez chaque projet selon son README local. Avant de continuer, les trois projets doivent pouvoir démarrer dans un environnement de développement ou de staging.

Installer Dify

Installez l'instance Dify à partir du dépôt cloné. L'objectif est d'obtenir une instance propre dans laquelle les DSL exportés depuis l'environnement source pourront être importés.

Après installation :

1. Ouvrez l'interface d'administration Dify.
2. Créez ou connectez-vous avec un compte administrateur.
3. Vérifiez que vous pouvez créer une application ou importer un workflow.
4. Vérifiez que l'instance Dify peut accéder au réseau des services externes requis : chatbot backend, Cloudflare D1, serveur MCP SAV et, pour Menzzo, recherche produit Typesense.

Installer les plugins Dify

Installez les plugins nécessaires avant d'importer les workflows. Les workflows importés peuvent référencer ces outils ; s'ils n'existent pas, des noeuds seront cassés ou incomplets.

Plugins requis :

Fonction	Plugin
Storage	storage:mohamedrayenbouzaabia-aexlites/storage-forked
OpenAI	OpenAI:langgenius/openai_tool
Conversational Memory	Conversational Memory:rayenbz/data_function_conversation_memory

Dans Dify, allez dans la section plugins ou marketplace, installez les trois plugins, puis vérifiez qu'ils apparaissent dans les outils disponibles.

Si OpenAI n'apparaît pas dans les providers de modèles, le plugin OpenAI n'est pas installé ou n'a pas été chargé correctement.

Importer les DSL Dify

Depuis l'ancien environnement :

1. Exportez tous les fichiers DSL requis.
2. Notez le nom métier de chaque workflow exporté.
3. Gardez une copie du mapping ancien workflow vers nouveau workflow.

Dans le nouvel environnement :

1. Importez tous les DSL dans Dify.
2. Ouvrez chaque workflow importé.
3. Vérifiez que tous les noeuds sont présents.
4. Publiez ou activez les workflows selon le mode utilisé par votre instance Dify.

Corriger les appels entre workflows

Après import, Dify génère de nouveaux IDs. Les appels internes peuvent encore référencer les anciens workflows ou les anciens noeuds.

Exemple :

Ancien environnement	Nouvel environnement
Workflow A appelle Workflow B	Workflow A' doit appeler Workflow B'

Le workflow A' ne doit pas continuer à appeler l'ancien workflow B. Pour chaque workflow importé :

1. Identifiez tous les noeuds qui appellent un autre workflow.
2. Remplacez chaque référence par le nouveau workflow importé correspondant.
3. Réinitialisez le nom de l'outil si nécessaire.
4. Vérifiez la description de l'outil.
5. Vérifiez chaque paramètre attendu.
6. Vérifiez le nom de chaque paramètre.
7. Vérifiez le type de chaque paramètre.
8. Vérifiez la méthode de remplissage : manual ou autodetect.
9. Vérifiez la description de chaque paramètre.
10. Sauvegardez le workflow.

:::warning Attention critique Une mauvaise référence de workflow, un paramètre mal nommé ou une méthode de remplissage incorrecte peut modifier fortement la réponse du chatbot. Cette étape doit être relue workflow par workflow. :::

Récupérer le workflow ID principal

Dans Dify :

1. Ouvrez le workflow principal du chatbot.
2. Récupérez son workflow ID.
3. Configurez ce workflow ID dans l'environnement du chatbot UI.
4. Configurez le même workflow ID dans l'environnement du chatbot backend.

Le workflow ID principal est la référence utilisée par les services applicatifs pour envoyer les messages client vers Dify.

Exposer le workflow principal pour le backend

Dans Dify :

1. Ouvrez le workflow principal.
2. Activez l'accès API ou service backend selon la configuration Dify utilisée.
3. Récupérez les informations nécessaires côté backend : endpoint, clé ou identifiant d'application si applicable.
4. Vérifiez que le chatbot backend peut appeler ce workflow depuis son environnement.

Créer l'utilisateur chatbot backend

Dans le chatbot backend :

1. Créez un utilisateur dédié à l'intégration chatbot.
2. Donnez-lui les permissions nécessaires pour effectuer les requêtes API utilisées par les workflows.
3. Conservez son username et son password dans le gestionnaire de secrets de l'environnement.
4. Configurez ces valeurs dans Dify avec les variables username et password.

Cet utilisateur ne doit pas être un compte personnel. Il doit être dédié au chatbot et révocable sans bloquer un utilisateur humain.

Exposer le serveur MCP SAV

Le MCP SAV doit être accessible par les workflows qui en dépendent.

Dans Dify :

1. Activez le serveur MCP.
2. Définissez le nom du serveur.
3. Définissez son ID.
4. Définissez son URL.
5. Sauvegardez.
6. Allez dans Tools.
7. Sélectionnez le MCP.
8. Choisissez le serveur MCP configuré.
9. Cliquez sur Update.

Vérifiez ensuite que les workflows qui appellent le MCP SAV utilisent bien ce nouveau serveur.

Validation de fin d'installation

Avant de remettre l'environnement au métier :

1. Lancez Dify, chatbot UI et chatbot backend.
2. Envoyez un message simple depuis l'UI.
3. Vérifiez que le message arrive dans Dify.
4. Vérifiez que Dify appelle le chatbot backend avec l'utilisateur dédié.
5. Testez une demande SAV qui utilise le MCP.
6. Si le parcours recommandation Menzzo est activé, testez une recommandation produit qui utilise Typesense.
7. Testez un upload image si le parcours en dépend.
8. Vérifiez les traces Langfuse si l'environnement les utilise.
9. Vérifiez qu'aucun secret n'apparaît dans les logs publics ou dans le dépôt.