AI Score
Jamdesk evalúa tus docs para agentes de IA según el estándar AFDocs en cada build. Consulta tu nota, corrige problemas y sigue su evolución.
Los asistentes de IA responden cada vez más preguntas sobre tu producto directamente desde tu documentación, pero solo cuando realmente pueden leerla. AI Score mide justamente eso. Después de cada build, Jamdesk analiza 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, y un desglose por problema sobre el que puedes actuar.
Las capturas de pantalla muestran la interfaz en inglés.
Pruébalo primero en cualquier sitio. La herramienta gratuita AI Score califica cualquier URL de documentación según el mismo estándar, y la extensión de Chrome AI Score califica los sitios mientras navegas. Dentro de Jamdesk, la puntuación se ejecuta automáticamente sobre tu propia documentación.
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 analiza tu documentación publicada y registra el resultado.
- Se ejecuta en cada build. Cada despliegue vuelve a puntuar tu sitio, así que una regresión aparece en cuanto se publica.
- Puntuación de 0 a 100 y una nota (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.
Consulta tu puntuación
La página AI Score tiene tres partes:
- Anillo de puntuación. Tu puntuación y nota actuales, además del cambio desde tu último build.
- Línea de tendencia. Tu puntuación a lo largo de los builds recientes, para detectar una caída de un vistazo.
- Tarjetas de categoría. Tus verificaciones agrupadas en siete áreas, cada una con su propia nota. Expande una para ver las verificaciones individuales y si pasaron, generaron una advertencia, o fallaron.
Un pie de página indica qué se analizó, cuántas páginas se muestrearon, y la versión de la especificación AFDocs.
Qué mide la puntuación
Cada categoría agrupa verificaciones relacionadas con la preparación para agentes:
| Categoría | Qué cubre |
|---|---|
| Detectabilidad del contenido | llms.txt y las señales que orientan a los agentes hacia tu contenido |
| Disponibilidad en Markdown | Una versión limpia en Markdown de cada página para que los agentes la lean |
| Tamaño de página y riesgo de truncamiento | Páginas lo bastante pequeñas para caber en la ventana de contexto de un agente |
| Estructura del contenido | Encabezados, orden, y contenido que comienza pronto en la página |
| Estabilidad de URL y redirecciones | URL estables y redirecciones correctas al mismo host |
| Observabilidad y salud del contenido | Códigos de estado, caché, y paridad entre lo que ven los lectores y los agentes |
| Autenticación y acceso | Si las páginas son accesibles o no para los agentes |
Corregir problemas
Cada verificación que genera una advertencia o falla viene con una explicación en lenguaje sencillo y una corrección redactada en términos de tu MDX y de 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 correcció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 todos automáticamente. Si alguno de estos falla, normalmente significa 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.
Copiar el prompt de corrección
Cada verificación corregible tiene un botón Copy prompt to fix. Copia un prompt listo para pegar que nombra la verificació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 el cambio, luego haz push para reconstruir y volver a puntuar.
Recibe un correo cuando cambie tu puntuación
Tu equipo no tiene que vigilar el dashboard. Jamdesk envía un correo a los miembros de tu proyecto con la nueva puntuación y el problema más importante a corregir cada vez que un build produce tu primera puntuación, mueve tu puntuación 3 puntos o más, o te devuelve a una puntuación perfecta de 100.
- Actí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.
- Las pequeñas variaciones se mantienen calladas. Un cambio de uno o dos puntos no envía un correo por sí solo, pero tampoco se olvida: Jamdesk compara cada nueva puntuación con la última sobre la que te envió un correo, así que la deriva gradual se acumula y te enteras en cuanto el cambio total llega a 3 puntos.
Las reejecuciones manuales y las puntuaciones generadas por un build pueden enviar correo; los análisis retroactivos y los de la herramienta pública nunca lo hacen.
Solución de problemas
Un análisis puede volver vacío si tu sitio estaba momentáneamente inaccesible, devolvió un error, o bloqueó el escáner. Jamdesk no guarda estos resultados, así que un fallo pasajero no fija una puntuación incorrecta ni daña tu línea de tendencia. Tu última puntuación buena se sigue mostrando; 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 (documentación interna o previa al lanzamiento), una puntuación baja aquí es esperable y está bien.
Un proyecto en noindex no tiene sitemap para que Jamdesk analice, así que AI Score se omite en lugar de ejecutarse — no hay nada que medir de forma fiable. Esto no afecta a los agentes de IA: pueden seguir leyendo tu documentación a través de llms.txt, que se mantiene publicado sin importar el noindex. Si quieres recuperar una puntuación, quita noindex de seo.metatags.robots en docs.json.
Algunas verificaciones 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.