Punteggio AI
A ogni build, Jamdesk valuta quanto gli agenti AI riescono a leggere la documentazione secondo lo standard AFDocs: consulta il voto, correggi i problemi e segui l'andamento.
Gli assistenti AI rispondono alle domande sul tuo prodotto usando la documentazione. Possono farlo solo se riescono a leggerla. AI Score misura quanto bene ci riescono. Dopo ogni build, Jamdesk scansiona il sito pubblicato secondo lo standard aperto AFDocs per la preparazione degli agenti AI. Ottieni un punteggio da 0 a 100, un voto in lettere e un dettaglio per ogni problema.
Gli screenshot mostrano l'interfaccia in inglese.
Provalo prima su qualsiasi sito. Lo strumento gratuito AI Score assegna un voto a qualsiasi URL di documentazione secondo lo stesso standard. L'estensione AI Score per Chrome valuta i siti mentre navighi. In Jamdesk, il punteggio viene calcolato automaticamente sulla tua documentazione.
Come funziona il punteggio
AI Score viene eseguito automaticamente, senza configurazione. Jamdesk attende che ogni build completata con successo venga pubblicata. Poi scansiona la documentazione pubblicata e registra il risultato.
- Viene eseguito a ogni build: ogni deploy valuta di nuovo il sito. Eventuali regressioni vengono rilevate non appena vengono pubblicate.
- Punteggio da 0 a 100 e voto in lettere (da A+ a F), misurati secondo lo standard aperto AFDocs. Usa lo stesso motore dello strumento pubblico gratuito.
- Esegui di nuovo la valutazione quando vuoi: apri la pagina AI Score del progetto e fai clic su Run score now. Il sito pubblicato viene valutato di nuovo senza attendere una build.
La trovi nel dashboard, sotto il tuo progetto → AI Score.
Leggere il punteggio
La pagina AI Score è composta da tre parti:
- Grafico ad anello: il punteggio e il voto attuali, oltre alla variazione rispetto all'ultima build.
- Linea di tendenza: il punteggio delle build recenti. Un calo è subito visibile.
- Schede di categoria: i controlli sono raggruppati in sette aree, ciascuna con un voto. Espandi una scheda per vedere i controlli e il relativo esito: superato, avviso o non superato.
Nel piè di pagina sono indicati gli elementi sottoposti a scansione, il numero di pagine campionate e la versione delle specifiche AFDocs.
Cosa misura il punteggio
Ogni categoria raggruppa controlli correlati alla preparazione per gli agenti AI:
| Categoria | Contenuto |
|---|---|
| Individuabilità dei contenuti | llms.txt e i segnali che indirizzano gli agenti ai tuoi contenuti |
| Disponibilità Markdown | Una versione Markdown pulita di ogni pagina, leggibile dagli agenti |
| Dimensione delle pagine e rischio di troncamento | Pagine abbastanza piccole da rientrare nella finestra di contesto di un agente |
| Struttura dei contenuti | Intestazioni, ordine e contenuti che iniziano all'inizio della pagina |
| Stabilità degli URL e reindirizzamenti | URL stabili e reindirizzamenti corretti sullo stesso host |
| Osservabilità e integrità dei contenuti | Codici di stato, caching e coerenza tra ciò che vedono i lettori e gli agenti |
| Autenticazione e accesso | Indica se gli agenti riescono a raggiungere le pagine |
Risolvere i problemi
Ogni controllo con un avviso o non superato include una spiegazione in linguaggio semplice. Le istruzioni per risolverlo fanno riferimento a MDX e docs.json. I risultati sono di due tipi:
- Problemi da correggere nei contenuti: per esempio, una pagina il cui contenuto inizia troppo in basso, una pagina troppo grande da suddividere o contenuti generati da un componente interattivo che non compaiono nel Markdown della pagina. Le istruzioni indicano il passaggio successivo e le pagine interessate.
- Attività gestite da Jamdesk: Jamdesk genera
llms.txt, l'esportazione Markdown, i codici di stato e il caching. Un errore in quest'area di solito indica un problema temporaneo della build. Esegui di nuovo la valutazione dopo la build successiva. Contatta il supporto se il problema persiste.
Copiare il prompt per la correzione
Ogni controllo correggibile include un pulsante Copy prompt to fix. Copia un prompt che descrive il controllo, il risultato e la correzione da apportare in MDX o docs.json. Incollalo in un agente di coding AI (Claude Code, il plugin Claude di Jamdesk, Cursor o Codex) per applicare la modifica. Esegui il push per avviare una nuova build e valutare di nuovo il sito.
Ricevere un'email quando cambia il punteggio
Jamdesk invia ai membri del progetto un'email con il nuovo punteggio e il problema più importante da risolvere. L'email viene inviata quando una build produce il primo punteggio, quando il punteggio cambia di almeno 3 punti o quando torna a 100.
- Attivala per ogni progetto: l'interruttore Email team when score changes si trova in cima alla pagina AI Score. È attivato per impostazione predefinita.
- Le variazioni minime non inviano notifiche: una variazione di uno o due punti non genera un'email. Jamdesk confronta ogni nuovo punteggio con l'ultimo per cui ti ha inviato un'email. Le variazioni graduali si sommano: ricevi un'email quando la variazione totale raggiunge 3 punti.
Le valutazioni manuali e quelle avviate da una build possono inviare l'email. Le scansioni retroattive e quelle dello strumento pubblico non la inviano mai.
Risoluzione dei problemi
Una scansione non restituisce risultati se il sito è stato temporaneamente irraggiungibile, ha restituito un errore o ha bloccato lo scanner. Jamdesk non salva questi risultati. Un problema momentaneo non farà comparire un punteggio errato né influirà sulla linea di tendenza. L'ultimo punteggio valido rimane visibile sulla pagina. Fai clic su Run score now per riprovare.
Gli agenti AI non possono leggere le pagine protette da password, e il punteggio ne tiene conto. Un punteggio basso è previsto quando la protezione è intenzionale, per esempio per la documentazione interna o non ancora pubblicata.
Un progetto noindex non ha una sitemap che Jamdesk possa scansionare. Jamdesk non esegue AI Score per quel progetto. Gli agenti AI possono comunque leggere la documentazione tramite llms.txt, che rimane pubblicato anche con noindex. Rimuovi noindex da seo.metatags.robots in docs.json per ottenere di nuovo un punteggio.
Alcuni controlli riguardano comportamenti della piattaforma gestiti da Jamdesk (llms.txt, esportazione Markdown, codici di stato e caching). Questi controlli dovrebbero essere superati. Un errore indica quasi sempre un problema temporaneo della build. Esegui di nuovo la valutazione dopo la build successiva. Contatta il supporto se il problema persiste.