Docusaurus

Synchronisez votre site de documentation Docusaurus dans la base de connaissances d'AI SmartTalk. Votre IA apprendra de chaque page de votre sitemap—parfait pour les bots de support qui répondent à des questions techniques.

---

Aperçu

L'intégration Docusaurus vous permet de :

• Importer automatiquement toutes les pages de votre sitemap
• Maintenir les docs synchronisés lorsque vous publiez des mises à jour
• Répondre aux questions sur votre documentation de manière conversationnelle
• Réduire la charge de support en laissant l'IA gérer les questions courantes

Fait amusant : La documentation d'AI SmartTalk utilise Docusaurus, et cette intégration alimente notre chatbot de support !

---

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Un compte AI SmartTalk actif
• Un site Docusaurus avec un sitemap.xml valide
• Votre site doit être accessible publiquement (ou fournir une authentification)

---

Configuration étape par étape

Étape 1 : Localiser votre Sitemap

Docusaurus génère automatiquement un sitemap. Trouvez-le à l'adresse :

https://your-docs-site.com/sitemap.xml

Vérifiez qu'il se charge dans votre navigateur et contient vos pages de documentation.

Étape 2 : Ajouter l'intégration Docusaurus

1. Connectez-vous à votre compte AI SmartTalk
2. Accédez à Paramètres → Intégrations
3. Trouvez Docusaurus et cliquez sur Connecter
4. Entrez l'URL de votre sitemap
5. Cliquez sur Valider

Étape 3 : Configurer les paramètres d'importation

Après validation, configurez votre importation :

Paramètre	Description
URL du Sitemap	URL complète de votre sitemap.xml
Modèles inclus	Synchronisez uniquement les pages correspondant à des modèles (optionnel)
Modèles exclus	Ignorez des pages ou sections spécifiques (optionnel)

Étape 4 : Démarrer l'importation

1. Cliquez sur Importer des pages
2. AI SmartTalk explore chaque URL de votre sitemap
3. Le contenu est extrait et ajouté à votre base de connaissances
4. Attendez que l'importation soit terminée (progrès affiché)

Étape 5 : Vérifier l'importation

1. Allez dans Connaissance dans AI SmartTalk
2. Vos pages de documentation devraient apparaître
3. Testez votre IA en posant des questions sur vos docs

---

Ce qui est synchronisé

Contenu	Comment il est traité
Titre de la page	Utilisé comme identifiant de document
Contenu de la page	Texte complet extrait du HTML
Titres	Préservés pour la structure
Blocs de code	Inclus tel quel
Tableaux	Convertis en format lisible
URLs	URL de la page stockée pour référence

Extraction de contenu

AI SmartTalk extrait la zone de contenu principale et ignore :

• Menus de navigation
• Barres latérales
• Pieds de page
• Scripts et styles

---

Comportement de Synchronisation

Importation Manuelle

Cliquez sur Importer dans les paramètres d'intégration pour :

• Récupérer le dernier sitemap
• Ajouter de nouvelles pages
• Mettre à jour les pages modifiées
• Supprimer les pages supprimées

Maintenir la Documentation à Jour

Pour une documentation toujours actuelle :

1. Rafraîchissement manuel : Cliquez sur Importer après la publication des mises à jour
2. Synchronisation programmée : Utilisez SmartFlow pour automatiser les importations

Importation Programmée SmartFlow

Workflow: Docusaurus Auto-Sync
Trigger: Scheduled (Daily at 3:00 AM)
Actions:
  - Sync Connector:
      Type: Docusaurus
      Sitemap: https://docs.example.com/sitemap.xml

---

Modèles d'URL

Modèles Inclus

Synchronisez uniquement des sections spécifiques :

Modèle	Effet
/docs/api/*	Documentation API uniquement
/docs/guides/*	Section des guides uniquement
/blog/*	Articles de blog uniquement

Modèles Exclus

Ignorez certaines pages :

Modèle	Effet
/docs/internal/*	Ignorer la documentation interne
/changelog	Ignorer la page de changelog
*/draft-*	Ignorer les pages de brouillon

---

Cas d'Utilisation

Bot de Support Technique

Synchronisez la documentation de votre produit :

• "Comment installer le SDK ?"
• "Quelles sont les limites de taux de l'API ?"
• "Montrez-moi un exemple d'authentification"

Documentation Développeur

Synchronisez les références et guides API :

• "Quels paramètres accepte le point de terminaison /users ?"
• "Comment gérer les webhooks ?"
• "Quelle est la différence entre l'API v1 et v2 ?"

Base de Connaissances Interne

Synchronisez les wikis et procédures de l'entreprise :

• "Quel est le processus pour demander un congé ?"
• "Comment configurer mon environnement de développement ?"
• "Où puis-je trouver les directives de marque ?"

---

Dépannage

Problèmes de Sitemap

Problème	Solution
"Sitemap invalide"	Vérifiez que l'URL renvoie un XML valide
"Aucune page trouvée"	Vérifiez que le sitemap contient des entrées <url>
"Accès refusé"	Assurez-vous que le sitemap est accessible publiquement

Problèmes d'Importation

Problème	Solution
Pages manquantes	Vérifiez les modèles d'inclusion/exclusion
Importation bloquée	Les grands sites prennent du temps ; attendez ou importez par lots
Ancien contenu	Réimportez pour récupérer les dernières versions

Qualité du Contenu

Problème	Solution
Mauvais contenu extrait	Signalez le problème—peut nécessiter une extraction personnalisée
Blocs de code manquants	Vérifiez que le code est dans des balises standard <pre><code>
Texte illisible	Vérifiez l'encodage de la page (UTF-8 recommandé)

---

Gestion de l'Intégration

Action	Comment
Réimporter tout	Cliquez sur Importer dans les paramètres d'intégration
Changer le sitemap	Mettez à jour l'URL et réimportez
Supprimer du contenu	Déconnectez l'intégration ou supprimez de la base de connaissances
Déconnecter	Paramètres → Intégrations → Docusaurus → Déconnecter

---

Meilleures Pratiques

1. Contenu de qualité : Des documents bien rédigés = de meilleures réponses de l'IA
2. Structure claire : Utilisez des titres, des listes et des tableaux
3. Titres descriptifs : Les titres de page aident l'IA à comprendre le contexte
4. Synchronisations régulières : Tenez l'IA à jour avec la documentation la plus récente
5. Testez en profondeur : Posez des questions courantes pour vérifier l'exactitude de l'IA

---

Conseils de Configuration Docusaurus

Optimiser pour l'Extraction de l'IA

Dans votre docusaurus.config.js :

module.exports = {
  // Ensure sitemap is generated
  plugins: ['@docusaurus/plugin-sitemap'],
  
  // Use descriptive page titles
  title: 'Your Product Docs',
  
  // Include metadata
  themeConfig: {
    metadata: [{
      name: 'description',
      content: 'Documentation for Your Product'
    }],
  },
};

Exclure des Pages du Sitemap

Pour empêcher certaines pages d'être synchronisées :

// In page frontmatter
---
title: Internal Page
sitemap:
  exclude: true
---

---

Documentation Connexe

• Aperçu des Intégrations
• Gestion de la Base de Connaissances
• Intégration du Flux RSS — Pour le contenu de blog/actualités
• Déclencheurs Planifiés SmartFlow — Automatiser les imports