В 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, 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 заново.

Источники