Xử lý sự cố

Thời gian: 30’–4 giờ (tuỳ lỗi) | Độ khó: Trung bình | Vai trò: Admin/Support

---

🎯 Mục Tiêu

• Chẩn đoán nhanh và xử lý triệt để các lỗi thường gặp

---

🚫 Bước 1: Widget không hiển thị (15’)

• Kiểm tra script chèn trước </body>

• Xem console errors (F12)

• Kiểm tra Display Rules (isVisible, conditions)

📭 Bước 2: Không gửi/nhận được tin (20’)

• Kiểm tra mạng/WS, token phiên

• Kiểm tra credits còn đủ

• Thử lại trình duyệt khác

💤 Bước 3: Phản hồi chậm/đứt quãng (20’)

• Kiểm tra tải server, mạng

• Rút gọn prompt, giới hạn độ dài trả lời

• Chuyển model phù hợp (GPT-3.5 ↔ GPT-4)

❓ Bước 4: Trả lời sai/ngẫu nhiên (30’)

• Rà soát system prompt; thêm ví dụ

• Kiểm tra KB đã indexed; bổ sung tài liệu thiếu

• Test trong Console với bộ câu hỏi chuẩn

🧱 Bước 5: Không tạo/attach KB (15’)

• Quyền AI_KB_CREATE/UPDATE

• Tên trùng → đổi tên

• Tạo KB trước rồi attach từ Settings

🔐 Bước 6: Quyền truy cập bị từ chối (10’)

• Kiểm tra role & permissions: AI_CHATBOT_*, AI_KB_*

• Xác nhận site/context đúng

🧾 Bước 7: Lỗi giới hạn chatbot (10’)

• Đã đạt 10 chatbots/site → xoá bớt

• Tạo lại sau khi dọn dẹp

🧩 Bước 8: Sự cố hiển thị/UX (15’)

• Điều chỉnh position/iconSize/launcherShape

• Kiểm tra xung đột CSS/Z-index

📊 Bước 9: Chi phí tăng bất thường (20’)

• Xem Usage breakdown theo chatbot

• Giới hạn độ dài trả lời, ưu tiên GPT-3.5

🧰 Bước 10: Tạo báo cáo & phòng ngừa (30’)

• Ghi lại nguyên nhân/giai pháp

• Cập nhật checklist/guide liên quan

• Theo dõi thêm 24–48 giờ

---

✅ Checklist

• Nguyên nhân gốc đã xác định

• Đã có biện pháp khắc phục

• Không tái diễn sau 48 giờ

---

🔗 Tài Liệu Liên Quan

• Test Console (../feature-guides/07-TEST-CONSOLE.md)

• Configure Chatbot (../feature-guides/04-CONFIGURE-CHATBOT.md)

• Live Chat Widget (../feature-guides/10-LIVE-CHAT-WIDGET.md)