В 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, jsonschema s = 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/$p done
Правильный ответ:
ai-catalog.json 200 application/json; charset=utf-8 ard.json 200 application/json; charset=utf-8
Запустите проверку в PSI заново.