# Cấu hình Bot

Trang **Cấu hình** (`/ai-bots/{botId}/config`) kiểm soát toàn bộ hành vi vận hành của Bot khi tiếp nhận tin nhắn thực tế từ khách hàng. Mọi thay đổi được lưu tự động ngay khi bạn chọn.

:::note[Quyền truy cập]
Bạn cần có quyền **`ai:manage`** hoặc **`workspace:manage`** để xem và cập nhật cấu hình Bot.
:::

## 1. Chế độ gửi tin của Bot

Chọn cách Bot tham gia hội thoại và ngưỡng tự tin khi tự động gửi:

- **Tạm dừng**: Bot ngừng hoạt động, không tạo nháp và không tự gửi tin nhắn.
- **Soạn nháp**: Bot soạn sẵn câu trả lời gợi ý trong khung chat để nhân viên duyệt trước khi gửi (`DRAFT`).
- **Thận trọng**: Tự động gửi (`AUTO_SEND`) chỉ khi dữ liệu kho tri thức khớp rất sát (ngưỡng khoảng cách ngữ nghĩa `0.42`).
- **Cân bằng** *(Khuyên dùng)*: Tự động gửi khi câu trả lời đạt độ chắc chắn tiêu chuẩn (ngưỡng `0.50`).
- **Mạnh dạn**: Tự động gửi cả khi tài liệu khớp ở mức vừa phải (ngưỡng `0.60`).
- **Luôn tự gửi**: Bỏ qua bước kiểm tra độ chắc chắn và luôn gửi ngay mọi câu Bot soạn (các rào chắn an toàn chống spam vẫn được áp dụng).

## 2. Mô hình AI & Trí tuệ

- **Mô hình ngôn ngữ**: Chọn một trong 7 mô hình được hỗ trợ:
  - **DeepSeek V3 (Khuyên dùng)** — `deepseek/deepseek-chat`
  - **Gemini 2.5 Flash Lite** — `google/gemini-2.5-flash-lite`
  - **GPT-4o Mini** — `openai/gpt-4o-mini`
  - **Gemini 2.5 Flash (Siêu tốc)** — `google/gemini-2.5-flash`
  - **DeepSeek R1 (Suy luận sâu)** — `deepseek/deepseek-r1-0528`
  - **Gemini 2.5 Pro** — `google/gemini-2.5-pro`
  - **GPT-4o** — `openai/gpt-4o`
- **Mức độ sáng tạo (Temperature)**:
  - **Chính xác & Kỷ luật** (`0.3`): Bám sát tri thức, hạn chế diễn giải thêm.
  - **Cân bằng & Tự nhiên** (`0.7`, mặc định): Giọng văn tự nhiên nhưng vẫn tôn trọng dữ liệu.
  - **Linh hoạt & Sáng tạo** (`1.0`): Ngữ điệu mềm dẻo hơn cho tình huống tư vấn bán hàng.
- **Độ dài câu trả lời**: Chọn **Ngắn gọn súc tích** (1–2 câu kiểu chat) hoặc **Đầy đủ & Chi tiết**.

## 3. Độ trễ phản hồi & Giả lập người thật

- **Mô phỏng nhịp gõ của con người**: Chọn **Tắt (Gửi tức thì)**, **2 – 4 giây (Nhanh)**, **3 – 7 giây (Tự nhiên - Khuyên dùng)**, **5 – 10 giây (Chậm rãi)** hoặc **Tùy chỉnh** khoảng tối thiểu (`0–60` giây) và tối đa (tối đa `120` giây).
- **Hiển thị trạng thái "Đang soạn tin..."**: Bật/tắt tín hiệu đang gõ gửi tới Zalo trong lúc Bot chuẩn bị trả lời (mặc định bật).

## 4. Lịch trực & Khung giờ hoạt động

- **Trực 24/7 liên tục**: Bot hoạt động suốt ngày đêm.
- **Theo ca / Giờ làm việc**: Thiết lập **Khung giờ trực** (ví dụ `08:30` – `18:00`) và **Các ngày áp dụng trong tuần** (T2 đến CN).
- **Hành vi ngoài ca trực**:
  - **Gợi ý nháp**: Chỉ tạo nháp để nhân viên duyệt vào ca sau.
  - **Tạm dừng Bot**: Tắt AI ngoài giờ trực. Khi chọn chế độ này, bạn có thể bật thêm **Gửi tin thông báo ngoài ca trực** với nội dung tùy chỉnh (không tốn token AI và có cơ chế chống spam).
  - **Tự động gửi**: Cho phép Bot tự động trả lời ngoài giờ làm việc.

## 5. Bàn giao nhân viên & Xử lý ngoại lệ

- **Khi không tìm thấy thông tin trong kho tri thức**:
  - **Chuyển sang dạng nháp (DRAFT)**: Không tự gửi phỏng đoán, để nhân viên tự xử lý.
  - **Gửi câu trả lời chờ hỗ trợ**: Gửi tin nhắn hẹn chuyên viên hỗ trợ theo nội dung tùy chỉnh, kèm tùy chọn **Tạm dừng Bot sau khi gửi tin nhắn chờ**.
- **Thời gian tạm dừng AI trong cuộc trò chuyện**: Chọn **1 giờ**, **4 giờ** (mặc định), **12 giờ**, **24 giờ**, hoặc **Cho đến khi bật lại**.
- **Ngắt bot khi phát hiện khiếu nại / gay gắt**: Tự động dừng Bot khi phát hiện khách hàng bức xúc hoặc khiếu nại (mặc định bật).
- **Số lượt bot tự trả lời liên tiếp tối đa**: Chọn **Không giới hạn**, **1**, **2**, **3** (Khuyên dùng), **5**, **10** hoặc **Tùy chỉnh** (`1–100` tin nhắn) trước khi tạm dừng để nhân viên tiếp quản.
- **Từ khóa yêu cầu gặp người thật**: Khi tin nhắn của khách chứa một trong các từ khóa này, Bot sẽ nhường cuộc trò chuyện cho nhân viên. Mặc định gồm: `gặp nhân viên`, `gặp người thật`, `tư vấn viên`, `alo shop`, `hotline`. Bạn có thể thêm hoặc xóa từ khóa bất kỳ lúc nào.

## 6. Giới hạn an toàn & Chống Spam

- **Gom tin nhắn khách (Debounce)**: Chọn **Tắt (Trả lời từng tin)**, **5 giây**, **10 giây (Khuyên dùng)** hoặc **15 giây**. Bot sẽ chờ hết khoảng thời gian này sau tin nhắn cuối cùng của khách để gom nhiều tin ngắn rời rạc thành một lần trả lời duy nhất.

## 7. Vùng nguy hiểm: Xóa Bot

:::caution[Thao tác không thể hoàn tác]
Nhấn **Xóa Bot** sẽ xóa vĩnh viễn Bot AI khỏi Workspace. Các kênh đang kết nối sẽ ngừng chạy Bot này cho đến khi được gán sang Bot khác; toàn bộ dữ liệu trong Kho kiến thức vẫn được giữ nguyên.
:::