Construire l’index

L’index permet à l’assistant de trouver le bon paragraphe par le sens, même quand le visiteur utilise d’autres mots que votre document. Vous le construisez en cliquant sur Build the index en haut de Answer Desk > Knowledge.

Qu’est-ce que l’index ?

Chaque document est découpé en passages (de courts morceaux de texte ; les anciennes versions les appelaient chunks). Le fournisseur d’index transforme chaque passage en une liste de nombres qui décrit son sens (on les appelle embeddings ou vecteurs). Quand un visiteur pose une question, elle est transformée en nombres de la même façon et comparée à vos passages. Tout est stocké dans votre propre base de données WordPress : aucun service supplémentaire n’est nécessaire.

Le construire

1. Allez dans Answer Desk > Knowledge.
2. La carte Search index (index de recherche) en haut montre le nombre de passages indexed (passages indexés) et combien restent à indexer, avec un coût estimé en dollars. Une étiquette à côté de son titre indique Complete (complet), To build (à construire), ou Words only (mots seulement) quand aucun fournisseur d’index n’est défini.
3. Cliquez sur Build the index. La construction se fait par lots avec une barre de progression ; vous pouvez la suivre sans que la page se fige.
4. À la fin, l’encadré indique The index is complete. Every document is searchable by meaning.

Le coût est en général de quelques centimes pour tout un site. L’estimation donne un ordre de grandeur ; la vraie facture vient de votre fournisseur.

Quand le reconstruire

• Après avoir téléversé ou importé de nouveaux documents.
• Après avoir modifié une page importée : son texte est mis à jour automatiquement, mais ses nouveaux passages doivent être indexés.
• Après avoir changé de fournisseur ou de modèle d’index (voir plus bas).

Vous n’avez pas besoin de vous en souvenir. Quand des documents ou des pages importées changent après la construction de l’index, Answer Desk marque l’index comme n’étant plus à jour : un avis avec un lien Build the index apparaît sur les écrans d’Answer Desk, et une fois dans la liste des Extensions (Answer Desk: some documents changed after the last index build, certains documents ont changé depuis la dernière construction de l’index), où vous pouvez le fermer jusqu’au prochain changement de l’index, et sur Start here l’étape Build the index perd sa coche. Les deux disparaissent quand l’index est de nouveau complet. L’extension ne reconstruit pas l’index toute seule, car chaque construction est une demande payante à votre fournisseur.

Qui construit l’index

Dans Answer Desk > AI provider, la carte Who builds the index a deux réglages :

• Index provider (fournisseur d’index) : par défaut The same one that answers, when it can (le même que celui qui répond, quand c’est possible). ChatGPT, Gemini et Mistral le peuvent. OpenRouter non : choisissez alors ici Voyage AI, ChatGPT, Gemini ou Mistral (avec sa clé enregistrée dans la carte API keys). Claude non plus, mais il n’a pas besoin d’index : laissez None: Claude reads the documents itself (aucun : Claude lit les documents lui-même, voir plus bas).
• Index model (modèle d’index) : le modèle recommandé est en tête de liste. Laissez-le sauf si vous savez pourquoi vous en voulez un autre.

Claude sans index

Si Claude répond et qu’aucun fournisseur d’index n’est réglé, il n’y a rien à construire. La carte Search index de l’écran Knowledge affiche Read by Claude (lu par Claude), et l’étape Build the index de Start here compte comme faite. Dans AI provider, le réglage How Claude reads your documents (comment Claude lit vos documents) choisit la manière :

• Automatic (par défaut) : en entier quand ils sont courts, par mots à chercher quand ils sont longs. Courts veut dire jusqu’à environ 33 000 mots au total, soit à peu près 80 pages de texte.
• Always whole (toujours en entier) : Claude lit tous les documents à chaque question. C’est le plus précis. Anthropic garde les documents dans son cache pendant cinq minutes, et les relire depuis ce cache coûte un dixième du prix normal : un chat très utilisé reste donc peu coûteux. La première question après une pause paie de nouveau le prix plein.
• Always by search words (toujours par mots à chercher) : un petit modèle Claude rapide transforme la question en mots à chercher, synonymes et traductions compris, et Claude ne lit que les passages qui les contiennent. C’est le moins cher : chaque question coûte à peu près autant qu’avec un index.

Sous le réglage, vous voyez combien de mots comptent vos documents et comment Claude les lit en ce moment. Dans Try it sur l’Overview, une note sous chaque réponse dit si Claude a lu tous vos documents ou quels mots il a cherchés.

Un index Voyage AI, ChatGPT, Gemini ou Mistral reste utile pour les archives très volumineuses, où chercher par le sens est plus précis que chercher par mots.

Sans index

Avec Claude, voir la section ci-dessus. Avec les autres fournisseurs, si aucun fournisseur d’index n’est réglé, l’assistant fonctionne quand même en comparant les mots au lieu du sens, et l’écran Knowledge le signale. Il ratera les questions posées avec d’autres mots : construisez donc l’index.

Très grandes archives

La recherche se fait à l’intérieur de WordPress. Sur un index très grand (plusieurs milliers de passages), le serveur peut ne pas réussir à tout parcourir à temps. Dans ce cas, l’extension le dit dans les résultats de Try it au lieu de ralentir en silence. Retirez les documents dont l’assistant n’a pas besoin, ou découpez ceux qui sont très longs.