Cai dat Site AI Agent: bat chatbot, mau bubble, kich thuoc, vi tri
Frontend Site AI Agent

DINHDANH Creator · Bài G06 · Trung bình

Frontend AI Agent:
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

Nav CMS → AI Agent
├─ Frontend AI Agent (bài này) - bubble trên site công khai, trả lời khách
└─ CMS AI Agent (bài G07) - bubble trong panel CMS, giúp admin quản nội dung
Công tắc chính: Bật Site AI Agent (tab Cấu hình)
→ Bật master = hiện bubble khách; CMS Agent mặc định cũng bật (có thể tắt riêng ở G07)
→ Token AI tính vào hạn mức tháng của chủ site

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:

1. System prompt tùy chỉnh (tab Build prompt) - bắt buộc; vai trò, giọng điệu, ngôn ngữ
2. Thông tin website (tuỳ chọn) - tên site, thương hiệu, slogan, email, tổ chức, mạng xã hội từ Cài đặt website
3. Danh sách chỉ mục - nhãn dạng [Tag] Tên; nội dung Markdown chỉ lấy khi câu hỏi khớp
4. Sản phẩm đã publish - tra catalog live (tên, giá, mô tả…)
→ Trả lời khách trên bubble site · lịch sử phiên lưu để admin xem (G07)
NguồnDùng đểKhông gồm
Prompt tùy chỉnhLuật trả lời, phong cách, phạm vi hỗ trợPrompt trống → chat không chạy
Thông tin websiteGiờ/địa chỉ/SĐT/brand đã điền ở Cài đặtTrường để trống thì không chèn
Chỉ mục kiến thứcFAQ, chính sách, mô tả dịch vụ bạn viết tayKhông tự lấy bài blog chưa đưa vào chỉ mục
Sản phẩm publishHỏi giá, tồn, mô tả sản phẩm đang bánBả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ĩaNơi thấy trên UI
Frontend AI AgentChatbot 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 AgentCông tắc chính hiện bubble kháchTab Cấu hình
Build promptSystem prompt + chèn site info + chỉ mục - nguồn “não” của Frontend AgentTab Build prompt
Tin nhắn chàoBubble đầu khách thấy; MarkdownTab Cấu hình
CMS AI AgentTrợ 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

  1. CMS → nav AI Agent → tab Cấu hình → bật Bật Site AI Agent.
  2. 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.”
  3. (Khuyến nghị) Bật Tự động chèn thông tin website nếu đã điền Cài đặt website (G05).
  4. 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.
  5. 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.
  6. Tab Cấu hình: welcome, palette, size, vị trí, model → lưu.
  7. 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 AgentCMS Agent (G07)Creator AI
Ai dùngKhách siteAdmin CMSNgười dựng app
Việc chínhTrả lời hỏi đápTổng quan + đọc/ghi nội dungSửa code VDisk
PromptBuild prompt bạn viếtPrompt hệ thống riêngPrompt & skills Creator
Ghi dữ liệuKhôngNháp nếu bật quyềnFile 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ốngXử lý
Không thấy bubbleBật Site AI Agent + lưu; mở URL live; hard refresh
Thiếu prompt / không trả lờiBuild 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

  1. Bạn kể được 4 nguồn kiến thức Frontend Agent dùng khi trả lời?
  2. Bạn phân biệt Frontend Agent vs CMS Agent vs Creator AI?
  3. 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.

DINHDANH Creator · Bộ hướng dẫn người dùng · G06