AI không hoạt động
Xem dạng Markdown
OmnyBot có hai nhóm trợ lý AI: **AI Bot trả lời khách** trong hộp thư đa kênh (chế độ `DRAFT` hoặc `AUTO_SEND`) và **Mina** (trợ lý trong ứng dụng hỗ trợ hỏi đáp và thao tác nhanh). Trang này giúp bạn khoanh vùng và xử lý nhanh các sự cố thường gặp.
## AI Bot không tự trả lời hoặc không tạo nháp gợi ý
Hãy kiểm tra lần lượt theo đúng thứ tự xử lý của hệ thống:
1. **Kênh chưa được gắn AI Bot hoạt động:**
- Trong kiến trúc Multi-Bot, mỗi kênh (Zalo, Facebook Fanpage, WhatsApp, Webchat) **bắt buộc phải được gắn một AI Bot đang bật (`isActive`)** và bật công tắc AI trên kênh đó.
- *Cách xử lý:* Vào mục **AI Bot** (yêu cầu quyền `ai:manage`), kiểm tra Bot đã ở trạng thái hoạt động và đã kết nối đúng kênh chưa.
2. **Công tắc tự động đang tắt:**
- Công tắc **Tự soạn khi có tin đến** (`autoDraftOnInbound`) ở cài đặt AI Workspace hoặc công tắc AI của **riêng hội thoại đó** đang tắt.
- *Cách xử lý:* Bật lại công tắc ở cài đặt AI hoặc ngay trên thanh công cụ của hội thoại. (Nút **Gợi ý AI** thủ công trong hộp thư vẫn hoạt động ngay cả khi hội thoại đang tắt tự động.)
3. **Ví AI hết Token (`AI_WALLET_INSUFFICIENT_TOKENS`):**
- Mỗi lượt AI cần tạm giữ tối thiểu **2.500 token** trong Ví AI trước khi gọi mô hình (hệ thống cảnh báo khi số dư dưới **15.000 token**).
- *Cách xử lý:* Kiểm tra số dư tại **Cài đặt → Thanh toán → Mức sử dụng** và nạp thêm gói **AI Bot Token** tại [Gói dịch vụ & Dùng thử](/workspace-management/billing/).
4. **AI đang tạm dừng do Chuyển giao nhân viên (Human Handoff):**
- **Khớp từ khóa chuyển giao (`KEYWORD_HANDOFF`):** Khi khách nhắn các từ khóa như *"gặp nhân viên"*, *"gặp người thật"*, *"tư vấn viên"*, *"alo shop"*, *"hotline"* (hoặc danh sách từ khóa tùy chỉnh của Bot), AI sẽ tự tạm dừng hội thoại đó (mặc định **4 giờ**).
- **Đạt giới hạn lượt trả lời liên tiếp:** Khi Bot đã tự trả lời liên tiếp đủ số lượt tối đa (mặc định **3 lượt**) mà chưa có nhân viên can thiệp, AI tự tạm dừng (mặc định **4 giờ**) để nhân sự tiếp quản.
- *Cách xử lý:* Bật lại AI thủ công ngay trong hội thoại nếu muốn Bot tiếp tục sớm, hoặc chờ hết thời gian tạm dừng để AI tự kích hoạt lại.
5. **Bộ lọc tin nhắn đầu vào (Inbound Triage):**
- **Tin nhiễu (`NOISE`):** Sticker, chỉ có emoji, hoặc tiếng cười suông (*"haha"*, *"hihi"*) → AI chủ động im lặng để tiết kiệm token.
- **Tin xác nhận (`ACK`):** *"ok"*, *"dạ"*, *"vâng"*, *"cảm ơn"* → AI thả cảm xúc **❤️** (tối đa **120 lượt/ngày**) thay vì nhắn thêm để tránh làm phiền khách.
6. **Hội thoại nhóm hoặc nhân viên đã trả lời:**
- AI tự động chỉ chạy cho hội thoại **1-1 (`DIRECT`)**, không chạy trong **chat nhóm (`GROUP`)**.
- Nếu tin nhắn mới nhất là do nhân sự gửi đi (`OUT`), AI sẽ không tạo thêm nháp.
7. **Ngoài khung giờ hoạt động:**
- Kiểm tra lịch hoạt động của Bot hoặc khung giờ hoạt động AI của Workspace.
## AI đang ở chế độ Tự động gửi (`AUTO_SEND`) nhưng chỉ hiện nháp (`DRAFT`)
Đây là cơ chế **rào chắn an toàn** để tránh Bot trả lời sai thông tin cho khách:
- **Độ tin cậy chưa đủ cao:** Không tìm thấy đoạn tri thức đủ sát trong Kho tri thức (khoảng cách vector lớn hơn ngưỡng tự gửi `0.5`) hoặc câu trả lời có cụm từ trì hoãn (*"kiểm tra lại"*, *"nhờ bộ phận"*, *"check lại"*). Hệ thống sẽ giữ lại ở dạng nháp để nhân sự duyệt và đồng thời ghi nhận vào mục **Lỗ hổng tri thức (`OPEN`)**.
- **Chạm giới hạn tự gửi mỗi ngày của kênh (`autoSendDailyCap`):** Khi hết hạn mức tự gửi trong ngày, các lượt tiếp theo lùi về chế độ nháp.
**Cách xử lý:**
1. Trong hộp thư, nhấn **Dùng** để gửi nháp, chỉnh sửa lại hoặc bỏ qua.
2. Mở mục **Lỗ hổng tri thức** để bổ sung tài liệu/FAQ còn thiếu vào **Kho tri thức** — dữ liệu càng sát, Bot càng tự tin tự gửi.
3. Kiểm tra lại cấu hình **giới hạn tự gửi/ngày** hoặc ngưỡng tự tin của Bot.
## Trợ lý Mina không trả lời hoặc từ chối thao tác
| Triệu chứng / Mã lỗi | Nguyên nhân | Cách xử lý |
| --- | --- | --- |
| `AI_AGENT_QUOTA_EXCEEDED` (429) | Đã hết hạn mức tin nhắn theo ngày của cá nhân hoặc của Workspace, hoặc hết dung lượng xử lý trong ngày. | Chờ sang ngày hôm sau để hạn mức tự đặt lại. |
| `AI_AGENT_BUSY` (409) | Cuộc trò chuyện Mina đang xử lý một lượt trước đó (khóa phiên tối đa 60 giây). | Đợi lượt hiện tại trả kết quả xong rồi gửi tiếp (tránh mở nhiều tab gửi cùng lúc). |
| Mina từ chối ghi Kho tri thức / xử lý lỗ hổng / tạo thẻ | Tài khoản thiếu quyền tương ứng: ghi Kho tri thức & lỗ hổng yêu cầu `workspace:manage`; kết nối QR yêu cầu `nick:connect`; tạo thẻ/mẫu tin yêu cầu `inbox:reply`. | Nhờ quản trị viên cấp quyền phù hợp hoặc thực hiện bằng tài khoản Owner. |
| `DEEPSEEK_GENERATION_FAILED` / `OPENROUTER_GENERATION_FAILED` / `EMBEDDINGS_FAILED` (502) | Nhà cung cấp mô hình AI hoặc dịch vụ nhúng vector đang gián đoạn tạm thời. | Đợi vài phút rồi thử lại. Token tạm giữ trong Ví AI sẽ tự động được hoàn trả khi lỗi xảy ra. |
:::tip[Theo dõi thiếu tri thức & số dư Token]
Bật thông báo **Lỗ hổng tri thức (`KNOWLEDGE_GAP`)** và cảnh báo **Ví AI (`WALLET_LOW_TOKENS` / `WALLET_OUT_OF_TOKENS`)** trong [Thông báo cá nhân](/workspace-management/account-notifications/) để xử lý kịp thời trước khi Bot bị gián đoạn.
:::
OmnyBot có hai nhóm trợ lý AI: AI Bot trả lời khách trong hộp thư đa kênh (chế độ DRAFT hoặc AUTO_SEND) và Mina (trợ lý trong ứng dụng hỗ trợ hỏi đáp và thao tác nhanh). Trang này giúp bạn khoanh vùng và xử lý nhanh các sự cố thường gặp.
AI Bot không tự trả lời hoặc không tạo nháp gợi ý
Phần tiêu đề “AI Bot không tự trả lời hoặc không tạo nháp gợi ý”Hãy kiểm tra lần lượt theo đúng thứ tự xử lý của hệ thống:
- Kênh chưa được gắn AI Bot hoạt động:
- Trong kiến trúc Multi-Bot, mỗi kênh (Zalo, Facebook Fanpage, WhatsApp, Webchat) bắt buộc phải được gắn một AI Bot đang bật (
isActive) và bật công tắc AI trên kênh đó. - Cách xử lý: Vào mục AI Bot (yêu cầu quyền
ai:manage), kiểm tra Bot đã ở trạng thái hoạt động và đã kết nối đúng kênh chưa.
- Trong kiến trúc Multi-Bot, mỗi kênh (Zalo, Facebook Fanpage, WhatsApp, Webchat) bắt buộc phải được gắn một AI Bot đang bật (
- Công tắc tự động đang tắt:
- Công tắc Tự soạn khi có tin đến (
autoDraftOnInbound) ở cài đặt AI Workspace hoặc công tắc AI của riêng hội thoại đó đang tắt. - Cách xử lý: Bật lại công tắc ở cài đặt AI hoặc ngay trên thanh công cụ của hội thoại. (Nút Gợi ý AI thủ công trong hộp thư vẫn hoạt động ngay cả khi hội thoại đang tắt tự động.)
- Công tắc Tự soạn khi có tin đến (
- Ví AI hết Token (
AI_WALLET_INSUFFICIENT_TOKENS):- Mỗi lượt AI cần tạm giữ tối thiểu 2.500 token trong Ví AI trước khi gọi mô hình (hệ thống cảnh báo khi số dư dưới 15.000 token).
- Cách xử lý: Kiểm tra số dư tại Cài đặt → Thanh toán → Mức sử dụng và nạp thêm gói AI Bot Token tại Gói dịch vụ & Dùng thử.
- AI đang tạm dừng do Chuyển giao nhân viên (Human Handoff):
- Khớp từ khóa chuyển giao (
KEYWORD_HANDOFF): Khi khách nhắn các từ khóa như “gặp nhân viên”, “gặp người thật”, “tư vấn viên”, “alo shop”, “hotline” (hoặc danh sách từ khóa tùy chỉnh của Bot), AI sẽ tự tạm dừng hội thoại đó (mặc định 4 giờ). - Đạt giới hạn lượt trả lời liên tiếp: Khi Bot đã tự trả lời liên tiếp đủ số lượt tối đa (mặc định 3 lượt) mà chưa có nhân viên can thiệp, AI tự tạm dừng (mặc định 4 giờ) để nhân sự tiếp quản.
- Cách xử lý: Bật lại AI thủ công ngay trong hội thoại nếu muốn Bot tiếp tục sớm, hoặc chờ hết thời gian tạm dừng để AI tự kích hoạt lại.
- Khớp từ khóa chuyển giao (
- Bộ lọc tin nhắn đầu vào (Inbound Triage):
- Tin nhiễu (
NOISE): Sticker, chỉ có emoji, hoặc tiếng cười suông (“haha”, “hihi”) → AI chủ động im lặng để tiết kiệm token. - Tin xác nhận (
ACK): “ok”, “dạ”, “vâng”, “cảm ơn” → AI thả cảm xúc ❤️ (tối đa 120 lượt/ngày) thay vì nhắn thêm để tránh làm phiền khách.
- Tin nhiễu (
- Hội thoại nhóm hoặc nhân viên đã trả lời:
- AI tự động chỉ chạy cho hội thoại 1-1 (
DIRECT), không chạy trong chat nhóm (GROUP). - Nếu tin nhắn mới nhất là do nhân sự gửi đi (
OUT), AI sẽ không tạo thêm nháp.
- AI tự động chỉ chạy cho hội thoại 1-1 (
- Ngoài khung giờ hoạt động:
- Kiểm tra lịch hoạt động của Bot hoặc khung giờ hoạt động AI của Workspace.
AI đang ở chế độ Tự động gửi (AUTO_SEND) nhưng chỉ hiện nháp (DRAFT)
Phần tiêu đề “AI đang ở chế độ Tự động gửi (AUTO_SEND) nhưng chỉ hiện nháp (DRAFT)”Đây là cơ chế rào chắn an toàn để tránh Bot trả lời sai thông tin cho khách:
- Độ tin cậy chưa đủ cao: Không tìm thấy đoạn tri thức đủ sát trong Kho tri thức (khoảng cách vector lớn hơn ngưỡng tự gửi
0.5) hoặc câu trả lời có cụm từ trì hoãn (“kiểm tra lại”, “nhờ bộ phận”, “check lại”). Hệ thống sẽ giữ lại ở dạng nháp để nhân sự duyệt và đồng thời ghi nhận vào mục Lỗ hổng tri thức (OPEN). - Chạm giới hạn tự gửi mỗi ngày của kênh (
autoSendDailyCap): Khi hết hạn mức tự gửi trong ngày, các lượt tiếp theo lùi về chế độ nháp.
Cách xử lý:
- Trong hộp thư, nhấn Dùng để gửi nháp, chỉnh sửa lại hoặc bỏ qua.
- Mở mục Lỗ hổng tri thức để bổ sung tài liệu/FAQ còn thiếu vào Kho tri thức — dữ liệu càng sát, Bot càng tự tin tự gửi.
- Kiểm tra lại cấu hình giới hạn tự gửi/ngày hoặc ngưỡng tự tin của Bot.
Trợ lý Mina không trả lời hoặc từ chối thao tác
Phần tiêu đề “Trợ lý Mina không trả lời hoặc từ chối thao tác”| Triệu chứng / Mã lỗi | Nguyên nhân | Cách xử lý |
|---|---|---|
AI_AGENT_QUOTA_EXCEEDED (429) | Đã hết hạn mức tin nhắn theo ngày của cá nhân hoặc của Workspace, hoặc hết dung lượng xử lý trong ngày. | Chờ sang ngày hôm sau để hạn mức tự đặt lại. |
AI_AGENT_BUSY (409) | Cuộc trò chuyện Mina đang xử lý một lượt trước đó (khóa phiên tối đa 60 giây). | Đợi lượt hiện tại trả kết quả xong rồi gửi tiếp (tránh mở nhiều tab gửi cùng lúc). |
| Mina từ chối ghi Kho tri thức / xử lý lỗ hổng / tạo thẻ | Tài khoản thiếu quyền tương ứng: ghi Kho tri thức & lỗ hổng yêu cầu workspace:manage; kết nối QR yêu cầu nick:connect; tạo thẻ/mẫu tin yêu cầu inbox:reply. | Nhờ quản trị viên cấp quyền phù hợp hoặc thực hiện bằng tài khoản Owner. |
DEEPSEEK_GENERATION_FAILED / OPENROUTER_GENERATION_FAILED / EMBEDDINGS_FAILED (502) | Nhà cung cấp mô hình AI hoặc dịch vụ nhúng vector đang gián đoạn tạm thời. | Đợi vài phút rồi thử lại. Token tạm giữ trong Ví AI sẽ tự động được hoàn trả khi lỗi xảy ra. |