Puntuación de la navegación con agentes de Lighthouse

La categoría de navegación con agentes evalúa qué tan bien está construido tu sitio para la interacción con máquinas a través de un conjunto de auditorías deterministas.

Cómo se califica la categoría

A diferencia de otras categorías de Lighthouse, la categoría de navegación con agentes no tiene una puntuación promedio ponderada de 0 a 100. Debido a que los estándares para la Web con agentes aún están surgiendo, el objetivo actual es recopilar datos y proporcionar indicadores prácticos en lugar de una clasificación definitiva.

En lugar de una puntuación, el informe muestra lo siguiente:

  • Una puntuación fraccionaria: Es una proporción que muestra cuántas verificaciones de preparación para agentes pasa tu sitio.
  • Estado de aprobado o reprobado: Las auditorías específicas pueden emitir errores o advertencias si no se cumplen los requisitos técnicos (como la validez del esquema de WebMCP).
  • Recuentos informativos: El encabezado de la categoría puede incluir una proporción de aprobados para ayudarte a observar el progreso general de un vistazo.

Por qué fluctúan los resultados

Si bien las auditorías son deterministas, tus resultados pueden fluctuar debido a los cambios en la forma en que tu sitio registra sus herramientas o responde a las solicitudes de agentes. Entre las causas comunes, se incluyen las siguientes:

  • Registro de herramientas dinámicas: Si tu sitio registra herramientas de WebMCP con JavaScript (API imperativa), el momento de estos registros puede afectar si se capturan durante la instantánea de Lighthouse.
  • Variabilidad en la construcción del árbol de accesibilidad: Los cambios significativos en el tamaño del DOM o la complejidad pueden afectar la estructura del árbol de accesibilidad, que es una métrica fundamental para la navegación con agentes.
  • Cambio de diseño acumulado (CLS): Los cambios de diseño causados por anuncios, imágenes sin dimensiones o contenido insertado pueden mover elementos entre el momento en que un agente los identifica y el momento en que intenta una interacción.

Cómo se determinan las auditorías

Lighthouse usa un conjunto de indicadores deterministas para evaluar tu página. Esto garantiza que las auditorías sean reproducibles y adecuadas para la integración en canalizaciones de CI/CD.

Integración de WebMCP

Lighthouse llama al dominio WebMCP del protocolo de Herramientas para desarrolladores de Chrome (CDP) para supervisar los eventos de registro de herramientas. Verifica las herramientas declarativas (definidas en HTML) y las herramientas imperativas (definidas en JS).

Accesibilidad centrada en el agente

Los agentes dependen del árbol de accesibilidad como su modelo de datos principal. Lighthouse filtra un subconjunto específico de auditorías de accesibilidad que son fundamentales para la interacción con máquinas, como las siguientes:

  • Nombres y etiquetas: Garantiza que cada elemento interactivo tenga un nombre programático
  • Integridad del árbol: Verifica que los roles y las relaciones entre elementos superiores y secundarios sean válidos.
  • Visibilidad: Confirma que el contenido no esté oculto en el árbol de accesibilidad mientras es interactivo.

Estabilidad y capacidad de descubrimiento

  • Cumulative Layout Shift (CLS): Mide la estabilidad visual, que es fundamental para los agentes que dependen del posicionamiento de los elementos.
  • llms.txt: Busca la presencia de un resumen legible por máquina en la raíz del dominio.

¿Qué pueden hacer los desarrolladores para mejorar?

Para mejorar la preparación de tu sitio para agentes, haz lo siguiente:

  • Adopta WebMCP: Usa la API de WebMCP para exponer explícitamente la lógica y los formularios de tu sitio a los agentes de IA.
  • Asegúrate de que el árbol de accesibilidad sea sólido: Prioriza el código HTML semántico y el etiquetado ARIA adecuado, ya que son la "vista de máquina" de tu página.
  • Optimiza la estabilidad: Reduce los cambios de diseño para garantizar que los agentes puedan interactuar de manera confiable con tu IU sin que los elementos se muevan de forma inesperada.

Comentarios

Si encuentras errores o tienes sugerencias para cambiar la auditoría de navegación con agentes, haz lo siguiente: