Canonical: https://seo.whoops.com.tw/a2ui-1-0/
Author: Sliven 褚崇名
Source robots: follow, index, max-snippet:-1, max-video-preview:-1, max-image-preview:large
Content modified (WordPress): 2026-11-15T09:50:29+00:00
Representation modified (content/template/converter): 2026-11-15T09:50:29+00:00

# A2UI 1.0 是什麼？Google 代理介面原理、SDK 與 MCP 分工教學

 

圖片：A2UI 1.0 精選圖，代理描述介面資料，經元件目錄驗證後，由桌面和手機的原生元件渲染互動畫面（來源：https://seo.whoops.com.tw/wp-content/uploads/2026/11/a2ui-1-0-featured.webp）

 

撰文作者 

[Sliven 褚崇名](<https://seo.whoops.com.tw/about/#founder-title>)

 

Whoops SEO 創辦人

 

SEO 與 AI SEO 專家，專長涵蓋技術 SEO、內容策略與 GEO 優化。從搜尋排名到 AI 答案中的品牌呈現，協助企業找出優化機會、排定執行順序，並追蹤實際成效。

 

圖片：Sliven 褚崇名肖像（來源：https://seo.whoops.com.tw/wp-content/uploads/2026/10/sliven-portrait-navy.webp）

 

[作者背景與專業領域](<https://seo.whoops.com.tw/about/#founder-title>) 更新 2026-11-15 約 17 分鐘閱讀

 

本篇內容

 

### 本篇內容

 

## 先看重點

摘自本文

- 兩種需求同時成立時，官方也提供把 A2UI 版面從 MCP 伺服器輸出、以及把 MCP Apps 嵌進 A2UI 介面區的雙向指南，疊用不需要二選一。

[A2UI、MCP Apps、AG-UI、A2A 怎麼分](<https://seo.whoops.com.tw/a2ui-1-0/#A2UI%E3%80%81MCP-Apps%E3%80%81AG-UI%E3%80%81A2A-%E6%80%8E%E9%BA%BC%E5%88%86>)
- 代理端從 Python、TypeScript、Dart 任選，客戶端依目標平台挑渲染套件，網頁端另有 Lit 與 Angular 版本，iOS 走 Swift Package Manager，Android 套件發布在 Google Maven，全部走各語言標準套件管理器。

[開發者怎麼開始：SDK、目錄與推論格式](<https://seo.whoops.com.tw/a2ui-1-0/#%E9%96%8B%E7%99%BC%E8%80%85%E6%80%8E%E9%BA%BC%E9%96%8B%E5%A7%8B%EF%BC%9ASDK%E3%80%81%E7%9B%AE%E9%8C%84%E8%88%87%E6%8E%A8%E8%AB%96%E6%A0%BC%E5%BC%8F>)
- A2UI 是模型無關的協定，官方提供 Express、Direct JSON 與 Jev 式決策模型幾種推論格式，任何能穩定輸出文字的模型都能上，CopilotKit 的整合說明也示範在不開工具呼叫的前提下寫 Express。

[A2UI 1.0 有綁定 Gemini 嗎？](<https://seo.whoops.com.tw/a2ui-1-0/#A2UI-1.0-%E6%9C%89%E7%B6%81%E5%AE%9A-Gemini-%E5%97%8E%EF%BC%9F>)

 

### 檢查網站的 SEO 基礎

從網站網址開始，檢視可讀性與頁面基礎訊號。

- 檢查標題與搜尋摘要標記
- 核對 canonical 與索引指令
- 整理公開 HTML 的待改善項目

[免費檢查網站](<https://seo.whoops.com.tw/free-seo-audit/>)

 

[將 Whoops 設為 Google 偏好來源（另開 Google 設定頁）](<https://www.google.com/preferences/source?q=seo.whoops.com.tw>)

 

A2UI 1.0 是 Google 於 2026 年 11 月 11 日發布的開放協定，全名 Agent-to-User Interface，任務是把 AI 代理的回答從純文字推進到互動介面：代理用一串 JSON 訊息即時描述表單、圖表、確認卡這類畫面，收到訊息的 App 再以自家 React、Flutter 或 SwiftUI 原生元件渲染，代理傳送的是介面資料，不必把生成的 HTML 或 JavaScript 交給客戶端執行。

 

這是專案自 2025 年 12 月問世以來的第一個穩定版，新增雙向函式呼叫，單一訊息就能生成完整畫面，授權採 Apache 2.0 免費開源。規格以 JSON 串流為核心，官方 Agent SDK 可在編譯時逐則驗證訊息，協助在渲染前找出結構錯誤，發布當天已有一線企業採用的案例可查，官方也同步釋出網頁、行動端的渲染器，連 Go 的終端機渲染都有社群版本。

 

對台灣的開發者與產品團隊，評估成本比想像低：Python、TypeScript、Dart 的代理端套件和各平台渲染套件都已就位，本機跑官方範例只需要一套 Node 或 Python 環境。它跟 MCP Apps 是分工互補的關係，兩者可以疊著用；既有 0.9 專案則有官方演化指南可對照升級。對內容與行銷團隊，它也是判讀互動式答案長相的入門素材，搜尋與助理產品正把這類畫面推到第一線。

 

Whoops SEO 影片解說：A2UI 1.0 是什麼？AI 回答如何變成可操作的介面

 

## A2UI 1.0 是什麼：Google 的生成式 UI 開放協定

 

Google 的 A2UI 團隊在 2026 年 11 月 11 日的[發布文章](<https://developers.googleblog.com/a2ui-10-build-delightful-fast-reliable-agentic-experiences/>)裡，把 1.0 定義為生成式 UI 開放協定的第一個穩定版本：讓 AI 代理用互動畫面回答，例如一張等待確認的表單或一張圖表。文章裡的一句話把定位講得最完整：代理描述要顯示什麼，每個 App 用自己的原生元件把介面畫出來。[官方網站](<https://a2ui.org/>)進一步把它描述成開源的生成式 UI 框架，加上為串流最佳化的通訊協定，代理挑選與組合元件，各端 App 負責渲染。

 

> Today we are releasing A2UI 1.0, now faster, easier, and stable, an open protocol and framework for generative UI across web, Android, iOS, wearables, TVs, and any other surface.
> 
> 👇 Check out what shipped [https://t.co/Hm5PhCIGtO](<https://t.co/Hm5PhCIGtO>)
> 
> — Google Cloud Tech (@GoogleCloudTech) [November 11, 2026](<https://x.com/GoogleCloudTech/status/2120563165557571629?ref_src=twsrc%5Etfw>)

 

專案在 2025 年 12 月 15 日由 Google 開發者部落格[首度公開](<https://developers.googleblog.com/introducing-a2ui-an-open-project-for-agent-driven-interfaces/>)，定位是 agent-driven interfaces 的開放專案：[AI 代理](<https://seo.whoops.com.tw/what-is-ai-agent/>)針對當下對話生成最合適的介面，交給前端應用呈現。規格沿 v0.8、v0.9、v0.9.1 一路演進，v0.8 已列淘汰，這條版本梯在官方文件的 LLM 索引裡寫得明白。

 

訊息結構由一組 JSON Schema 定義，common\_types、agent\_to\_renderer 與 renderer\_to\_agent 三份構成訊息信封的核心，驗證器依 Schema 檢查每則訊息，合法與否不看口頭約定，這也是 1.0 穩定性的具體承諾。GitHub 專案在 1.0 前一週仍連續出 SDK 改版，代理端套件與命令列工具都在發布當週更新，推進節奏以週為單位。

 

在這套標準出現前，生成式 UI 是各家自建的封閉工程。聊天機器人要出現一張能互動的卡片，工程師得為單一產品寫一套私有描述格式與渲染邏輯，換一個平台就重寫一次；模型輸出稍有偏差，畫面就直接壞給使用者看。私有格式的另一個代價是換模型，提示詞綁死特定輸出習性，模型一換版面就失控。A2UI 把「介面長什麼樣」變成可驗證的資料結構，把這兩層耦合一次切開。

 

採用名單已經有分量。Atlassian、Alation、Bloomberg 與 ByteDance 出現在 1.0 發布文章的採用名單，Google 自家的 Gemini Notebook 也用它的卡片讓使用者確認生成結果，[官方採用專頁](<https://a2ui.org/built-with-a2ui/>)再補上每家目前的作法。名單橫跨企業軟體、金融資訊與內部工具三種場景，顯示它被當成基礎設施在用，而不是示範專案。

 

治理走公開路線。規格各版本與演化指南都發布在 a2ui.org，程式碼提交一律走 GitHub 的 PR 審查並遵循 Google 開源社群準則，官方文件另收路線圖頁面，下一步動向可以直接追。

 

 

圖說：Google 官方 Flutter 頻道在 1.0 發布當天的說明影片，重點是穩定版對 Flutter 開發者的意義，以及 GenUI 套件交棒給 a2ui\_flutter 的位置。

 

影片裡提到的 GenUI 套件正是新舊交替之處。Flutter 專案現在的組合是 a2ui\_flutter 搭配 a2ui\_core，舊的 flutter\_genui 與 genui\_a2ui 已列入停用，[Flutter 官方部落格的更新說明](<https://flutter.dev/blog/new-updates-to-a2ui-and-flutters-genui-package>)把這段沿革與 a2ui\_agent 的角色一併整理。Dart 生態的 a2ui\_agent 讓 Flutter 端也能直接呼叫模型，同一套目錄在客戶端與代理端共用。

 

## 運作機制：介面即資料，訊息流建構畫面

 

A2UI 的代理端到渲染端之間只走一條單向 JSON 訊息流，畫面完全由資料建構。[v1.0 規格](<https://a2ui.org/specification/v1.0-a2ui/>)定義四種核心訊息：createSurface 建立介面區，updateComponents 更新元件，updateDataModel 更新資料模型，deleteSurface 移除介面區，回合結束由傳輸層負責收尾；1.0 的雙向函式再補上 callRendererFunction 與 agentFunctionResponse 兩種代理端訊息，讓同一條流也承載函式呼叫。渲染端每收一則訊息就增量更新畫面，把生成式 UI 當成串流問題處理，代理不需要懂任何平台的 Widget 系統，只描述結構與資料，平台差異全部留給渲染端。

 

元件不能讓代理隨手發明。每個實作先準備 catalog.json，以 JSON Schema 定義可用元件與屬性，標上 protocolVersion 1.0 與 catalogId；SDK 與渲染器依協商的目錄驗證後，應拒絕未登記的元件。A2UI 傳送的是資料描述，避免直接執行代理生成的 UI 程式碼；實作仍須落實驗證與權限檢查。

 

目錄本身也是規則庫。allowedParents 與 allowedChildren 把哪個元件能放進哪個容器寫成約束，組合錯誤同樣在驗證階段現形；1.0 還允許單一畫面混搭多份目錄，公司設計系統與第三方元件庫可以同台，解析順序是元件層 @catalogId、畫面預設 catalogId，兩者皆缺就直接報錯，不會暗中退回其他目錄。渲染端連線時宣告支援哪些 catalogId，代理端也能以 inlineCatalogs 即時補充定義，兩端當場談出這次畫面可用的元件集合。

 

資料與版面是分離的。畫面數值放進以路徑定址的資料模型，例如 /outbound/price，元件以 @path 綁定取值，函式呼叫走 @call，樣板式的重複渲染走 @index；@ 開頭的鍵在 1.0 全屬保留字，資料裡真要出現開頭的 @ 就連打兩次跳脫。函式呼叫帶 args 參數，回傳走共用的 FunctionResponse 包裝，成功與錯誤同一套格式，前端不必為每個函式寫例外處理。

 

用一張旅遊比價卡走一次流程。代理先送 createSurface，內含一張 Card、一個 Column 容器與一段 Text，Text 的內容以 @path 綁到 /outbound/price；接著 updateDataModel 把最新票價寫進路徑，畫面隨即更新。若 createSurface 設定 sendDataModel: true，使用者按下送出時，渲染端會透過傳輸層 metadata 附上當下的整份資料模型；未啟用時，action 只帶回事件中指定的 context。使用者改變條件時，代理再送 updateComponents 換掉圖表元件，畫面不整頁重刷，互動狀態留在原地。同一張卡要在明細與摘要之間切換，也只需要改路徑內容，元件樹不必重建。

 

圖片：A2UI 將介面結構與資料模型分開，更新旅遊卡片數值時保留既有畫面，使用者操作再回到代理端（來源：https://seo.whoops.com.tw/wp-content/uploads/2026/11/a2ui-1-0-ui-structure-data-model.webp）

介面結構決定元件與資料綁定，updateDataModel 更新數值。使用者操作的回傳內容，仍取決於 action.context 與 sendDataModel 設定。

 

1.0 的實質升級集中在三件事。callAgentFunction 讓渲染端可以回頭呼叫代理端函式，像送出前驗證供應商編號或查庫存，呼叫資格由目錄的 allowedCallers 限定並在執行期驗證；createSurface 可直接內嵌完整的 components 與 dataModel，一則訊息生成整個畫面。v0.9 的 theme 與 primaryColor 則被移除，視覺風格回歸各平台原生主題，帶著 theme 的 1.0 createSurface 無法通過嚴格驗證，寬鬆的渲染器則可能忽略該欄位。

 

樣式下放之後，同一份訊息在 iOS 與 Android 上各自長成平台該有的樣子，設計系統的掌控權回到 App 團隊手上。反方向的 callRendererFunction 讓代理呼叫渲染端函式，做驗證、資料轉換或動態屬性綁定，兩個方向的回傳型別都先在目錄裡宣告，執行期據此核對。

 

圖片：A2UI 代理端向渲染端呼叫 callRendererFunction，渲染端以 callAgentFunction 呼叫代理端，元件目錄宣告 allowedCallers（來源：https://seo.whoops.com.tw/wp-content/uploads/2026/11/a2ui-1-0-catalog-bidirectional-functions.webp）

callRendererFunction 由代理端呼叫渲染端；callAgentFunction 由渲染端呼叫代理端。目錄宣告可用函式與 allowedCallers，SDK 與渲染器負責執行期驗證。

 

訊息信封也從 v0.9 的 server\_to\_client 改名為 agent\_to\_renderer 與 renderer\_to\_agent，規格給的理由很直白：A2UI 的生成有時發生在客戶端，渲染有時發生在伺服器，舊名稱的假設不再成立。既有專案的遷移對照，官方整理在[v1.0 演化指南](<https://a2ui.org/specification/v1.0-evolution-guide/>)，把信封改名、雙向函式與 @ 命名空間逐項列清，並附可直接驗證訊息的 v1.0 JSON Schemas。指南同時標出相容規則：混搭的目錄必須使用同一個規格版本，升級時整批一起升，才不會出現半新半舊的畫面。

 

無障礙與擴充也在訊息層內建。@accessibility 是保留鍵，元件可附帶無障礙屬性交給渲染端依平台機制呈現；@metadata 留給自訂擴充，識別字採 Unicode 標準規則，a2ui\_ 前綴保留給官方使用。對需要無障礙驗收的政府與大型企業標案，這些鍵值就是可以直接寫進規格書的項目。

 

### 單則訊息建立畫面：官方最小範例

 

下面是 [1.0 規格的 createSurface 範例](<https://a2ui.org/specification/v1.0-a2ui/#createsurface>)。同一則訊息帶入 Column、Text 與初始資料，文字元件透過 @path 讀取 /name。渲染器必須支援 1.0，並登記相同的 Basic Catalog；catalogId 是目錄識別值，不代表客戶端會從該網址下載程式碼。

 

````
{
  "version": "1.0",
  "createSurface": {
    "surfaceId": "user_profile_card",
    "catalogId": "https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json",
    "sendDataModel": true,
    "components": [
      {
        "id": "root",
        "component": "Column",
        "children": [
          "user_name"
        ]
      },
      {
        "id": "user_name",
        "component": "Text",
        "text": {
          "@path": "/name"
        }
      }
    ],
    "dataModel": {
      "name": "John Doe"
    }
  }
}
````

 

這個範例只顯示文字，沒有送出按鈕。要把使用者操作送回代理，還需要互動元件的 action.event 與傳輸層回傳通道。sendDataModel 設為 true 後，回傳訊息才會透過 metadata 帶上當下的完整資料模型；單純修改本機欄位，不會自行發出請求。

 

## 傳輸與生態：AG-UI 是標準搭載，A2A 與 MCP 各有官方接法

 

A2UI 不綁定任何特定傳輸層，規格只約束傳輸必須做到的事：可靠且依序送達、能框住每則 JSON（JSONL 換行、WebSocket 幀或 SSE 事件皆可）、支援 metadata 做能力交換，類比 A2A 的 Agent Card 或 MCP 的初始化，並可留一條回傳通道讓使用者的 action 事件送回代理端。能力交換讓兩端先講好支援哪些目錄與訊息，避免代理送出渲染端畫不出來的元件。

 

標準搭載由 [AG-UI](<https://docs.ag-ui.com/introduction>) 擔任，這是 CopilotKit 維護的代理對前端傳輸協定，CopilotKit 的說法是任何 AG-UI 代理不加自訂整合就能直接使用 A2UI 1.0。跨代理場景另有 v1.0 的 [A2A](<https://a2a-protocol.org/>) 擴充規格，把 A2UI 映射到 A2A 之上，統一 metadata 擺放位置、渲染端能力協商與雙向資料模型同步。已經用 A2A 組多代理架構的團隊，UI 訊息可以跟著既有管道走，不必為畫面另開一條路。

 

具體搭法按既有基礎設施選。JSONL 換行分幀適合最簡單的管線，SSE 事件對網頁端最省事，WebSocket 幀支撐高頻互動，就連不串流的 REST 也在支援之列；重點只有一個，別讓傳輸層重新排序或吞掉訊息。因為一切互動都是明確的 JSON 訊息，監控端直接看訊息流就能重播整個過程，除錯不需要截圖猜畫面。

 

與 MCP 的關係是分工。A2UI 可裝在 MCP 的工具呼叫、工具輸出或資源訂閱裡傳遞，A2UI 的網頁與 Flutter 渲染器也能跑在 Claude、Gemini 宿主的 MCP Apps 裡；[官方 MCP 整合指南](<https://a2ui.org/guides/mcp-overview/>)給的選法很實際，伺服器想擁有完整 UI 體驗就選 MCP Apps，要跨平台又貼合自家 App 的動態介面就選 A2UI。在[Claude Desktop 教學](<https://seo.whoops.com.tw/claude-desktop/>)裡可以找到 MCP 伺服器的實際設定步驟。

 

把責任邊界想成三層就很好記：A2UI 定義內容，傳輸層定義怎麼送，宿主定義能出現在哪。sendDataModel 預設為 false，啟用後會在使用者觸發 action 等回傳訊息時附上當下的資料模型；只在欄位輸入文字，不會自動發出網路請求。不同傳輸或宿主若支援相同協定版本與元件目錄，就能重用同一份介面描述。

 

 

圖說：Google Cloud Tech 於 2026 年 6 月 25 日發布的官方講座，說明 A2UI、AG-UI 與 MCP Apps 的分工。影片早於 1.0 發布，版本差異請對照本文所引的 1.0 規格。

 

## A2UI、MCP Apps、AG-UI、A2A 怎麼分

 

四個名字解決四層不同的事，混在同一句話裡只會愈比愈亂。A2UI 管 UI 怎麼被描述與渲染，AG-UI 管代理訊息怎麼傳到前端，A2A 管代理之間怎麼互相呼叫，MCP 管模型怎麼接上工具與資料來源；Google 同時推 A2UI 與 A2A，兩者用擴充規格接軌。疊起來看更清楚：模型經 MCP 接資料，代理用 A2UI 描述畫面，訊息交給 AG-UI 傳輸，多代理協作走 A2A，四層各司其職。

 

圖片：代理以 A2UI 描述介面、AG-UI 傳遞事件、A2A 連接其他代理、MCP 接工具資料，MCP Apps 在宿主中呈現工具介面（來源：https://seo.whoops.com.tw/wp-content/uploads/2026/11/a2ui-ag-ui-a2a-mcp-apps-protocol-roles.webp）

A2UI 描述介面，AG-UI 傳遞代理與前端事件，A2A 處理代理協作，MCP 連接工具與資料；MCP Apps 提供宿主內的工具 UI。圖中各連線表示責任分工，並非必須全部採用的部署順序。

 

A2UI 與相鄰協定分工對照（依 2026 年 11 月 15 日各官方文件）

| 名稱 | 主責單位 | 解決的層次 | 與 A2UI 1.0 的關係 |
| --- | --- | --- | --- |
| A2UI | Google A2UI 團隊，Apache 2.0 開源 | 代理如何用資料描述互動介面並跨平台渲染 | 協定本體，1.0 為首個穩定版 |
| AG-UI | CopilotKit | 代理與前端之間的事件傳輸 | 官方指定的標準搭載 |
| A2A | Google 發起 | 代理對代理的探索與呼叫 | 官方 v1.0 擴充規格把 A2UI 接到 A2A |
| MCP Apps | MCP 生態，宿主含 Claude 與 Gemini | 伺服器端自帶 Web UI 在宿主內呈現 | A2UI 渲染器可跑在其中，互補可疊用 |

 

選型判斷可以再收斂。產品已有自己的 App 與設計系統，要讓代理在既有畫面裡動態長出符合品牌的互動區塊，A2UI 是直接答案；服務本身要嵌進 Claude 或 Gemini 這類宿主成為完整工具介面，MCP Apps 比較省事。兩種需求同時成立時，官方也提供把 A2UI 版面從 MCP 伺服器輸出、以及把 MCP Apps 嵌進 A2UI 介面區的雙向指南，疊用不需要二選一。判斷走錯方向的徵兆，是為了一張卡片引入整套網頁容器，那通常代表該用的是 A2UI 而不是 iframe。

 

## 開發者怎麼開始：SDK、目錄與推論格式

 

安裝門檻在 1.0 之後降到貼近一般前端專案，官方 SDK 已覆蓋主要語言與平台。代理端從 Python、TypeScript、Dart 任選，客戶端依目標平台挑渲染套件，網頁端另有 Lit 與 Angular 版本，iOS 走 Swift Package Manager，Android 套件發布在 Google Maven，全部走各語言標準套件管理器。渲染套件只負責畫面，代理套件負責產生與驗證訊息，兩端可以交給不同團隊分頭維護。

 

- `` npm install @a2ui/react @a2ui/web_core ``（網頁端渲染器） 
- `` pip install a2ui-agent-sdk ``（Python 代理端，另附 a2ui-adk 與 a2ui-a2a） 
- `` flutter pub add a2ui_flutter a2ui_core ``（Flutter 用戶端） 
- `` dart pub add a2ui_agent ``（Dart 代理端）

 

不想手寫提示詞的團隊有現成路徑。Agent SDK 的技能產生器從目錄自動生成模型提示與文法規則，目錄更新後重新生成即可，提示詞與元件定義不會各走各的。編譯器接手剖析、驗證並輸出 wire 訊息，串流場景下逐塊剖析，連斷在字串中間的輸出都能修補；格式錯誤的內容會退回模型自我修正，不直接丟給使用者。寫程式代理還能以 [npx skills add a2ui-project/a2ui](<https://github.com/a2ui-project/a2ui>) 一行指令把 A2UI 技能裝進 Claude Code、Gemini CLI、Cursor、Codex 與 Windsurf，這種把說明寫給代理讀的慣例，與 [AGENTS.md](<https://seo.whoops.com.tw/what-is-agents-md/>) 是同一個方向。

 

模型端不必逐字輸出 wire JSON。[A2UI Express](<https://a2ui.org/concepts/inference-formats/>) 是精簡的位置型寫法，模型在 a2ui 標籤之間輸出介面塊，官方文件指出，原始 wire JSON 的重複鍵值讓輸出長度約為位置型寫法的三倍；在 54 題 core\_v1\_0、gemini-3.8-flash、temperature=0.0 的基準中，Express 的輸入 Token 中位數為 6,000，Direct JSON 為 10,980，實際差距仍取決於模型與目錄；對按 Token 計費的[大型語言模型](<https://seo.whoops.com.tw/what-is-llm/>)來說，差距直接反映在每次互動的帳單上。Express 同時覆蓋 v0.9、v0.9.1 與 v1.0 的生成，升級規格版本不必換提示詞格式；Jev 式決策模型讓輕量模型直接挑元件與數值，Direct JSON 保留給除錯與舊版 v0.8 相容，幾種格式共用同一套目錄與客戶端。

 

第一次定義目錄，官方的基本目錄實作指南是最好的起點。若也要替 AI 編碼代理補齊 HTML、CSS 與瀏覽器相容性知識，可搭配 [Modern Web Guidance 的網頁平台指南](<https://seo.whoops.com.tw/modern-web-guidance/>)。先把文字、按鈕、欄位這類通用元件的屬性與限制寫清楚，再逐步換成公司設計系統的元件，目錄品質決定代理發揮的上限。

 

最快的動手路徑是[官方快速入門](<https://a2ui.org/quickstart/>)的 Travel A2UI 範例，一個 Python 代理伺服器配上 React 與 Flutter 客戶端，從一個提示就能跑通整套流程，文件另提供給寫程式代理的引導頁，讓 Claude Code 或 Gemini CLI 直接照著把範例架起來。A2UI 官網還為 AI 檢索提供 llms.txt 語料，所有文件頁都能加 .md 後綴取得 Markdown 版，做法與[llms.txt 部署教學](<https://seo.whoops.com.tw/llms-txt-guide/>)裡的原則一致。

 

圖片：A2UI 導入依序定義元件目錄、接上 SDK、選擇渲染器，再驗證各端版本與使用者互動（來源：https://seo.whoops.com.tw/wp-content/uploads/2026/11/a2ui-1-0-sdk-catalog-renderer-implementation.webp）

先整理可用元件與限制，再接 Agent SDK、選擇渲染器。最後核對版本相容性，測試資料更新、表單送出及錯誤處理。

 

## 誰已經上線：採用案例與版本落差

 

第一波使用者的導入方式各有側重。Atlassian 在 Jira 讓代理於工作項目內以互動卡片追問補充資訊；Alation 的 AIOS 把帶 SQL 出處的指標卡與圖表，同時渲染到自家 App 與 Claude 裡；Gemini Notebook 的確認卡同時出現在網頁與行動端，同一份訊息餵兩個平台；Bloomberg 也被官方點名在列，具體情境尚未公開。

 

生態的版本腳步並不整齊，導入前要逐項核對。ByteDance 的 Lynx 渲染器 2026 年 6 月釋出，目前支援 0.9，正與 A2UI 團隊合作走向 1.0 與 A2UI Express，Lynx 工程負責人在官方專頁的評語是「A2UI 走在對的方向」。Jetpack Compose 渲染器官方標註仍在 0.9.1，Gemini Enterprise 的企業代理註冊支援到 0.9.1，Google Cloud 另有把 A2UI 代理放上 [Cloud Run 的整合指南](<https://cloud.google.com/blog/topics/developers-practitioners/guide-to-gemini-enterprise-and-a2ui-integration>)。這種參差對採購文件的意義很實際：驗收條款要綁規格版本，寫清楚 1.0 才不會收到 0.9 的交付。

 

周邊工具鏈同步補齊。CopilotKit 以 A2UI 1.0 為底，推出內建 70 個標準元件的生成式 UI 產品，元件走 A2UI 標準目錄格式、與自建目錄可以混用；其[1.0 整合說明](<https://www.copilotkit.ai/blog/introducing-a2ui-1-0>)也把 AG-UI 搭載與 Express 的關係講清楚。Google 發布文章裡的 A2UI Playground 同樣出自 CopilotKit，線上就能直接試寫。

 

評估的起手順序顛倒不得：先定義公司自己的元件目錄，平台與推論格式都排在目錄之後，目錄綁死單一框架是最常見的返工來源，把目錄當產品文件維護、版本與審查比照程式碼，是這類專案最常被低估的工時。1.0 這個節點的意義，在於把代理畫面從各家私有實作變成可驗證的公開規格，導入時仍要核對 SDK、渲染器與宿主支援的版本，再評估工程排程。

 

## 對產品與內容經營者的實際意義

 

這條協定影響的不只 App 開發，搜尋與內容生態都會被牽動。[Google I/O 2026](<https://seo.whoops.com.tw/google-io-2026-search-agents-seo/>) 已把搜尋走向代理優先的變化說明清楚，當代理開始用元件回答，內容被引用的方式也從整頁變成區塊，[AI 搜尋](<https://seo.whoops.com.tw/ai-search/>)的引用邏輯與流量影響值得重新盤點。

 

從產品設計來看，24/7 個人代理是可評估這類介面的情境，[OpenAI Dots](<https://seo.whoops.com.tw/openai-dots/>) 與 [Gemini Spark](<https://seo.whoops.com.tw/gemini-spark/>) 這類服務每多一種可動態生成的介面，能承接的任務邊界就往外推一格。想像客服代理收到退訂請求，直接生成一張帶訂單明細與理由選項的表單，使用者填完送回，中間不必來回貼文字。

 

內容經營者的因應分兩層。技術層把結構化做好，讓代理讀得懂，清晰的標題層級與機器可讀文件都是基本功；策略層追蹤哪些查詢正被互動介面取代，把[AI 搜尋 SEO 指南](<https://seo.whoops.com.tw/google-ai-search-seo-guide/>)的應對清單當起點，再以 [LLMO](<https://seo.whoops.com.tw/what-is-llmo/>) 的角度檢視內容的可引用性。互動卡出現在使用者眼前時，被引用的不只是文字，還有結構化的選項與資料，內容端準備得越結構化，代理能組裝的材料就越多，這對產品文件與教學內容的影響最直接。

 

短期內最該盯的訊號有兩個：Jetpack Compose 與 Lynx 的 1.0 支援何時到位，決定行動端的導入成本；主要助理宿主何時原生內建 A2UI 渲染器，決定互動式答案的覆蓋率。這兩個訊號都會先出現在官方文件與 GitHub 專案的更新裡，直接訂閱原始碼庫的 release 比等媒體轉述快。對照 2025 年 12 月首次公告到 1.0 只走了十一個月，這條協定的演進速度快於多數企業標準，評估不宜放到明年再說。

 

## A2UI 1.0 常見問題

 

### A2UI 1.0 可以商用嗎？要授權費嗎？

 

可以。Apache 2.0 允許商業使用、修改與再散布，不必支付授權金，也不要求衍生作品開源，只要依授權條款保留版權與聲明。把程式碼貢獻回官方專案才需要簽署 Google 的 CLA 並經 PR 審查，那是貢獻者流程，與採用方的使用權利無關；導入時把授權標示納入法務檢查清單即可。

 

### 既有的 0.9 專案要怎麼升到 1.0？

 

官方的 v1.0 演化指南列出完整對照，信封改名、theme 移除、雙向函式與 @ 命名空間都在裡面。實務順序是先把 Agent SDK 與渲染套件升到支援 1.0 的版本，再依指南調整目錄與訊息內容，收尾用官方的 v1.0 JSON Schemas 重驗每則訊息。代理端與客戶端最好同一版切換，半新半舊的組合最容易出現難查的驗證錯誤。

 

### 哪個網站才是 A2UI 官方來源？

 

官方來源有三個：a2ui.org 的文件與規格、GitHub 的 a2ui-project/a2ui 原始碼庫，以及 Google 開發者部落格的公告。搜尋結果裡的 a2ui.sh、a2ui.me 不在官方文件的生態連結裡，屬於第三方網站，與協定本體沒有隸屬關係；第三方文章可以讀，引用規格與數字時以 a2ui.org 為準並核對版本號，因為 0.9 時期的內容現在還大量流通。

 

### A2UI 1.0 有綁定 Gemini 嗎？

 

沒有綁定。A2UI 是模型無關的協定，官方提供 Express、Direct JSON 與 Jev 式決策模型幾種推論格式，任何能穩定輸出文字的模型都能上，CopilotKit 的整合說明也示範在不開工具呼叫的前提下寫 Express。選型考量回到成本、延遲與輸出穩定度，換模型不必換協定，目錄與客戶端都能原封不動；Gemini 在這套生態裡是宿主之一，模型與宿主都可以自由替換。

 

### iOS 與 Android 的原生支援現況如何？

 

iOS 已可透過 Swift Package Manager 安裝官方 SwiftUI 套件；Android 的 Jetpack Compose 渲染器仍在 0.9.1，官方把 1.0 支援列為即將推出。急著驗證的團隊先用 React 或 Flutter 客戶端跑通全流程，之後把原生端當成另一個渲染平台接上，訊息流與目錄設計都能沿用。兩個平台的套件座標都列在官方文件的安裝區，直接複製即可。

 

### 與 MCP 混用時，資安驗收該看哪些點？

 

A2UI 目錄裡的 allowedCallers 限定函式可由 agent、renderer 或兩側呼叫，渲染器與 SDK 必須在執行期落實驗證。元件清單、資料路徑、需要使用者操作才能執行的函式，以及敏感資料是否留在伺服器端，都要逐一檢查。MCP 宿主與伺服器的身分認證、工具權限及業務資料驗證也要分開驗收，不能只憑目錄檢查就判定安全。

 

### 搜尋到的 A2UI Composer 是什麼？

 

Composer 與 Inspector 是官方文件生態區列出的視覺化工具，用來輔助編排介面與檢查輸出，屬於生態工具，不是協定規格本體。搜尋「a2ui composer」的人多半想找這套編輯工具，把它與協定分開理解就不會混淆；官方的 LLM 索引把它與 Playground 並列在生態工具區，引用規格時仍以 a2ui.org 的文件為準。

 

[A2A](<https://seo.whoops.com.tw/tag/a2a/>)[A2UI](<https://seo.whoops.com.tw/tag/a2ui/>)[AG-UI](<https://seo.whoops.com.tw/tag/ag-ui/>)[AI Agent](<https://seo.whoops.com.tw/tag/ai-agents/>)[AI 工具](<https://seo.whoops.com.tw/tag/ai-%e5%b7%a5%e5%85%b7/>)[Google](<https://seo.whoops.com.tw/tag/google/>)[MCP](<https://seo.whoops.com.tw/tag/mcp/>)[前端開發](<https://seo.whoops.com.tw/tag/%e5%89%8d%e7%ab%af%e9%96%8b%e7%99%bc/>)[生成式 UI](<https://seo.whoops.com.tw/tag/%e7%94%9f%e6%88%90%e5%bc%8f-ui/>)[開放標準](<https://seo.whoops.com.tw/tag/%e9%96%8b%e6%94%be%e6%a8%99%e6%ba%96/>)

 

喜歡這篇內容？讓下次搜尋，更容易遇見 Whoops。

[將 Whoops 設為 Google 偏好來源（另開 Google 設定頁）](<https://www.google.com/preferences/source?q=seo.whoops.com.tw>)前往 Google 選取並確認，即可完成設定。

 

[## Sliven 褚崇名](<https://seo.whoops.com.tw/about/#founder-title>)

Sliven 褚崇名是 Whoops SEO 創辦人，負責技術 SEO、內容與關鍵字策略、WordPress 網站重建，以及 AI SEO、AEO、GEO 的量測與內容優化。作者頁可查閱由他署名的〈SEO 是什麼〉與〈AI SEO 是什麼〉等教學；內容中的自有量測、模型觀測與第三方來源應分開判讀，並以各頁標示的方法與限制為準。是否適合特定專案，仍需依網站現況、目標、執行範圍與可驗證成果判斷。

[查看作者文章 →](<https://seo.whoops.com.tw/about/#founder-title>)

 

## 討論與提問

 

### 發佈留言

 

WHOOPS / JOURNAL

## 更多值得一讀的文章

[探索知識庫 ↗](<https://seo.whoops.com.tw/blog/>)

[AI 工具與應用約 29 分鐘閱讀

### MiniMax H3 是什麼？帶原生立體聲的全模態影片生成模型完整解析

MiniMax H3 是 MiniMax 2026 年 7 月發布的全模態生成模型，統一理解文字、圖片、影片、音訊，輸出最長 15 秒、最高 2K、帶原生立體聲的影片。本文拆解四種生成模式、完整規格、官方提示詞系統，以及跟 Sora、Veo 的選擇方法。

閱讀文章](<https://seo.whoops.com.tw/minimax-h3/>) [GEO 與 AI 搜尋優化約 31 分鐘閱讀

### Businesses in ChatGPT 是什麼？商家認領、Business Hub 與 Business Agent 台灣完整教學

Businesses in ChatGPT 讓商家認領檔案、管理資訊及查看 28 天洞察。本文整理 Business Hub 四種驗證方式、Persona、Business Agent 美國資格、台灣適用條件及商家準備清單。

閱讀文章](<https://seo.whoops.com.tw/businesses-in-chatgpt/>)
