AI Score
Jamdesk bewertet bei jedem Build, wie gut KI-Agenten Ihre Dokumentation nach dem offenen AFDocs-Standard lesen können. Ergebnisse verbessern und verfolgen.
KI-Assistenten beantworten zunehmend Fragen zu Ihrem Produkt direkt aus Ihrer Dokumentation – aber nur, wenn sie diese tatsächlich lesen können. AI Score misst genau das. Nach jedem Build scannt Jamdesk Ihre veröffentlichte Website anhand des offenen AFDocs-Standards für Agent-Readiness und gibt Ihnen eine Bewertung von 0 bis 100, eine Buchstabennote und eine nach Problemen aufgeschlüsselte Übersicht, auf deren Grundlage Sie handeln können.
Die Screenshots zeigen die Benutzeroberfläche auf Englisch.
Testen Sie es zuerst auf einer beliebigen Website. Das kostenlose AI Score tool bewertet jede Dokumentations-URL anhand desselben Standards, und die AI Score Chrome extension 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 dann 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.
- Score 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 Seite AI Score 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 Seite AI Score besteht aus drei Teilen:
- Score-Ring. Ihr aktueller Score und Ihre Note sowie die Änderung seit Ihrem letzten Build.
- Trendlinie. Ihr Score aus den letzten Builds, sodass ein Rückgang sofort erkennbar ist.
- Kategorie-Karten. Ihre Prüfungen, gruppiert in sieben Bereiche, jeweils mit eigener Note. Klappen Sie einen Bereich auf, um die einzelnen Prüfungen und deren Status – bestanden, Warnung oder fehlgeschlagen – anzuzeigen.
In einer Fußzeile wird vermerkt, was gescannt wurde, wie viele Seiten als Stichprobe dienten und welche Version der AFDocs-Spezifikation verwendet wurde.
Was der Score misst
Jede Kategorie fasst miteinander verbundene Prüfungen zur Agent-Readiness zusammen:
| Kategorie | Inhalt |
|---|---|
| Auffindbarkeit von Inhalten | llms.txt und Signale, die Agenten zu Ihren Inhalten führen |
| Markdown-Verfügbarkeit | Eine saubere Markdown-Version jeder Seite zum Lesen für Agenten |
| Seitengröße und Kürzungsrisiko | Seiten, die klein genug für das Kontextfenster eines Agenten sind |
| 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 der Ansicht für Leser und Agenten |
| Authentifizierung und Zugriff | Ob Agenten Seiten überhaupt erreichen können |
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. Zum Beispiel 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 betroffenen Seiten.
- Probleme, die Jamdesk für Sie übernimmt.
llms.txt, Markdown-Export, Statuscodes und Caching werden automatisch erzeugt. Wenn eine dieser Prüfungen fehlschlägt, handelt es sich normalerweise um ein vorübergehendes Build-Problem. Führen Sie den Score nach Ihrem nächsten Build erneut aus und wenden Sie sich an den Support, wenn 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 ständig beobachten. Jamdesk sendet den Mitgliedern Ihres Projekts eine E-Mail mit dem neuen Score und dem wichtigsten zu behebenden Problem, sobald ein Build Ihren ersten Score erzeugt, Ihren Score um mindestens 3 Punkte verändert oder ihn wieder auf perfekte 100 bringt.
- Pro Projekt aktivieren. Der Schalter Email team when score changes befindet sich oben auf der Seite AI Score. Standardmäßig ist er aktiviert.
- Kleine Schwankungen bleiben ohne Benachrichtigung. Eine Änderung um ein oder zwei Punkte löst allein keine E-Mail aus, wird aber nicht vergessen: Jamdesk vergleicht jeden neuen Score mit dem letzten Score, über den Sie per E-Mail benachrichtigt wurden. So summieren sich schrittweise Veränderungen, und Sie erhalten eine Nachricht, sobald die Gesamtänderung 3 Punkte erreicht.
Manuelle erneute Ausführungen und durch Builds ausgelöste Bewertungen können beide eine E-Mail senden; nachträglich eingetragene und über das öffentliche Tool ausgeführte Scans tun dies nie.
Fehlerbehebung
Ein Scan kann leer zurückkommen, wenn Ihre Website kurzzeitig nicht erreichbar war, einen Fehler zurückgegeben oder den Scanner blockiert hat. Jamdesk speichert diese Ergebnisse nicht, sodass ein vorübergehender Ausfall keinen falschen Score festschreibt und Ihre Trendlinie nicht beeinträchtigt. Ihr letzter gültiger Score bleibt sichtbar. Klicken Sie auf Run score now, um es erneut zu versuchen.
KI-Agenten können keine Seiten hinter einem Passwort lesen, daher spiegelt der Score dies wider. Wenn der Zugriff bewusst beschränkt ist (z. B. bei interner oder noch nicht veröffentlichter Dokumentation), ist ein niedriger Score hier erwartbar und unproblematisch.
Einige Prüfungen betreffen das Plattformverhalten, für das Jamdesk verantwortlich ist (llms.txt, Markdown-Export, Statuscodes und Caching). Diese Prüfungen bestehen konstruktionsbedingt. Ein Fehler bedeutet daher fast immer ein vorübergehendes Build-Problem. Führen Sie den Score nach Ihrem nächsten Build erneut aus und wenden Sie sich an den Support, wenn das Problem bestehen bleibt.