Hướng dẫn sử dụng: Question Library

1. Question Library là gì?

Question Library là kho câu hỏi mẫu đã được admin tuyển chọn và xác thực (curated, verified), xuất hiện dưới dạng gợi ý "Try asking" ngay trong giao diện chat của AI Analytics.

Mục đích:

• Giúp business user (người không rành kỹ thuật/dữ liệu) biết nên hỏi Agent câu gì thay vì phải tự nghĩ câu hỏi từ đầu.
• Đảm bảo các câu hỏi gợi ý đã được kiểm chứng là Agent trả lời đúng, tránh việc AI trả lời sai/gây hiểu nhầm.
• Cho phép admin kiểm soát: câu hỏi nào áp dụng cho Agent nào, phòng ban nào.

2. Truy cập Question Library

Truy cập vào mục Question Library tại trang menu.

3. Tổng quan giao diện

3.1 Ba tab trạng thái

Số hiển thị cạnh mỗi tab (VD: Published 1) là số lượng câu hỏi thuộc trạng thái đó.

3.2 Các nút chức năng

3.3 Bảng danh sách câu hỏi

Lưu ý: Các câu hỏi nếu ở trạng thái public Published nhưng có cảnh báo "Not verified" — nghĩa là câu hỏi đã hiển thị công khai cho người dùng, nhưng admin chưa xác nhận độ chính xác của câu trả lời AI. Nên xử lý xác thực trước khi để trạng thái này tồn tại lâu.

4. Câu hỏi trong Question Library hiển thị ở đâu?

Sau khi được Published và gán vào đúng Agent, câu hỏi sẽ tự động xuất hiện dưới dạng gợi ý "Try asking" ngay khi người dùng mở phiên chat mới với Agent đó trong AI Analytics. Người dùng chỉ cần click vào gợi ý để gửi câu hỏi đó ngay, không cần tự gõ. Nếu muốn xem thêm, có thể bấm "See more questions".

5. Hướng dẫn thao tác cho Admin

5.1 Thêm câu hỏi mới thủ công

1. Vào Question Library.
2. Bấm + Add question.
3. Nhập nội dung câu hỏi, chọn Topic, Department áp dụng.
4. Chọn (các) Agent sẽ hiển thị gợi ý câu hỏi này.
5. Lưu ở trạng thái Draft (nếu muốn kiểm tra trước) hoặc Publish ngay để hiển thị cho người dùng.

Lưu ý: chi tiết form "Add question" (các trường bắt buộc, cách chọn Agent) mình chưa có screenshot cụ thể — phần trên là suy luận từ cấu trúc bảng dữ liệu hiện có. Bạn có thể bổ sung ảnh chụp màn hình form này để mình hoàn thiện chính xác hơn.

5.2 Duyệt câu hỏi đề xuất (tab Suggested)

1. Vào tab Suggested để xem các câu hỏi được hệ thống/người dùng đề xuất.
2. Kiểm tra nội dung, đảm bảo Agent trả lời đúng và hữu ích.
3. Gán Topic/Department/Agent phù hợp rồi Publish, hoặc xoá nếu không phù hợp.

5.3 Xác thực câu hỏi (bỏ cờ "Not verified")

1. Mở câu hỏi đang có cảnh báo Not verified.
2. Thử hỏi lại Agent bằng chính câu hỏi đó để kiểm tra câu trả lời có chính xác không.
3. Nếu đúng → đánh dấu đã xác thực. Nếu sai → chỉnh sửa câu hỏi hoặc gỡ Publish, chuyển về Draft.

5.4 Đồng bộ dữ liệu (Sync)

• Bấm Sync định kỳ để cập nhật số liệu Times (tần suất sử dụng) và nạp thêm các câu hỏi mới được đề xuất từ lịch sử chat thực tế của người dùng.

6. Mẹo dùng hiệu quả

• Ưu tiên publish những câu hỏi phổ biến, dễ hiểu, mang lại giá trị rõ ràng (VD: doanh thu, top sản phẩm, xu hướng bán hàng) để business user dễ bắt đầu.
• Gán đúng Agent và Department — tránh gợi ý câu hỏi không liên quan đến dữ liệu mà Agent đó đang quản lý.
• Theo dõi cột Times để biết câu hỏi nào thực sự được dùng nhiều, ưu tiên xác thực và tối ưu trước.
• Xử lý sớm các câu hỏi Not verified đang ở trạng thái Published để tránh gợi ý sai cho người dùng.