# AI không hoạt động

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ử](/vi/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](/vi/workspace-management/account-notifications/) để xử lý kịp thời trước khi Bot bị gián đoạn.
:::