AI Score
Jamdesk évalue la lisibilité de vos docs par les agents IA selon la norme AFDocs à chaque build. Score, corrections et suivi dans le temps.
Les assistants IA répondent de plus en plus aux questions sur votre produit directement à partir de votre documentation, mais seulement lorsqu'ils peuvent réellement la lire. AI Score mesure cela. Après chaque build, Jamdesk analyse votre site publié par rapport à la norme ouverte de préparation aux agents AFDocs et vous attribue un score de 0 à 100, une note lettrée, et un détail par problème sur lequel vous pouvez agir.
Testez-le d'abord sur n'importe quel site. L'outil AI Score gratuit note n'importe quelle URL de documentation selon la même norme, et l'extension Chrome AI Score note les sites pendant votre navigation. Dans Jamdesk, le score s'exécute automatiquement sur vos propres docs.
Fonctionnement du scoring
AI Score s'exécute automatiquement, sans configuration. Après chaque build réussi, Jamdesk attend que la nouvelle version soit en ligne, puis analyse vos docs publiées et enregistre le résultat.
- S'exécute à chaque build. Chaque déploiement renote votre site, donc une régression apparaît dès qu'elle est publiée.
- Score de 0 à 100 et une note lettrée (de A+ à F), mesurés par rapport à la norme ouverte AFDocs. C'est le même moteur que celui de l'outil public gratuit.
- Relancez à tout moment. Ouvrez la page AI Score de votre projet et cliquez sur Run score now pour renoter le site en ligne sans attendre un build.
Retrouvez-le dans le dashboard, sous votre projet → AI Score.
Lire votre score
Les captures d'écran montrent l'interface en anglais.
La page AI Score comporte trois parties :
- Donut de score. Votre score et votre note actuels, ainsi que l'évolution depuis votre dernier build.
- Ligne de tendance. Votre score sur les builds récents, pour repérer une baisse en un coup d'œil.
- Cartes de catégorie. Vos vérifications regroupées en sept domaines, chacun avec sa propre note. Développez-en une pour voir les vérifications individuelles et leur statut : réussie, avertissement ou échec.
Un pied de page indique ce qui a été analysé, combien de pages ont été échantillonnées, et la version de la spécification AFDocs.
Ce que mesure le score
Chaque catégorie regroupe des vérifications liées à la préparation aux agents :
| Catégorie | Ce qu'elle couvre |
|---|---|
| Content Discoverability | llms.txt et les signaux qui orientent les agents vers votre contenu |
| Markdown Availability | Une version Markdown propre de chaque page que les agents peuvent lire |
| Page Size & Truncation Risk | Des pages assez petites pour tenir dans la fenêtre de contexte d'un agent |
| Content Structure | Titres, ordre, et contenu qui démarre tôt sur la page |
| URL Stability & Redirects | URLs stables et redirections correctes vers le même hôte |
| Observability & Content Health | Codes de statut, mise en cache, et parité entre ce que voient les lecteurs et les agents |
| Authentication & Access | Si les pages sont accessibles ou non aux agents |
Corriger les problèmes
Chaque vérification en avertissement ou en échec est accompagnée d'une explication en langage clair et d'une correction formulée en termes de votre MDX et de votre docs.json. Deux types de résultats apparaissent :
- Ce que vous corrigez dans votre contenu. Par exemple, une page dont le contenu réel commence trop bas, une page trop volumineuse qui devrait être scindée, ou du contenu rendu par un composant interactif qui n'apparaît pas dans le Markdown de la page. Le texte de correction indique la prochaine étape et les pages concernées.
- Ce que Jamdesk gère pour vous.
llms.txt, l'export Markdown, les codes de statut et la mise en cache sont tous générés automatiquement. Si l'un d'eux échoue, cela signifie généralement un problème de build transitoire ; relancez le score après votre prochain build, et contactez le support si le problème persiste.
Copier le prompt de correction
Chaque vérification corrigible dispose d'un bouton Copy prompt to fix. Il copie un prompt prêt à coller qui nomme la vérification, le constat, et la façon de le résoudre dans votre MDX ou votre docs.json. Collez-le dans un agent de codage IA (Claude Code, le plugin Claude Jamdesk, Cursor, ou Codex) et laissez-le effectuer la modification, puis publiez pour reconstruire et renoter.
Recevoir un e-mail lorsque votre score change
Votre équipe n'a pas besoin de surveiller le dashboard. Lorsqu'un build modifie votre score ou votre note (ou produit votre tout premier score), Jamdesk envoie un e-mail aux membres du projet avec le nouveau score et le problème le plus important à corriger.
- Activez-le par projet. Le commutateur Email team when score changes se trouve en haut de la page AI Score. Il est activé par défaut.
- Seuls les changements significatifs déclenchent un envoi. Un build qui laisse votre score inchangé ne déclenche pas d'e-mail, donc votre boîte de réception reste calme sauf si quelque chose a réellement bougé.
L'e-mail signale un changement, pas chaque build. Les relances manuelles et les scores déclenchés par un build peuvent tous deux envoyer un e-mail ; les scans rétroactifs et ceux de l'outil public n'en envoient jamais.
Dépannage
Une analyse peut revenir vide si votre site était momentanément inaccessible, a renvoyé une erreur, ou a bloqué le scanner. Jamdesk n'enregistre pas ces résultats, donc un incident transitoire ne fixera pas un score erroné ni n'affectera votre ligne de tendance. Votre dernier bon score reste affiché ; cliquez sur Run score now pour réessayer.
Les agents IA ne peuvent pas lire les pages protégées par un mot de passe, donc le score en tient compte. Si le contrôle d'accès est intentionnel (docs internes ou pré-lancement), un score bas ici est normal et sans problème.
Certaines vérifications couvrent un comportement de la plateforme géré par Jamdesk (llms.txt, export Markdown, codes de statut, mise en cache). Elles réussissent par construction, donc un échec signifie presque toujours un problème de build transitoire. Relancez le score après votre prochain build, et contactez le support si le problème persiste.