Агенты уже читают 80% трафика на документацию 20 000 компаний — в январе было наоборот

Заголовок «ИИ-агенты читают 80% интернета» так и просится в категорию кликбейта. Он неточный, но сама история интереснее, чем кажется по заголовку. Она про то, что у документации для разработчиков сменился основной читатель.

Что на самом деле посчитали

Цифра относится не ко всему вебу. Речь о трафике на сайты с официальной документацией для разработчиков, которые принадлежат примерно 20 000 компаний. Среди них Anthropic, Microsoft и Amazon. Сейчас около 80% этого трафика приходит от агентов. В январе соотношение было обратным: преобладали люди.

За десять месяцев большинство читателей документации сменилось с человека на программу. Именно эту динамику стоит запомнить, а не круглое число из заголовка. Обратите внимание, что мы пересказываем цифры по материалу в Substack и по разбору Андрея Себрanta. Как именно авторы отделяют агентов от людей, из пересказа не видно. Тем, кто будет ссылаться на эти данные, стоит открыть первоисточник и посмотреть методологию.

Почему именно документация

Документация почти идеальный контент для агента. У неё чёткая цель: найти, как вызвать метод API, какие параметры принимает функция, что значит конкретная ошибка. Раньше с этим вопросом шёл разработчик, открывал страницу и читал. Теперь он ставит задачу кодинг-ассистенту, а тот сам идёт на сайт, забирает нужные куски и пишет код.

Человек при этом читает документацию реже и опосредованно, через ответ агента. Это наша интерпретация, но она хорошо объясняет, почему счётчики визитов так резко поменялись. Один запрос разработчика может породить несколько обращений агента к разным страницам, так что сдвиг в трафике выглядит драматичнее, чем сдвиг в реальном числе пользователей.

Что с этим делать

Если вы отвечаете за документацию или продукт с API, из этого следует несколько практических шагов.

• Разделите аналитику. Посмотрите, какая доля обращений к вашим докам приходит от агентов. Если вы считаете все визиты людьми, ваши метрики вводят вас в заблуждение.
• Пишите для машины как для первого читателя. Чёткие заголовки, полные примеры кода, которые можно скопировать и запустить, явные версии API, понятное описание ошибок. Агент не догадывается по контексту, он берёт то, что написано.
• Не прячьте суть. Ключевая информация в вкладках, картинках или в интерфейсе, который рендерится только скриптами, рискует вообще не дойти до агента.
• Рассмотрите машиночитаемые форматы. Например, версии страниц в простой разметке или предложенный сообществом файл llms.txt со списком важных материалов. Это не стандарт, а договорённость, и поддерживают её не все, но стоимость внедрения невелика.
• Меряйте успех иначе. Просмотры страниц плохо показывают, помогла ли документация. Полезнее смотреть, справился ли агент с задачей по вашему API с первой попытки.

Людям документация по-прежнему нужна, но другая: концепции, обзоры архитектуры, обучение с нуля. Справочный слой всё больше превращается в интерфейс для агентов.

Ограничения

Во-первых, это выборка по сайтам с документацией, а не по всему интернету. Блоги, новости и форумы читаются иначе, и переносить на них 80% нельзя. Во-вторых, это доля визитов, а не доля читателей. Агент может сделать десятки запросов там, где человек открыл бы одну страницу. В-третьих, как уже сказано, детали методики по пересказу неизвестны.

Итог такой: даже с оговорками тренд очевиден. Если ваш продукт используют разработчики, то значительную часть первого знакомства с ним сегодня делает не человек. Документацию стоит проверять так же, как вы проверяете интерфейс: сможет ли новый читатель, на этот раз программный, с ней разобраться.