Сервис Velu представил бесплатную проверку документации на пригодность для ИИ-агентов. Пользователь указывает URL сайта с документацией, после чего инструмент оценивает его по 23 проверкам из семи категорий открытого стандарта Agent-Friendly Documentation Spec. Регистрация не требуется, а результат можно сохранить ссылкой.
Что именно проверяет Velu
Проверка охватывает не только наличие специального файла для языковых моделей. Среди критериев:
- наличие, структура и размер llms.txt;
- Markdown-версии страниц по адресам с суффиксом .md;
- поддержка заголовка HTTP Accept: text/markdown;
- наличие контента в исходном HTTP-ответе без обязательного JavaScript;
- ограничение объёма страницы примерно 50 тысячами символов;
- корректная структура заголовков, вкладок и блоков кода;
- настоящие ответы 4xx вместо «мягких» 404;
- корректные редиректы, sitemap и cache-заголовки;
- совпадение Markdown-представления с HTML;
- доступ к страницам без интерактивного входа или наличие документированного альтернативного пути.
По описанию проекта, проверки выполняются через эталонную реализацию afdocs. Оценка должна показать не только общий результат, но и конкретные места, где агент может столкнуться с препятствиями.
Почему это важно
ИИ-агент обычно не читает сайт так же, как человек. Он может не выполнить JavaScript, потерять важный текст среди элементов навигации или не понять, где находится нужная страница. При отсутствии стабильного индекса агенту сложнее обнаружить документацию, а при слишком большой странице — обработать её в рамках доступного контекста.
Velu отдельно выделяет llms.txt как наиболее весомую проверку в спецификации. Этот файл должен содержать краткое описание документации и структурированный список ссылок. Идея в том, чтобы агент сначала получил карту сайта, а затем перешёл к нужным материалам.
Практическое следствие для команд разработки: удобство документации для агентов становится свойством опубликованных страниц, а не отдельной задачей «на потом». Человеческая HTML-версия и машинно читаемые артефакты должны обновляться вместе.
Ограничения подхода
Проверка измеряет техническую доступность и структуру документации, но не гарантирует, что агент правильно поймёт смысл API или применит инструкцию без ошибок. Хороший HTTP-ответ, Markdown и sitemap не заменяют точные примеры, описание ограничений и актуальные версии.
Открытый стандарт также находится на ранней стадии развития: сам проект описывает дополнительные возможности, включая единый поисковый и цитируемый endpoint, как направление за пределами текущих требований. Поэтому итоговый балл стоит воспринимать как диагностический ориентир, а не как универсальную сертификацию.
Для владельцев документации инструмент полезен прежде всего как быстрый аудит перед публикацией или миграцией. Он помогает проверить базовые условия, от которых зависит обнаружение, загрузка и разбор страниц ИИ-агентами.
