Bắt đầu

Hướng dẫn nhanh để bắt đầu sử dụng AI Assistant trong Noova Manage

Phiên bản: 1.0 | Ngày: 2025-10-19 | Trạng thái: ✅ Hoàn thành

---

📋 Tổng Quan

AI Assistant cho phép bạn tạo và quản lý các chatbot AI để hỗ trợ nhân viên và người dùng. Hướng dẫn này sẽ giúp bạn bắt đầu trong 5 phút.

---

✅ Điều Kiện Tiên Quyết

Trước khi bắt đầu, hãy đảm bảo bạn có:

• ✅ Tài khoản Noova Manage với quyền truy cập AI Assistant

• ✅ Quyền tạo chatbot (AI_CHATBOT_CREATE)

• ✅ Quyền tạo cơ sở tri thức (AI_KB_CREATE)

• ✅ Số dư credits đủ để sử dụng

---

🚀 Bắt Đầu Nhanh (5 phút)

Bước 1: Truy Cập AI Assistant

1. Đăng nhập vào Noova Manage

2. Điều hướng đến Manage → AI → Chatbots

3. Bạn sẽ thấy trang tổng quan chatbot

Bước 2: Tạo Chatbot Đầu Tiên

1. Nhấp vào nút "Tạo Trợ lý AI"

2. Điền thông tin cơ bản:

   • Tên: "Trợ lý HR" (hoặc tên phù hợp)

   • Mô tả: "Hỗ trợ câu hỏi về chính sách nhân sự"

3. Nhấp "Tiếp theo"

Bước 3: Thêm Cơ Sở Tri Thức (Tùy chọn)

1. Nếu bạn có tài liệu:

   • Nhấp "Tạo cơ sở tri thức mới"

   • Đặt tên: "Chính sách HR"

   • Upload tài liệu (PDF, DOCX, TXT)

2. Nếu chưa có tài liệu:

   • Nhấp "Bỏ qua" để tiếp tục

Bước 4: Chọn Mô Hình AI

1. Chọn mô hình:

   • GPT-3.5 Turbo: Nhanh, tiết kiệm chi phí

   • GPT-4 Turbo: Chất lượng cao hơn, chậm hơn

2. Nhấp "Tiếp theo"

Bước 5: Viết System Prompt

1. Nhập hướng dẫn cho chatbot:

Bạn là trợ lý HR chuyên nghiệp của công ty.
Bạn có thể trả lời câu hỏi về:
- Chính sách nghỉ phép
- Quy trình onboarding
- Chính sách làm việc từ xa

Luôn lịch sự, chuyên nghiệp và trích dẫn nguồn.

1. Nhấp "Tạo"

Bước 6: Kiểm Tra Chatbot

1. Chuyển sang tab Console

2. Gửi tin nhắn thử: "Chính sách nghỉ phép là gì?"

3. Xem phản hồi và điều chỉnh nếu cần

---

🎯 Các Khái Niệm Chính

1. Chatbot (Trợ lý AI)

Chatbot là trợ lý AI có thể trò chuyện với người dùng và trả lời câu hỏi.

Thành phần chính:

• Tên: Tên hiển thị của chatbot

• Mô hình AI: GPT-3.5 hoặc GPT-4

• System Prompt: Hướng dẫn cho chatbot

• Cơ sở tri thức: Tài liệu tham khảo (tùy chọn)

Giới hạn: Tối đa 10 chatbots mỗi site

---

2. Cơ Sở Tri Thức (Knowledge Base)

Cơ sở tri thức là bộ sưu tập tài liệu mà chatbot có thể tham khảo.

Loại tài liệu hỗ trợ:

• PDF

• DOCX

• TXT

• MD (Markdown)

Kích thước:

• Tối đa 10MB mỗi file

• Tối đa 100MB mỗi cơ sở tri thức

---

3. System Prompt

System Prompt là hướng dẫn định nghĩa cách chatbot hoạt động.

Nên bao gồm:

• Vai trò của chatbot

• Khả năng và giới hạn

• Phong cách giao tiếp

• Hướng dẫn định dạng phản hồi

Ví dụ tốt:

Bạn là trợ lý IT chuyên nghiệp.
Bạn có thể giúp với:
- Khắc phục sự cố phần cứng
- Hỗ trợ phần mềm
- Yêu cầu truy cập

Luôn hỏi làm rõ khi cần.
Trích dẫn tài liệu khi có thể.

---

4. Display Rules (Quy Tắc Hiển Thị)

Display Rules kiểm soát khi nào và ở đâu chatbot xuất hiện.

Cài đặt cơ bản:

• isVisible: Hiển thị hay ẩn

• displayPriority: Thứ tự ưu tiên (1-100)

• hideWhenLimitExhausted: Ẩn khi hết credits

Quy tắc nâng cao:

• Hiển thị theo vai trò người dùng

• Hiển thị theo trang cụ thể

• Hiển thị theo thời gian

---

5. Widget Appearance (Giao Diện Widget)

Widget Appearance tùy chỉnh giao diện chat widget.

Tùy chọn:

• Màu chủ đề: Màu chính của widget

• Vị trí: Góc dưới phải/trái

• Kích thước icon: Nhỏ, trung bình, lớn

• Hình dạng launcher: Tròn, vuông

• Tin nhắn chào: Tiêu đề và nội dung

---

📚 Các Tác Vụ Thường Gặp

Tạo Chatbot Mới

1. Điều hướng đến Manage → AI → Chatbots

2. Nhấp "Tạo Trợ lý AI"

3. Làm theo wizard 4 bước

4. Kiểm tra trong Console

5. Triển khai lên website

Thời gian: 10-15 phút

Tham khảo: Hướng dẫn Tạo Chatbot

---

Thêm Tài Liệu vào Cơ Sở Tri Thức

1. Điều hướng đến Manage → AI → Knowledge Bases

2. Nhấp vào cơ sở tri thức

3. Nhấp "Upload Documents"

4. Chọn files (PDF, DOCX, TXT)

5. Đợi indexing hoàn tất

6. Kiểm tra trong Console

Thời gian: 5-30 phút (tùy kích thước file)

Tham khảo: Quản Lý Cơ Sở Tri Thức

---

Kiểm Tra Chatbot

1. Mở chatbot trong danh sách

2. Chuyển sang tab Console

3. Gửi tin nhắn thử

4. Xem phản hồi

5. Kiểm tra trích dẫn (nếu có KB)

6. Điều chỉnh system prompt nếu cần

Thời gian: 10-30 phút

Tham khảo: Hướng dẫn Test Console

---

Triển Khai Widget lên Website

1. Mở chatbot Settings

2. Cấu hình Display Rules

3. Tùy chỉnh Widget Appearance

4. Lấy embed code:

<script src="https://yourdomain.com/manage/chat-widget.js"></script>
<script>
  NoovaChat.init({
    ddpUrl: 'https://yourdomain.com/manage',
    autoConnect: true
  });
</script>

1. Thêm vào website trước </body>

2. Kiểm tra trên staging

3. Triển khai lên production

Thời gian: 30-60 phút

Tham khảo: Live Chat Widget

---

Theo Dõi Sử Dụng và Chi Phí

1. Điều hướng đến Manage → AI → Credits

2. Xem số dư hiện tại

3. Kiểm tra usage breakdown

4. Xem allocation orders

5. Thiết lập limit grants nếu cần

Thời gian: 5-10 phút

Tham khảo: Credits & Usage

---

💡 Mẹo Cho Người Mới Bắt Đầu

1. Bắt Đầu Đơn Giản

• Tạo 1 chatbot đầu tiên

• Sử dụng GPT-3.5 (nhanh, rẻ)

• Viết system prompt ngắn gọn

• Kiểm tra kỹ trước khi triển khai

2. Sử Dụng Cơ Sở Tri Thức

• Upload tài liệu chất lượng cao

• Định dạng tài liệu rõ ràng

• Cập nhật thường xuyên

• Kiểm tra độ chính xác

3. Kiểm Tra Kỹ Lưỡng

• Test 20-30 câu hỏi

• Thử các trường hợp khó

• Kiểm tra trên nhiều thiết bị

• Thu thập phản hồi người dùng

4. Tối Ưu Hóa Chi Phí

• Sử dụng GPT-3.5 khi có thể

• Giới hạn độ dài phản hồi

• Thiết lập usage limits

• Theo dõi chi phí thường xuyên

5. Cải Thiện Liên Tục

• Thu thập phản hồi

• Phân tích usage metrics

• Cập nhật system prompt

• Thêm tài liệu mới

---

🔧 Khắc Phục Sự Cố Thường Gặp

Chatbot Không Phản Hồi

Kiểm tra:

• Chatbot status là active

• Mô hình AI đã được chọn

• System prompt không trống

• Số dư credits > 0

• Kết nối mạng ổn định

Giải pháp:

1. Kiểm tra số dư credits

2. Xác nhận mô hình đã chọn

3. Kiểm tra system prompt

4. Test trong Console

5. Xem browser console logs

---

Phản Hồi Không Chính Xác

Kiểm tra:

• Cơ sở tri thức đã attach

• Tài liệu đã được indexed

• System prompt rõ ràng

• Câu hỏi liên quan đến KB

Giải pháp:

1. Xác nhận KB đã attach

2. Kiểm tra tài liệu đã indexed

3. Cải thiện system prompt

4. Thêm tài liệu liên quan

5. Test với câu hỏi đơn giản hơn

---

Widget Không Hiển Thị

Kiểm tra:

• Embed code đúng

• Script URL accessible

• Display rules cho phép hiển thị

• Không có lỗi JavaScript

• Chatbot status là active

Giải pháp:

1. Xác nhận embed code đúng vị trí

2. Kiểm tra display rules (isVisible = true)

3. Xóa cache và reload

4. Test trong incognito mode

5. Xem browser console

---

📖 Các Hướng Dẫn Khác

Hướng Dẫn Tính Năng

1. Tổng Quan Chatbot - Trang overview và thống kê

2. Tạo Chatbot - Wizard 4 bước chi tiết

3. Cấu Hình Chatbot - Settings và tùy chỉnh

4. Display Rules - Quy tắc hiển thị

5. Widget Appearance - Tùy chỉnh giao diện

6. Test Console - Kiểm tra chatbot

7. Quản Lý KB - Cơ sở tri thức

8. Credits & Usage - Quản lý chi phí

9. Live Chat Widget - Tích hợp website

Workflows

1. Chatbot Setup Workflow - Quy trình thiết lập

2. Knowledge Base Workflow - Quy trình quản lý KB

3. Widget Deployment Workflow - Quy trình triển khai

4. Optimization Workflow - Quy trình tối ưu hóa

5. Troubleshooting Workflow - Quy trình khắc phục sự cố

---

🎓 Lộ Trình Học Tập

Tuần 1: Cơ Bản

• Đọc hướng dẫn này

• Tạo chatbot đầu tiên

• Test trong Console

• Hiểu các khái niệm chính

Tuần 2: Nâng Cao

• Tạo cơ sở tri thức

• Upload tài liệu

• Cấu hình display rules

• Tùy chỉnh widget appearance

Tuần 3: Triển Khai

• Triển khai widget lên staging

• Test kỹ lưỡng

• Thu thập phản hồi

• Triển khai lên production

Tuần 4: Tối Ưu Hóa

• Phân tích metrics

• Tối ưu system prompt

• Cải thiện KB

• Giảm chi phí

---

📞 Hỗ Trợ

Cần trợ giúp? Tham khảo:

• Troubleshooting Workflow - Khắc phục sự cố

• Feature Guides - Tất cả hướng dẫn

• Support: [Liên hệ support của bạn]

---

🎯 Bước Tiếp Theo

Sau khi hoàn thành hướng dẫn này:

1. Tạo chatbot đầu tiên - Làm theo Bắt Đầu Nhanh

2. Đọc Chatbot Overview - Hiểu trang tổng quan

3. Học cách tạo KB - Thêm tài liệu

4. Triển khai widget - Đưa lên website

5. Tối ưu hóa - Cải thiện hiệu suất

Chúc bạn thành công với AI Assistant! 🚀

---

Phiên bản: 1.0 Cập nhật lần cuối: 2025-10-19 Trạng thái: ✅ Hoàn thành