# Понятия

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

> Страница сайта A2A Docs — неофициального перевода документации протокола Agent2Agent (https://a2adocs.ru/concepts/). Тип: Перевод. Основа: Спецификация, раздел 2.2 (https://a2a-protocol.org/latest/specification/#22-core-concepts). Версия спецификации 1.0, сверено 05.10.2026.

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

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

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

> **Заметка переводчика.** В оригинале роли сообщения записаны как `user` и `agent`. В версии 1.0 в самом протоколе они передаются значениями `ROLE_USER` и `ROLE_AGENT`.

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

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

1. **Знакомство.** Клиент читает Agent Card удалённого агента: кто это, что он умеет, как подключиться и как аутентифицироваться.
2. **Запрос.** Клиент отправляет сообщение. Оно состоит из частей: текста, файлов или структурированных данных.
3. **Работа.** Если работа не мгновенная, агент оформляет задачу со статусом. За ходом можно следить опросом, потоком событий или получать push-уведомления.
4. **Результат.** Итог работы приходит как артефакт, а задача переходит в конечное состояние.

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

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

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

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

- [Agent Card](https://a2adocs.ru/concepts/agent-card/): как агент рассказывает о себе.
- [Задача](https://a2adocs.ru/concepts/task/): поля, состояния, идентификаторы.
- [Сообщение и часть](https://a2adocs.ru/concepts/message-and-part/): из чего состоит обмен.
- [Артефакт](https://a2adocs.ru/concepts/artifact/): как приходит результат.