A2UI 官方网站正式上线：完整入门指南

开发者社区的好消息：a2ui.org 正式上线！ Google 的官方 A2UI 网站为文档、规范和入门资源提供了一个中央枢纽。

在本文中，我们将带您了解该网站上有哪些资源，以及如何迈出 A2UI 开发的第一步。

[!IMPORTANT] 更新 (2026年1月): A2UI 现已正式开源！ 本文介绍的是最初的网站上线预览。有关官方公开发布、参考实现和开源仓库的最新详细信息，请阅读我们的新专题文章：A2UI 正式开源。

什么是 a2ui.org？

a2ui.org 是 A2UI 项目的官方主页。它充当：

A2UI 规范的 权威来源。
面向构建 A2UI 客户端或 Agent 的开发者的 文档中心。
链接到 GitHub、Discord 和贡献指南的 社区入口。

专业提示 (E-E-A-T)：始终以 a2ui.org 作为最新规范的参考来源。第三方教程可能会随着协议向 v1.0 演进而过时。

a2ui.org 上的核心资源

1. A2UI 规范

定义 Agent 如何描述 UI 组件的核心 JSON 模式。这是以下内容的 唯一事实来源 (Single Source of Truth)：

组件类型 (button, form, datePicker 等)
操作定义 (用户交互时发生什么)
状态管理模式

2. 客户端渲染器库

用于在您的应用程序中渲染 A2UI JSON 的官方库：

平台	库	状态
Flutter	`a2ui_flutter`	✅ 稳定
Angular	`@a2ui/angular`	✅ 稳定
Web (Lit)	`@a2ui/lit`	✅ 稳定
React	`@a2ui/react`	⏳ 2026 年 Q1

3. Agent 集成指南

将 A2UI 集成到您的 AI Agent 中的分步教程，无论您使用的是：

Vertex AI Agent Builder (参阅我们的专题文章)
LangChain / LangGraph
自定义 LLM 管道

4. 安全最佳实践

一个专门介绍为什么 A2UI 选择 JSON 以及组件目录模型如何防止 UI 注入攻击的章节。

快速入门：您的第一个 A2UI Agent

以下是一个 A2UI JSON 负载的最小示例：

{
  "components": [
    {
      "id": "greeting",
      "type": "text",
      "content": "你好！有什么我可以帮您的？"
    },
    {
      "id": "dateInput",
      "type": "datePicker",
      "label": "选择日期",
      "action": "selectDate"
    },
    {
      "id": "submitBtn",
      "type": "button",
      "label": "提交",
      "action": "submitForm"
    }
  ]
}

当您的客户端应用程序接收到此负载时，它会使用其自身的 UI 框架渲染一个原生文本元素、一个日期选择器和一个按钮。

为什么这很重要？

a2ui.org 的上线标志着 A2UI 正在超越”实验性”阶段。拥有专属网站意味着：

提高可见性：开发者更容易发现和学习。
社区建设：一个用于讨论和贡献的中心场所。
增强企业信心：一个专业的形象，让企业采用者更加放心。

下一步是什么？

随着官方网站的上线，我们建议：

收藏 a2ui.org 以获取规范更新。
Star GitHub 仓库 以跟踪开发进度。
加入社区 以对 A2UI 路线图提供反馈。