Bỏ qua tới nội dung
Ông T.vn

A2UI: để AI agent tự dựng giao diện gốc trên web và mobile — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

Bài này là một góc nhìn khác về a2ui-project/a2ui — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: A2UI: để AI agent tự dựng giao diện thật trên web và mobile — hướng dẫn cài đặt và dùng →

A2UI: để AI agent tự dựng giao diện gốc trên web và mobile — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

A2UI (Agent-to-User Interface) là framework mã nguồn mở, giấy phép Apache-2.0. Nó giúp AI agent trả lời bằng giao diện thật (nút, form, biểu đồ) thay vì chỉ chữ, bằng cách gửi dữ liệu mô tả UI mà ứng dụng tự vẽ. Muốn thử nhanh thì không cần cài gì, dùng A2UI Composer trên trình duyệt; còn tích hợp vào ứng dụng thì cần biết lập trình.

A2UI (Agent-to-User Interface) là một framework mã nguồn mở giúp AI agent không chỉ trả lời bằng chữ mà còn “nói” bằng giao diện thật: nút bấm, form, danh sách, thẻ thông tin. Agent không gửi code. Nó gửi dữ liệu mô tả giao diện, còn ứng dụng của bạn tự vẽ ra bằng thành phần gốc của chính ứng dụng đó.

Repo này dành cho lập trình viên và nhóm làm sản phẩm đang xây chatbot, trợ lý ảo hoặc ứng dụng có agent. Nếu bạn không code, bạn vẫn thử được phần “nhìn thấy” ngay trên trình duyệt qua công cụ A2UI Composer, không cần cài gì. Hiện repo có khoảng 17.220 sao và 1.395 fork, dùng giấy phép Apache-2.0.

Điều đáng giá nhất là cách làm: giao diện được biểu diễn bằng dữ liệu có schema chặt chẽ, nên agent chỉ dùng được những thành phần mà ứng dụng cho phép. Với agent của bên thứ ba hoặc agent hay “bịa”, đây là lớp rào chắn rất có ích.

Framework

a2ui-project/a2ui

A2UI là framework mã nguồn mở để AI agent gửi dữ liệu mô tả giao diện, rồi ứng dụng vẽ ra bằng thành phần gốc (React, Angular, Flutter, SwiftUI, Compose).

★ 17kTypeScriptApache-2.0
Xem repo trên GitHub

I.A2UI làm được gì

A2UI không phải một thư viện đơn lẻ mà là một bộ nhiều lớp. Mỗi lớp giải quyết một việc riêng.

A.Giao diện là dữ liệu, không phải code

Agent mô tả giao diện bằng dữ liệu, được kiểm tra theo một schema. Lợi ích thực tế: agent không thể nhét mã thực thi vào ứng dụng của bạn. Mọi khả năng agent có đều là khả năng chuẩn có sẵn, hoặc do chính bạn cấp.

B.Vẽ bằng thành phần gốc của ứng dụng

A2UI có bộ vẽ (renderer) cho nhiều nền tảng: Lit (web components), Angular, React, Flutter, SwiftUI và Jetpack Compose (theo mô tả của tác giả). Bạn không cần WebView hay HTML để hiển thị. Giao diện giữ được tốc độ và vẻ ngoài như phần còn lại của app.

C.Truyền theo luồng (streaming)

Giao thức được thiết kế để mô hình ngôn ngữ sinh ra hiệu quả và gửi qua mạng với độ trễ thấp, hiển thị dần từng phần. Người dùng thấy giao diện hiện ra từ từ thay vì chờ cả khối.

D.Một agent, nhiều nền tảng

Cùng một agent có thể gửi giao diện tới ứng dụng Flutter, React, SwiftUI hay Compose mà trải nghiệm vẫn thống nhất. Hợp với nhóm có cả web lẫn mobile.

E.Bộ SDK cho agent và các “catalog” thành phần

Phía agent có SDK bằng Python, TypeScript và Dart. Chúng thương lượng catalog thành phần, tạo prompt và skill, rồi biên dịch đầu ra của mô hình thành thông điệp A2UI. Có thêm cầu nối tới giao thức A2A và Agent Development Kit (ADK) ở Python, catalog MCP (gọi công cụ MCP và vẽ kết quả), và catalog VegaChart để vẽ biểu đồ Vega/Vega-Lite (gói này README ghi là chưa phát hành, dùng từ mã nguồn).

F.Công cụ thử không cần cài

README có A2UI Composer (soạn giao diện bằng trình soạn trực quan, ra JSON để dán vào prompt) và A2UI Theater (xem các kịch bản streaming có sẵn trên Lit, React, Angular).

II.Cần chuẩn bị gì

Tư liệu repo nói khá ít về yêu cầu chung, nên mình chỉ ghi những gì có thật:

  • Để thử nhanh: chỉ cần trình duyệt. Composer và Theater đều ghi là không cần cài.
  • Để chạy từ mã nguồn bằng Python: file pyproject.toml yêu cầu Python từ 3.10 trở lên.
  • Repo có package.json (tên gói npm gốc là a2ui-workspace) và pyproject.toml, nên phần TypeScript cần Node và phần Python cần Python. README không nêu phiên bản Node cụ thể.
  • Repo có thư mục dart, kotlin, swift. Phần Swift phân phối qua Swift Package Manager từ Package.swift ở gốc repo.
  • Cần một agent hoặc mô hình ngôn ngữ phía sau. README không nói bạn phải dùng nhà cung cấp nào, và cũng chưa nói rõ về API key hay GPU. Nếu Quickstart yêu cầu key, bạn sẽ thấy ở đó.

Repo này không tự có “bộ não” AI. Nếu bạn nối nó với một mô hình có tính phí, chi phí gọi mô hình là chi phí của bạn. Khi làm theo Quickstart, nếu được yêu cầu nhập API key, hãy để key trong biến môi trường hoặc file cấu hình cục bộ, đừng dán vào mã rồi đẩy lên GitHub.

III.Cài đặt từng bước

Lưu ý trung thực: README chưa ghi một dòng lệnh cài đặt cụ thể nào. Nó chỉ trỏ tới trang Quickstart và bảng liệt kê các gói. Vì vậy mình không bịa lệnh. Dưới đây là lộ trình an toàn dựa trên đúng những gì README nói.

  1. Thử không cần càiMở A2UI Composer hoặc A2UI Theater trên trình duyệt để hiểu A2UI hoạt động ra sao
  2. Đọc QuickstartLàm theo trang Quickstart (khoảng 5 phút) để dựng ứng dụng đầy đủ có backend và frontend
  3. Tải mã nguồnDùng git clone để lấy repo về nếu muốn đọc ví dụ hoặc dùng gói chưa phát hành
  4. Chọn gói đúng nền tảngChọn renderer và SDK agent khớp với ngôn ngữ app của bạn
  5. Xem file khai báoĐọc package.json, pyproject.toml và thư mục samples để biết cách chạy từ mã nguồn

A.Thử trên trình duyệt trước

Mở A2UI Composer tại https://a2ui-project.github.io/composer/. Đây là trình soạn trực quan, bạn kéo thả giao diện rồi lấy JSON dán vào prompt của agent. Muốn xem giao diện hiện ra theo luồng, vào A2UI Theater tại https://a2ui-composer.ag-ui.com/theater. Cả hai chưa cần cài gì, mất khoảng một phút.

B.Làm theo Quickstart

Trang Quickstart tại https://a2ui.org/quickstart/ hướng dẫn dựng một ứng dụng A2UI đầy đủ, có cả backend lẫn frontend, trong khoảng 5 phút. Mình không chép lệnh ở đây vì README không có lệnh, và trang đó có thể thay đổi theo từng phiên bản. Bạn mở trang, làm đúng từng dòng.

C.Tải mã nguồn về máy

Nếu bạn muốn xem ví dụ hoặc dùng các gói mà README ghi “Not published yet” (dùng từ mã nguồn), hãy tải repo về. Mở terminal (PowerShell trên Windows, Terminal trên macOS/Linux) rồi chạy:

Terminal
git clone https://github.com/a2ui-project/a2ui.git
cd a2ui

Lệnh đầu tải toàn bộ repo về một thư mục tên a2ui. Lệnh thứ hai đi vào thư mục đó. Người mới hay vấp ở chỗ chạy lệnh sai thư mục, nên mọi lệnh sau nhớ chạy khi terminal đang ở trong thư mục a2ui. Máy cần có Git.

D.Chọn gói đúng nền tảng

README chia gói theo ngôn ngữ. Bạn chỉ cần lấy phần mình dùng:

  • Web: @a2ui/web_core là lõi, cộng thêm một renderer: @a2ui/lit, @a2ui/angular hoặc @a2ui/react. Có thêm @a2ui/markdown-it để vẽ Markdown.
  • Agent bằng TypeScript: @a2ui/agent.
  • Agent bằng Python: a2ui-core, a2ui-agent-sdk, cùng a2ui-a2a (cho A2A) hoặc a2ui-adk (cho ADK).
  • Flutter/Dart: a2ui_core, a2ui_agent, a2ui_flutter, và công cụ a2ui_cli (tải ở trang GitHub Releases).
  • iOS/macOS: thư viện Swift gồm A2UISwiftCore, BasicCatalog, A2UISwiftUI, BasicCatalogSwiftUI, qua Swift Package Manager từ Package.swift ở gốc repo.

README không ghi lệnh cài (ví dụ npm install hay pip install) cho từng gói. Cách chính xác nằm ở trang Quickstart và tài liệu tại https://a2ui.org/. Bạn cũng nên xem thư mục docs/ và samples/ trong repo.

E.Xem cách chạy từ mã nguồn

Trong thư mục gốc có package.json, yarn.lock, pyproject.toml và uv.lock, cho thấy dự án dùng workspace cho cả TypeScript lẫn Python. Hãy mở CONTRIBUTING.md và AGENTS.md để biết cách dựng môi trường phát triển chính thức, thay vì đoán lệnh.

IV.Kiểm tra đã chạy được chưa

README không nêu một lệnh kiểm tra chuẩn. Dựa trên tư liệu, bạn có thể coi là thành công khi:

  • Ở Composer hoặc Theater: bạn thấy giao diện hiện ra và thay đổi khi bạn thao tác hoặc bước qua từng kịch bản.
  • Ở Quickstart: ứng dụng có backend và frontend chạy lên, bạn hỏi agent và nhận lại giao diện (nút, form, thẻ) thay vì chỉ chữ. Màn hình cụ thể sẽ do trang Quickstart mô tả.
  • Khi tự tích hợp: agent trả thông điệp A2UI hợp lệ, và renderer của bạn vẽ được chúng. Nếu thông điệp sai schema, bạn sẽ không thấy giao diện, và đó cũng là cơ chế bảo vệ của A2UI.

Nếu bạn tải mã nguồn, thư mục conformance/ và eval/ cho thấy repo có bộ kiểm tra tuân thủ và đánh giá. Bạn có thể xem chúng để biết cách kiểm thử chính thức.

V.Dùng vào việc thật

A2UI là công cụ cho người làm sản phẩm. Dưới đây là các tình huống bám sát những gì repo nói.

A.Chủ shop muốn hình dung trợ lý bán hàng có giao diện

Bạn kinh doanh online và đang nghĩ đến một trợ lý trả lời khách bằng thẻ sản phẩm, nút “Đặt hàng”, form nhập địa chỉ. Chưa cần lập trình viên, bạn mở A2UI Composer, dựng thử bố cục bằng trình soạn trực quan rồi lấy JSON. Sau đó bạn đưa cho đội kỹ thuật để họ dán vào prompt của agent. Kết quả: có một bản mẫu cụ thể để thống nhất với người làm kỹ thuật, thay vì mô tả bằng lời.

Giao diện là dữ liệu, không phải code: agent chỉ được vẽ những gì bạn đã cho phép.

Ông T

B.Dev web muốn agent hiện form thay vì hỏi từng câu

Bạn là lập trình viên React hoặc Angular, có chatbot hỗ trợ khách. Thay vì hỏi “Tên bạn là gì? Số điện thoại?” từng câu, bạn muốn agent dựng ngay một form. Bạn dùng @a2ui/web_core cùng renderer @a2ui/react (hoặc Angular), phía agent dùng SDK để biên dịch đầu ra mô hình thành thông điệp A2UI. Yêu cầu mẫu cho agent có thể là: “Khách muốn đặt lịch hẹn, hãy hiển thị form chọn ngày giờ và nhập số điện thoại.” Kết quả: form được vẽ bằng component React của chính ứng dụng, giữ đúng phong cách thương hiệu.

C.Nhóm mobile cần một agent phục vụ cả iOS, Android và web

Công ty bạn có app Flutter hoặc SwiftUI cùng một web. Bạn muốn một agent duy nhất. Với A2UI, agent phát cùng một dạng thông điệp, mỗi nền tảng dùng renderer riêng (a2ui_flutter, A2UISwiftUI, hoặc renderer web). Kết quả: trải nghiệm thống nhất, bạn không phải viết lại logic hiển thị cho từng nền tảng. Công cụ a2ui_cli còn sinh sẵn code component có kiểu dữ liệu chặt từ một catalog.

D.Dev có agent từ bên thứ ba, cần rào chắn an toàn

Bạn gắn một agent từ xa hoặc của đối tác vào app, và không muốn nó đụng vào dữ liệu nhạy cảm như số thẻ hay thông tin cá nhân. A2UI cho bạn chỉ định catalog thành phần được phép, kiểm tra đầu vào và đầu ra theo schema, và không cho chạy mã tuỳ ý. Kết quả: agent chỉ ghép được các “viên gạch” bạn cho phép. Nếu cần gọi công cụ MCP và hiện kết quả, có gói @a2ui/catalog-mcp.

VI.Lỗi hay gặp và cách xử lý

A.Không tìm thấy lệnh cài đặt trong README

Đây là điều đầu tiên bạn sẽ gặp. README chỉ dẫn tới Quickstart và tài liệu. Cách xử lý: làm theo https://a2ui.org/quickstart/, rồi xem CONTRIBUTING.md và thư mục samples/ trong repo. Đừng tự đoán tên gói rồi cài, vì dễ cài nhầm gói không liên quan.

B.Gói “Not published yet” không cài được từ kho công khai

Ví dụ @a2ui/catalog-vegachart được README ghi là chưa phát hành. Gói loại này phải dùng từ mã nguồn trong repo đã tải. Hãy clone repo và xem cách dùng trong thư mục typescript/.

C.Chạy lệnh sai thư mục

Người mới hay mở terminal ở thư mục khác rồi báo “không thấy file”. Hãy cd vào đúng thư mục a2ui (hoặc thư mục dự án của bạn) trước khi chạy lệnh, và kiểm tra bằng cách liệt kê file xem có package.json hoặc pyproject.toml chưa.

D.Giao diện không hiện dù agent đã trả lời

Thường do thông điệp agent sinh ra sai schema, hoặc thành phần agent dùng không có trong catalog mà ứng dụng cho phép. Vì A2UI kiểm tra chặt, nó sẽ từ chối. Hãy kiểm tra lại catalog đã khai báo và prompt hướng dẫn agent, rồi xem thư mục specification/ để đối chiếu.

E.Python quá cũ

Nếu chạy phần Python mà báo lỗi phiên bản, hãy kiểm tra Python của bạn. pyproject.toml yêu cầu từ 3.10 trở lên. Cập nhật Python rồi thử lại.

VII.Có nên dùng không

Điểm mạnh: ý tưởng rõ (giao diện là dữ liệu), có nhiều renderer cho web lẫn mobile, thiết kế hướng tới an toàn khi agent ở ngoài ranh giới tin cậy, giấy phép Apache-2.0 thoải mái, và repo vẫn được cập nhật trong vài tháng gần đây. Có công cụ thử không cần cài nên đánh giá ban đầu rất rẻ.

Giới hạn: đây là framework cho người làm sản phẩm, không phải ứng dụng bấm là chạy. README chưa ghi lệnh cài cụ thể, nên bạn phải theo tài liệu ngoài. Một số phần còn nằm trong lộ trình (giao thức v1.1, logic chạy trong sandbox, mẫu template dùng chung), và một số gói chưa phát hành. Bạn cũng cần tự lo mô hình ngôn ngữ và chi phí đi kèm.

Khi nào chọn cách khác: nếu bạn chỉ cần chatbot trả lời bằng chữ, hoặc giao diện cố định không cần agent quyết định, A2UI là thừa. Nếu bạn không biết lập trình và chỉ muốn một công cụ có sẵn, hãy dừng ở bước thử Composer và Theater, rồi nhờ đội kỹ thuật đánh giá tiếp.

3.9/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

A2UI có miễn phí không?

Có. Repo dùng giấy phép Apache-2.0, là mã nguồn mở. Tuy nhiên nếu agent của bạn gọi một mô hình AI có tính phí thì khoản đó tách riêng, README không nói gì về chi phí này.

A2UI khác gì việc để AI sinh HTML hoặc code giao diện?

A2UI để agent gửi dữ liệu mô tả giao diện, được kiểm tra theo schema, thay vì mã thực thi. Ứng dụng tự vẽ bằng thành phần gốc, không cần WebView hay HTML. Nhờ vậy ứng dụng kiểm soát được agent làm được gì.

Có chạy được trên Windows không?

Tư liệu không nói riêng về hệ điều hành. README chỉ cho biết có renderer cho web, Flutter, SwiftUI và Jetpack Compose. Phần thử trên trình duyệt (Composer, Theater) thì dùng được trên mọi máy có trình duyệt.

Cần GPU hay máy mạnh không?

Tư liệu chưa có thông tin về phần cứng. Bản thân A2UI là giao thức và các thư viện vẽ giao diện, không phải mô hình AI. Yêu cầu phần cứng sẽ phụ thuộc vào mô hình agent bạn dùng.

Dữ liệu có an toàn không?

Theo README, A2UI đặt an toàn lên đầu: giao diện là dữ liệu được kiểm tra theo schema, không cho chạy mã tuỳ ý, và nhà phát triển quyết định agent được dùng những gì. Điều này giúp bảo vệ ranh giới tin cậy với agent bên thứ ba. Nhưng an toàn thực tế còn phụ thuộc cách bạn cấu hình ứng dụng.

Không biết lập trình có dùng được không?

Bạn thử được phần nhìn thấy bằng A2UI Composer và A2UI Theater ngay trên trình duyệt, không cần cài. Còn để đưa vào ứng dụng thật thì cần lập trình viên, vì phải dùng renderer và SDK agent.

Tích hợp với A2A, ADK hay MCP được không?

Được theo README. Có gói a2ui-a2a cho giao thức A2A, a2ui-adk cho Agent Development Kit, và @a2ui/catalog-mcp để gọi công cụ MCP rồi vẽ kết quả. Cách cấu hình chi tiết xem trong tài liệu chính thức.

Chuyển nhanh tới mục

  1. I.A2UI làm được gì
    1. A.Giao diện là dữ liệu, không phải code
    2. B.Vẽ bằng thành phần gốc của ứng dụng
    3. C.Truyền theo luồng (streaming)
    4. D.Một agent, nhiều nền tảng
    5. E.Bộ SDK cho agent và các “catalog” thành phần
    6. F.Công cụ thử không cần cài
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Thử trên trình duyệt trước
    2. B.Làm theo Quickstart
    3. C.Tải mã nguồn về máy
    4. D.Chọn gói đúng nền tảng
    5. E.Xem cách chạy từ mã nguồn
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop muốn hình dung trợ lý bán hàng có giao diện
    2. B.Dev web muốn agent hiện form thay vì hỏi từng câu
    3. C.Nhóm mobile cần một agent phục vụ cả iOS, Android và web
    4. D.Dev có agent từ bên thứ ba, cần rào chắn an toàn
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Không tìm thấy lệnh cài đặt trong README
    2. B.Gói “Not published yet” không cài được từ kho công khai
    3. C.Chạy lệnh sai thư mục
    4. D.Giao diện không hiện dù agent đã trả lời
    5. E.Python quá cũ
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.