AI-Score
Jamdesk bewertet bei jedem Build anhand des offenen AFDocs-Standards, wie gut KI-Agenten Ihre Dokumentation lesen können. Ergebnisse verbessern und verfolgen.
KI-Assistenten beantworten zunehmend Fragen zu Ihrem Produkt direkt anhand Ihrer Dokumentation – aber nur, wenn sie diese tatsächlich lesen können. Genau das misst AI Score. Nach jedem Build scannt Jamdesk Ihre veröffentlichte Website anhand des offenen AFDocs-Standards für Agenten und gibt Ihnen eine Bewertung von 0 bis 100, eine Buchstabennote sowie eine nach Problemen aufgeschlüsselte Übersicht, anhand derer Sie Maßnahmen ergreifen können.
Die Screenshots zeigen die Benutzeroberfläche auf Englisch.
Testen Sie es zuerst auf jeder beliebigen Website. Das kostenlose AI Score-Tool bewertet jede Dokumentations-URL anhand desselben Standards, und die AI Score Chrome-Erweiterung bewertet Websites, während Sie darin navigieren. Innerhalb von Jamdesk wird der Score automatisch für Ihre eigene Dokumentation berechnet.
So funktioniert die Bewertung
AI Score wird automatisch und ohne Einrichtung ausgeführt. Nach jedem erfolgreichen Build wartet Jamdesk, bis die neue Version live ist, scannt anschließend Ihre veröffentlichte Dokumentation und speichert das Ergebnis.
- Wird bei jedem Build ausgeführt. Bei jedem Bereitstellen wird Ihre Website erneut bewertet, sodass eine Verschlechterung sofort beim Veröffentlichen sichtbar wird.
- Bewertung von 0 bis 100 und Buchstabennote (von A+ bis F), gemessen am offenen AFDocs-Standard. Dabei kommt dieselbe Engine wie beim kostenlosen öffentlichen Tool zum Einsatz.
- Jederzeit erneut ausführen. Öffnen Sie die AI Score-Seite Ihres Projekts und klicken Sie auf Run score now, um die Live-Website erneut zu bewerten, ohne auf einen Build zu warten.
Sie finden die Funktion im Dashboard unter Ihrem Projekt → AI Score.
Ihren Score lesen
Die AI Score-Seite besteht aus drei Teilen:
- Bewertungsring. Ihre aktuelle Bewertung und Note sowie die Änderung seit Ihrem letzten Build.
- Trendlinie. Ihre Bewertung über die letzten Builds hinweg, sodass ein Rückgang sofort erkennbar ist.
- Kategorie-Karten. Ihre Prüfungen, gruppiert in sieben Bereiche, jeweils mit eigener Note. Klappen Sie eine Karte auf, um die einzelnen Prüfungen und deren Status – bestanden, Warnung oder fehlgeschlagen – zu sehen.
Eine Fußzeile gibt an, was gescannt wurde, wie viele Seiten als Stichprobe verwendet wurden und welche AFDocs-Spezifikationsversion zum Einsatz kam.
Was der Score misst
Jede Kategorie fasst verwandte Prüfungen zur Agentenbereitschaft zusammen:
| Kategorie | Inhalt |
|---|---|
| Auffindbarkeit von Inhalten | llms.txt und Signale, die Agenten zu Ihren Inhalten führen |
| Verfügbarkeit von Markdown | Eine saubere Markdown-Version jeder Seite zum Lesen für Agenten |
| Seitengröße und Kürzungsrisiko | Seiten, die klein genug sind, um in das Kontextfenster eines Agenten zu passen |
| Inhaltsstruktur | Überschriften, Reihenfolge und Inhalte, die früh auf der Seite beginnen |
| URL-Stabilität und Weiterleitungen | Stabile URLs und korrekte Weiterleitungen innerhalb desselben Hosts |
| Beobachtbarkeit und Inhaltsqualität | Statuscodes, Caching und Übereinstimmung zwischen dem, was Leser und Agenten sehen |
| Authentifizierung und Zugriff | Ob Seiten für Agenten überhaupt erreichbar sind |
Probleme beheben
Jede Prüfung mit einer Warnung oder einem Fehler enthält eine verständliche Erklärung und eine Lösung, die sich auf Ihr MDX und docs.json bezieht. Es gibt zwei Arten von Ergebnissen:
- Probleme, die Sie in Ihren Inhalten beheben. Dazu gehören beispielsweise eine Seite, deren eigentlicher Inhalt zu weit unten beginnt, eine zu große Seite, die aufgeteilt werden sollte, oder Inhalte, die von einer interaktiven Komponente gerendert werden und nicht im Markdown der Seite erscheinen. Der Lösungstext nennt den nächsten Schritt und die Seiten, für die er gilt.
- Probleme, die Jamdesk für Sie behebt.
llms.txt, der Markdown-Export, Statuscodes und Caching werden automatisch generiert. Wenn eine dieser Prüfungen fehlschlägt, handelt es sich normalerweise um ein vorübergehendes Build-Problem. Führen Sie die Bewertung nach Ihrem nächsten Build erneut aus und wenden Sie sich an den Support, falls das Problem bestehen bleibt.
Lösungsvorschlag kopieren
Jede behebbare Prüfung verfügt über eine Schaltfläche Copy prompt to fix. Sie kopiert einen direkt einfügbaren Prompt, der die Prüfung, das Ergebnis und die Lösung in Ihrem MDX oder docs.json nennt. Fügen Sie ihn in einen KI-Coding-Agenten (Claude Code, das Jamdesk Claude-Plugin, Cursor oder Codex) ein und lassen Sie die Änderung vornehmen. Pushen Sie anschließend, um einen neuen Build und eine erneute Bewertung auszulösen.
Bei Änderungen Ihres Scores eine E-Mail erhalten
Ihr Team muss das Dashboard nicht überwachen. Jamdesk sendet Ihren Projektmitgliedern eine E-Mail mit der neuen Bewertung und dem wichtigsten zu behebenden Problem, sobald ein Build erstmals eine Bewertung erzeugt, Ihre Bewertung um mindestens 3 Punkte verändert oder sie wieder auf perfekte 100 steigt.
- Pro Projekt aktivieren. Der Schalter Email team when score changes befindet sich oben auf der AI Score-Seite. Standardmäßig ist er aktiviert.
- Kleine Schwankungen bleiben unbemerkt. Eine Änderung um ein oder zwei Punkte löst allein keine E-Mail aus, wird aber nicht vergessen: Jamdesk vergleicht jede neue Bewertung mit der letzten, über die Sie per E-Mail informiert wurden. Dadurch summieren sich allmähliche Veränderungen, und Sie werden benachrichtigt, sobald die Gesamtänderung 3 Punkte erreicht.
Manuelle erneute Bewertungen und durch Builds ausgelöste Bewertungen können beide E-Mails senden; nachträglich eingetragene und Scans des öffentlichen Tools senden niemals E-Mails.
Fehlerbehebung
Ein Scan kann leer zurückkommen, wenn Ihre Website vorübergehend nicht erreichbar war, einen Fehler zurückgegeben oder den Scanner blockiert hat. Jamdesk speichert diese Ergebnisse nicht, sodass eine vorübergehende Störung keine falsche Bewertung festschreibt und Ihre Trendlinie nicht beeinträchtigt. Ihre letzte gültige Bewertung bleibt angezeigt. Klicken Sie auf Run score now, um es erneut zu versuchen.
KI-Agenten können keine Seiten hinter einem Passwort lesen, daher spiegelt die Bewertung dies wider. Wenn der Zugriff absichtlich beschränkt ist, etwa bei interner oder noch nicht veröffentlichter Dokumentation, ist eine niedrige Bewertung hier zu erwarten und unproblematisch.
Ein noindex-Projekt verfügt über keine Sitemap, die Jamdesk scannen kann. Daher wird AI Score übersprungen, statt ausgeführt zu werden – es gibt nichts, das zuverlässig gemessen werden kann. Dies wirkt sich nicht auf KI-Agenten aus: Sie können Ihre Dokumentation weiterhin über llms.txt lesen, das unabhängig von noindex veröffentlicht bleibt. Wenn Sie wieder eine Bewertung erhalten möchten, entfernen Sie noindex aus seo.metatags.robots in docs.json.
Einige Prüfungen betreffen Plattformverhalten, für das Jamdesk zuständig ist (llms.txt, Markdown-Export, Statuscodes und Caching). Diese Prüfungen bestehen konstruktionsbedingt, daher bedeutet ein Fehler fast immer ein vorübergehendes Build-Problem. Führen Sie die Bewertung nach Ihrem nächsten Build erneut aus und wenden Sie sich an den Support, falls das Problem bestehen bleibt.