«Недействительная схема (ai-catalog.json)» в Google PageSpeed Insights: как исправить за 10 минут

В 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" } ]}

Что заменить:

  1. В identifier — домен. Формат: urn:air:::.

  2. displayName, description, tags, ссылки.

  3. representativeQueries — от двух до пяти фраз, по которым агент должен находить ресурс.

  4. 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

0 0 голоса
Рейтинг новости
1
0
Подписаться
Уведомить о
0 комментариев