Una página de documentación puede parecer completa en un navegador mientras que su HTML original carece del texto que el lector necesita. Un agente de IA que busque esa página a través de una solicitud HTTP simple sin ejecutar JavaScript perderá ese texto. Agentic Engine Optimization (AEO) ayuda a identificar estas barreras verificando el acceso al contenido, la estructura y las formas de descubrir material relacionado.
La auditoría AEO de Milten examina una página seleccionada y archivos públicos del sitio. El informe muestra las comprobaciones superadas, los problemas detectados y la información que falta.
¿Qué es Agentic Engine Optimization?
Agentic Engine Optimization significa preparar un sitio web para que los agentes de IA lo lean y lo utilicen. Para la documentación, eso significa que un agente puede recuperar la descripción de una operación, encontrar un ejemplo y seguir un enlace a una referencia relacionada.
La auditoría es útil para guías de integración, referencias de API y páginas con ejemplos técnicos. Complementa el SEO al examinar cómo un cliente de software puede acceder al contenido publicado. El informe no mide las clasificaciones de búsqueda ni la probabilidad de ser citado en las respuestas de IA.
¿Qué comprueba una auditoría del sitio web AEO?
La auditoría AEO examina ocho aspectos, agrupados a continuación. Consulte en cada informe qué comprobaciones se aplican y cómo se calcula la puntuación:
| Grupo | Qué se examina |
|---|---|
| Descubrimiento de contenido | Reglas de robots.txt e índice de llms.txt |
| Estructura de la página | Encabezados, marcado semántico, ejemplos, Markdown e indicios de dependencia de JavaScript |
| Tamaño del contexto | Número de tokens y metadatos de la página |
| Reglas de interacción | Descripciones de acceso y restricciones en agent-permissions.json |
| Transferencia de texto al agente | Controles para copiar contenido y enlaces al texto sin formato |
Cada comprobación incluye un resultado y observaciones; su contribución a la puntuación depende de las reglas del informe. Por ejemplo, se examinan tanto la existencia de llms.txt como sus enlaces, descripciones y secciones. El archivo por sí solo no hace que la documentación sea fácil de usar.
Los recuentos de tokens ayudan a estimar cuánto texto necesitaría procesar un modelo. No calculan los costos de las solicitudes, ya que los modelos utilizan diferentes tokenizadores y precios.
La auditoría inspecciona la respuesta original del servidor sin ejecutar JavaScript. Busca signos estructurales de problemas, pero no ejecuta un agente de IA en una tarea del usuario. Comprobar si un agente en particular puede utilizar la documentación requiere un intento por separado de esa tarea.
Cómo ARD ayuda a los agentes a descubrir los recursos del sitio
Agentic Resource Discovery (ARD) describe el descubrimiento de recursos disponibles para un cliente de IA, como una API, un servidor MCP o un flujo de trabajo. El cliente puede usar una descripción para encontrar un recurso adecuado y luego acceder a él a través de la propia interfaz de ese recurso.
La sección ARD comprueba cómo se publican estas descripciones. Busca /.well-known/ard.json, enlaces en HTML y cabeceras HTTP, directivas Agentmap en robots.txt y ARD JSON-LD integrado. También reconoce el formato anterior ai-catalog.json para identificar materiales que podrían necesitar una migración.
El informe enumera los recursos descubiertos, las direcciones de sus descripciones, errores de campo y cualquier límite que impidió una verificación completa. Un catálogo faltante, una recuperación fallida y un documento no válido aparecen como resultados diferentes. Esta verificación de publicación no confirma que las API o los servidores MCP enumerados funcionen.
Los resultados de ARD aparecen por separado y no afectan la puntuación AEO. Esta sección anteriormente pertenecía al escáner de velocidad; Se ejecutan nuevas comprobaciones en AEO, mientras que los informes de velocidad guardados permanecen accesibles.
Cómo mejorar su sitio después de una auditoría AEO
Comience por una página que el agente necesite leer para una tarea concreta. En una guía de integración, por ejemplo, compruebe que estén disponibles la descripción de la operación, sus parámetros y una solicitud de ejemplo.
- Compruebe el acceso al texto principal. Si el informe señala una dependencia de JavaScript, compare el HTML original con el contenido del navegador. Si falta el texto necesario, considere el renderizado en el servidor o una versión Markdown accesible.
- Revise la estructura. Use niveles de encabezado consecutivos, coloque los ejemplos junto a las operaciones que explican y elimine explicaciones repetidas. Las tablas ayudan a comparar parámetros u opciones.
- Revise la extensión. Divida las referencias largas en temas enlazados y conserve las condiciones y los ejemplos necesarios para comprender cada página.
- Compruebe cómo se descubren los materiales complementarios. Si usa
llms.txt, actualice sus enlaces y descripciones breves. Si publica recursos mediante ARD, corrija las direcciones de catálogo inaccesibles y las entradas no válidas. - Repita la auditoría de la misma URL tras publicar los cambios. Compare las observaciones y asigne al agente la tarea original, como localizar los parámetros de una operación API y preparar una solicitud.
Cómo leer la puntuación AEO
Interprete el porcentaje junto con las comprobaciones aplicables, sus puntuaciones máximas y los resultados incompletos. Esta auditoría no ejecuta comprobaciones de AGENTS.md ni de SKILL.md.
Las reglas y los pesos pueden cambiar. Compare informes con las mismas reglas y use el máximo indicado en el informe, en lugar de una suma fija de un ejemplo antiguo. El porcentaje por sí solo no explica qué problema queda.
Revise las observaciones y los errores de descarga. Las reglas utilizan heurísticas y pueden pasar por alto marcado, expresiones o idiomas poco habituales. Una puntuación alta no garantiza posiciones en los buscadores, citas en respuestas de IA ni compatibilidad con todos los formatos por parte de un agente concreto.
Preguntas frecuentes sobre la optimización para agentes de IA
¿Una auditoría AEO controla todo el sitio web?
Una ejecución examina la URL seleccionada y los archivos del sitio público recuperados. No rastrea todas las páginas ni lee un repositorio privado. Realice una verificación por separado para otra guía o página de referencia.
¿Debo permitir todos los rastreadores en robots.txt?
No. Bloquear un rastreador concreto puede ser una política deliberada del sitio. Contraste la observación con su política de acceso y cambie las reglas solo para los clientes que quiera permitir.
¿Es suficiente agregar llms.txt?
No. Un índice de enlaces no soluciona textos inaccesibles, errores de descarga ni ejemplos incompletos. Haga accesible el contenido necesario y decida después si llms.txt encaja en sus flujos de trabajo con agentes.
Ejecute una auditoría AEO del sitio para una guía o página de API. Use las observaciones para elegir los cambios y compruebe el resultado con la misma tarea.