AI Chat

Quick Reference

• Who: Tất cả vai trò (Owner, Admin, Member)
• Where: Menu trái → Trò chuyện AI (/chat)
• Time: ~1-2 phút per câu hỏi
• Prerequisites: AI Connector đã được cấu hình

Prerequisites

• [ ] Đã đăng nhập hệ thống
• [ ] AI Connector đã được cấu hình (xem Cài đặt)

Step-by-Step Guide

Step 1: Mở giao diện Chat

1. Click Trò chuyện AI trên sidebar trái
2. Giao diện Chat hiện ra với ô nhập câu hỏi ở dưới cùng

TIP

Nếu đây là lần đầu sử dụng và chưa cấu hình AI Connector, hệ thống sẽ hiện Onboarding Wizard tự động. Làm theo hướng dẫn để setup.

Step 2: Đặt câu hỏi

1. Nhập câu hỏi vào ô "Nhập câu hỏi..."
2. Nhấn Enter hoặc click nút Gửi

Ví dụ câu hỏi hay:

Loại	Câu hỏi mẫu
Doanh thu	"Doanh thu 7 ngày qua"
So sánh	"So sánh doanh thu Shopee vs Lazada"
Top sản phẩm	"Top 10 sản phẩm bán chạy tháng này"
Fulfillment	"Tình hình fulfillment hôm nay"
Tồn kho	"Tồn kho theo warehouse"
Vận chuyển	"Chi phí vận chuyển theo carrier"
Hoàn trả	"Tỷ lệ hoàn trả tháng này"
Lợi nhuận	"Phân tích lợi nhuận gộp"

Step 3: Sử dụng Suggested Questions

1. Khi chat trống, hệ thống hiện các câu hỏi gợi ý
2. Click vào câu hỏi bất kỳ để gửi ngay

Step 4: Xem kết quả

Kết quả AI trả về gồm:

Thành phần	Mô tả
Giải thích	Text mô tả kết quả (Markdown)
Biểu đồ	ECharts visualization (line, bar, pie, area...)
Bảng dữ liệu	Table với phân trang
Cảnh báo	Alerts (info/warning/critical) nếu có
SQL	Câu truy vấn SQL đã sử dụng (collapsible)

Step 5: Đánh giá kết quả (Rating)

1. Dưới mỗi câu trả lời, click sao (1-5) để đánh giá
2. Rating giúp hệ thống cải thiện chất lượng

Step 6: Pin biểu đồ vào Dashboard

1. Trên artifact (biểu đồ/bảng), click nút Pin to Dashboard
2. Chọn dashboard đích → widget được tạo tự động

TIP

Pin to Dashboard là cách nhanh nhất để xây dựng dashboard từ các câu hỏi AI thường dùng.

Expected Results

• AI trả lời trong 1-3 giây
• Biểu đồ tự động chọn type phù hợp (line cho trend, pie cho phân bố, bar cho so sánh)
• Alerts hiện khi có dữ liệu đáng chú ý (VD: tồn kho dưới ngưỡng)

Troubleshooting

AI không trả lời / hiện lỗi "blocked"

Cause: AI Connector chưa được cấu hình hoặc API key hết hạn.

Solution:

1. Vào Cài đặt → AI Connectors
2. Kiểm tra connector có is_active = true
3. Nếu cần, thêm connector mới hoặc test lại connection

Source: (ai-config.service.ts:20)

Biểu đồ không hiển thị

Cause: Response không có chart_hint hoặc dữ liệu không phù hợp để visualize.

Solution:

• Thử hỏi cụ thể hơn (thêm thời gian, filter)
• Dữ liệu vẫn hiện ở dạng bảng

Source: (artifact-renderer.component.ts)

Kết quả chậm (>5 giây)

Cause: Query phức tạp hoặc model AI chậm.

Solution:

1. Thử đơn giản hoá câu hỏi
2. Vào Settings → đổi sang model nhanh hơn (VD: Claude Sonnet thay vì Opus)

FAQ

Q: AI có thể hỏi bằng tiếng Anh không?

A: Có. AI hỗ trợ cả tiếng Việt và tiếng Anh. Trả lời theo ngôn ngữ câu hỏi.

Q: Chat history có lưu lại không?

A: Chat history lưu trong session hiện tại. Khi refresh trang, history sẽ reset.

Related

• Insight Catalog — Xem insights có sẵn
• Dashboards — Quản lý dashboard + widgets
• Cài đặt AI — Cấu hình AI Connector
• API: POST /api/v1/ai/chat — Xem API