# AGENTS.md — a2aregistry.ru

Инструкция для ИИ-агентов, работающих с реестром российских ИИ-агентов.

## Что здесь

Открытый реестр: кто есть кто среди ИИ-агентов российских компаний. Каждая запись — владелец, паспорт ИИ-агента (формат 0.1, валидатор на паспорт-агента.рф), карточка A2A (если опубликована), адрес обращения, статус ежедневной проверки. Реестр не оценивает качество агентов.

## Как пользоваться

1. Поиск: `GET https://a2aregistry.ru/api/v1/agents?skill=verify&industry=it&q=текст` — JSON, поля описаны в OpenAPI.
2. Карточка: `GET https://a2aregistry.ru/api/v1/agents/{slug}.json`.
3. Проверка по адресу: `GET https://a2aregistry.ru/api/v1/verify?url=example.ru` — отвечает ли адрес, валидна ли карточка A2A, есть ли паспорт, совпадают ли владелец в карточке и в паспорте. Лимит 10 проверок в минуту с адреса.
4. Статистика: `GET https://a2aregistry.ru/api/v1/stats`.
5. Все записи одним файлом: `https://a2aregistry.ru/api/v1/agents.json`.

Лимит API — 60 запросов в минуту с одного адреса; ключ не нужен; CORS открыт для чтения. OpenAPI: https://a2aregistry.ru/openapi.json. Markdown-версия любой страницы: `?format=md` или `Accept: text/markdown`.

## Поля статуса

- `status`: active — подтверждён владельцем и адрес отвечает; unconfirmed — запись по открытым данным, владелец не подтверждал; offline — адрес не отвечает три проверки подряд; revoked — снята.
- `passport.status`: none / published / confirmed / unconfirmed / suspended / revoked / invalid.
- `card.status`: none / valid / invalid / offline.
- `operator_robot: true` — робот оператора реестра (ООО «САРМАТЕХ»), образец формата; в счётчик внешних паспортов не входит.

## Как добавить агента

Опубликуйте паспорт ИИ-агента по адресу `/.well-known/agent-passport.json` (выпуск бесплатный: https://xn----7sbbaom0ddhbmjqf.xn--p1ai/vypusk/), при желании — карточку A2A по адресу `/.well-known/agent-card.json`, затем подайте заявку: https://a2aregistry.ru/dobavit/. Код подтверждения уходит на почту из паспорта или на admin@/info@ домена.

## Робот реестра

User-Agent `A2ARegistryBot/1.0 (+https://a2aregistry.ru/stop/)`. Обращается только к адресам из заявок и записей: паспорт, карточка, адрес обращения. Остановка: https://a2aregistry.ru/stop/. Паспорт робота: https://a2aregistry.ru/.well-known/agent-passport.json.

## Лицензия

Данные — CC BY 4.0, ссылка на a2aregistry.ru обязательна.