Эталонные реализации
Hugging Face Discover Tool
Заголовок раздела «Hugging Face Discover Tool»Discover Tool от Hugging Face открывает поиск по тысячам навыков (Skills), ML-приложений и MCP-серверов - на Hugging Face или в любом другом сервисе, соответствующем ARD.
Hugging Face CLI (hf)
Заголовок раздела «Hugging Face CLI (hf)»discover встроен в Hugging Face CLI (hf). Чтобы начать:
# Install the Hugging Face CLI tool:uv tool install huggingface_hub
# Search for resources to train a modelhf discover search "Fine tune a language model"
# Find MCP Servers to generate an imagehf discover search "Generate an image" --json --kind mcp
# Search other registrieshf discover search "Purchase aeroplane tickets" --registry-url <catalog-url>
# Navigate a federated catalog from a websitehf discover navigate <web-url> "Research biomedical datasets"Доступ через REST и MCP API
Заголовок раздела «Доступ через REST и MCP API»Обращайтесь к сервису каталога Hugging Face напрямую:
- REST API по адресу:
https://huggingface-hf-discover.hf.space/search - MCP по адресу:
https://huggingface-hf-discover.hf.space/mcp
GitHub Agent Finder
Заголовок раздела «GitHub Agent Finder»Agent Finder от GitHub - это сервис обнаружения агентных ресурсов (agentic resources): навыков, инструментов и MCP-серверов, - доступный по HTTPS по адресу https://agentfinder.github.com/api/v1.
GitHub Copilot
Заголовок раздела «GitHub Copilot»GitHub Copilot может искать в нём напрямую: добавьте Agent Finder как инструмент удалённого MCP (или как пользовательские инструкции), затем попросите Copilot найти возможность для вашей задачи, и он вернёт ранжированные совпадения, из которых вы выбираете, что установить. Полная настройка описана на странице Подключение GitHub Copilot - в качестве примера там используется эта же конечная точка (endpoint).
HTTP API
Заголовок раздела «HTTP API»Вызывайте поиск напрямую: POST https://agentfinder.github.com/api/v1/search. Конечная точка MCP - https://agentfinder.github.com/api/v1/mcp.
Cisco AI Catalog
Заголовок раздела «Cisco AI Catalog»Эталонная реализация ARD AGNTCY Agent Directory развёрнута в AI Catalog от Cisco. Каталог можно получить по адресу ai-catalog.outshift.io/.well-known/ard.json. Он поддерживает безопасную проверку через манифесты доверия, так что клиенты могут проверить идентичность издателя и целостность ресурса перед использованием.
1. Получите манифест каталога
Заголовок раздела «1. Получите манифест каталога»curl -sS https://ai-catalog.outshift.io/.well-known/ard.json | jq '.entries | length'2. Найдите карточки A2A
Заголовок раздела «2. Найдите карточки A2A»curl -sS 'https://ai-catalog.outshift.io/v1/agents?filter=type%3Dapplication%2Fa2a-agent-card%2Bjson' \ | jq -r '.results[] | "\(.displayName)\t\(.data.card_data.url // .identifier)"'3. Выполните поиск по типу карточки и извлеките сведения о доверии
Заголовок раздела «3. Выполните поиск по типу карточки и извлеките сведения о доверии»curl -sS 'https://ai-catalog.outshift.io/v1/agents?filter=type%3Dapplication%2Fmcp-server-card%2Bjson' \ | jq -r '.results[] | {displayName, identity: .trustManifest.identity, identityType: .trustManifest.identityType, cardUrl: .data.card_data.url} | @json'Ora Directory
Заголовок раздела «Ora Directory»Ora Directory - это сервис обнаружения ARD по продуктам и сервисам, которыми агенты пользуются от имени пользователей; его ведёт Ora. Ora проверяет каждый продукт на готовность к работе с агентами - статические проверки его документации, llms.txt, реестров и публичных API, а также живые запуски агентов, которые пытаются использовать продукт от начала до конца, - и отдаёт результаты по протоколу ARD вместе с обнаруженными у каждого продукта MCP-серверами, навыками (Skills) и спецификациями OpenAPI, а также платными конечными точками HTTP x402/MPP с оплатой за вызов, проиндексированными из публичного реестра Bazaar. Каждая запись продукта несёт его оценочную карту готовности к работе с агентами в виде подписанной аттестации доверия, так что клиент может учитывать не только то, подходит ли ресурс для задачи, но и то, подтверждено ли наблюдениями, что он работает с агентами.
Манифест издателя Ora по адресу ora.ai/.well-known/ard.json описывает собственные ресурсы Ora и объявляет реестр: его запись application/ai-registry+json указывает на https://ora.ai/api/ard, где отдаётся самоописывающий дескриптор с перечнем конечных точек (endpoints). Сам индекс запрашивается через эти конечные точки.
Поиск и просмотр
Заголовок раздела «Поиск и просмотр»Реестр реализует весь интерфейс протокола - POST /search, POST /explore и GET /agents с выражениями filter и параметром orderBy из спецификации - и возвращает referrals на равноправные реестры.
# Find products for a taskcurl -sS -X POST https://ora.ai/api/ard/search \ -H 'content-type: application/json' \ -d '{"query":{"text":"send transactional email"},"pageSize":5}' \ | jq -r '.results[] | "\(.displayName)\t\(.url)"'
# Browse just the MCP servers in the indexcurl -sS -G https://ora.ai/api/ard/agents \ --data-urlencode "filter=type = 'application/mcp-server-card+json'" \ --data-urlencode "pageSize=5" \ | jq -r '.items[].displayName'Проверка оценочной карты
Заголовок раздела «Проверка оценочной карты»Поле trustManifest.attestations[] каждого результата ссылается на оценочную карту готовности продукта к работе с агентами, подписанную отделённой подписью Ed25519 JWS и проверяемую по JWKS по адресу ora.ai/.well-known/jwks.json:
curl -sS https://ora.ai/api/ard/attestation/resend.com \ | jq '{subject, score, grade, issuer}'Ora также доступен как MCP-сервер по адресу https://ora.ai/api/mcp (streamable HTTP); его инструменты discover_products, get_score и search_capabilities обращаются к тому же индексу.
Desvela ARD Registry
Заголовок раздела «Desvela ARD Registry»Desvela ARD Registry - это нейтральный реестр по открытому вебу, не привязанный к экосистеме одного поставщика. Вместо того чтобы индексировать собственные ресурсы какой-то платформы, он обходит первые 100K доменов рейтинга Tranco и собирает то, что посещающий агент действительно может прочитать, - /.well-known/ard.json, его предшественника /.well-known/ai-catalog.json, /llms.txt, /agents.md, /.well-known/agent-card.json, /.well-known/mcp.json и директивы для ИИ-ботов в /robots.txt. Данные обновляются каждую неделю, поэтому реестр находит издателей за пределами любой отдельной экосистемы. Методика обхода и ежемесячные результаты опубликованы на desvela.ai/census.
Собственный манифест Desvela по адресу desvela.dev/.well-known/ard.json описывает её ресурсы, включая сам реестр, а сайт выводит <link rel="ard">.
Оба пути манифеста обходятся и подсчитываются отдельно, а не заменяют друг друга. Перепись - это помесячный ряд, и если бы при переносе канонического пути в спецификации один столбец просто заменили другим, ряд показал бы обвал внедрения ARD, вызванный инструментом измерения, а не вебом, - а издателей пока так мало, что это имеет значение. Для каждого источника указана дата, когда он вошёл в перепись, поэтому ноль до этой даты читается как не измерялось, а не никто не публиковал.
Поиск и обзор
Заголовок раздела «Поиск и обзор»# Find resources for a taskcurl -sS -X POST https://registry.desvela.dev/search \ -H 'content-type: application/json' \ -d '{"query":{"text":"brand monitoring"},"pageSize":5}' \ | jq -r '.results[] | "\(.displayName)\t\(.url)"'
# Facet counts across the index (ARD spec §7.3)curl -sS -X POST https://registry.desvela.dev/explore \ -H 'content-type: application/json' \ -d '{"resultType":{"facets":[{"field":"type"}]}}' \ | jq '.facets'Предварительная проверка перед обращением к домену
Заголовок раздела «Предварительная проверка перед обращением к домену»Бесплатный инструмент MCP проверяет, что домен публикует для агентов, прежде чем вы что-либо у него запросите:
curl -sS https://registry.desvela.dev/mcp \ -H 'content-type: application/json' \ -H 'accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preflight","arguments":{"domain":"example.com"}}}'Удалённый MCP-сервер по адресу https://registry.desvela.dev/mcp (Streamable HTTP) предоставляет preflight(domain) и watch(domain, webhook_url); второй присылает уведомление (webhook) с подписью HMAC, когда меняется то, что домен публикует для агентов.
ANS Finder
Заголовок раздела «ANS Finder»ANS Finder - это сервис обнаружения в составе эталонной реализации Agent Name Service (ANS) с открытым исходным кодом: центр регистрации, журнал прозрачности и автономный верификатор на Go, основанные на черновике ANS в IETF. Finder читает ленту событий жизненного цикла реестра, заносит каждого зарегистрированного в ANS агента в поисковый индекс и предоставляет REST-интерфейс реестра ARD: POST /v1/search и POST /v1/explore (ARDS v0.9). Его отличает проверяемая регистрация: поле trustManifest.attestations[] каждой записи каталога несёт аттестацию ANS-Registration, URI которой разрешается в квитанцию SCITT COSE в журнале прозрачности ANS (ANS Transparency Log), так что клиент может криптографически проверить регистрацию агента - независимо от Finder - перед его вызовом. Сервис проходит проверку набором тестов на соответствие этого проекта (режим реестра).
ANS Finder рассчитан на самостоятельное размещение: запустите стек локально (или разверните собственный), а не обращайтесь к публичной конечной точке (endpoint).
Запуск демонстрационного стека
Заголовок раздела «Запуск демонстрационного стека»git clone https://github.com/agentnameservice/ans && cd ansscripts/demo/start.sh # builds + starts the registry :18080, transparency log :18081, finder :18082scripts/demo/register.sh --v2 translator.example.com # register an MCP agent and drive it to ACTIVEFinder опрашивает ленту событий реестра (в демонстрации - каждые 2 секунды) и индексирует агента; Swagger UI показывает контракт ARD сервиса Finder по адресу http://localhost:18082/docs.
curl -sS -X POST http://localhost:18082/v1/search \ -H 'content-type: application/json' \ -d '{"query":{"text":"translator"},"pageSize":5}' \ | jq '.results[] | {identifier, displayName, url, score}'Проверка записи по журналу прозрачности
Заголовок раздела «Проверка записи по журналу прозрачности»Поле trustManifest.attestations[] каждого результата несёт URI квитанции SCITT в журнале прозрачности:
curl -sS -X POST http://localhost:18082/v1/search \ -H 'content-type: application/json' \ -d '{"query":{"text":"translator"},"pageSize":1}' \ | jq -r '.results[0].trustManifest.attestations[0].uri'Проверка соответствия
Заголовок раздела «Проверка соответствия»git clone https://github.com/ards-project/ard-specard-spec/conformance/bin/conformance-test registry http://localhost:18082/v1MCP Gateway Registry
Заголовок раздела «MCP Gateway Registry»MCP Gateway Registry - это реализация ARD с открытым исходным кодом (Apache-2.0) для самостоятельного размещения, которая охватывает обе роли - издателя (Publisher) и реестра (Registry), - а также федерацию между реестрами. Она индексирует MCP-серверы, агентов A2A и навыки и отдаёт их по контракту ARD. Полное описание - в docs/ard.md.
Издатель: получение манифеста каталога
Заголовок раздела «Издатель: получение манифеста каталога»Роль издателя (Publisher) формирует из записей реестра соответствующий спецификации анонимный /.well-known/ai-catalog.json, где перечислены только публичные и включённые активы. Каждая запись несёт URN, привязанный к домену (urn:air:<publisher>:<namespace>:<name>), тип содержимого (media type) IANA для своего вида и trustManifest со схемой https.
Обратите внимание: сейчас эта реализация отдаёт путь /.well-known/ai-catalog.json, принятый до версии v0.91, а не /.well-known/ard.json; в примерах ниже используется путь, по которому работающий экземпляр отвечает сегодня, а поддержка ard.json ожидается в основном проекте.
# Against a self-hosted instancecurl -sS https://your-registry.example.com/.well-known/ai-catalog.json \ | jq '.specVersion, .host.displayName'Реестр: поиск и просмотр
Заголовок раздела «Реестр: поиск и просмотр»Роль реестра (Registry) предоставляет контракт поиска и просмотра ARD по пути /api/ard. Обе конечные точки требуют JWT и ограничены правами доступа: вызывающая сторона видит только те активы, к которым ей разрешён доступ.
# Semantic search over the catalogcurl -sS -X POST https://your-registry.example.com/api/ard/search \ -H "Authorization: Bearer $TOKEN" \ -H "content-type: application/json" \ -d '{"query":{"text":"financial data tools","filter":{"type":["mcp_server"],"tags":["finance"]}},"pageSize":10}' \ | jq -r '.results[] | "\(.displayName)\t\(.score)"'
# Browse all asset types (MCP servers + A2A agents + skills)curl -sS -X GET "https://your-registry.example.com/api/ard/agents?orderBy=identifier" \ -H "Authorization: Bearer $TOKEN" \ | jq -r '.items[].displayName'Результаты - это записи catalogEntry протокола ARD с добавлением score (целое число 0-100) и source. Ошибки используют оболочку ARD {errorCode, message}. Федерация загружает каталоги ai-catalog.json других реестров в единый локальный индекс; режим выбирается для каждого запроса параметром federation (none / auto / referrals).
Nevermined
Заголовок раздела «Nevermined»Nevermined - издатель ARD и платёжный слой для агентного обнаружения. Большинство сервисов обнаружения отвечает на вопрос «что может выполнить эту задачу?»; Nevermined отвечает ещё и на вопрос «сколько это будет стоить и как за это заплатить?»: каждая запись каталога называет свой платёжный протокол, цену за вызов и сеть расчётов, а его Router позволяет агенту действительно оплатить найденное (x402 и MPP, в разных блокчейнах, в пределах лимита расходов), не выходя из процесса обнаружения.
Манифест издателя Nevermined по адресу api.live.nevermined.app/.well-known/ard.json - это курируемый каталог сервисов для агентов (Agent Services Catalog): внешние сервисы x402 / MPP / REST / A2A, и каждая запись указывает на свою вызываемую конечную точку. Данные об оплате и обнаружении передаются в терминах расширения JSON-LD (@context + nvm:catalog для внешних сервисов, nvm:payment для тарифов, размещённых в Nevermined), поэтому реестр может индексировать цену, протокол и сеть как измерения фильтра, а не разбирать метаданные в свободной форме. Поле trustManifest.identity каждой записи привязано к домену издателя.
1. Получите манифест каталога
Заголовок раздела «1. Получите манифест каталога»curl -sS https://api.live.nevermined.app/.well-known/ard.json | jq '.entries | length'2. Найдите сервисы и их условия оплаты за вызов
Заголовок раздела «2. Найдите сервисы и их условия оплаты за вызов»curl -sS https://api.live.nevermined.app/.well-known/ard.json \ | jq -r '.entries[] | [.displayName, .["nvm:catalog"].protocol, .["nvm:catalog"].priceLabel, .["nvm:catalog"].network] | @tsv'Поле nvm:catalog каждой записи содержит платёжный протокол protocol (x402 / mpp), цену за вызов priceLabel, сеть расчётов network, вызываемый адрес targetUrl и цены для отдельных конечных точек - всё, что нужно агенту, чтобы до вызова решить, платить ли и как.
3. Получите условия x402 агента, размещённого в Nevermined, для предварительной подписи
Заголовок раздела «3. Получите условия x402 агента, размещённого в Nevermined, для предварительной подписи»Агенты, размещённые в Nevermined, публикуются по организациям, и у каждого платного тарифа в nvm:payment есть блок x402 accepts, который клиент может заранее подписать для блокчейна этого тарифа:
curl -sS https://api.live.nevermined.app/api/v1/organizations/<orgId>/ai-catalog.json \ | jq '.entries[0]["nvm:payment"].plans[0].accepts[0]'4. Проверьте идентичность издателя
Заголовок раздела «4. Проверьте идентичность издателя»curl -sS https://api.live.nevermined.app/.well-known/ard.json | jq '{host, trust: .entries[0].trustManifest}'Проверка соответствия
Заголовок раздела «Проверка соответствия»git clone https://github.com/ards-project/ard-specpip install jsonschemaard-spec/conformance/bin/conformance-test manifest https://api.live.nevermined.app/.well-known/ard.jsonAgentic Resource Registry
Заголовок раздела «Agentic Resource Registry»Agentic Resource Registry - это реестр и платформа наблюдаемости для агентных ресурсов с открытым исходным кодом (Apache-2.0), рассчитанные на самостоятельное размещение. Это основная система учёта (system of record) агентных ресурсов организации - агентов, MCP-серверов, навыков (Skills), перехватчиков (hooks), подсказок (prompts) и песочниц (sandboxes). В комплект входят CLI и встроенный навык, которые работают в девяти агентных средах (harnesses) для программирования (Claude Code, Kiro, Cursor, Pi, Copilot, Codex, OpenCode, Antigravity и Goose). Реестр реализует обе роли ARD v0.91 - издателя (Publisher) и реестра (Registry) - как проекцию поверх собственного реестра: существующие записи остаются главным источником для установки, проверки и владения, а ARD открывает их для обнаружения. Полное описание - в docs/adr/0001-agentic-resource-discovery.md.
Издатель: получение манифеста каталога
Заголовок раздела «Издатель: получение манифеста каталога»Роль издателя (Publisher) формирует соответствующий спецификации /.well-known/ard.json (он также отдаётся по прежнему пути /.well-known/ai-catalog.json), где перечислены публичные одобренные записи. Каждая запись несёт постоянный URN, привязанный к домену (urn:air:<deployment-domain>:<kind>:<uuid>), тип содержимого (media type) IANA для своего вида и trustManifest со схемой https, привязанный к домену издателя. Человекочитаемое имя namespace/slug@version сохраняется в поле obs:nativeRef, чтобы клиент мог сразу перейти к командам установки. Если реестр закрытый, манифест содержит только собственную запись реестра с типом application/ai-registry+json, которая указывает рабочий базовый адрес https://<deployment>/api/v1/ard.
# Against a self-hosted instancecurl -sS https://your-registry.example.com/.well-known/ard.json \ | jq '.entries | length'Реестр: поиск и просмотр
Заголовок раздела «Реестр: поиск и просмотр»Роль реестра (Registry) предоставляет контракт ARD по пути /api/v1/ard: POST /search (обязательно) и GET /agents (детерминированный просмотр), а POST /explore зарезервирован для фасетов. Доступ ограничен существующими правилами видимости реестра: анонимные вызывающие стороны видят только публичные одобренные записи, и только если в развёртывании включён публичный реестр; вошедшие пользователи видят ровно то, что им разрешила бы установка, включая собственные записи, ожидающие проверки.
# Semantic search across Agents and all five component typescurl -sS -X POST https://your-registry.example.com/api/v1/ard/search \ -H "Authorization: Bearer $TOKEN" \ -H "content-type: application/json" \ -d '{"query":{"text":"review a pull request"},"pageSize":5}' \ | jq -r '.results[] | "\(.displayName)\t\(.score)"'
# Browse just the MCP servers in the indexcurl -sS -G "https://your-registry.example.com/api/v1/ard/agents" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "filter=type = 'application/mcp-server-card+json'" \ --data-urlencode "pageSize=5" \ | jq -r '.items[].displayName'score - это только семантическая релевантность (0-100). Признаки управления, которые реестр уже отслеживает, - статус одобрения, доверие, доступность и поддерживаемые агентные среды - возвращаются отдельными именованными полями (obs:approval, obs:trust, obs:availability, obs:supportedHarnesses), а не смешиваются с оценкой. Федерация ограничена списком разрешённых реестров, который ведёт администратор, и выбирается для каждого запроса (none / auto / referrals), поэтому текст внутренних поисковых запросов не покидает развёртывание, пока вышестоящий реестр явно не разрешён. Соответствие проверяется в CI набором тестов на соответствие этого проекта, закреплённым на реализованном коммите спецификации.
Русский перевод Agentic Resource Discovery. Оригинал - agenticresourcediscovery.org.