A2UI magyarázata: Mit tesz (és nem) az Agent-to-UI Protokoll
A A2UI egy deklaratív JSON protokoll, amely lehetővé teszi az AI-ügynökök számára, hogy interfészeket írjanak le a kliens számára. Hogyan működik, mely megjelenítők léteznek, és mit nem.
Core Takeaway
A A2UI (Agent to UI) a Google által létrehozott nyílt, deklaratív JSON protokoll. Az AI-ügynök elküldi az interfész leírását, az ügyfél pedig a saját natív összetevőivel jeleníti meg azt ahelyett, hogy az ügynöktől származó kódot hajtana végre. Ez egy módja annak, hogy a felhasználói felület struktúráját és adatait áthelyezze egy megbízhatósági határon, nem pedig animációs rendszeren, komponenskönyvtáron vagy kész megjelenítőn. A ExodeUI nem A2UI megjelenítő, és nem áll kapcsolatban a Google-lal.
Mi az a A2UI?
A A2UI egy protokoll ügynökvezérelt interfészek számára. Ahelyett, hogy szöveges falat küldene vissza vagy generált kódot hajtana végre, az AI-ügynök JSON üzenetfolyamot küld, amely leírja a felhasználói felületet: melyik felületet kell létrehozni, mely összetevőket tartalmaz, és milyen adatok töltik ki azokat. Az ügyfél megkapja ezeket az üzeneteket, és az eredményt olyan összetevőkkel jeleníti meg, amelyekben már megbízik. A A2UI-et a Google hozta létre, és Apache 2.0 licenccel rendelkezik, a CopilotKit és a nyílt forráskódú közösség közreműködésével. 2026 októberétől a jelenlegi éles specifikáció a v0.9.1 volt, a v1.0 pedig a kiadás jelöltje volt.
A probléma, amelyet a A2UI próbál megoldani
Az ügynökök jók abban, hogy hasznos választ adjanak, és rosszul kommunikálnak interfészként. A szöveges válasz nem tartalmazhat összehasonlító táblázatot, megrendelőlapot vagy irányítópultot. Tetszőleges HTML vagy JavaScript generálása megoldja a prezentációs problémát, és létrehoz egy biztonsági problémát, mivel a kliens most olyan kódot futtat, amelyet nem írt. A A2UI egy harmadik utat választ: az ügynök korlátozott formátumban írja le a felhasználói felületet, és az ügyfél dönti el, hogyan jelenítse meg. Az ügynök csak az ügyfél által jóváhagyott összetevőket használhatja, és a kimenet inkább adat, mint végrehajtható kód.
Hogyan épül fel a A2UI felület
A protokoll üzenettípusok kis csoportját használja. A pontos séma változatonként változik, ezért a megvalósítás előtt ellenőrizze a specifikációt, de az alakzat stabil.
- createSurface: utasítja a megjelenítőt, hogy hozzon létre egy új felületet, amely az interfész azon része, amelyet az ügynök frissíthet
- updateComponents: hozzáadja vagy módosítja az összetevődefiníciókat az adott felületen
- updateDataModel: megváltoztatja az összetevők által megjelenített adatokat a struktúra újraküldése nélkül
- deleteSurface: eltávolítja a felületet, amikor már nincs rá szükség
Renderelők és szállítók
A A2UI szállítás-agnosztikus. A specifikáció az üzeneteket írja le, nem pedig azt, hogyan továbbítják őket. A projekt felsorolja a Angular, Flutter, Lit, React és Markdown renderelő implementációit, valamint az AG-UI, A2A és MCP szállítási összerendeléseit, a WebSockets, SSE és REST is használható. Ez a rugalmasság a lényeg: ugyanazt az ügynöki választ előállíthatja egy webes kliens, egy mobilalkalmazás vagy egy asztali alkalmazás, amelyek mindegyike saját tervezési rendszert használ.
Amit a A2UI nem csinál
A A2UI könnyen túlolvasható. Nem szállít olyan komponenskönyvtárat, amelyet egy alkalmazásba dobhat, és önmagában sem jelenít meg semmit: szüksége van egy megjelenítőre és egy komponenskatalógusra, amelyet az ügyfél vezérel. Nem dönti el, hogy a felhasználói felület hogyan mozog. Nem helyettesíti a MCP-et, amely az eszközöket és az adatokat egy modellnek teszi ki, vagy az AG-UI-t, amely az ügynök és a frontend közötti interakciós eseményeket hordozza. És nem szünteti meg a mérnöki felülvizsgálat szükségességét: a generált interfészeknek továbbra is kezelniük kell a betöltési, üres- és hibaállapotokat, engedélyeket és hozzáférhetőséget.
A2UI vs AG-UI vs MCP
Ezt a hármat gyakran együtt emlegetik, mert ugyanazon probléma különböző rétegeit oldják meg. Hasznos rövidítés: A A2UI leírja az interfészt, az AG-UI az interakciót, a MCP pedig az ügynök eszközöket és adatokat. A A2UI saját dokumentációja az AG-UI-t a A2UI szállítási összerendeléseként írja le, és a A2UI a MCP-en is utazhat. Ezek egymást kiegészítő, nem versengő szabványok. Ha integrációt választ, akkor abból induljon ki, hogy a kliense mit tud renderelni, és melyik szállítást támogatja már, ne a legnagyobb lendületű protokollból.
Ahol az animáció és az interakció megfér
A A2UI struktúrát és adatokat ír le. A mozgás az ügyfél gondja: a megjelenítő dönti el, hogy egy felület azonnal megjelenik-e, elhalványul-e vagy átáll-e egy korábbi állapotból. Ez jó hír a termékcsapatok számára, mert az animációs rendszert a kliensben tartja, ahol tiszteletben tudja tartani a tervezési rendszert és az akadálymentesítési beállításokat. Ez azt is jelenti, hogy a A2UI megvalósítás nem animálódik automatikusan. Ha egy generált felületen gombnyomásra, állapotváltásra vagy kabalareakcióra van szüksége, akkor ezt a viselkedést a kliensnek kell biztosítania. A ExodeUI interaktív mozgást tud lejátszani egy kliensben, és rendelkezik egy MCP szerverrel az AI kódolóeszközökhöz, de ez nem egy A2UI renderer, és nem így kell leírni.
Gyártási megvalósítási részlet
// 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" } }Kulcs Principle, amit meg kell jegyezni
- A A2UI egy JSON protokoll ügynök által leírt interfészekhez, amelyet a Google hozott létre, és az Apache 2.0 licenc alatt van.
- A kliens saját komponenseivel renderel; az ügynök nem hajt végre tetszőleges felhasználói felület kódot
- Meghatározza az üzeneteket, és a renderelőt, a szállítást és a mozgást a kliensre bízza
- Ez nem egy animációs rendszer vagy egy beugró komponenskönyvtár
- A ExodeUI nem A2UI megjelenítő, és nem áll kapcsolatban a Google-lal