Vysvetlenie A2UI: Čo robí (a nerobí) protokol Agent-to-UI
A2UI je deklaratívny protokol JSON, ktorý umožňuje agentom AI opísať rozhrania pre klienta na vykreslenie. Ako to funguje, ktoré renderery existujú a čo nerobí.
Core Takeaway
A2UI (Agent to UI) je otvorený deklaratívny protokol JSON vytvorený spoločnosťou Google. Agent AI odošle popis rozhrania a klient ho vykreslí pomocou vlastných natívnych komponentov namiesto spustenia kódu z agenta. Je to spôsob, ako presunúť štruktúru používateľského rozhrania a údaje cez hranicu dôveryhodnosti, nie animačný systém, knižnicu komponentov alebo hotový renderer. ExodeUI nie je vykresľovač A2UI a nie je pridružený k spoločnosti Google.
Čo je A2UI?
A2UI je protokol pre rozhrania riadené agentmi. Namiesto vrátenia steny textu alebo vykonania vygenerovaného kódu, agent AI odošle prúd správ JSON, ktoré popisujú používateľské rozhranie: ktorý povrch vytvoriť, ktoré komponenty obsahuje a aké údaje ich naplnia. Klient dostane tieto správy a vykreslí výsledok s komponentmi, ktorým už dôveruje. A2UI bol vytvorený spoločnosťou Google a má licenciu na Apache 2.0 s príspevkami od CopilotKit a komunity s otvoreným zdrojovým kódom. Od októbra 2026 bola aktuálna produkčná špecifikácia v0.9.1 a v1.0 bola kandidátom na vydanie.
Problém, ktorý sa snaží vyriešiť A2UI
Agenti sú dobrí v produkovaní užitočnej odpovede a zlí v jej poskytovaní ako rozhranie. Textová odpoveď nemôže zobraziť porovnávaciu tabuľku, objednávkový formulár ani informačný panel. Generovanie ľubovoľného HTML alebo JavaScript rieši problém prezentácie a vytvára bezpečnostný, pretože klient teraz spúšťa kód, ktorý nenapísal. A2UI má tretiu cestu: agent popisuje používateľské rozhranie v obmedzenom formáte a klient sa rozhodne, ako ho vykreslí. Agent môže používať iba komponenty, ktoré schválil klient, a výstupom sú údaje, nie spustiteľný kód.
Ako sa vytvára povrch A2UI
Protokol používa malú skupinu typov správ. Presná schéma sa medzi verziami mení, preto pred implementáciou jednej skontrolujte špecifikáciu, ale tvar je stabilný.
- createSurface: povie vykresľovaciemu modulu, aby vytvoril nový povrch, čo je oblasť rozhrania, ktorú môže agent aktualizovať
- updateComponents: pridáva alebo mení definície komponentov na tomto povrchu
- updateDataModel: zmení údaje, ktoré komponenty zobrazujú, bez opätovného odoslania štruktúry
- deleteSurface: odstráni povrch, keď už nie je potrebný
Kafilery a transporty
A2UI je agnostický pre transport. Špecifikácia popisuje správy, nie spôsob ich prenosu. Projekt uvádza implementácie rendererov pre Angular, Flutter, Lit, React a Markdown a transportné väzby pre AG-UI, A2A a MCP, pričom sú použiteľné aj WebSockets, SSE a REST. O túto flexibilitu ide: rovnakú odozvu agenta môže vykresliť webový klient, mobilná aplikácia alebo desktopová aplikácia, pričom každý z nich používa svoj vlastný dizajnový systém.
Čo A2UI nerobí
A2UI je ľahko čitateľný. Nedodáva knižnicu komponentov, ktorú môžete vložiť do aplikácie, a sama nič nevykresľuje: potrebujete vykresľovací modul a katalóg komponentov, ktorý ovláda klient. Nerozhoduje o tom, ako sa UI pohybuje. Nenahrádza MCP, ktorý vystavuje nástroje a údaje modelu, alebo AG-UI, ktoré prenáša udalosti interakcie medzi agentom a frontendom. A neodstraňuje to potrebu technickej kontroly: generované rozhrania musia stále zvládať načítanie, prázdne a chybové stavy, povolenia a dostupnosť.
A2UI vs AG-UI vs MCP
Tieto tri sa často spomínajú spolu, pretože riešia rôzne vrstvy toho istého problému. Užitočná skratka: A2UI popisuje rozhranie, AG-UI nesie interakciu a MCP poskytuje agentovi nástroje a údaje. Vlastná dokumentácia A2UI popisuje AG-UI ako transportnú väzbu pre A2UI a A2UI môže tiež cestovať cez MCP. Sú to doplnkové, nie konkurenčné normy. Ak si vyberáte integráciu, začnite od toho, čo váš klient dokáže vykresliť a ktorý prenos už podporuje, nie od protokolu s najväčšou dynamikou.
Kde sa hodí animácia a interakcia
A2UI popisuje štruktúru a dáta. Pohyb je záležitosťou klienta: renderer rozhoduje o tom, či sa povrch objaví okamžite, zoslabne alebo prejde z predchádzajúceho stavu. To je dobrá správa pre produktové tímy, pretože ponecháva animačný systém v klientovi, kde môže rešpektovať dizajnový systém a nastavenia prístupnosti. Znamená to tiež, že implementácia A2UI nie je automaticky animovaná. Ak vygenerované rozhranie vyžaduje stlačenie tlačidla, zmenu stavu alebo reakciu maskota, klient musí zabezpečiť toto správanie. ExodeUI dokáže prehrávať interaktívny pohyb v klientovi a má server MCP pre nástroje na kódovanie AI, ale nie je to vykresľovací modul A2UI a nemal by byť ako taký opísaný.
Snippet implementácie výroby
// 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" } }Kľúč Principle na zapamätanie
- A2UI je protokol JSON pre rozhrania popísané agentmi, vytvorený spoločnosťou Google a licencovaný podľa Apache 2.0
- Klient renderuje s vlastnými komponentmi; agent nevykonáva ľubovoľný kód používateľského rozhrania
- Definuje správy a ponecháva renderer, transport a pohyb na klientovi
- Nie je to animačný systém ani knižnica komponentov
- ExodeUI nie je vykresľovač A2UI a nemá žiadne spojenie so spoločnosťou Google