---
title: AI Score
sidebarTitle: AI Score
description: Jamdesk puntúa qué tan bien los agentes de IA pueden leer tus documentos contra el estándar AFDocs en cada build — ve tu nota, corrige problemas y haz seguimiento.
---
> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.
Los asistentes de IA responden cada vez más preguntas sobre tu producto directamente desde tu documentación, pero solo cuando pueden leerla. AI Score mide eso. Tras cada build, Jamdesk escanea tu sitio publicado contra el estándar abierto [AFDocs](https://afdocs.dev) de disponibilidad para agentes y te da una puntuación de 0–100, una nota en letra y un desglose por problema sobre el que puedes actuar. Esta página es para cualquier persona que mantenga un sitio en Jamdesk y quiera que funcione igual de bien para agentes de IA que para lectores humanos.
Las capturas de pantalla muestran la interfaz en inglés.
**Pruébalo en cualquier sitio primero.** La herramienta gratuita [AI Score](https://www.jamdesk.com/ai-score) califica cualquier URL de documentación contra el mismo estándar, y la [extensión de Chrome AI Score](https://chromewebstore.google.com/detail/jamdesk-ai-score/mhihkkgpcbmapmojnakhjfhjmiagkhlj) califica sitios mientras navegas. Dentro de Jamdesk, la puntuación se ejecuta automáticamente en tus propios documentos.
## 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 documentos publicados y registra el resultado.
- **Se ejecuta en cada build.** Cada despliegue vuelve a puntuar tu sitio, de modo que una regresión aparece en el momento en que se publica.
- **Puntuación de 0–100 y una nota en letra** (A+ hasta F), medida contra el estándar abierto AFDocs. Es el mismo motor detrás de la herramienta pública gratuita.
- **Vuelve a ejecutar en cualquier momento.** Abre la página **AI Score** de tu proyecto y haz clic en **Run score now** para puntuar el sitio en vivo de nuevo sin esperar un build.
Encuéntralo en el dashboard bajo tu proyecto → **AI Score**.
## Lee tu puntuación
La página AI Score tiene tres partes:
- **Gráfico 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 en los builds recientes, de modo que una caída se nota 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, advirtieron 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 verificaciones de disponibilidad para agentes relacionadas:
| Categoría | Qué cubre |
|---|---|
| Descubribilidad de contenido | `llms.txt` y las señales que apuntan a los agentes hacia tu contenido |
| Disponibilidad de Markdown | Una versión Markdown limpia de cada página para que los agentes lean |
| Tamaño de página y riesgo de truncamiento | Páginas suficientemente 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 | URLs estables y redirecciones correctas dentro del mismo host |
| Observabilidad y salud del contenido | Códigos de estado, caché y paridad entre lo que ven lectores y agentes |
| Autenticación y acceso | Si los agentes pueden acceder a las páginas en absoluto |
## Corregir problemas
Cada verificación que advierte o falla viene con una explicación en lenguaje sencillo y una corrección escrita para documentos de Jamdesk, nunca jerga de línea de comandos. Aparecen dos tipos de hallazgos:
- **Cosas que corriges en tu contenido.** Por ejemplo, una página cuyo contenido real comienza demasiado abajo, una página sobredimensionada que debería dividirse, o contenido renderizado por un componente interactivo que no aparece en el Markdown de la página. El texto de corrección nombra el siguiente paso y a qué páginas aplica.
- **Cosas que Jamdesk maneja por ti.** `llms.txt`, la exportación Markdown, los códigos de estado y el caché se generan automáticamente. Si alguno de estos falla, generalmente significa un problema de build transitorio, así que vuelve a ejecutar la puntuación después de tu próximo build y contacta a 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 de IA ([Claude Code](/es/ai/claude-code), el [plugin de Jamdesk para Claude](/es/claude-code-plugin), [Cursor](/es/ai/cursor), o [Codex](/es/ai/codex)) y deja que haga la edición, luego haz push para reconstruir y volver a puntuar.
## Recibir un correo cuando cambie tu puntuación
Tu equipo no tiene que estar pendiente del dashboard. Cuando un build cambia tu puntuación o nota (o produce tu primera puntuación), Jamdesk envía un correo a los miembros de tu proyecto con la nueva puntuación y el único problema más importante a corregir.
- **Actívalo por proyecto.** El interruptor **Email team when score changes** se encuentra en la parte superior de la página AI Score. Está activado por defecto.
- **Solo envía cambios significativos.** Un build que deja tu puntuación sin cambios no activa un correo, así que el correo permanece silencioso a menos que algo haya cambiado realmente.
El correo informa un cambio, no cada build. Las ejecuciones manuales y las puntuaciones activadas por build pueden enviar; las de relleno y los escaneos 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ó el escáner. Jamdesk **no** guarda estos resultados, así que un problema transitorio 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 intentarlo de nuevo.
Los agentes de IA no pueden leer páginas detrás de una contraseña, así que la puntuación refleja eso. Si restringir el acceso es intencional (documentos internos o previos al lanzamiento), una puntuación baja aquí es esperada y está bien. Es una compensación, no un defecto.
Algunas verificaciones cubren el comportamiento de la plataforma que Jamdesk gestiona (`llms.txt`, exportación Markdown, códigos de estado, caché). Estas pasan por construcción, así que un fallo casi siempre significa un problema de build transitorio. Vuelve a ejecutar la puntuación después de tu próximo build y contacta a soporte si persiste.
## ¿Qué sigue?
El índice que las herramientas de IA leen para entender todo tu sitio
El Markdown sin procesar que los agentes obtienen para cualquier página
Mantén la documentación actualizada conforme tu producto cambia
Califica cualquier sitio de documentación de forma gratuita