В Google PageSpeed Insights (PSI), в категории «Агентный просмотр», раздел «Доступность для агентов», появляется ошибка:
Недействительная схема (ai-catalog.json) Не удалось загрузить файл каталога для проверки схемы.
Заголовок говорит «схема недействительна», и я первым делом искал ошибку в JSON. Её не было, потому что не было самого файла. Ответ — в красной приписке: PSI не смог файл даже загрузить.
Что проверяет PSI
Он запрашивает https://сайт/.well-known/ai-catalog.json и сверяет ответ с JSON Schema спецификации ARD (Agentic Resource Discovery). Чтобы проверка прошла, файл должен:
-
отдаваться с кодом 200, без редиректа;
-
иметь тип application/json;
-
проходить схему.
Шаг 1. Посмотреть, что отдаёт сервер
curl -sI https://example.com/.well-known/ai-catalog.json
У меня было так:
Запрос
Ответ
GET /.well-known/ai-catalog.json
301 на /.well-known/ai-catalog.json/
GET /.well-known/ai-catalog.json/
404 text/html
Файла нет, WordPress дописал слэш и вернул HTML-страницу 404. Если у вас 301, 404 или text/html, файл нужно создать. Если файл есть, а ошибка остаётся, переходите к списку ошибок схемы ниже.
Шаг 2. Создать файл
Рабочий пример:
{ "specVersion": "1.0", "host": { "displayName": "Avigroup", "documentationUrl": "https://avigroup.pro/llms.txt", "logoUrl": "https://avigroup.pro/wp-content/uploads/2020/08/avilogo.png" }, "entries": [ { "identifier": "urn:air:avigroup.pro:docs:llms-txt", "displayName": "Avigroup.pro: материалы для LLM", "type": "text/markdown", "url": "https://avigroup.pro/llms.txt", "description": "Каталог ключевых страниц агентства Avigroup (SEO, контекстная реклама, разработка и аудит сайтов) с правилами цитирования для ИИ-ассистентов.", "tags": ["seo", "ppc", "web-development", "site-audit", "ru"], "representativeQueries": [ "агентство SEO-продвижения сайтов", "аудит сайта стоимость", "продвижение сайта в нейросетях" ], "updatedAt": "2026-11-20T00:00:00Z" } ]}
Что заменить:
-
В identifier — домен. Формат: urn:air:::.
-
displayName, description, tags, ссылки.
-
representativeQueries — от двух до пяти фраз, по которым агент должен находить ресурс.
-
updatedAt — дату последнего изменения.
В entries указывайте только ресурсы, которые реально существуют. Если на сайте нет MCP-сервера или A2A-агента, подойдёт llms.txt с типом text/markdown. Если MCP-сервер есть, добавьте запись с «type»: «application/mcp-server-card+json».
Ошибки, из-за которых схема не проходит
-
Лишние поля в корне или в host. Там additionalProperties: false. В корне допустимы только specVersion, host, entries.
-
specVersion не строка «1.0». Число 1.0 не пройдёт.
-
identifier не по шаблону ^urn:air:[a-zA-Z0-9.-]+(:[a-zA-Z0-9._-]+)+$. URL не подходит.
-
В записи нет url и data, или есть оба. Нужно ровно одно.
-
representativeQueries меньше двух или больше пяти.
-
updatedAt без времени и часового пояса. Нужно 2026-11-20T00:00:00Z, а не 2026-11-20.
-
Относительные ссылки в url, documentationUrl, logoUrl. Нужны абсолютные.
-
У host нет displayName.
Шаг 3. Проверить файл до выкладки
python3 -m venv /tmp/ard && /tmp/ard/bin/pip -q install "jsonschema[format]"curl -sO https://raw.githubusercontent.com/ards-project/ard-spec/main/spec/schemas/ai-catalog.schema.json/tmp/ard/bin/python -c 'import json, jsonschemas = json.load(open("ai-catalog.schema.json"))d = json.load(open("ai-catalog.json"))jsonschema.Draft202012Validator(s, format_checker=jsonschema.FormatChecker()).validate(d)print("VALID")'
Без [format] валидатор не проверяет uri и date-time и пропустит «updatedAt»: «вчера». При ошибке он называет поле и нарушенное правило.
Шаг 4. Выложить по двум адресам
/.well-known/ai-catalog.json
/.well-known/ard.json
Второй адрес нужен потому, что в актуальной версии ARD (v0.91) основной путь — ard.json, а ai-catalog.json назван путём предшественника. PSI пока проверяет старый путь, агенты по спецификации обязаны читать новый. Содержимое одно и то же, оно проходит обе схемы.
Apache и nginx отдают существующий .json как статику. Если запрос всё равно уходит в CMS или тип не тот, добавьте в nginx:
location ^~ /.well-known/ { default_type application/json; try_files $uri =404;}
Если /.well-known/acme-challenge обрабатывается отдельным правилом, ограничьтесь двумя адресами через location =.
Сбросьте кеш: proxy_cache, CDN, WP Rocket. Иначе PSI будет получать закешированный 301.
Шаг 5. Проверить после выкладки
for p in ai-catalog.json ard.json; do curl -s -o /dev/null -w "$p %{http_code} %{content_type} %{redirect_url}n" https://example.com/.well-known/$pdone
Правильный ответ:
ai-catalog.json 200 application/json; charset=utf-8ard.json 200 application/json; charset=utf-8
Запустите проверку в PSI заново.
Источники
-
Спецификация ARD и JSON-схемы
-
Agentic Resource Discovery на specification.website
Источник: habr.com