Паспорт протокола#
| Характеристика | Значение |
|---|---|
| Полное название | Agent2Agent (A2A) Protocol |
| Действующая версия | 1.0 (1.0.0 выпущена 12 марта 2026) |
| Последний патч-релиз | 1.0.1 от 26 мая 2026: исправления текста спецификации (медиатип application/a2a+json в HTTP-привязке, ошибки при транскодировании, значения статуса задачи). Версия протокола по Major.Minor осталась 1.0 |
| Предыдущие версии | 0.3.0, 0.2.6, 0.1.0 |
| Управление | Agentic AI Foundation, Linux Foundation |
| Лицензия | Apache 2.0 |
| Нормативный источник | Файл spec/a2a.proto в репозитории проекта |
| Привязки протокола | JSON-RPC 2.0, gRPC, HTTP+JSON (REST); допускаются собственные привязки |
| Потоковая передача | Server-Sent Events для JSON-RPC и HTTP+JSON, потоковые вызовы gRPC |
| Обнаружение агента | /.well-known/agent-card.json, реестры, прямая настройка |
| Медиатип | application/a2a+json |
| Служебные параметры | A2A-Version, A2A-Extensions |
| Аутентификация | API-ключ, HTTP-аутентификация, OAuth 2.0, OpenID Connect, взаимный TLS |
| Подпись карточки | JWS (RFC 7515) над JSON, канонизированным по RFC 8785 |
| Формат ошибок | google.rpc.Status с ErrorInfo, домен a2a-protocol.org |
| Официальные SDK | Python, Go, JavaScript, Java, .NET, Rust |
| Подробная документация на русском | a2adocs.ru |
Три уровня спецификации#
Спецификация разделена на три уровня, и это главное, что нужно понять перед чтением:
- Модель данных. Задача, сообщение, часть, артефакт, карточка агента и другие объекты. Описаны один раз, независимо от способа передачи.
- Абстрактные операции. Что можно сделать: отправить сообщение, получить задачу, отменить, подписаться на обновления.
- Привязки протокола. Как операции выглядят на проводе в JSON-RPC, gRPC и HTTP+JSON. Все три привязки обязаны быть функционально равнозначными — см. привязка протокола.
Благодаря этому одна и та же задача может прийти к агенту по разным привязкам, а новые привязки добавляются без изменения модели данных.
Операции#
Спецификация определяет одиннадцать операций в четырёх группах: отправка сообщений (SendMessage, SendStreamingMessage), работа с задачами (GetTask, ListTasks, CancelTask, SubscribeToTask), настройка push-уведомлений (четыре операции: создание, чтение, список, удаление) и расширенная карточка (GetExtendedAgentCard). ListTasks появилась в версии 1.0.
Параметры, ответы, ошибки и поведение каждой операции — в таблице методов на a2adocs.ru.
Пример запроса в привязке JSON-RPC. Клиент передаёт версию протокола в заголовке A2A-Version: 1.0.
{
"jsonrpc": "2.0",
"id": 1,
"method": "SendMessage",
"params": {
"message": {
"messageId": "9b6f3a2e-5c1d-4e8a-9f0b-7d2c1a4e6b35",
"role": "ROLE_USER",
"parts": [
{
"text": "Подбери стеллаж для склада высотой 2 м, бюджет до 30 000 ₽"
}
]
},
"configuration": {
"acceptedOutputModes": [
"application/json"
],
"returnImmediately": false
}
}
}По умолчанию операция ждёт, пока задача дойдёт до конечного или прерванного состояния. С returnImmediately: true сервер сразу возвращает задачу в работе, а обновления клиент получает опросом, потоком или push-уведомлениями.
Жизненный цикл задачи#

- Рабочие:
TASK_STATE_SUBMITTED— задача принята,TASK_STATE_WORKING— выполняется. - Прерванные:
TASK_STATE_INPUT_REQUIRED— агенту нужны данные от клиента,TASK_STATE_AUTH_REQUIRED— нужна аутентификация. - Конечные:
TASK_STATE_COMPLETED,TASK_STATE_FAILED,TASK_STATE_CANCELED,TASK_STATE_REJECTED. После них задача сообщений не принимает.
Результаты работы передаются артефактами, а не сообщениями. Сообщения служат для постановки задачи, уточнений и статусов, и спецификация прямо предупреждает: полагаться на них как на надёжный канал доставки важных данных нельзя.
Поля задачи, правила идентификаторов и многоходовые взаимодействия — на странице «Задача» a2adocs.ru.
Доставка обновлений#
Клиент узнаёт о ходе задачи одним из трёх способов:
- Опрос через
GetTask. Прост, работает везде, но с задержкой. - Потоковая передача через
SendStreamingMessageилиSubscribeToTask. Требуетcapabilities.streaming. События приходят строго по порядку, к одной задаче можно подключить несколько потоков. - Push-уведомления на вебхук клиента. Требуют
capabilities.pushNotifications. Подходят для задач, которые идут часами.
Порядок событий, несколько потоков одной задачи и формат push-уведомлений — на странице «Обновления задач» a2adocs.ru.
Ошибки#
Спецификация определяет девять ошибок, специфичных для A2A, например TaskNotFoundError, UnsupportedOperationError, VersionNotSupportedError, и общие категории: аутентификация, авторизация, валидация, ресурсы, системные сбои. В версии 1.0 ошибки передаются в формате google.rpc.Status с ErrorInfo.
Спецификация требует не различать «не существует» и «нет доступа»: агент не должен раскрывать существование чужих задач.
Полная таблица ошибок с примерами ответов — на странице «Ошибки» a2adocs.ru.
Что изменилось в 1.0#
Версия 1.0 несовместима с 0.3 на уровне формата. Если вы читаете статью или код, где встречаются message/send, kind: "text" или TextPart, — это материал о прошлой версии.
Главное: переименованы операции, три типа частей объединены в один, значения перечислений записываются с префиксом, адреса подключения собраны в supportedInterfaces, версия протокола передаётся заголовком A2A-Version, изменены ошибки и OAuth 2.0.
Подробный разбор с примерами «было — стало» и порядком обновления — на странице «Миграция с 0.3 на 1.0» a2adocs.ru.