Corregir con IA
Revisa y aplica las correcciones sugeridas por IA para enlaces rotos y descripciones faltantes desde el dashboard de Jamdesk, con commit en GitHub.
Cuando un build termina con enlaces rotos o páginas sin descripción, Jamdesk puede reparar muchos de ellos por ti. El botón Fix with AI lee esos avisos de build, propone una edición concreta para cada uno y hace commit de las correcciones que apruebes en tu repositorio de GitHub conectado, lo que inicia un nuevo build. Esta página es para cualquiera que mantenga un sitio Jamdesk y quiera resolver avisos de build sin editar MDX a mano.
Las capturas de pantalla muestran la interfaz en inglés.
Para una versión local basada en terminal de la misma idea, consulta el comando de la CLI jamdesk fix. El flujo del dashboard de abajo hace commit de los cambios por ti; la CLI escribe en tu copia de trabajo y te deja el commit a ti.
Qué corrige
Fix with AI funciona con tres tipos de avisos de build:
- Enlaces internos rotos. Un fragmento de enlace que apunta a un encabezado que ya no existe en la página de destino, como un error tipográfico (
#instalation→#installation), o una página traducida cuyo encabezado fue renombrado. - Descripciones de página faltantes. Una página sin
descriptionen su frontmatter. Jamdesk redacta un breve resumen a partir del contenido de la página para que lo revises. - Títulos de página faltantes. Una página sin título recibe uno sugerido, extraído del contenido de la página, para que lo revises.
Solo propone un cambio cuando puede resolver el destino con confianza. Todo lo ambiguo se deja sin modificar y se lista por separado para que puedas corregirlo manualmente.
Fix with AI hace hasta 1,000 solicitudes de IA por proyecto en un periodo de 24 horas. Los resultados de las páginas que no han cambiado se reutilizan y no cuentan para el límite.
El número de elementos corregibles no es el mismo que el número de avisos. Un build puede mostrar cinco avisos mientras Fix with AI ofrece corregir tres de ellos, porque los otros dos no tienen una corrección inequívoca. El banner siempre refleja lo que realmente se puede corregir.
Requisitos previos
- Un repositorio de GitHub conectado para el proyecto.
- Acceso de escritura para la GitHub App de Jamdesk, para que pueda hacer commit de las correcciones. Si falta el acceso, el modal muestra un enlace Grant access que te lleva a GitHub para agregarlo.
- Un build completado que tenga avisos de enlace roto o de descripción faltante.
Encontrar el banner
Abre tu proyecto y desplázate hasta Build History en la página Project Home. Cuando tu build más reciente tiene problemas corregibles, aparece un banner encima de la lista de builds con un contador y un botón Fix with AI.
El banner solo aparece en tu build completado más reciente. Los builds anteriores del historial no lo muestran, porque las correcciones siempre se aplican al estado actual de tu documentación.
Revisar y aplicar las correcciones
Haz clic en Fix with AI. El modal se abre y el agente de IA revisa tu documentación para preparar un plan de corrección. Esto tarda unos segundos.
Las correcciones se agrupan por tipo. Broken links muestra cada ancla reescrita, Missing descriptions muestra el resumen sugerido para cada página y Missing titles muestra el título propuesto. Desmarca la casilla de lo que prefieras omitir esta vez, o usa el botón de ignorar para silenciar una recomendación de forma definitiva. Los problemas sin una corrección clara aparecen bajo Can't be fixed automatically y se dejan para que los resuelvas manualmente.
Haz clic en Apply fixes. Jamdesk hace commit de los cambios seleccionados en tu rama conectada con el mensaje docs: apply AI-suggested fixes (via Jamdesk) e inicia un nuevo build.
Observa el nuevo build en Build History. Cuando se publique, los avisos corregidos habrán desaparecido. Lo que quede es un aviso que Fix with AI no pudo resolver o un nuevo problema del contenido más reciente.
Aplicar escribe un commit real en tu repositorio, por lo que el cambio queda registrado en tu historial de Git y puedes revisarlo o revertirlo en GitHub como cualquier otro commit.
Cuando algunos problemas no se pueden corregir
Si un aviso no tiene una corrección clara, el modal lo lista bajo un encabezado independiente y lo deja como está. Motivos comunes:
- Un enlace roto cuya página o encabezado de destino no existe en ningún lugar, por lo que no hay nada hacia donde apuntarlo.
- Una entrada de navegación sin archivo fuente correspondiente.
- Una página para la que el agente no pudo generar una descripción automáticamente.
Estos casos necesitan una edición manual. Abre la página en el editor o en tu editor de código, corrige el enlace o agrega la descripción, y luego haz push para reconstruir.
Ignorar recomendaciones
Algunos avisos no vale la pena atenderlos: un enlace que rompiste a propósito, o una página provisional que no necesita descripción. Desmarcar una corrección solo la omite una vez. Ignorarla la elimina del contador hasta que indiques lo contrario.
Cada fila del modal, corregible o no, tiene un botón de ignorar. Haz clic en él y el elemento pasa a una sección Ignored colapsada en la parte inferior. Al cerrar el modal, el contador del banner en la página Project Home baja para coincidir, y los avisos correspondientes desaparecen de Build History, tanto en el build actual como en todos los siguientes. Ignore all hace lo mismo con todo lo que quede listado.
Cómo se comportan los elementos ignorados:
- Compartido y persistente. Los elementos ignorados se aplican a todo el proyecto, así que todos los miembros ven la misma lista, y se mantiene entre builds. Jamdesk relaciona cada aviso con su contenido en lugar de con su número de línea, así que editar otras partes de la página no hará reaparecer un elemento ignorado.
- Restaurar. Expande la sección Ignored y haz clic en Restore en cualquier elemento. Si ignoras todo en un build, el banner desaparece y un pequeño enlace "N ignored recommendations" debajo de Build History vuelve a abrir el modal.
- Los avisos modificados reaparecen. Si el problema subyacente cambia, por ejemplo si el enlace roto ahora apunta a otro lugar, deja de coincidir con la entrada ignorada y vuelve a aparecer como una recomendación nueva.
Fix with AI frente a la CLI
Ambas herramientas corrigen anclas de enlaces rotos. Se diferencian en dónde se ejecutan y cómo se aplica el cambio.
| Fix with AI (dashboard) | jamdesk fix (CLI) | |
|---|---|---|
| Ejecución | En el dashboard, sobre un build | En tu terminal, sobre archivos locales |
| Corrige | Enlaces rotos y descripciones faltantes | Anclas de enlaces rotos |
| Commit | Hace commit en tu rama por ti | Escribe archivos locales; tú haces commit |
| Activación | Un clic en el banner del build | jamdesk fix |
Usa el flujo del dashboard para una reparación rápida sin salir de Jamdesk. Usa la CLI cuando quieras tener primero los cambios en tu copia de trabajo, por ejemplo para agruparlos con otras ediciones.