【文章翻譯】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 構建之前在客戶端強制執行。

allowedParents and allowedChildren reach the model in the catalog schema, and the Flutter client rejects a DataTable placed inside MyButton before building widgets
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"MyButton": {
"type": "object",
"allowedParents": ["Row", "Column"],
"allowedChildren": ["Text", "Icon"],
"properties": {
"component": { "const": "MyButton" },
"child": {
"$ref": "common_types.json#/$defs/Child",
"description": "The label or icon displayed inside the button."
}
}
}
}

如果 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 的組件。

basicCatalog, healthWidgetsCatalog, and customChartCatalog feed one MessageProcessor, and a single surface mixes components from all three

在 Flutter 中,只需在建立 MessageProcessor 時傳遞一個 catalog 列表:

1
2
3
4
5
6
7
8
final processor = MessageProcessor(
catalogs: [
CommonCatalog(),
HealthWidgetsCatalog(),
CustomChartCatalog(),
],
// ...
);

a2ui_flutter 為 LLM 提供統一的 schema,並自動解析所有已註冊目錄中的組件名稱。核心 UI 團隊可以維護共享佈局原始類型,而領域團隊則可以獨立發布專用的 Widget 目錄。

4. 使用 callAgentFunction 實現 UI 到後端的直接往返

不是每次在生成的介面中的點擊都是一個新的開放式問題。點擊圖表長條或後續提示芯片會觸發新的 LLM 輪次,但在現有卡片內調整滑塊、步進器或過濾器不應該等待幾秒鐘的往返。

Tapping a portfolio chart bar starts a new LLM turn. Changing the SOL quantity uses callAgentFunction to update weights, fees, and remaining cash on the same draft order card.

A2UI 1.0 的新功能 callAgentFunction 允許渲染的 Widget 直接調用代理後端公開的確定性函數。後端重新計算結果,無需涉及 LLM,更新的資料直接返回到現有組件中,將生成的 UI 從答案的靜態快照轉變為互動式工具。

Somnio Software 圍繞著這種確切的區別構建了他們的開源投資組合伴侶。在篩選出八個候選想法,只留下三個擊敗靜態表單(投資組合歸因瀑布圖、稅務地段影響表和多腿訂單草稿)後,執行長 Mauricio 和他的團隊使用 callAgentFunction 來保持每個計算的確定性和快速。當使用者起草一份價值 1 萬美元的多樣化訂單,包括 BTC、ETH 和 SOL,並在步進器上點擊 + 調整腿數量時,訂單票證會透過 callAgentFunction 直接呼叫後端,在不到一秒的時間內更新權重、費用和剩餘現金,而無需打開新的聊天輪次。

5. 透過可擴展性中繼資料實現可觀察性和自訂

生產應用程式通常需要在 A2UI 訊息之外傳遞結構化的帶外資料,例如路由標誌、樣式提示、安全上下文或將多代理後端日誌與行動遙測綁定的關聯 token。

A correlation token in A2UI metadata ties Python multi-agent backend logs to the Flutter app's telemetry

A2UI 1.0 支援在 Surfaces、個別組件、Catalog 定義和 Actions 上使用可擴展性中繼資料。例如,當在 Python 中確定性地建構訊息時,透過中繼資料傳遞您的有效負載:

1
2
3
4
5
6
7
8
9
10
11
CreateSurface(
surface_id="my_surface",
catalog_id=(
"https://example.com/catalog.json"
),
metadata={
"extensions": {
"com_example_logging": {"token": "ABC123"}
}
},
)

或者,如果您的模型直接輸出 Express,請在傳送訊息之前附加擴展:

1
2
3
4
part.a2ui = set_surface_extensions(
part.a2ui,
extensions={"com_example_logging": {"token": "ABC123"}},
)

代理和客戶端 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
An `a2ui_flutter` app driven by an agent built with `a2ui_agent` and Genkit Dart, or with the Python or TypeScript agent SDK and frameworks such as Google ADK and CopilotKit

對於全端 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 可以直接呼叫原生程式碼

Mariam Hasnany
Mariam Hasnany
2026 年 11 月 12 日 · 6 分鐘閱讀

我是如何將 GenLatte 轉換為全端 Dart 的

並減少了應用程式的伺服器費用

Craig Labenz
Craig Labenz
2026 年 9 月 22 日 · 7 分鐘閱讀