Що таке ARD і як він знаходить ресурси для AI
Автор: Редакція Domeny.ForSale Опубліковано Оновлено
ARD (Agentic Resource Discovery) — відкрита специфікація опису та пошуку ресурсів, якими можуть користуватися агенти AI. Вона допомагає застосунку знайти інструмент, сервер MCP, іншого агента або набір інструкцій, що відповідає завданню користувача. Специфікація поєднує описи ресурсів, опубліковані їхніми власниками, з реєстрами, які індексують ці описи й забезпечують пошук. Ця стаття спирається на специфікацію ARD .
Яку проблему розв’язує ARD?
Припустімо, ви просите асистента: «Знайди короткий домен для магазину велосипедів». Для виконання завдання йому потрібні доступ до каталогу доменів та інструкції з пошуку в ньому. У невеликому застосунку розробник може заздалегідь підключити відповідний інструмент. Але коли доступні тисячі сервісів, вручну налаштовувати кожну інтеграцію та додавати всі описи до контексту моделі стає складно.
ARD пропонує шукати ресурси відповідно до потреби. Застосунок надсилає запит до реєстру, отримує відповідні описи й вибирає, чим скористатися. Тоді до контексту моделі можуть потрапити відомості лише про вибрані ресурси, а не весь каталог.
Це механізм виявлення доступних можливостей. Знайшовши ресурс, застосунок ще має підтримувати відповідний спосіб зв’язку та мати необхідні права доступу. Специфікація відокремлює пошук від подальшого використання інструмента. Принципи проєктування ARD
Як працює ARD: крок за кроком
У процесі беруть участь видавець ресурсу, реєстр і застосунок, що використовує агента AI.
- Видавець описує ресурс. Зазначає його назву, ідентифікатор, тип і документ з описом можливостей або інструкціями з використання.
- Опис стає доступним в інтернеті. Основне розташування маніфесту —
/.well-known/ard.json. Специфікація також передбачає, зокрема, вбудовані дані JSON-LD, посилання HTMLrel="ard", директивуAgentmapуrobots.txtта записи DNS. - Реєстр отримує та індексує записи. Він використовує їхні дані для пошуку відповідних ресурсів.
- Застосунок описує потребу. Надсилає до реєстру запит природною мовою, за потреби — з фільтрами.
- Застосунок вибирає результат і читає опис ресурсу. Далі він може скористатися ресурсом відповідно до потрібного протоколу та власних правил доступу.
Отже, публікація маніфесту й ведення реєстру — різні речі. Власник сайту може надати статичний файл, не запускаючи власний пошуковий сервіс. Вимога надавати пошуковий інтерфейс REST стосується реєстрів. Виявлення та індексування ресурсів
Що містить запис ARD?
Запис — це опис ресурсу в моделі JSON-LD. Маніфест ard.json об’єднує такі записи в масиві entries. Найважливіші поля:
| Поле | Значення | Вимога |
|---|---|---|
identifier | Унікальний ідентифікатор у форматі urn:air:<publisher>:<namespace>:<agent-name> | Обов’язкове |
displayName | Зрозуміла назва ресурсу | Обов’язкове |
type | Тип описуваного документа, зазначений як тип медіа | Обов’язкове |
url або data | Адреса документа або його вміст, розміщений у записі | Рівно одне з цих полів |
representativeQueries | Приклади запитань або команд, на які відповідає ресурс | Рекомендовано 2–5 прикладів |
capabilities | Короткі позначення функцій, корисні для фільтрування | Необов’язкове |
Поле url веде до описуваного документа, наприклад картки сервера або файлу інструкцій. Його не слід ототожнювати з адресою, на яку надсилають команду для виконання завдання. Натомість ідентифікатор urn:air:… дає змогу відокремити ідентичність ресурсу від місця зберігання його опису.
Особливу роль відіграє representativeQueries: реєстр використовує приклади запитів для семантичного індексування. Без цього поля запис може залишатися структурно коректним, але не мати даних, потрібних для його знаходження таким пошуком. У такому разі інструмент перевірки відповідності видає попередження, а не повідомлення про помилку схеми.
Модель запису та вимоги до полів
Як застосунок шукає інструмент?
Реєстр надає кінцеву точку POST /search. Приклад тіла запиту для пошуку доменів міг би виглядати так:
{
"query": {
"text": "знайди домен на продаж для магазину велосипедів",
"filter": {
"capabilities": ["searchDomainCatalog"]
}
},
"federation": "none",
"pageSize": 5
}
Це приклад запиту до реєстру, який проіндексував відповідний ресурс. query.text описує потребу, а фільтр обмежує результати записами, що декларують зазначену функцію. pageSize обмежує кількість результатів на сторінці.
Реєстри також можуть співпрацювати. Параметр federation приймає три значення: none означає пошук у власному індексі, auto дозволяє реєстру опитати інші реєстри й об’єднати результати, а referrals додатково повертає вказівки на реєстри, які клієнт може обшукати самостійно. Типовий режим — auto.
Пошуковий інтерфейс
і
федерація реєстрів
Як ARD пов’язаний із MCP та agent skills?
Ці рішення виконують різні ролі в одному процесі:
| Елемент | Роль |
|---|---|
| ARD | Допомагає знайти ресурс, що відповідає потребі |
| MCP | Забезпечує спосіб зв’язку застосунку AI з доступними інструментами й даними |
| A2A | Забезпечує зв’язок між агентами |
| Agent skills | Надають інструкції та матеріали, потрібні для певного завдання |
ARD може описувати ресурси, представлені в різних форматах. Знаходження запису сервера MCP не означає автоматичного підключення до цього сервера. Застосунок має підтримувати відповідну інтеграцію. Типи ресурсів і розмежування функцій
Приклад із Domeny.ForSale
На цьому сайті доступний
маніфест ARD
. Він містить опис навички пошуку в каталозі доменів і статей. Поле url вказує на
інструкцію з використання пошуку
, а representativeQueries містить, зокрема, запит на пошук домену для інтернет-магазину.
Завдяки такому опису клієнт із підтримкою ARD може дізнатися, що сайт надає корисний ресурс і де знайти інструкцію з його використання. Сам файл не виконує пошук і не доводить, що певний асистент уже проіндексував сайт.
Чи можна довіряти знайденому ресурсу?
Відповідність запиту й надійність — окремі питання. Значення score, яке повертає реєстр за шкалою 0–100, визначає семантичну відповідність. Воно не є оцінкою безпеки, сертифікатом або підтвердженням прав доступу.
Специфікація передбачає необов’язкове поле trustManifest, яке дає змогу передати відомості для перевірки ідентичності та походження. Якщо це поле присутнє, заявлена ідентичність має бути пов’язана з доменом видавця, зазначеним в ідентифікаторі. ARD не визначає власної універсальної процедури підписування; перевірка залежить від зазначеної системи довіри.
Ідентичність і довіра в ARD
На дату оновлення статті документ описує версію 0.91 зі статусом «Proposal». Під час впровадження варто спиратися на актуальну специфікацію та можливості конкретного клієнта. Це стосується і старої назви маніфесту ai-catalog.json, яку поточна версія замінює шляхом ard.json.
Дивіться також: Що таке ai-catalog.json? · Що таке MCP? · Що таке agent skills?
Читайте також
