Що таке ai-catalog.json і як перейти на ARD?
Автор: Редакція Domeny.ForSale Опубліковано Оновлено
Коротко: /.well-known/ai-catalog.json — попередній шлях для публікації маніфесту ресурсів для агентів AI. У специфікації Agentic Resource Discovery (ARD) його описано як попередника /.well-known/ard.json. Такий маніфест подає доступні інструменти, агентів або інструкції з їх використання у структурованому форматі JSON. Для нового впровадження слід використовувати шлях ard.json та посилання HTML rel="ard".
Стаття ґрунтується на специфікації ARD v0.91 від 26 серпня 2026 року, позначеній як Proposal, тобто пропозиція. Стан документації перевірено 3 жовтня 2026 року.
Для чого потрібен каталог ресурсів для агентів?
Асистент, якому потрібен зовнішній інструмент, має спочатку з’ясувати, що цей інструмент робить і де знайти його опис. Маніфест дає видавцеві змогу подати цю інформацію в єдиній структурі. Окремі записи можуть вказувати, зокрема, на опис сервера MCP, картку агента A2A або файл з інструкціями виконання завдання, який називають skill.
У ARD публікація маніфесту є статичною частиною виявлення ресурсів. Окрему роль відіграє реєстр: він отримує записи, індексує їх і забезпечує пошук. Завдяки цьому клієнт може надіслати запит щодо конкретної потреби й отримати відповідні ресурси. Сам файл JSON не запускає інструментів; спосіб їх запуску визначає відповідний протокол або інструкція. Ці рівні описано в розділах 3 і 5 специфікації .
Чому зараз використовують ard.json?
У розділі 5.1 специфікація встановлює однозначні правила пошуку маніфестів:
| Механізм | Поточна назва | Попередня назва |
|---|---|---|
| Файл у домені | /.well-known/ard.json | /.well-known/ai-catalog.json |
| Посилання в HTML | rel="ard" | rel="ai-catalog" |
| Підтримка клієнтом ARD | Обов’язкова під час виявлення записів домену | Необов’язкова зворотна сумісність |
Клієнт, який відповідає специфікації та виявляє ресурси домену, має завантажити /.well-known/ard.json і врахувати посилання rel="ard". Додатково він може перевіряти попередній шлях і відношення ai-catalog; у такому разі він трактує їх як рівнозначні джерела записів.
Це означає, що сервіс, який надає лише ai-catalog.json, може залишитися непоміченим для клієнта ARD, навіть якщо той працює правильно. Специфікація рекомендує перейти на ard.json. Збереження старої адреси поряд із новою — можливість для підтримки старіших інтеграцій, а не вимога до нового впровадження.
Як виглядає коректний маніфест?
Документ містить масив entries з описами окремих ресурсів. Нижче наведено скорочену версію
маніфесту Domeny.ForSale
:
{
"entries": [
{
"identifier": "urn:air:domeny.forsale:skill:domain-catalog-search",
"displayName": "Пошук у каталозі Domeny.ForSale",
"type": "text/markdown; profile=\"urn:air:agent-skills\"",
"url": "https://domeny.forsale/.well-known/agent-skills/domain-catalog-search/SKILL.md",
"capabilities": ["searchDomainCatalog"],
"representativeQueries": [
"знайди домен на продаж для інтернет-магазину",
"покажи статті про вибір і купівлю домену"
]
}
]
}
Запис вказує на
інструкцію пошуку в каталозі
. Інструкція описує використання інструмента WebMCP searchDomainCatalog, а якщо він недоступний — пошук в індексі JSON сервісу. Отже, адреса в url веде до документа з описом порядку дій.
Відповідно до розділів 4.2 і 4.3 :
identifier,displayNameіtype— обов’язкові поля. Вони визначають ідентифікатор, зрозумілу назву й тип ресурсу.- Запис має містити рівно одне з двох полів:
url, яке вказує на документ, абоdata, яке містить його безпосередньо. representativeQueriesмає містити 2–5 прикладів запитів. Вони допомагають індексувати ресурс з огляду на потреби користувача. Відсутність поля або інша кількість прикладів спричиняє попередження інструмента перевірки відповідності, а не помилку валідації за схемою.capabilities— необов’язковий список коротких назв функцій, корисний для фільтрування.
Маніфест також може містити додаткові поля верхнього рівня, як-от host або specVersion. ARD не визначає їхнього значення у своїй моделі маніфесту. Тому наявність у нашому файлі "specVersion": "1.0" не означає, що поточна специфікація ARD має версію 1.0. Структуру формально визначає
схема запису й маніфесту
.
Як перейти з ai-catalog.json на ard.json?
Наявний каталог можна перенести за чотири кроки:
- Перевірте записи за поточною схемою ARD, зокрема ідентифікатори, адреси ресурсів і приклади запитів.
- Опублікуйте маніфест за шляхом
/.well-known/ard.jsonу власному домені. - Додайте в секцію
<head>сторінок посилання на цей документ. - Перевірте завантаження маніфесту й указаних ресурсів та виконайте валідацію. Якщо зберігаєте старий шлях для наявних клієнтів, підтримуйте узгодженість обох версій.
Посилання може виглядати так:
<link rel="ard" href="/.well-known/ard.json" type="application/json">
Специфікація надає інструмент для тестування відповідності . Він дає змогу перевірити маніфест і його виявлення в домені.
Що дає публікація такого файлу?
Маніфест допомагає програмному забезпеченню, яке підтримує ARD, розпізнати можливості сервісу. У нашому прикладі він описує спосіб пошуку доменів і статей. Щоб ресурс з’явився в результатах пошуку конкретного реєстру, цей реєстр має знайти джерело та проіндексувати його.
Сама публікація файлу не гарантує підтримки будь-яким асистентом або вищої позиції сайту в Google. Практичний результат слід перевіряти в інтеграції, яка справді використовує ARD: чи завантажує вона маніфест, чи розпізнає запис і чи може скористатися вказаним ресурсом.
Дивіться також: Що таке ARD?
Читайте також
