AI Score
Em cada build, o Jamdesk avalia como agentes de IA leem sua documentação segundo o padrão aberto AFDocs. Veja a nota, corrija problemas e acompanhe a evolução.
Os assistentes de IA respondem cada vez mais a perguntas sobre seu produto diretamente a partir da sua documentação, mas apenas quando conseguem realmente lê-la. O AI Score mede isso. Após cada build, o Jamdesk verifica seu site publicado em relação ao padrão aberto de prontidão para agentes AFDocs e fornece uma pontuação de 0 a 100, uma nota em letras e uma análise detalhada por problema, para que você possa agir.
As capturas de tela mostram a interface em inglês.
Experimente primeiro em qualquer site. A ferramenta AI Score gratuita avalia qualquer URL de documentação com base no mesmo padrão, e a extensão AI Score para Chrome avalia sites enquanto você navega. Dentro do Jamdesk, a pontuação é executada automaticamente na sua própria documentação.
Como a pontuação funciona
O AI Score é executado automaticamente, sem configuração. Após cada build bem-sucedido, o Jamdesk espera a nova versão entrar no ar, verifica sua documentação publicada e registra o resultado.
- É executado em cada build. Cada deploy recalcula a pontuação do seu site, então uma regressão aparece assim que é publicada.
- Pontuação de 0 a 100 e uma nota em letras (de A+ a F), medidas em relação ao padrão aberto AFDocs. É o mesmo mecanismo usado pela ferramenta pública gratuita.
- Execute novamente a qualquer momento. Abra a página AI Score do seu projeto e clique em Run score now para pontuar o site ativo novamente sem esperar por um build.
Encontre-o no dashboard, em seu projeto → AI Score.
Leia sua pontuação
A página do AI Score tem três partes:
- Gráfico de pontuação. Sua pontuação e nota atuais, além da mudança desde o último build.
- Linha de tendência. Sua pontuação ao longo dos builds recentes, para que uma queda apareça rapidamente.
- Cartões de categorias. Suas verificações agrupadas em sete áreas, cada uma com sua própria nota. Expanda uma delas para ver as verificações individuais e saber se foram aprovadas, emitiram um aviso ou falharam.
Um rodapé informa o que foi verificado, quantas páginas foram amostradas e a versão da especificação AFDocs.
O que a pontuação mede
Cada categoria agrupa verificações relacionadas à prontidão para agentes:
| Categoria | O que abrange |
|---|---|
| Descobribilidade do conteúdo | llms.txt e os sinais que direcionam os agentes para seu conteúdo |
| Disponibilidade em Markdown | Uma versão limpa em Markdown de cada página para leitura pelos agentes |
| Tamanho da página e risco de truncamento | Páginas pequenas o suficiente para caber na janela de contexto de um agente |
| Estrutura do conteúdo | Títulos, ordenação e conteúdo que começa cedo na página |
| Estabilidade de URL e redirecionamentos | URLs estáveis e redirecionamentos adequados no mesmo host |
| Observabilidade e integridade do conteúdo | Códigos de status, cache e paridade entre o que leitores e agentes veem |
| Autenticação e acesso | Se as páginas podem ser acessadas pelos agentes |
Corrija os problemas
Cada verificação que emite um aviso ou falha vem acompanhada de uma explicação em linguagem simples e de uma correção descrita em termos do seu MDX e docs.json. Dois tipos de descobertas podem aparecer:
- Itens que você corrige no conteúdo. Por exemplo, uma página cujo conteúdo real começa muito abaixo, uma página grande demais que deveria ser dividida ou conteúdo renderizado por um componente interativo que não aparece no Markdown da página. O texto da correção informa a próxima etapa e a quais páginas ela se aplica.
- Itens que o Jamdesk resolve por você.
llms.txt, exportação para Markdown, códigos de status e cache são todos gerados automaticamente. Se um deles falhar, isso geralmente significa um problema temporário no build. Execute a pontuação novamente após o próximo build e entre em contato com o suporte se o problema persistir.
Copie o prompt de correção
Cada verificação corrigível tem um botão Copy prompt to fix. Ele copia um prompt pronto para colar que identifica a verificação, a descoberta e como resolvê-la no seu MDX ou docs.json. Cole-o em um agente de programação de IA (Claude Code, o plugin Claude do Jamdesk, Cursor ou Codex) e deixe que ele faça a edição. Em seguida, faça push para executar um novo build e recalcular a pontuação.
Receba um e-mail quando sua pontuação mudar
Sua equipe não precisa monitorar o dashboard. O Jamdesk envia um e-mail aos membros do projeto com a nova pontuação e o problema mais importante a corrigir sempre que um build gerar sua primeira pontuação, alterar sua pontuação em 3 ou mais pontos ou restaurá-la para o valor perfeito de 100.
- Ative por projeto. O controle Email team when score changes fica no topo da página do AI Score. Ele vem ativado por padrão.
- Pequenas oscilações não geram avisos. Uma mudança de um ou dois pontos não envia um e-mail por si só, mas também não é esquecida: o Jamdesk compara cada nova pontuação com a última sobre a qual enviou um e-mail, então uma variação gradual se acumula e você é avisado quando a mudança total chega a 3 pontos.
Execuções manuais e pontuações acionadas por builds podem enviar e-mails; verificações retroativas e verificações pela ferramenta pública nunca enviam.
Solução de problemas
Uma verificação pode retornar vazia se seu site estiver momentaneamente inacessível, retornar um erro ou bloquear o verificador. O Jamdesk não salva esses resultados, então uma instabilidade temporária não fixa uma pontuação incorreta nem prejudica sua linha de tendência. Sua última pontuação válida continua sendo exibida; clique em Run score now para tentar novamente.
Agentes de IA não conseguem ler páginas protegidas por senha, então a pontuação reflete isso. Se restringir o acesso for intencional (para documentação interna ou em pré-lançamento), uma pontuação baixa é esperada e aceitável.
Um projeto noindex não tem sitemap para o Jamdesk verificar, então o AI Score é ignorado em vez de ser executado — não há nada que possa ser medido de forma confiável. Isso não afeta os agentes de IA: eles ainda podem ler sua documentação por meio de llms.txt, que continua publicado independentemente de noindex. Se quiser obter uma pontuação novamente, remova noindex de seo.metatags.robots em docs.json.
Algumas verificações abrangem comportamentos da plataforma gerenciados pelo Jamdesk (llms.txt, exportação para Markdown, códigos de status e cache). Elas passam por construção, portanto uma falha quase sempre significa um problema temporário no build. Execute a pontuação novamente após o próximo build e entre em contato com o suporte se o problema persistir.