Onboarding từng bước (Wizard)

Giao diện Wizard Onboarding (/app/onboarding) dẫn dắt bạn thiết lập Trợ lý AI và nạp bộ não kiến thức ban đầu — toàn bộ wizard mất khoảng 15 phút (nút “Bắt đầu” khởi tạo Agent đầu tiên trong ~2 phút).

Giao diện quy trình gồm 4 giai đoạn (PHASES = ['story', 'template', 'chat', 'done']):

flowchart LR
  S1[❶ Câu chuyện<br/>story] --> S2[❷ Chọn ngành<br/>template]
  S2 --> S3[❸ Dạy AI qua chat<br/>chat]
  S3 --> S4[❹ Hoàn tất & Kết nối<br/>done]

---

❶ Giai đoạn 1: Câu chuyện Hero (story)

Màn hình giới thiệu sự khác biệt trước và sau khi ứng dụng Trợ lý AI:

• Trước khi dùng AI:
  • 03:00 sáng: Vẫn phải thức nhắn tin trả lời từng khách.
  • 09:00 sáng: Ngập trong hàng trăm tin nhắn tồn đọng chưa đọc.
• Sau khi dùng AI:
  • 03:00 sáng: AI tự động chốt đơn và chăm sóc khách 24/7.
  • 09:00 sáng: Bạn chỉ việc vào duyệt các đơn hàng và công việc chất lượng cao.

Nút bấm hành động:

• “Bắt đầu — chỉ 2 phút” (onboarding.start_2_min): Khởi tạo Trợ lý AI đầu tiên trong ~2 phút rồi chuyển sang Giai đoạn 2 (toàn bộ wizard ~15 phút).
• “Bỏ qua, vào app ngay” (onboarding.skip_to_app): Bỏ qua wizard và đi thẳng tới Dashboard.

---

❷ Giai đoạn 2: Chọn mẫu ngành nghề (template)

TrolyPage cung cấp danh mục mẫu Trợ lý AI được tối ưu sẵn theo ngành nghề.

Danh mục ngành nghề

Hệ thống hiển thị lưới chọn template ngành:

• Thời trang & Phụ kiện (fashion)
• Mỹ phẩm & Làm đẹp (cosmetics)
• Thực phẩm & Đặc sản (food)
• Đồ điện tử & Gia dụng (electronics)
• Nội thất & Decor (furniture)
• Sức khỏe & Thực phẩm chức năng (health)
• Du lịch & Khách sạn (travel)
• Giáo dục & Khóa học (education)
• Bất động sản (realestate)
• Dịch vụ & Spa (services)
• F&B (Nhà hàng, Quán ăn) (fnb)
• Ngành khác (Mặc định) (other)

Thao tác

1. Chọn 1 ô ngành nghề phù hợp.
2. Bấm nút “Tiếp tục” (onboarding.btn_continue / onboarding.btn_continue_other).
3. Hệ thống hiển thị hiệu ứng creating_agent (“Đang khởi tạo Trợ lý AI…”) và tự động áp dụng System Prompt + bộ công cụ của ngành đó.

---

❸ Giai đoạn 3: Dạy AI qua trò chuyện (chat)

Đây là bước quan trọng nhất — phỏng vấn và nạp kiến thức đầu tiên cho AI.

Cách thức hoạt động

1. AI Agent gửi câu chào đầu tiên phù hợp với ngành bạn đã chọn.
2. AI tự động đặt các câu hỏi phỏng vấn gợi ý (vd: “Shop mình bán sản phẩm gì?”, “Giá khoảng bao nhiêu?”, “Phí ship và chính sách đổi trả thế nào?”).
3. Bạn gõ câu trả lời tự nhiên vào ô chat.
4. Backend tự động phân tích (extraction) và trích xuất thành các Facts V4 có cấu trúc.

Thanh tiến trình kiến thức (Knowledge Progress)

Phía trên khung chat hiện thanh tiến trình onboarding.knowledge_collected:

• Trạng thái Chưa đủ: AI cần thêm thông tin tối thiểu (Sản phẩm, Giá, Ship, Đổi trả).
• Trạng thái Sẵn sàng (onboarding.knowledge_ready): Đạt 100% kiến thức cốt lõi.

Xem AI thử nghiệm (Demo Reply)

• Sau vài câu hội thoại, nút “Xem AI trả lời khách thử” (onboarding.see_ai_reply) sẽ sáng lên.
• Bạn bấm vào → AI tự đóng vai khách hỏi một câu thực tế (“Shop ship HCM bao nhiêu?”, “Mẫu này còn size M không?”) và sinh câu trả lời để bạn kiểm tra chất lượng.

Khi hoàn tất, bấm “Xong, vào Dashboard” (onboarding.done_to_dashboard) để chuyển sang Giai đoạn 4.

---

❹ Giai đoạn 4: Hoàn tất & Kết nối (done)

Khi đạt 100% onboarding:

• Hiệu ứng pháo hoa Confetti 🎉 chúc mừng (onboarding.agent_ready).

• Checklist 3 mục đã hoàn thành:

  1. ✅ check_created: Đã khởi tạo Trợ lý AI.
  2. ✅ check_knowledge: Đã nạp bộ não kiến thức ban đầu.
  3. ✅ check_connect: Đã sẵn sàng nhận kênh giao tiếp.

• Nút “Đến Trang chủ” (onboarding.go_to_dashboard): Chuyển tới Dashboard /app/home.

Giao diện Checklist 6 bước trên Dashboard

Sau khi hoàn tất Wizard 4 giai đoạn ban đầu, bạn có thể tiếp tục hoàn thành Checklist 6 bước trên Dashboard (Tạo Agent, Thêm kiến thức, Kết nối kênh, Brand Kit, Kích hoạt AI Routing…).

Bước tiếp theo

• Tổng quan Dashboard — Đọc 6-step setup checklist và KPI.
• Tổng quan Hộp thư — Quản lý hội thoại.
• Thêm nội dung Knowledge — Nạp thêm file/website cho AI.