Начало / Справочник
Справочник
Версии спецификации, SDK и нормативные источники
Здесь собраны сведения, к которым удобно возвращаться: какие бывают версии спецификации, где взять SDK и что считается нормативным источником.
Версии спецификации#
Последняя выпущенная версия — 1.0.0. У каждой версии на официальном сайте есть своя копия спецификации.
| Версия | Статус | Спецификация |
|---|---|---|
| 1.0.0 | Последняя выпущенная версия, основа этого сайта | a2a-protocol.org/v1.0.0/specification |
| 0.3.0 | Предыдущая версия | a2a-protocol.org/v0.3.0/specification |
| 0.2.6 | Историческая | a2a-protocol.org/v0.2.6/specification |
| 0.1.0 | Историческая | a2a-protocol.org/v0.1.0/specification |
Изменения между версиями собраны в примечаниях к релизам проекта. Разбор перехода с 0.3 на 1.0: «Миграция».
Официальные SDK#
Проект поддерживает SDK для шести языков. Какие версии протокола поддерживает конкретная версия SDK, смотрите в документации самого SDK: не все библиотеки обновились до 1.0 одновременно.
| Язык | Пакет или модуль | Репозиторий |
|---|---|---|
| Python | a2a-sdk |
a2aproject/a2a-python |
| JavaScript и TypeScript | @a2a-js/sdk |
a2aproject/a2a-js |
| Java | — | a2aproject/a2a-java |
| Go | github.com/a2aproject/a2a-go |
a2aproject/a2a-go |
| C# и .NET | A2A |
a2aproject/a2a-dotnet |
| Rust | a2a-rs |
a2aproject/a2a-rs |
Кроме SDK, у проекта есть примеры реализаций с интеграциями в популярные агентные фреймворки и официальный консольный клиент a2a-cli. Пошаговый учебный пример на Python: Quickstart из восьми шагов.
Нормативные источники#
| Источник | Что это | Статус |
|---|---|---|
| Спецификация | Человекочитаемый текст протокола. | Нормативная вместе с a2a.proto |
| a2a.proto | Определение всех объектов и сообщений в Protocol Buffers. | Единственное нормативное определение данных |
| a2a.json | JSON Schema (2020-12), создаётся из proto при сборке. | Не нормативный |
| Protocol Definition | Страница с proto и схемой. | Справочная |
| llms-reference.txt | Краткая справка для агентов и людей. | Не нормативная |
Словарь терминов#
Русскоязычный словарь терминов A2A (29 терминов с английскими оригиналами и рекомендациями по переводу) ведётся на отдельном сайте: глоссарий a2aprotocol.ru. Он же доступен в машиночитаемом виде: glossary.json. Принципы перевода, принятые на этом сайте, описаны на странице «О проекте».