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

Комментарии 0