Bonnes pratiques d'indexation

La qualité des réponses de Pyxaura dépend directement de la façon dont vos documents sont
structurés et indexés. Ce guide résume les pratiques qui font le plus de différence, sans entrer
dans les détails d'implémentation.

1. Des titres explicites

Le titre d'un document apparaît dans les citations des réponses ([1] Politique de retour,
[2] Contrat cadre 2026...). Un titre vague ("Document 1", "Sans titre") rend la réponse moins
exploitable même si le contenu est parfaitement pertinent — l'utilisateur ne sait pas quelle
source consulter pour vérifier.

2. Un document = un sujet cohérent

Pyxaura découpe chaque document en fragments ("chunks") pour la recherche. Un document qui mélange
plusieurs sujets sans rapport (ex. un wiki fourre-tout de 200 pages) dilue la pertinence de
chaque fragment. Préférez plusieurs documents ciblés à un unique document monolithique — c'est
aussi plus facile à maintenir (mettre à jour un document de 2 pages plutôt que retrouver un
paragraphe dans un fichier de 300).

3. Laissez le texte structuré

Titres de section (#, ##...), listes à puces, tableaux : ces structures aident la recherche
lexicale (qui s'appuie sur la ponctuation et le découpage naturel du texte) autant que la lecture
humaine. Un texte brut sans aucune structure (mur de texte continu) est indexé, mais moins
précisément découpé.

4. Attention aux formats scannés

Un PDF scanné (image, pas de texte sélectionnable) nécessite une extraction OCR — automatique,
mais moins fiable qu'un texte natif, en particulier sur des documents de mauvaise qualité
d'impression ou une mise en page complexe (tableaux, colonnes). Quand c'est possible, privilégiez
la version texte native du document (export Word/Google Docs plutôt que scan papier).

5. Codes, références, identifiants

Si vos documents contiennent des références exactes (SKU, numéro de contrat, référence produit),
gardez-les lisibles telles quelles dans le texte plutôt que dans une image ou un format tabulaire
complexe : Pyxaura reconnaît spécifiquement ce type de motif pour garantir qu'une question
contenant une référence exacte retrouve bien la bonne ligne, même noyée dans un gros document.

6. Nettoyez les connecteurs inactifs

Un connecteur désynchronisé depuis longtemps (identifiants expirés, dossier supprimé côté
fournisseur) continue de consommer votre quota documents sans apporter de valeur. Vérifiez
périodiquement le statut de vos sources (page Connecteurs) et désactivez celles qui ne sont plus à
jour plutôt que de les laisser occuper un quota.

7. Une source par périmètre, pas un fourre-tout

Si vous gérez plusieurs projets ou clients, préférez plusieurs spaces Pyxaura dédiés plutôt
qu'un unique space mélangeant tout : cela évite qu'une question sur le projet A ne remonte des
résultats du projet B, et facilite l'attribution de jetons API à portée limitée (voir le
guide MCP sur les jetons scopés à une seule source).

En résumé

Bonne pratique	Pourquoi
Titre explicite	Citations exploitables
Un sujet par document	Fragments plus pertinents
Texte structuré (titres, listes)	Meilleur découpage
Texte natif plutôt que scan	Extraction plus fiable
Références exactes en texte brut	Garantie de correspondance exacte
Connecteurs à jour	Quota utilisé efficacement
Un space par périmètre	Pas de pollution croisée