Los agentes ya leen el 80 % del tráfico a la documentación de 20 000 empresas; en enero era al revés

El titular «Los agentes de IA leen el 80 % de internet» pide a gritos entrar en la categoría de clickbait. Es impreciso, pero la historia en sí es más interesante de lo que sugiere el titular. Trata de que la documentación para desarrolladores ha cambiado de lector principal.

Qué se contó realmente

La cifra no se refiere a toda la web. Se trata del tráfico a sitios con documentación oficial para desarrolladores que pertenecen a unas 20 000 empresas. Entre ellas están Anthropic, Microsoft y Amazon. Actualmente cerca del 80 % de ese tráfico procede de agentes. En enero la proporción era la contraria: predominaban las personas.

En diez meses, la mayoría de los lectores de documentación pasó de ser humana a ser un programa. Esa dinámica es lo que conviene recordar, no la cifra redonda del titular. Tenga en cuenta que reproducimos las cifras a partir de una publicación en Substack y de un análisis de Andrey Sebrant. Cómo separan exactamente los autores a los agentes de las personas no se desprende del resumen. Quien vaya a citar estos datos debería abrir la fuente original y revisar la metodología.

Por qué precisamente la documentación

La documentación es un contenido casi ideal para un agente. Tiene un objetivo claro: encontrar cómo llamar a un método de la API, qué parámetros acepta una función, qué significa un error concreto. Antes, el desarrollador con esa pregunta abría la página y leía. Ahora encarga la tarea a un asistente de programación, que va por sí mismo al sitio, recoge los fragmentos necesarios y escribe el código.

La persona, entretanto, lee la documentación con menos frecuencia y de forma indirecta, a través de la respuesta del agente. Es nuestra interpretación, pero explica bien por qué los contadores de visitas han cambiado tan bruscamente. Una sola petición del desarrollador puede generar varias consultas del agente a distintas páginas, de modo que el cambio en el tráfico parece más dramático que el cambio en el número real de usuarios.

Qué hacer al respecto

Si usted es responsable de la documentación o de un producto con API, de esto se desprenden varios pasos prácticos.

• Separe la analítica. Vea qué proporción de las consultas a su documentación procede de agentes. Si cuenta todas las visitas como humanas, sus métricas le inducen a error.
• Escriba para la máquina como primer lector. Encabezados claros, ejemplos de código completos que se puedan copiar y ejecutar, versiones de API explícitas, descripciones comprensibles de los errores. El agente no adivina por el contexto: toma lo que está escrito.
• No esconda lo esencial. La información clave en pestañas, imágenes o en una interfaz que solo se renderiza con scripts corre el riesgo de no llegar nunca al agente.
• Considere formatos legibles por máquinas. Por ejemplo, versiones de las páginas en marcado simple o el archivo llms.txt propuesto por la comunidad, con una lista de materiales importantes. No es un estándar, sino un acuerdo, y no todos lo respaldan, pero el coste de implantarlo es pequeño.
• Mida el éxito de otra manera. Las visitas a páginas muestran mal si la documentación ayudó. Es más útil ver si el agente resolvió la tarea con su API al primer intento.

Las personas siguen necesitando documentación, pero de otro tipo: conceptos, visiones generales de arquitectura, aprendizaje desde cero. La capa de referencia se convierte cada vez más en una interfaz para agentes.

Limitaciones

En primer lugar, es una muestra de sitios de documentación, no de todo internet. Los blogs, las noticias y los foros se leen de otra manera, y el 80 % no puede extrapolarse a ellos. En segundo lugar, es una proporción de visitas, no de lectores. Un agente puede hacer decenas de peticiones donde una persona abriría una sola página. En tercer lugar, como ya se ha dicho, los detalles de la metodología son desconocidos según el resumen.

En resumen: incluso con reservas, la tendencia es evidente. Si su producto lo usan desarrolladores, una parte significativa del primer contacto con él hoy no la hace una persona. Conviene revisar la documentación igual que revisa una interfaz: ¿podrá un nuevo lector, esta vez programático, entenderla?