A2UI Açıklaması: Aracıdan Kullanıcı Arayüzüne Protokolün Yaptığı (ve Yapmadığı) Şeyler
A2UI, AI aracılarının bir istemcinin oluşturacağı arayüzleri tanımlamasına olanak tanıyan bildirim temelli bir JSON protokolüdür. Nasıl çalışır, hangi oluşturucular mevcuttur ve ne yapmaz.
Ana nokta
A2UI (Aracıdan Kullanıcı Arayüzüne), Google tarafından oluşturulan açık, bildirime dayalı bir JSON protokolüdür. Bir AI aracısı, bir arayüzün açıklamasını gönderir ve istemci, aracıdan kod yürütmek yerine onu kendi yerel bileşenleriyle işler. Bu, bir animasyon sistemi, bir bileşen kitaplığı veya bitmiş bir oluşturucu değil, kullanıcı arayüzü yapısını ve verilerini bir güven sınırı boyunca taşımanın bir yoludur. ExodeUI bir A2UI oluşturucusu değildir ve Google'a bağlı değildir.
A2UI nedir?
A2UI aracı odaklı arayüzlere yönelik bir protokoldür. Bir AI aracısı, bir metin duvarı döndürmek veya oluşturulan kodu yürütmek yerine, bir kullanıcı arayüzünü tanımlayan bir JSON mesajları akışı gönderir: hangi yüzeyin oluşturulacağı, hangi bileşenleri içerdiği ve bunları hangi verilerin doldurduğu. İstemci bu mesajları alır ve sonucu zaten güvendiği bileşenlerle işler. A2UI, Google tarafından oluşturulmuştur ve CopilotKit ve açık kaynak topluluğunun katkılarıyla Apache 2.0 lisanslıdır. Ekim 2026 itibarıyla mevcut üretim spesifikasyonu v0.9.1'di ve v1.0, sürüm adayıydı.
A2UI'in çözmeye çalıştığı sorun
Aracılar yararlı bir yanıt üretmede iyi, ancak bunu bir arayüz olarak sunmada kötüdür. Metin yanıtında bir karşılaştırma tablosu, sipariş formu veya kontrol paneli gösterilemez. Rastgele HTML veya JavaScript oluşturmak sunum sorununu çözer ve bir güvenlik sorunu yaratır çünkü istemci artık yazmadığı kodu çalıştırıyor. A2UI üçüncü bir yol izler: Aracı, kullanıcı arayüzünü kısıtlı bir formatta tanımlar ve istemci, bunun nasıl oluşturulacağına karar verir. Aracı yalnızca müşterinin onayladığı bileşenleri kullanabilir ve çıktı, yürütülebilir kod yerine verilerdir.
A2UI yüzeyi nasıl oluşturulur?
Protokol küçük bir dizi mesaj türünü kullanır. Tam şema sürümler arasında değişir, bu nedenle birini uygulamadan önce spesifikasyonu kontrol edin, ancak şekil stabildir.
- createSurface: oluşturucuya, aracının güncelleyebileceği arayüzün bir bölgesi olan yeni bir yüzey oluşturmasını söyler
- updateComponents: o yüzeydeki bileşen tanımlarını ekler veya değiştirir
- updateDataModel: yapıyı yeniden göndermeden bileşenlerin görüntülediği verileri değiştirir
- deleteSurface: artık ihtiyaç duyulmadığında yüzeyi kaldırır
Oluşturucular ve aktarımlar
A2UI aktarımdan bağımsızdır. Spesifikasyon, mesajların nasıl seyahat ettiğini değil, mesajları açıklar. Proje, Angular, Flutter, Lit, React ve Markdown için oluşturucu uygulamalarını ve WebSockets, SSE ve REST ile birlikte AG-UI, A2A ve MCP için taşıma bağlamalarını listeliyor. Önemli olan bu esnekliktir: Aynı temsilci yanıtı, her biri kendi tasarım sistemini kullanan bir web istemcisi, bir mobil uygulama veya bir masaüstü uygulaması tarafından oluşturulabilir.
A2UI ne yapmaz
A2UI'in aşırı okunması kolaydır. Bir uygulamaya bırakabileceğiniz bir bileşen kitaplığı göndermez ve kendi başına hiçbir şey oluşturmaz: bir oluşturucuya ve istemcinin kontrol ettiği bir bileşen kataloğuna ihtiyacınız vardır. Kullanıcı arayüzünün nasıl hareket edeceğine karar vermez. Araçları ve verileri bir modele sunan MCP'in veya bir aracı ile ön uç arasındaki etkileşim olaylarını taşıyan AG-UI'nin yerini almaz. Ve mühendislik incelemesi ihtiyacını ortadan kaldırmaz: oluşturulan arayüzlerin hâlâ yükleme, boş ve hata durumlarını, izinleri ve erişilebilirliği yönetmesi gerekir.
A2UI vs AG-UI vs MCP
Bu üçü sıklıkla birlikte anılır çünkü aynı problemin farklı katmanlarını çözerler. Yararlı bir kısa yol: A2UI arayüzü tanımlar, AG-UI etkileşimi taşır ve MCP aracı araçları ve verileri sağlar. A2UI'in kendi belgeleri AG-UI'yi A2UI için bir aktarım bağlaması olarak tanımlar ve A2UI ayrıca MCP üzerinden de seyahat edebilir. Bunlar birbirini tamamlayan standartlardır, rakip standartlar değil. Bir entegrasyon seçiyorsanız, en fazla momentuma sahip protokolden değil, istemcinizin neyi oluşturabildiğinden ve halihazırda hangi aktarımı desteklediğinden başlayın.
Animasyon ve etkileşimin uygun olduğu yer
A2UI yapıyı ve verileri açıklar. Hareket müşteriyi ilgilendiren bir konudur: Oluşturucu, bir yüzeyin anında görünüp görünmeyeceğine, yavaş yavaş kaybolup kaybolmayacağına veya önceki bir durumdan geçiş yapıp yapmadığına karar verir. Bu, ürün ekipleri için iyi bir haber çünkü animasyon sistemini, tasarım sistemine ve erişilebilirlik ayarlarına saygı duyabilecek şekilde istemcide tutuyor. Bu aynı zamanda bir A2UI uygulamasının otomatik olarak canlandırılmadığı anlamına da gelir. Oluşturulan bir arayüzün bir düğmeye basılmasına, bir durum geçişine veya bir maskot reaksiyonuna ihtiyacı varsa müşterinin bu davranışı sağlaması gerekir. ExodeUI, bir istemcide etkileşimli hareket oynatabilir ve AI kodlama araçları için bir MCP sunucusuna sahiptir, ancak bir A2UI oluşturucu değildir ve bir A2UI oluşturucusu olarak tanımlanmamalıdır.
Üretim için uygulama örneği
// 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" } }Hatırlanacak temel ilkeler
- A2UI, aracı tarafından tanımlanan arayüzlere yönelik, Google tarafından oluşturulan ve Apache 2.0 altında lisanslanan bir JSON protokolüdür.
- İstemci kendi bileşenleriyle işliyor; aracı rastgele UI kodunu yürütmez
- Mesajları tanımlar ve oluşturucuyu, taşımayı ve hareketi müşteriye bırakır.
- Bu bir animasyon sistemi veya açılır bileşen kütüphanesi değildir
- ExodeUI bir A2UI oluşturucusu değildir ve Google ile hiçbir bağlantısı yoktur