Variables d'environnement
Cette page liste les variables à préparer pour redéployer le chatbot sur un nouveau projet. Les noms doivent rester identiques à ceux utilisés par les workflows et les services existants.
:::danger Secrets Ne commitez jamais de token, mot de passe, clé API ou identifiant sensible dans Git. Utilisez le gestionnaire de secrets de l'environnement cible. :::
Variables du workflow principal Dify
Configurez ces variables dans le workflow principal Dify importé.
| Variable | Exemple | Description |
|---|---|---|
maintenance | no ou yes | Active ou désactive le mode maintenance du chatbot. |
folow_up_only | no ou yes | Si yes, le chatbot donne uniquement des informations de suivi et ne crée pas de tickets. |
Cloudflare_API_Token | Secret Cloudflare | Token API utilisé pour accéder aux services Cloudflare. |
cloudflare_account_id | ID de compte Cloudflare | Identifiant du compte Cloudflare. |
cloudflare_Database_id | ID D1 | Identifiant de la base Cloudflare D1 utilisée par le chatbot. |
nl_model_id | ID du modèle NL Typesense | Identifiant du modèle de recherche naturelle configuré dans Typesense. |
X_TYPESENSE_API_KEY | Clé publique Typesense | Clé utilisée pour les recherches produit. Utilisez la clé publique prévue pour cet usage. |
typesense_collection | products | Collection principale contenant les produits. |
typesense_url | https://search.domaine-name.com/ | URL publique ou interne du service Typesense. |
secteur | Meubles et décoration maison | Secteur métier utilisé par les prompts de recommandation. |
website_url | www.example-boutque.com | URL du site e-commerce. |
website_name | menzzo.fr | Nom affiché ou nom de domaine de la boutique. |
style | - Responses must be short, native, and to the point. | Instructions de style ajoutées aux réponses. |
domain_name | URL API backend | Endpoint exposé par le chatbot backend. |
username | Utilisateur backend dédié | Nom d'utilisateur créé dans le chatbot backend. |
password | Mot de passe backend | Mot de passe de l'utilisateur chatbot backend. |
Variables à synchroniser dans les services applicatifs
Le chatbot UI et le chatbot backend doivent pointer vers le même workflow principal Dify que celui importé et publié.
| Service | Valeur à synchroniser | Pourquoi |
|---|---|---|
| Chatbot UI | Workflow ID principal Dify | L'UI doit envoyer les conversations au bon workflow. |
| Chatbot backend | Workflow ID principal Dify | Le backend doit appeler ou relayer vers le bon workflow. |
| Chatbot backend | Identifiants Dify/API si utilisés | Le backend doit pouvoir appeler le workflow exposé. |
| Chatbot backend | URL Dify/API si utilisée | Le backend doit cibler la nouvelle instance Dify. |
Après import DSL, récupérez le nouveau workflow ID dans Dify. N'utilisez pas l'ancien ID de production.
Variables Cloudflare D1
Préparez les valeurs suivantes depuis Cloudflare :
| Variable | Description |
|---|---|
D1_database_id | Identifiant de la base D1. |
D1_account_id | Identifiant du compte Cloudflare. |
D1_access_token | Token d'accès autorisé à utiliser D1. |
Dans le workflow Dify, les noms réellement utilisés sont cloudflare_account_id, cloudflare_Database_id et Cloudflare_API_Token. Conservez le mapping entre les noms Cloudflare et les noms attendus par le workflow.
Variables recherche produit Menzzo
Dans le contexte Menzzo, Typesense est nécessaire pour activer la recommandation produit. Pour un autre client, cette partie doit être adaptée à la solution de recherche produit disponible.
| Variable | Description |
|---|---|
typesense_url | URL de l'instance Typesense. |
typesense_collection | Collection principale contenant les produits. |
X_TYPESENSE_API_KEY | Clé utilisée par le workflow pour interroger Typesense. |
nl_model_id | ID du modèle NL search configuré dans Typesense. |
Dans le parcours Menzzo, seuls les produits indexés dans Typesense peuvent être recherchés ou recommandés par le chatbot.
Checklist avant lancement
- Toutes les variables Dify sont renseignées dans le workflow principal.
- Le chatbot UI et le chatbot backend utilisent le nouveau workflow ID principal.
- Les credentials backend correspondent à l'utilisateur dédié au chatbot.
- Les variables Cloudflare D1 correspondent au nouveau compte ou à la nouvelle base.
- Pour Menzzo, Typesense contient les produits de la boutique cible.
- Aucun secret réel n'est présent dans les fichiers du dépôt.