AI Score
Jamdesk evalúa la legibilidad de tus docs para agentes de IA según el estándar abierto AFDocs en cada build. Consulta tu nota y corrige incidencias.
Los asistentes de IA responden cada vez más preguntas sobre tu producto directamente desde tu documentación, pero solo cuando pueden leerla de verdad. AI Score mide eso. Después de cada build, Jamdesk escanea tu sitio publicado según el estándar abierto de preparación para agentes AFDocs y te da una puntuación de 0 a 100, una nota con letra y un desglose por incidencia sobre el que puedes actuar.
Pruébalo primero en cualquier sitio. La herramienta AI Score gratuita califica cualquier URL de documentación según el mismo estándar, y la extensión de Chrome AI Score califica sitios mientras navegas. Dentro de Jamdesk, la puntuación se ejecuta automáticamente en tus propios docs.
Cómo funciona la puntuación
AI Score se ejecuta automáticamente, sin configuración. Después de cada build exitoso, Jamdesk espera a que la nueva versión esté en vivo, luego escanea tus docs publicados y registra el resultado.
- Se ejecuta en cada build. Cada deploy vuelve a puntuar tu sitio, así que una regresión aparece en el momento en que se publica.
- Puntuación de 0 a 100 y una nota con letra (de A+ a F), medida según el estándar abierto AFDocs. Es el mismo motor que hay detrás de la herramienta pública gratuita.
- Vuelve a ejecutarla cuando quieras. Abre la página AI Score de tu proyecto y haz clic en Run score now para volver a puntuar el sitio en vivo sin esperar a un build.
Encuéntrala en el dashboard, dentro de tu proyecto → AI Score.
Lee tu puntuación
Las capturas de pantalla muestran la interfaz en inglés.
La página AI Score tiene tres partes:
- Donut de puntuación. Tu puntuación y nota actuales, más el cambio desde tu último build.
- Línea de tendencia. Tu puntuación a lo largo de los últimos builds, para que una caída se note de un vistazo.
- Tarjetas de categoría. Tus comprobaciones agrupadas en siete áreas, cada una con su propia nota. Expande una para ver las comprobaciones individuales y si pasaron, generaron advertencia o fallaron.
Un pie de página indica qué se escaneó, cuántas páginas se muestrearon y la versión de la especificación AFDocs.
Qué mide la puntuación
Cada categoría agrupa comprobaciones de preparación para agentes relacionadas:
| Categoría | Qué cubre |
|---|---|
| Content Discoverability | llms.txt y las señales que orientan a los agentes hacia tu contenido |
| Markdown Availability | Una versión limpia en Markdown de cada página para que la lean los agentes |
| Page Size & Truncation Risk | Páginas lo bastante pequeñas para caber en la ventana de contexto de un agente |
| Content Structure | Encabezados, orden y contenido que empieza pronto en la página |
| URL Stability & Redirects | URLs estables y redirects correctos dentro del mismo host |
| Observability & Content Health | Códigos de estado, caché y paridad entre lo que ven los lectores y los agentes |
| Authentication & Access | Si los agentes pueden llegar a las páginas |
Corrige incidencias
Cada comprobación que genera advertencia o falla viene con una explicación en lenguaje sencillo y una solución redactada en términos de tu MDX y docs.json. Aparecen dos tipos de hallazgos:
- Cosas que corriges en tu contenido. Por ejemplo, una página cuyo contenido real empieza demasiado abajo, una página demasiado grande que debería dividirse, o contenido renderizado por un componente interactivo que no aparece en el Markdown de la página. El texto de la solución indica el siguiente paso y a qué páginas se aplica.
- Cosas que Jamdesk gestiona por ti.
llms.txt, la exportación a Markdown, los códigos de estado y la caché se generan automáticamente. Si alguna de estas falla alguna vez, suele deberse a un problema pasajero del build, así que vuelve a ejecutar la puntuación después de tu próximo build y contacta con soporte si persiste.
Copia el prompt de corrección
Cada comprobación corregible tiene un botón Copy prompt to fix. Copia un prompt listo para pegar que nombra la comprobación, el hallazgo y cómo resolverlo en tu MDX o docs.json. Pégalo en un agente de codificación con IA (Claude Code, el plugin de Claude para Jamdesk, Cursor o Codex) y deja que haga la edición, luego haz push para reconstruir y volver a puntuar.
Recibe un email cuando cambie tu puntuación
Tu equipo no tiene que vigilar el dashboard. Cuando un build cambia tu puntuación o nota (o produce tu primera puntuación), Jamdesk envía un email a los miembros del proyecto con la nueva puntuación y la incidencia más importante a corregir.
- Actívalo o desactívalo por proyecto. El interruptor Email team when score changes está en la parte superior de la página AI Score. Está activado de forma predeterminada.
- Solo se envían cambios significativos. Un build que deja tu puntuación sin cambios no dispara un email, así que la bandeja de entrada se mantiene tranquila a menos que algo se haya movido de verdad.
El email informa de un cambio, no de cada build. Tanto las reejecuciones manuales como las puntuaciones activadas por un build pueden enviarlo; los escaneos con retroactividad y los de la herramienta pública nunca lo hacen.
Solución de problemas
Un escaneo puede volver vacío si tu sitio estuvo momentáneamente inaccesible, devolvió un error o bloqueó al escáner. Jamdesk no guarda estos resultados, así que un fallo pasajero no fijará una puntuación incorrecta ni afectará tu línea de tendencia. Tu última puntuación válida sigue mostrándose; haz clic en Run score now para volver a intentarlo.
Los agentes de IA no pueden leer páginas detrás de una contraseña, así que la puntuación lo refleja. Si restringir el acceso es intencional (docs internos o previos al lanzamiento), una puntuación baja aquí es esperable y está bien.
Algunas comprobaciones cubren un comportamiento de la plataforma que gestiona Jamdesk (llms.txt, exportación a Markdown, códigos de estado, caché). Estas pasan por construcción, así que un fallo casi siempre significa un problema pasajero del build. Vuelve a ejecutar la puntuación después de tu próximo build y contacta con soporte si persiste.