
DINHDANH Creator · Bài G06 · Trung bình
cơ chế & chatbot khách trên site
Hiểu cách Frontend Agent trả lời khách từ prompt tùy chỉnh + thông tin website + sản phẩm publish + chỉ mục - rồi bật bubble trên site live.
Mục tiêu bài học: Nắm cơ chế Frontend AI Agent (nguồn kiến thức → trả lời khách), phân biệt với CMS Agent / Creator AI, và bật bubble trên site live.
Thời lượng đọc: khoảng 15 phút
Điều kiện trước: Đã vào được Aura CMS (G01); site đã Lưu thay đổi ít nhất một lần; nên có sản phẩm đã publish nếu muốn chatbot trả lời catalog (G03).
Bài trước → sau: G05 → G06 → G07 (CMS Agent · Build prompt · Lịch sử)
1. Hai agent trong Site AI Agent
Cả hai khác Creator AI Agent (sửa HTML/CSS/JS trong App Editor) và khác MCP (IDE - H02).
2. Cơ chế Frontend AI Agent
Khi khách mở bubble và gửi câu hỏi, agent ghép kiến thức theo thứ tự sau rồi trả lời:
| Nguồn | Dùng để | Không gồm |
|---|---|---|
| Prompt tùy chỉnh | Luật trả lời, phong cách, phạm vi hỗ trợ | Prompt trống → chat không chạy |
| Thông tin website | Giờ/địa chỉ/SĐT/brand đã điền ở Cài đặt | Trường để trống thì không chèn |
| Chỉ mục kiến thức | FAQ, chính sách, mô tả dịch vụ bạn viết tay | Không tự lấy bài blog chưa đưa vào chỉ mục |
| Sản phẩm publish | Hỏi giá, tồn, mô tả sản phẩm đang bán | Bản nháp · liên hệ · đơn hàng · bài chưa publish |
3. Chức năng Frontend Agent (cho khách & chủ site)
- Hỗ trợ khách 24/7 trên site live - không cần login CMS.
- Trả lời theo kiến thức bạn dựng: prompt + site info + chỉ mục + catalog sản phẩm đã publish.
- Hội thoại nhiều lượt trong cùng lần mở bubble; đóng/F5 có thể mất ngữ cảnh trên máy khách - phiên vẫn lưu ở Lịch sử chat để bạn xem (G07).
- Không ghi CMS: khách không tạo/sửa bài, sản phẩm hay đơn qua bubble này.
- Giao diện: welcome Markdown, màu, size, vị trí, model (DeepSeek / OpenAI) - dùng chung theme với CMS Agent.
4. Thuật ngữ
| Thuật ngữ | Nghĩa | Nơi thấy trên UI |
|---|---|---|
| Frontend AI Agent | Chatbot khách trên website công khai (một nửa của Site AI Agent) | Bubble góc site live |
| Bật Site AI Agent | Công tắc chính hiện bubble khách | Tab Cấu hình |
| Build prompt | System prompt + chèn site info + chỉ mục - nguồn “não” của Frontend Agent | Tab Build prompt |
| Tin nhắn chào | Bubble đầu khách thấy; Markdown | Tab Cấu hình |
| CMS AI Agent | Trợ lý admin trong panel - đọc/ghi nội dung theo quyền (G07) | Tab CMS Agent |
5. Bật Frontend Agent - từng bước
- CMS → nav AI Agent → tab Cấu hình → bật Bật Site AI Agent.
- Tab Build prompt: viết System prompt (bắt buộc). Ví dụ: “Bạn là trợ lý cửa hàng… trả lời ngắn bằng tiếng Việt.”
- (Khuyến nghị) Bật Tự động chèn thông tin website nếu đã điền Cài đặt website (G05).
- Thêm vài chỉ mục FAQ/chính sách nếu cần (chi tiết thao tác ở G07) → Lưu Build prompt.
- Publish sản phẩm muốn bot bán/giới thiệu (G03) - chỉ bản publish mới vào Frontend Agent.
- Tab Cấu hình: welcome, palette, size, vị trí, model → lưu.
- Mở site live (ẩn danh) → mở bubble → hỏi thử giờ mở cửa / tên sản phẩm / chính sách giao hàng.
6. So sánh nhanh
| Tiêu chí | Frontend Agent | CMS Agent (G07) | Creator AI |
|---|---|---|---|
| Ai dùng | Khách site | Admin CMS | Người dựng app |
| Việc chính | Trả lời hỏi đáp | Tổng quan + đọc/ghi nội dung | Sửa code VDisk |
| Prompt | Build prompt bạn viết | Prompt hệ thống riêng | Prompt & skills Creator |
| Ghi dữ liệu | Không | Nháp nếu bật quyền | File nháp (chưa Lưu) |
7. Giới hạn kỹ thuật
Làm được
- Trả lời từ prompt + site info + chỉ mục + SP publish
- Chỉnh welcome, palette, size, vị trí, model
- Lưu phiên để admin xem lịch sử
Hạn chế
- Thiếu system prompt → chat không chạy
- Không đọc contacts / orders / bản nháp
- Token khách trừ hạn mức chủ site
8. Vấn đề thường gặp
| Tình huống | Xử lý |
|---|---|
| Không thấy bubble | Bật Site AI Agent + lưu; mở URL live; hard refresh |
| Thiếu prompt / không trả lời | Build prompt → System prompt → Lưu |
| Hỏi SP không biết giá | Publish sản phẩm (G03) hoặc thêm chỉ mục |
| Bot không biết địa chỉ/SĐT | Điền Cài đặt website + bật chèn thông tin website |
9. Checklist tự kiểm
- Bạn kể được 4 nguồn kiến thức Frontend Agent dùng khi trả lời?
- Bạn phân biệt Frontend Agent vs CMS Agent vs Creator AI?
- Bubble live trả lời đúng theo prompt / site info / sản phẩm publish?
Bài tiếp theo
G07 - CMS AI Agent: quản nội dung bằng AI + lịch sử
Tổng quan site, đọc liên hệ/đơn, tạo-sửa bài / sản phẩm / custom type (nháp), và quản lý toàn bộ lịch sử phiên chat.
Điều hướng nội bộ (cùng ngôn ngữ)
DINHDANH Creator · Bộ hướng dẫn người dùng · G06