Configuration

Cette page décrit les services externes à préparer pour un nouveau projet chatbot : Cloudflare D1, OpenAI, stockage image, Firecrawl, Langfuse et, pour le contexte Menzzo, Typesense.

Cloudflare D1

Créez ou utilisez un compte Cloudflare pour le projet cible.

Étapes :

1. Connectez-vous à Cloudflare.
2. Activez ou souscrivez au service D1.
3. Créez la base D1 dédiée au projet.
4. Récupérez le D1_database_id.
5. Récupérez le D1_account_id.
6. Créez un token d'accès D1.
7. Récupérez le D1_access_token.
8. Reportez ces valeurs dans les variables attendues par Dify et par les services qui utilisent D1.

Dans Dify, le mapping habituel est :

Valeur Cloudflare	Variable Dify
D1_access_token	Cloudflare_API_Token
D1_account_id	cloudflare_account_id
D1_database_id	cloudflare_Database_id

OpenAI Platform

Créez un compte OpenAI Platform pour l'entreprise ou utilisez le compte technique prévu pour le projet.

Étapes :

1. Connectez-vous à OpenAI Platform.
2. Ajoutez des crédits au compte. Pour un démarrage, prévoir au minimum 50 USD.
3. Créez une API key.
4. Stockez la clé dans le gestionnaire de secrets.
5. Configurez le provider OpenAI dans Dify.

Dans Dify :

1. Ouvrez Profile.
2. Allez dans Settings.
3. Ouvrez Model Providers.
4. Sélectionnez OpenAI.
5. Ajoutez l'API key.
6. Sauvegardez.

Si OpenAI n'apparaît pas dans la liste des providers, installez le plugin OpenAI:langgenius/openai_tool, puis revenez sur cette configuration.

Recherche produit Menzzo avec Typesense

Dans le contexte Menzzo, la recommandation produit s'appuie sur Typesense. Ce n'est pas un composant standard obligatoire pour tous les clients, mais la solution de recherche produit utilisée par Menzzo.

Tous les produits qui doivent être recommandés par ce parcours doivent être indexés dans la collection principale.

Configuration attendue :

1. Vérifiez que l'instance Typesense est accessible depuis Dify et le chatbot backend.
2. Vérifiez que la collection principale contient les produits de la boutique cible.
3. Créez ou configurez le modèle NL search.
4. Donnez au modèle un system prompt adapté au secteur métier.
5. Configurez les stopwords.
6. Récupérez le nl_model_id.
7. Configurez nl_model_id, typesense_url, typesense_collection et X_TYPESENSE_API_KEY dans Dify.

Exemple de secteur :

Meubles et décoration maison

Le system prompt du modèle NL search doit aider Typesense à transformer une demande client naturelle en recherche produit exploitable. Les stopwords doivent réduire le bruit des requêtes sans supprimer les termes métier importants.

S3 pour les uploads image

Le stockage S3 est utilisé pour les images envoyées par les clients, par exemple dans les parcours SAV qui demandent des photos.

À vérifier :

• Le bucket existe pour le projet cible.
• Le chatbot backend ou le service responsable peut générer ou utiliser les URLs attendues.
• Les permissions d'écriture et de lecture correspondent au parcours métier.
• Les URLs stockées restent accessibles par les workflows qui en ont besoin.

Firecrawl

Firecrawl est une source de données utilisée pour collecter ou enrichir du contenu web exploitable par le chatbot.

À vérifier :

• Le compte ou token Firecrawl existe.
• Les URLs autorisées correspondent au site cible.
• Les données collectées sont alignées avec website_url et website_name.

Langfuse

Langfuse sert au suivi et à l'observabilité des conversations et appels IA.

À vérifier :

• Le projet Langfuse existe.
• Les credentials sont configurés dans les services qui émettent les traces.
• Les conversations de test apparaissent dans le tableau de bord après installation.

Docusaurus

La documentation elle-même reste un site Docusaurus. Pour modifier la navigation, utilisez sidebars.ts. Pour modifier les pages, éditez les fichiers .mdx dans docs/.

Le déploiement de cette documentation est automatisé via Cloudflare Pages lors de chaque push sur la branche main.