【文章翻譯】Announcing A2UI 1.0 and a2ui_flutter
【文章內容使用 Gemini 2.5 Flash 自動翻譯產生】
原文:https://flutter.dev/blog/a2ui-launch
宣布 A2UI 1.0 和 a2ui_flutter
更快、更安全、更模組化的 Flutter 生成式 UI
當 AI 代理協助使用者推論資料或在應用程式中採取行動時,純文字很少是最佳介面。沒有人想在聊天段落中尋找埋藏的數字,或鍵入三個後續訊息只為了確認更新。生成式 UI (GenUI) 讓代理能夠以真實、互動式的 Flutter Widget 回應,這些 Widget 專為使用者當前的確切情境量身打造。
今天,我們將推出 A2UI 1.0 和 a2ui_flutter,這是以前稱為 genui 的 Flutter 套件。透過 1.0 版本,協定和 SDK 更加緊密、更快,並配備了行動、網頁和桌面生產團隊所需的結構護欄。

在這篇文章中,我們將探討生成式 UI 如何在傳統 Flutter 畫面中佔有一席之地,介紹 A2UI 1.0 中的新功能,並了解 Very Good Ventures、Solid Software 和 Somnio Software 等社群合作夥伴如何已經在不同行業中應用這些功能。
奠定 GenUI:何時生成 UI,以及何時確定性 Widget 勝出
首先,一個經驗法則:生成式 UI 無意取代您應用程式的確定性畫面。標準表單、列表和導航標籤快速且可預測。如果靜態表單已經能清晰地處理工作流程,那麼堅持使用確定性 UI 是一個不錯的選擇。

當正確的介面取決於對開放式情境進行推理時,生成式 UI 便能發光發熱。以我們的 Commis 示範為例,這是一個餐飲應用程式,用於管理工作、食譜和食材。詢問菜單是否需要為對貝類過敏的主人更改,代理會確認當前菜單是安全的,然後提供修改菜單的選項,只顯示不含貝類的食譜。該應用程式無需設定核取方塊或貝類搜尋過濾器。由於代理既能推理請求又能建構 UI,因此使用者可以更改菜單,而不會有選擇貝類菜餚的機會。
從 genui 到 a2ui_flutter:更簡單的架構
轉移到 A2UI 1.0 讓我們可以直接將 Flutter 套件名稱與協定對齊(歡迎,a2ui_flutter),並將早期 genui 版本中的六個概念整合到更精簡的架構中:

Transport已移除:您不再受限於套件專用的傳輸抽象,因此您可以使用您喜歡的串流或 HTTP 設定。MessageProcessor取代了SurfaceController + Conversation:一個中央類別現在處理目錄、驗證傳入的 A2UI 訊息並管理 Surface 狀態。Catalog、Surface和Data Model已完善:它們現在支援層次結構護欄、每個 Surface 多個 Catalog 以及可擴展性中繼資料。
讓我們看看 A2UI 1.0 中最大的五個新增功能。
1. 雙層護欄與 allowedParents 和 allowedChildren
賦予代理太少的自由,它就無法適應您的使用者;賦予它太多的自由,它可能會注意到 Button 接受一個子元素,然後決定在其中塞入一個 DataTable。

A2UI 1.0 透過您的目錄 schema 中的 allowedParents 和 allowedChildren 解決了這個問題。這些屬性充當雙層護欄:它們是代理提示中目錄 schema 的一部分,因此 LLM 預先知道有效的嵌套規則,並且它們在 Widget 構建之前在客戶端強制執行。
1 | { |
如果 LLM 仍然出錯並返回無效的階層,a2ui_flutter 會捕捉到驗證錯誤,而不是崩潰或渲染損壞的 UI,並通知代理該組件無法按描述渲染,並發出 UNALLOWED_PARENT 或 UNALLOWED_CHILD 錯誤。
2. 透過 Express 推論格式實現更快的 UI 生成
當代理即時串流介面時,每個輸出 token 都會增加延遲。標準 JSON 帶有沉重的語法開銷,包括重複的引號、大括號、id 鍵和「component」辨別符。A2UI 1.0 的新功能是 Express 推論格式,它以緊湊的函數調用語法表示完全相同的組件樹,顯著減少字元和 token 數量,以便模型可以更快地生成介面。在以下範例中,Express 以比壓縮 JSON 少 46% 的字元描述了五個組件,這表示模型需要生成的 token 更少。

Solid Software 在 GenUI Clinic 中對 Express 進行了測試,這是一個 Flutter 醫療保健原型,它根據患者的病史和就診原因編寫個性化的只讀臨床摘要,以便提供者不會浪費時間挖掘記錄。由於代理只選擇 Widget 而不能更改底層臨床資料,因此輸出保持安全且可預測,而臨床醫生可以在檢查中途修改儀表板。他們的團隊發現,切換到 Express 格式將全螢幕儀表板生成時間從 10 秒縮短到 5 秒,使即時臨床資料檢索對於未來的專案感覺切實可行。

3. 透過多個目錄實現模組化設計系統
在 A2UI 0.9 中,每個 Surface 都被鎖定到一個 Catalog,這迫使團隊手動將核心 UI 組件與特定功能 Widget 合併。在 A2UI 1.0 中,一個 Surface 可以混合來自多個 Catalog 的組件。
在 Flutter 中,只需在建立 MessageProcessor 時傳遞一個 catalog 列表:
1 | final processor = MessageProcessor( |
a2ui_flutter 為 LLM 提供統一的 schema,並自動解析所有已註冊目錄中的組件名稱。核心 UI 團隊可以維護共享佈局原始類型,而領域團隊則可以獨立發布專用的 Widget 目錄。
4. 使用 callAgentFunction 實現 UI 到後端的直接往返
不是每次在生成的介面中的點擊都是一個新的開放式問題。點擊圖表長條或後續提示芯片會觸發新的 LLM 輪次,但在現有卡片內調整滑塊、步進器或過濾器不應該等待幾秒鐘的往返。
A2UI 1.0 的新功能 callAgentFunction 允許渲染的 Widget 直接調用代理後端公開的確定性函數。後端重新計算結果,無需涉及 LLM,更新的資料直接返回到現有組件中,將生成的 UI 從答案的靜態快照轉變為互動式工具。
Somnio Software 圍繞著這種確切的區別構建了他們的開源投資組合伴侶。在篩選出八個候選想法,只留下三個擊敗靜態表單(投資組合歸因瀑布圖、稅務地段影響表和多腿訂單草稿)後,執行長 Mauricio 和他的團隊使用 callAgentFunction 來保持每個計算的確定性和快速。當使用者起草一份價值 1 萬美元的多樣化訂單,包括 BTC、ETH 和 SOL,並在步進器上點擊 + 調整腿數量時,訂單票證會透過 callAgentFunction 直接呼叫後端,在不到一秒的時間內更新權重、費用和剩餘現金,而無需打開新的聊天輪次。
5. 透過可擴展性中繼資料實現可觀察性和自訂
生產應用程式通常需要在 A2UI 訊息之外傳遞結構化的帶外資料,例如路由標誌、樣式提示、安全上下文或將多代理後端日誌與行動遙測綁定的關聯 token。
A2UI 1.0 支援在 Surfaces、個別組件、Catalog 定義和 Actions 上使用可擴展性中繼資料。例如,當在 Python 中確定性地建構訊息時,透過中繼資料傳遞您的有效負載:
1 | CreateSurface( |
或者,如果您的模型直接輸出 Express,請在傳送訊息之前附加擴展:
1 | part.a2ui = set_surface_extensions( |
代理和客戶端 SDK 都會自動處理序列化和解析。在 Flutter 客戶端上,讀取 Surface 或組件模型上的中繼資料 getter 以檢索您的資料。
在 Dart、Python 或 TypeScript 中建立代理
a2ui_flutter 渲染 UI。在代理端,A2UI 代理 SDK 會教導模型您的 Catalog,將其輸出(包括 Express)編譯成 A2UI 訊息,並在這些訊息到達應用程式之前進行驗證。代理 SDK 有三種語言版本,任何一種都可以驅動相同的 Flutter 應用程式:
- Dart (新):
a2ui_agent - Python:
a2ui-agent-sdk,加上 Google ADK 的a2ui-adk和 A2A 協定的a2ui-a2a - TypeScript:Node.js 的
@a2ui/agent
對於全端 Dart 應用程式,請將 a2ui_agent 與 Google 的開源框架 Genkit Dart 配對,該框架用於使用 Dart 和 Flutter 建構代理應用程式。其 genkit_a2ui 中介軟體(目前處於預覽階段)基於 a2ui_agent,因此您可以用一種語言撰寫代理、其工具和 Flutter UI。
Very Good Ventures 使用此堆疊建構了 開源智慧家庭面板,該面板為每個家庭成員組合成不同的儀表板。其 Dart Frog 後端運行 a2ui_agent 和 Genkit Dart,使用 Gemini Live 將語音轉換為文字,並將 A2UI 1.0 訊息傳送到廚房牆壁顯示器上的 a2ui_flutter 應用程式。請嘗試 即時示範。
總結
透過 A2UI 1.0 和 a2ui_flutter,您將獲得一個更緊密、更快速的基礎,用於建構代理驅動的 Flutter 體驗,配備更多護欄、透過 Express 格式實現更快的生成、模組化多目錄介面、使用 callAgentFunction 實現亞秒級互動,以及協定級別的可擴展性中繼資料。
您準備好嘗試了嗎?
- 開始建構:請查看 a2ui.org 上的快速入門和協定文件。
- 探索範例程式碼:深入了解 g.dev/ai/flutter-demos 上的 Flutter AI 和 GenUI 示範。
我們迫不及待想看看您會建立什麼!
更多來自 Flutter 的內容
宣布穩定直接原生互操作性
FFIgen for Objective-C 和 JNIgen for Java/Kotlin 現已穩定,Pigeon 使它們能夠運作,讓您的 Plugin 可以直接呼叫原生程式碼
我是如何將 GenLatte 轉換為全端 Dart 的
並減少了應用程式的伺服器費用