返回產品博客

領先 Google 官方發佈!我們開源了首個 A2UI React 完整實現

本文發佈於 2026年1月13日。產品當前能力參見產品能力。

領先 Google 官方發佈!我們開源了首個 A2UI React 完整實現

領先 Google 官方發佈!我們開源了首個 A2UI React 完整實現

當 AI 不再只是輸出文字,而是直接「畫」出界面


什麼是 A2UI?

2025 年 12 月,Google 正式發佈了一項革命性的開源協議 —— A2UI(Agent-to-User Interface),即「智能體到用戶界面」協議。

這是什麼意思?

想像一下:當你和 AI 對話時,AI 不再只是返回一段文字,而是直接返回一個完整的交互式界面——有按鈕、有卡片、有表單、有圖表。用戶可以直接點擊、填寫、交互,而不是複製粘貼一大段文字。

這就是 A2UI 協議要解決的問題。


為什麼 A2UI 如此重要?

傳統 AI 交互的痛點

用戶:幫我生成一份報告

AI:好的,以下是報告內容… [一大段純文本] …如需修改請告訴我

用戶需要:

  • 複製粘貼文本
  • 自己排版格式化
  • 再次對話反覆修改

A2UI 時代的交互

用戶:幫我生成一份報告

AI:[直接渲染出報告界面]

  • 包含圖表
  • 可編輯的表格
  • 一鍵導出按鈕
  • 實時修改反饋

這不是概念,這是現實。


我們做了什麼?率先實現 React 版本

根據 Google 的官方路線圖:

時間節點 里程碑
2025.12 A2UI 協議發佈 (v0.8 公開預覽版)
2026 Q1 官方 React 渲染器發佈
2026 Q2 SwiftUI / Jetpack Compose 渲染器
2026 Q4 v1.0 穩定版發佈

然而,我們等不及了。

Zhama AI 團隊基於 A2UI 協議規範,在官方 React 渲染器發佈之前,率先開源了首個完整的 React 實現:

@zhama/a2ui


@zhama/a2ui 核心特性

AI 優先設計

專為 AI 智能體動態生成 UI 而設計,不是讓開發者手寫組件,而是讓 AI 輸出結構化數據自動渲染。

完整協議支持

100% 實現 A2UI 協議規範,包括:

  • 所有標準組件類型
  • 數據綁定與路徑引用
  • 事件處理與動作系統
  • Surface 管理

獨立樣式系統

  • 零依賴 Tailwind — 自帶完整 CSS 工具類
  • a2- 前綴 — 避免與宿主應用衝突
  • 自動暗色模式 — 使用 CSS light-dark() 函數
  • OKLCH 色彩空間 — 現代色彩系統

安全優先

採用聲明式數據格式,而非可執行代碼:

  • AI 只能使用預定義組件
  • 沒有代碼注入風險
  • 完全可控的 UI 渲染

豐富組件庫

組件 用途
Text 支持 Markdown 的文本渲染
Button 帶動作的交互按鈕
Card 內容卡片容器
List 垂直/水平列表
TextField 文本輸入框
Checkbox 複選框
Tabs 選項卡切換
Modal 模態對話框
Chart 數據圖表
Image/Video/Audio 多媒體組件

高性能

  • 遵循 React 最佳實踐
  • 優化的重渲染策略
  • 支持流式渲染

完整 TypeScript 支持

  • 全面的類型定義
  • 智能代碼補全
  • 編譯時錯誤檢查

看看實際效果

場景一:AI 培訓助手

用戶輸入 hello,AI 直接生成帶主題卡片的歡迎界面:

歡迎來到 AI 培訓系統

包含課程卡片(React 入門、Python 進階)、開始學習按鈕、實時學習進度條顯示 80%

場景二:交互式表單

AI 需要收集用戶信息時,直接生成表單:

請填寫以下信息

包含姓名輸入框、郵箱輸入框、訂閱複選框、取消/確認提交按鈕

場景三:數據可視化

AI 分析數據後,直接展示圖表:

銷售數據分析

包含月度趨勢柱狀圖、類別分佈餅圖、AI 洞察提示「3月銷量環比增長 25%」


5 分鐘快速開始

安裝

npm install @zhama/a2ui
# 或
pnpm add @zhama/a2ui

基礎使用

import { StyleProvider, ThemeProvider, A2UIRoot } from '@zhama/a2ui';

function App() {
  // AI 输出的组件结构
  const components = [
    {
      id: 'welcome',
      type: 'Card',
      properties: {
        child: {
          id: 'content',
          type: 'Column',
          properties: {
            children: [
              {
                id: 'title',
                type: 'Text',
                properties: {
                  text: { literal: '欢迎使用 A2UI!' },
                  usageHint: { literal: 'h1' }
                }
              },
              {
                id: 'action',
                type: 'Button',
                properties: {
                  child: {
                    id: 'btn-text',
                    type: 'Text',
                    properties: { text: { literal: '开始体验' } }
                  },
                  action: { type: 'postback', payload: 'start' }
                }
              }
            ]
          }
        }
      }
    }
  ];

  return (
    <StyleProvider>
      <ThemeProvider>
        <A2UIRoot 
          childComponents={components}
          onAction={(e) => console.log('用户点击:', e)}
        />
      </ThemeProvider>
    </StyleProvider>
  );
}

運行 Demo

# 克隆仓库
git clone https://github.com/zhama-ai/a2ui-react.git
cd a2ui-react

# 运行示例
cd examples/basic-demo
npm install
npm run dev

打開 http://localhost:5174 體驗完整 Demo!


應用場景

AI 教育培訓

  • 動態生成課程內容
  • 交互式測驗和評估
  • 個性化學習路徑
  • 實時進度追蹤

智能客服

  • 表單式信息收集
  • 產品卡片推薦
  • 多步驟引導流程
  • 可視化數據展示

商業智能

  • AI 驅動的報告生成
  • 動態儀表板
  • 審批工作流
  • 數據錄入表單

開發者工具

  • 交互式文檔
  • 配置嚮導
  • 調試界面
  • 代碼生成預覽

架構設計

A2UI 採用兩層架構,讓 AI 專注內容,框架專注渲染:

flowchart LR
    subgraph LLM["LLM 輸出"]
        A[JSON 結構化數據]
    end
    
    subgraph CM["ContentModel"]
        B[語義層<br/>場景 & 意圖]
    end
    
    subgraph UI["A2UI UI"]
        C[React 渲染組件]
    end
    
    LLM --> CM --> UI
    
    style LLM fill:#e0f2fe,stroke:#0284c7
    style CM fill:#fef3c7,stroke:#d97706
    style UI fill:#dcfce7,stroke:#16a34a

核心優勢:

  • 關注點分離 — LLM 不需要關心 UI 細節
  • 靈活性 — 更換渲染框架無需改 Prompt
  • 安全性 — 聲明式數據,無代碼執行
  • 可測試 — 內容邏輯與 UI 獨立測試

為什麼選擇 @zhama/a2ui?

特性 @zhama/a2ui 等待官方
可用時間 現在 2026 Q1
React 18 支持 支持 -
完整組件庫 15+ 組件 -
TypeScript 100% -
獨立樣式系統 支持 -
中文文檔 支持 -
開源協議 MIT -
生產可用 支持 -

參與貢獻

我們歡迎社區參與!無論是:

  • 提交 Issue
  • 功能建議
  • 完善文檔
  • 提交 PR

都非常歡迎!

GitHub 倉庫: https://github.com/zhama-ai/a2ui-react


資源鏈接


未來展望

A2UI 代表了 AI 交互的未來方向。隨著協議的成熟,我們將持續:

  • 跟進 A2UI 協議版本更新
  • 擴展更多組件類型
  • 提供更多主題選項
  • 優化移動端體驗
  • 增加插件擴展能力

最後

AI 時代已經到來,但 AI 的表達方式還在進化。

從純文本 → Markdown → 結構化數據 → 動態交互界面

A2UI 讓 AI 不再只是「說」,而是真正地「做」。

現在就開始使用 @zhama/a2ui,讓你的 AI 應用擁有真正的交互能力!

npm install @zhama/a2ui

如果覺得有幫助,請給我們 Star!

GitHub | NPM | 文檔

Made with love by Zhama AI


本文首發於 Zhama AI 公眾號,轉載請註明出處。


附錄:常見問題

Q: A2UI 和普通 React 組件有什麼區別?

A2UI 組件專為 AI 動態生成設計。AI 輸出的是結構化數據(JSON),而非代碼。這意味著:

  • 更安全(無代碼注入風險)
  • 更靈活(數據驅動,易於修改)
  • 更適合 AI(LLM 擅長生成結構化數據)

Q: 可以不用 AI 直接使用 A2UI 嗎?

可以!雖然 A2UI 專為 AI 設計,但你完全可以手動構建 ComponentNode 結構。只是比傳統 React 開發更繁瑣。

Q: 支持哪些 LLM?

任何能輸出 JSON 的 LLM 都可以:

  • GPT-4 / GPT-3.5 (OpenAI)
  • Claude 3 (Anthropic)
  • Gemini Pro (Google)
  • 各類開源模型

Q: 如何自定義樣式?

A2UI 提供多種自定義方式:

  1. 通過 ThemeProvider 的 theme 屬性覆蓋組件樣式
  2. 直接覆蓋 CSS 變量
  3. 添加自定義 CSS 類

Q: 生產環境可用嗎?

是的!@zhama/a2ui 已在多個生產應用中使用,穩定可靠。我們遵循語義化版本控制,確保升級平滑。

16 個開箱即用的 TeGo 模板技能:IT 運維 + 跨境電商,一上線就能跑

TeGo v3.0.0 一次性補齊了 16 個 TeGo 系列模板技能,覆蓋 IT 運維與跨境電商兩條最高頻的產業鏈路。每個技能都附帶可執行 bash 腳本,不是「提示詞模板」,而是真正能跑——本文系統介紹這 16 個技能、對應業務流程,以及與 per_user / 模板治理 / BusinessMonitor 是怎麼聯動的。

微信交流群二維碼 微信公眾號二維碼