A2A Docs спецификация 1.0.0

Начало / Понятия

Понятия

Основные объекты и роли протокола

ПереводОснова: Спецификация, раздел 2.2Сверено 05.10.2026, версия 1.0.0Открыть .md

A2A строится вокруг нескольких ключевых понятий. Ниже они перечислены так, как определены в разделе 2.2 спецификации; отдельные страницы разбирают главные объекты подробно. Краткие определения и рекомендации по переводу терминов — в глоссарии a2aprotocol.ru.

Словарь понятий#

Понятие Что это
A2A-клиент (A2A Client) Приложение или агент, который обращается к A2A-серверу от имени пользователя или другой системы.
A2A-сервер, удалённый агент (A2A Server) Агент или система агентов, которая открывает совместимую с A2A точку входа, обрабатывает задачи и отдаёт ответы.
Agent Card JSON-документ, который публикует A2A-сервер. Описывает его идентичность, возможности, навыки, адрес сервиса и требования к аутентификации.
Сообщение (Message) Реплика в обмене между клиентом и удалённым агентом. Имеет роль (user или agent) и содержит одну или несколько частей.
Задача (Task) Основная единица работы в A2A с уникальным идентификатором. Задачи хранят состояние и проходят заданный жизненный цикл.
Часть (Part) Наименьшая единица содержимого сообщения или артефакта. Может содержать текст, ссылки на файлы или структурированные данные.
Артефакт (Artifact) Результат, созданный агентом при выполнении задачи: документ, изображение, структурированные данные. Состоит из частей.
Потоковая передача (Streaming) Обновления задачи в реальном времени: изменения статуса и фрагменты артефактов, которые приходят механизмом конкретной привязки.
Push-уведомления Асинхронные обновления задачи: сервер сам отправляет HTTP POST на адрес вебхука, указанный клиентом. Для долгих задач и отключённых клиентов.
Контекст (Context) Необязательный идентификатор, который логически объединяет связанные задачи и сообщения.
Расширение (Extension) Механизм, позволяющий агентам предоставлять дополнительные функции или данные сверх базовой спецификации.

Как это работает вместе#

Типичный обмен состоит из четырёх шагов.

  1. Знакомство. A2A-клиент. Приложение или агент, который обращается к A2A-серверу от имени пользователя или другой системы. В глоссарии читает Agent Card (карточка агента). JSON-документ, который публикует A2A-сервер. Описывает агента: кто он, что умеет, где находится, как к нему подключиться и аутентифицироваться. В глоссарии удалённого агента: кто это, что он умеет, как подключиться и как аутентифицироваться.
  2. Запрос. Клиент отправляет Сообщение (Message). Одна реплика в обмене между клиентом и удалённым агентом. Имеет роль (пользователь или агент) и состоит из одной или нескольких частей. В глоссарии. Оно состоит из Часть (Part). Наименьшая единица содержимого в сообщении или артефакте: текст, файл (по ссылке или в байтах) либо структурированные данные. В глоссарии: текста, файлов или структурированных данных.
  3. Работа. Если работа не мгновенная, агент оформляет Задача (Task). Основная единица работы в A2A. Принята агентом, имеет уникальный идентификатор и статус и проходит через определённые состояния. В глоссарии со статусом. За ходом можно следить опросом, Потоковая передача (Streaming). Получение обновлений задачи по мере появления: изменения статуса и фрагменты артефактов приходят по потоку, например Server-Sent Events. В глоссарии или получать Push-уведомления. Асинхронные обновления задачи: сервер сам отправляет HTTP POST на адрес вебхука, который указал клиент. Подходят для долгих задач и отключённых клиентов. В глоссарии.
  4. Результат. Итог работы приходит как Артефакт (Artifact). Результат работы агента над задачей: документ, изображение, структурированные данные. Состоит из частей. В глоссарии, а задача переходит в конечное состояние.

Агент может ответить и сразу сообщением, без создания задачи: так устроены простые взаимодействия.

Три способа получать обновления#

Для долгих задач в A2A есть три взаимодополняющих механизма: опрос (запрос состояния задачи), потоковая передача и push-уведомления. Их сравнение и требования к Agent Card описаны на странице «Обновления задач».

Что читать дальше#