Index du Centre d'aide
Ré-encode les pages du Centre de connaissances pour que l’assistant intégré puisse les retrouver.
Fonctionnement
L’assistant intégré utilise une recherche vectorielle sur une copie chunked et embeddée du Centre de connaissances pour répondre aux questions. Cette tâche reconstruit (ou met à jour incrementalement) cet index :
- Découpe les pages par titre
- Calcule les embeddings pour les chunks dont le contenu a changé depuis la dernière exécution
- Les écrit dans la table globale
help_chunks - Supprime les orphelins — les chunks dont la page source n’est plus dans l’ensemble fourni sont retirés en mode « full »
La tâche a deux modes :
- Incremental — déclenché par CI/CD après une publication du Centre. L’entrée liste les pages changées et leur contenu markdown inline
- Reindex complet — parcourt le répertoire local
content(par défaut/help/content). Utilisé pour amorcer un nouveau déploiement ou récupérer d’une corruption d’index
L’index est global, pas par espace de travail. La tâche est épinglée à l’espace système et refuse de tourner ailleurs.
Quand elle s’exécute
La tâche est déclenchée par l’opérateur — pas de planification. La CI/CD l’invoque après chaque déploiement du Centre de connaissances ; vous pouvez aussi la lancer manuellement.
Paramètres
| Paramètre | Description |
|---|---|
| Content Dir | Chemin d’un répertoire Hugo local. Utilisé par le mode reindex complet. Par défaut /help/content |
| Pages | Une liste de chemins et de contenus markdown inline. Utilisée par le mode incremental |
| Deleted Paths | Une liste de chemins de pages à retirer de l’index |
| Full | Lorsqu’activé avec Pages, autorise le nettoyage des orphelins — tout chunk dont le chemin source n’est pas dans l’ensemble fourni est supprimé. À utiliser uniquement quand Pages contient l’ensemble complet du contenu |
La tâche est ignorée avec skipped: true, reason: "embedder not configured" quand le déploiement n’a pas de fournisseur d’embeddings configuré.
Résultats de la tâche
| Métrique | Description |
|---|---|
files_processed | Nombre de pages parcourues |
chunks_created | Nouvelles lignes de chunk insérées |
chunks_updated | Lignes existantes dont l’embedding a été rafraîchi |
chunks_deleted | Lignes orphelines supprimées |
chunks_skipped | Chunks dont le hash a correspondu à la ligne existante (pas de nouvel embedding) |
languages | Ensemble des locales rencontrées |
Dépannage
| Problème | Solution |
|---|---|
Saut embedder not configured | Le déploiement n’a pas de fournisseur d’embeddings. Configurez-en un, ou acceptez que la recherche de l’assistant retombe sur la recherche par mots-clés |
| Échec avec une erreur d’autorisation | Vérifiez que la clé API du fournisseur d’embeddings est encore valide |
| L’assistant renvoie encore des réponses obsolètes | Rafraîchissez la session de l’assistant. Le magasin vectoriel est lu à chaque requête, mais l’assistant peut avoir mis en cache des réponses récentes |