Tổng quan
AI App là ứng dụng AI được tích hợp trực tiếp vào giao diện Chat của V-App thông qua giao thức Model Context Protocol (MCP). Thay vì cung cấp giao diện riêng biệt như Mini App, AI App hoạt động trong ngữ cảnh hội thoại — cho phép người dùng tương tác bằng ngôn ngữ tự nhiên, trong khi model AI tự động gọi các tools phù hợp và hiển thị kết quả bằng widget trực quan.
Ví dụ: Người dùng nhắn "Đặt phòng họp lúc 3h chiều thứ 5" → AI gọi tool
book_room→ Widget hiển thị form xác nhận → Người dùng bấm "Xác nhận" → AI trả lời "Đã đặt phòng thành công."
Mini App vs AI App
| Tiêu chí | Mini App | AI App |
|---|---|---|
| Cách tiếp cận | UI-first — giao diện phong phú, tích hợp sâu | AI-first — hội thoại tự nhiên, widget hỗ trợ |
| Giao diện | Full WebView, navigation riêng | Widget inline trong chat (iframe) |
| Tương tác | Người dùng navigate, click, nhập form | Người dùng nhắn tin, AI gọi tools |
| Entry point | Menu app, QR code, deep link | Prompt tự nhiên, launcher, gợi ý từ AI |
| Backend | REST API, GraphQL | MCP Server (tools, resources) |
Kiến trúc tổng quan
AI App được xây dựng từ 3 thành phần chính:
┌─────────────────────────────────────────────────────┐
│ Host App (V-App) │
│ ┌───────────────┐ ┌────────────┐ ┌─────────────┐ │
│ │ Chat UI │ │ LLM Server │ │ MCP Gateway │ │
│ │ (user input) │→ │ (reasoning)│→ │ (routing) │ │
│ └───────┬───────┘ └────────────┘ └──────┬──────┘ │
│ │ │ │
│ ┌───────▼───────┐ ┌──────▼──────┐ │
│ │ Widget (iframe)│ ◄──postMessage──│ MCP Server │ │
│ │ (AI App UI) │ │ (your code) │ │
│ └───────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────┘
- MCP Server — Backend của bạn. Định nghĩa tools (hành động AI có thể gọi), xử lý logic, trả về dữ liệu.
- Widget — Frontend chạy trong iframe. Hiển thị UI từ dữ liệu tool trả về, cho phép user tương tác (click, submit form) rồi gọi lại tools.
- Host App (V-App) — Nền tảng Chat. Nhận input người dùng, gửi tới LLM, LLM gọi tools qua MCP Gateway, hiển thị widget.
Bắt đầu từ đâu?
| Mục tiêu | Đọc gì |
|---|---|
| Tạo AI App đầu tiên trong 10 phút | Bắt đầu |
| Hiểu cách AI App hoạt động | Khái niệm chính |