Пояснення A2UI: що робить (і чого не робить) протокол Agent-to-UI
A2UI — це декларативний протокол JSON, який дозволяє агентам штучного інтелекту описувати інтерфейси для відтворення клієнтом. Як це працює, які рендерери існують і чого вони не роблять.
Основний винос
A2UI (Agent to UI) — це відкритий декларативний протокол JSON, створений Google. Агент штучного інтелекту надсилає опис інтерфейсу, а клієнт рендерить його за допомогою власних компонентів замість виконання коду агента. Це спосіб перемістити структуру інтерфейсу користувача та дані через кордон довіри, а не систему анімації, бібліотеку компонентів чи готовий рендерер. ExodeUI не є рендерером A2UI і не пов’язаний з Google.
Що таке A2UI?
A2UI — це протокол для керованих агентами інтерфейсів. Замість того, щоб повертати стіну тексту чи виконувати згенерований код, агент ШІ надсилає потік повідомлень JSON, які описують інтерфейс користувача: яку поверхню створити, які компоненти він містить і які дані їх заповнюють. Клієнт отримує ці повідомлення та відображає результат із компонентами, яким він уже довіряє. A2UI був створений Google і має ліцензію Apache 2.0 за участі CopilotKit і спільноти з відкритим кодом. Станом на жовтень 2026 року поточна робоча специфікація була v0.9.1, а v1.0 була кандидатом на випуск.
Проблему, яку намагається вирішити A2UI
Агенти добре створюють корисну відповідь і погано передають її як інтерфейс. Текстова відповідь не може відображати порівняльну таблицю, форму замовлення чи інформаційну панель. Створення довільних HTML або JavaScript вирішує проблему презентації та створює проблему безпеки, оскільки клієнт зараз виконує код, який він не написав. A2UI вибирає третій шлях: агент описує інтерфейс користувача в обмеженому форматі, а клієнт вирішує, як його відобразити. Агент може використовувати лише компоненти, схвалені клієнтом, а виводом є дані, а не виконуваний код.
Як будується поверхня A2UI
Протокол використовує невеликий набір типів повідомлень. Точна схема змінюється між версіями, тому перевірте специфікацію перед впровадженням, але форма стабільна.
- createSurface: повідомляє рендереру створити нову поверхню, яка є областю інтерфейсу, яку агент може оновити
- updateComponents: додає або змінює визначення компонентів на цій поверхні
- updateDataModel: змінює дані, які відображають компоненти, без повторного надсилання структури
- deleteSurface: видаляє поверхню, коли вона більше не потрібна
Рендерери та транспорти
A2UI не залежить від транспорту. Специфікація описує повідомлення, а не те, як вони передаються. У проекті перераховано реалізації засобів візуалізації для Angular, Flutter, Lit, React і Markdown, а також транспортні прив’язки для AG-UI, A2A і MCP, а також доступні WebSockets, SSE і REST. Саме гнучкість полягає в тому, що одна й та сама відповідь агента може бути відтворена веб-клієнтом, мобільною програмою або програмою для настільного комп’ютера, кожна з яких використовує власну систему дизайну.
Чого не робить A2UI
A2UI легко перечитати. Він не доставляє бібліотеку компонентів, яку можна вставити в програму, і сам нічого не рендерить: вам потрібен рендерер і каталог компонентів, якими керує клієнт. Він не вирішує, як рухатиметься інтерфейс користувача. Він не замінює MCP, який надає інструменти та дані моделі, або AG-UI, який передає події взаємодії між агентом і інтерфейсом. І це не скасовує потреби в інженерній перевірці: згенеровані інтерфейси все ще повинні обробляти завантаження, порожні та помилкові стани, дозволи та доступність.
A2UI проти AG-UI проти MCP
Ці три часто згадуються разом, оскільки вони вирішують різні рівні однієї проблеми. Корисна скорочення: A2UI описує інтерфейс, AG-UI забезпечує взаємодію, а MCP надає агенту інструменти та дані. Власна документація A2UI описує AG-UI як транспортне прив’язування для A2UI, а A2UI також може подорожувати через MCP. Вони є взаємодоповнюючими, а не конкуруючими стандартами. Якщо ви обираєте інтеграцію, виходьте з того, що ваш клієнт може відтворити та який транспорт він уже підтримує, а не з протоколу, який має найбільше значення.
Де підходять анімація та взаємодія
A2UI описує структуру та дані. Рух — це питання клієнта: рендерер вирішує, чи з’являється поверхня миттєво, зникає чи переходить із попереднього стану. Це хороша новина для команд, які працюють над продуктами, оскільки вона зберігає систему анімації в клієнті, де вона може поважати систему дизайну та налаштування доступності. Це також означає, що реалізація A2UI не анімується автоматично. Якщо згенерований інтерфейс потребує натискання кнопки, зміни стану або реакції талісмана, клієнт повинен забезпечити таку поведінку. ExodeUI може відтворювати інтерактивний рух у клієнті та має сервер MCP для інструментів кодування штучного інтелекту, але він не є рендерером A2UI і не повинен називатися таким.
Фрагмент впровадження виробництва
// Simplified shape of an A2UI message stream (schema differs by version).
{ "createSurface": { "surfaceId": "cart" } }
{ "updateComponents": { "surfaceId": "cart", "components": [ /* ... */ ] } }
{ "updateDataModel": { "surfaceId": "cart", "data": { /* ... */ } } }
{ "deleteSurface": { "surfaceId": "cart" } }Ключі Principle, які слід запам’ятати
- A2UI — це протокол JSON для описаних агентами інтерфейсів, створений Google і ліцензований під Apache 2.0
- Клієнт рендерить своїми компонентами; агент не виконує довільний код інтерфейсу користувача
- Він визначає повідомлення та залишає клієнту рендерер, транспорт і рух
- Це не система анімації чи бібліотека компонентів, що вставляються
- ExodeUI не є рендерером A2UI і не пов’язаний з Google