Todo lo que Necesitas Saber Sobre la Navegación Agéntica

Navegación Agéntica es una nueva categoría (que ya debes haber notado) que se está usando en el Pagespeed Insights de Google y - obviamente - también en la biblioteca Lighthouse. Esto es un antes y un después para ese mecanismo de análisis, porque antes el foco estaba exclusivamente en la experiencia del usuario humano, y ahora hay un (por ahora) pequeño espacio para medir qué tan "legible" es tu sitio para agentes de inteligencia artificial.
Caso real: Un cliente me llamó por la mañana y me contó que estaba sorprendido, porque fue a hacer un presupuesto de una reforma estructural en la casa de una persona, y en la entrevista le preguntaron si había tenido alguna recomendación. La respuesta fue sorprendente y graciosa: Claude.
Sí, así, "Claude". Como si fuera un amigo en común. Esto muestra que estamos en un camino sin retorno: o te actualizas, o puedes perder negocios importantes.
¿Qué tiene que ver esto con la Navegación Agéntica? Ni idea, puede que por eso el cliente de mi cliente haya agendado el presupuesto, puede que no. Pero que es un hecho muy gracioso, lo es.
Ok, ¡de vuelta al tema! Esta nueva categoría de análisis tiene cuatro pilares:
WebMCP
¿El sitio expone herramientas estructuradas para agentes?
Aquí tenemos el core de todo este cambio: WebMCP es el estándar propuesto por Google, que va a permitir a los desarrolladores exponer las funcionalidades del sitio directamente a la IA. Tu sitio va a llegar a la IA y decirle "¡eh, colega! No hace falta hacer scraping, el mapa del tesoro está aquí...".
Según la documentación oficial, "El WebMCP puede ayudar a reducir la distancia entre las aplicaciones web y los agentes, mejorando la eficiencia, la confiabilidad y la finalización de tareas, al proporcionar reglas para la interacción. En lugar de que un agente analice el elemento, como un botón o un campo, para entender su finalidad, el sitio declara el propósito del elemento, para que se use correctamente.".
El sitio va a declarar explícitamente sus capacidades a los agentes, vía json schema o html declarativo (de la misma forma que lo hace Schema.org). Esto le va a facilitar al agente efectuar tareas sin volverse loco (aka. alucinar) y errar todo. Como en el ejemplo simple y rudimentario de abajo:
// Registro de uma ferramenta via JSdocument.modelContext.registerTool({ name: 'buscar_voos', description: 'Busca voos disponíveis entre duas cidades em datas específicas.', inputSchema: { type: 'object', properties: { origem: { type: 'string', description: 'Código IATA da cidade de origem (ex: GRU)' }, destino: { type: 'string', description: 'Código IATA do destino (ex: JFK)' }, data: { type: 'string', format: 'date' }, classe: { type: 'string', enum: ['economica', 'executiva', 'primeira'] } }, required: ['origem', 'destino', 'data'] }, execute: async ({ origem, destino, data, classe }) => { // Lógica interna do site para chamar sua API de backend const resultados = await minhaApiDeVoos(origem, destino, data, classe); return JSON.stringify(resultados); // Retorno estruturado para a IA }});Cosas interesantes en ese js:
inputSchemautiliza el estándarJSON Schemapara validar la entrada de la IA incluso antes de que la función se ejecute, reduciendo errores de procesamiento.executees una función asíncrona, el retorno se envía de vuelta al "pensamiento" de la IA.
En ese ciclo de vida, puedes usar un AbortController para desactivar la herramienta dinámicamente (cuando el usuario cierra sesión, por ejemplo).
Y mira, se puede hacer directo en el html, como en el ejemplo de abajo:
<form toolname="solicitarSuporte" tooldescription="Envia um ticket de suporte técnico para a equipe." toolautosubmit="true" action="/api/suporte"> <label for="tipo">Tipo de Problema:</label> <select name="tipo" toolparamdescription="Categoria do problema técnico."> <option value="login">Problema de Acesso</option> <option value="pagamento">Erro de Cobrança</option> </select>
<label for="msg">Descrição:</label> <textarea name="msg"></textarea>
<button type="submit">Enviar Ticket</button></form>Cosas interesantes en ese formulario:
toolnameytooldescriptionidentifican la herramienta para el modelo de IA.toolparamdescriptionayuda a la IA a entender qué espera cada campo del formulario, aumentando la precisión del llenadotoolautosubmit, si se define como true, avisa a la IA que puede llenar y enviar el formulario sin intervención humana (útil para tareas totalmente autónomas).
También se puede reaccionar cuando una IA interactúa, usando el evento toolactivated:
window.addEventListener('toolactivated', (event) => { console.log(`A ferramenta ${event.toolName} foi ativada por um Agente de IA.`);});En el sitio oficial puedes conocerlo de forma mucho más profunda, leer todos los parámetros, además de conocer los conceptos de seguridad para evitar que la IA ejecute acciones maliciosas.
¡Aviso importante!
WebMCP todavía es experimental, no corre "gratis" en PageSpeed Insights. El soporte de WebMCP es experimental, exige Chrome 150 o superior, y los audits de WebMCP solo funcionan si registras tu origen en el origin trial. Para activarlo, necesitas un token. El flujo es el mismo de cualquier origin trial de Chrome: tomas el token generado para tu origen y lo pegas en una meta tag en el <head> de cada página:
<meta http-equiv="origin-trial" content="{SEU TOKEN AQUI}">Para jugar localmente sin token, se puede activar el flag en chrome://flags/#enable-webmcp-testing. ¿Vale la pena todo este trabajo? Sin duda, no solo es prometedor: es el camino natural, y la largada ya se dio. Mejor estar listo antes.
El archivo llms.txt
¿Existe una guía de contexto para la IA en la raíz del dominio?
Ya no basta con tener un robots.txt, ahora necesitas un llms.txt, que va a servir de mapa para que la IA entienda tu sitio sin perderse en el camino. Observa este ejemplo oficial:
# Title
> Optional description goes here
Optional details go here
## Section name
- [Link title](https://link_url): Optional link details
## Optional
- [Link title](https://link_url)La documentación lo deja claro: "While sitemaps list all pages for search engines, llms.txt offers a curated overview for LLMs" y "robots.txt and llms.txt have different purposes—robots.txt is generally used to let automated tools know what access to a site is considered acceptable ... On the other hand, llms.txt information will often be used on demand when a user explicitly requests information about a topic, such as when including a coding library’s documentation in a project, or when asking a chat bot with search functionality for information".
Tu llms.txt va a ser un archivo de contexto, guía de uso y una curaduría del contenido de tu sitio. Hay un ejemplo completo de FastHTML, que puedes leer íntegro.
Lo más irónico es que el proyecto usa un .txt que escribe .md. Contraintuitivo, ¿verdad? Claro, pero hay un motivo: la infra esparcida por la web es absurdamente legacy, y usar .txt es una forma de traer compatibilidad universal y facilidad de configuración en esos servidores de la época de Dante.
Árbol de accesibilidad
¿La estructura de accesibilidad permite la navegación por máquinas?
¡Los agentes también necesitan accesibilidad! La buena noticia es que si ya sigues las buenas prácticas del árbol de accesibilidad, tu sitio ya debería tenerlo 100% ajustado: etiquetas semánticas en el lugar correcto, organización de títulos y subtítulos, formularios con labels declaradas, etc.
Voy a ser sincero contigo: este pilar y el siguiente no tienen mucho que cubrir. Son dos campos que ya existían y ya estaban documentados mucho antes de que apareciera la Navegación Agéntica, no son ninguna novedad. Los menciono porque forman parte de la categoría, pero no voy a profundizar en ellos - sería reinventar la rueda.
Cumulative Layout Shift
¿El layout es lo bastante estable para que un agente haga clic con precisión?
Como avisé arriba, ¡tampoco cambia nada! Si tu sitio tiene un buen CLS para un humano, ¡también va a estar bien para el agente! Un trabajo menos.
Conclusión
Mirando los cuatro pilares juntos, se nota algo importante: dos de ellos ya los tienes gratis si ya haces frontend bien hecho. Árbol de accesibilidad y CLS son tarea vieja: si cuidas la experiencia del usuario humano, el agente la hereda sin que muevas un dedo.
El llms.txt es trabajo de una tarde, como máximo (estoy preparando un generador para tener menos trabajo con esto 🫣). El verdadero cambio de juego es WebMCP, y es en él donde vale la pena invertir energía ahora.
La web está empezando (o forzando, lo que no importa si el resultado va a ser el mismo) a tratar a los agentes como ciudadanos de primera clase, no como "scrapers que toleramos". En algunos años, tener un WebMCP bien diseñado va a ser tan básico como tener un robots.txt hoy - y quien llegue primero va a cosechar los frutos de agentes que eligen tu sitio porque es el más fácil de usar.