О проекте

A2A Docs — русскоязычный справочный сайт по протоколу Agent2Agent. Он содержит перевод и пересказ официальной документации, а со временем и авторские разборы. Сайт неофициальный.

Статус#

Сайт не является официальным ресурсом проекта A2A. Оригинал документации находится на a2a-protocol.org.
Основа перевода — версия спецификации 1.0.0. Дата последней сверки указана в шапке каждой страницы.
Если перевод и оригинал расходятся, верен оригинал.
Нормативным определением структур данных считается файл a2a.proto, а не текст сайта.

Как отмечены страницы#

В шапке каждой страницы стоит отметка о том, чем она является.

Отметка	Что это
Перевод	Близкий к тексту перевод раздела оригинала. Таблицы и перечни сохранены.
Перевод и пересказ	Часть материала переведена близко к тексту, часть пересказана и собрана из нескольких мест оригинала.
Авторский разбор	Текст, написанный нами на основе документации. Такие страницы будут отмечены отдельно.
Справочник	Сводные сведения со ссылками на источники.
Раздел готовится	Страница-заглушка: перевода ещё нет. Такие страницы закрыты от индексации.

Рядом с отметкой указан раздел оригинала, на котором основана страница.

Принципы перевода#

Нормативные слова в стиле RFC 2119 передаются так: MUST — ДОЛЖЕН, MUST NOT — НЕ ДОЛЖЕН, SHOULD — СЛЕДУЕТ, SHOULD NOT — НЕ СЛЕДУЕТ, MAY — МОЖЕТ. В тексте сайта они выделены заглавными буквами.
Имена полей, методов, ошибок, значений перечислений и заголовков остаются как в оригинале и набираются моноширинным шрифтом.
Термины берутся из глоссария a2aprotocol.ru и при первом появлении даются с оригинальным названием: «задача (Task)», «артефакт (Artifact)», «навык (Skill)». Объект Agent Card в заголовках, таблицах и коде пишется по-английски, как в спецификации, а в тексте допустима форма «карточка агента», принятая в глоссарии.
Заметки переводчика на полях отмечают места, где перевод неоднозначен или где внутри оригинала есть расхождения.
Примеры кода берутся из оригинала. Если мы составляем пример сами, это сказано рядом.

Лицензия и авторство#

Документация и спецификация проекта A2A распространяются на условиях лицензии Apache License 2.0 (Copyright The Linux Foundation). Проект A2A передан Linux Foundation компанией Google. Материалы этого сайта — производная работа от оригинальной документации.

Лицензия: Apache License, Version 2.0.
Оригинальный проект: github.com/a2aproject/A2A.
Внесённые изменения: перевод на русский язык; сокращение, пересказ и перегруппировка материала; добавление пояснений и заметок переводчика; оформление.
Название A2A и знаки принадлежат их правообладателям. Сайт не использует логотипы проекта и не выдаёт себя за официальный.

Связанный сайт#

Справочник a2aprotocol.ru отвечает на вопросы «что это» и «как называется»: определения, терминология, сравнение с MCP, A2A в коммерции, хронология стандарта. Здесь, на A2A Docs, разбирается устройство протокола: поля, методы, ошибки, миграция. Сайты ведёт один владелец. Определения терминов лучше цитировать по справочнику, а описание полей и операций по этому сайту.

Сообщить об ошибке#

Нашли неточность в переводе или устаревшее место? Напишите на info@a2adocs.ru. Укажите адрес страницы и фрагмент: так мы быстрее проверим его по оригиналу.

Кто ведёт сайт#

Справочный сайт. Владелец: ООО «САРМАТЕХ», ИНН 4725011864.

Машиночитаемые версии#

Каждая страница сайта доступна и в виде Markdown: добавьте к адресу страницы index.md или нажмите «Открыть .md» в шапке страницы. Весь сайт одним файлом: llms-full.txt. Список страниц для ИИ-агентов: llms.txt.