# Cấu hình chatbot

> Chọn model AI, cấu hình endpoint và tùy chỉnh chatbot cho AI Admin Assistant.

**Quyền truy cập:** Cần quyền **Sử dụng AI Admin** **Điều hướng:** `Trợ lý AI > AI Admin Assistant`

***

## Tổng quan

AI Admin Assistant sử dụng chatbot từ hệ thống Trợ lý AI để xử lý yêu cầu. Chatbot cần được cấu hình với model hỗ trợ **tool calling** để AI có thể gọi các công cụ quản trị.

***

## Chọn chatbot

### Cách chọn

1. Mở trang **AI Admin Assistant** (`/manage/ai/admin-assistant`)
2. Trên thanh tiêu đề, nhấp vào dropdown **Chatbot**
3. Chọn chatbot từ danh sách

### Thông tin hiển thị

Mỗi chatbot trong dropdown hiển thị:

| Thông tin | Mô tả                             |
| --------- | --------------------------------- |
| **Tên**   | Tên chatbot                       |
| **Model** | Tên model AI đang sử dụng         |
| **Giá**   | Chi phí tính theo VND / 1K tokens |

### Liên kết cấu hình

Nhấp biểu tượng **bánh răng** bên cạnh dropdown chatbot để chuyển đến trang quản lý chatbot (`/manage/ai/chatbots`).

***

## Yêu cầu model

AI Admin yêu cầu model có hỗ trợ **tool calling** (function calling). Các model phù hợp:

| Model           | Nhà cung cấp | Ghi chú                                             |
| --------------- | ------------ | --------------------------------------------------- |
| **GPT-5 nano**  | OpenAI       | Model mặc định, tốt nhất về tỷ lệ chi phí/hiệu suất |
| **GPT-5 mini**  | OpenAI       | Model dự phòng                                      |
| **GPT-4o mini** | OpenAI       | Nhẹ, nhanh                                          |
| **GPT-4o**      | OpenAI       | Mạnh, chi phí cao hơn                               |
| **o3-mini**     | OpenAI       | Model suy luận                                      |
| **Claude 3.5**  | Anthropic    | Model của Anthropic                                 |

> **Quan trọng:** Model Gradient (DigitalOcean) có thể không hỗ trợ tool calling. Nên sử dụng model OpenAI hoặc Anthropic cho AI Admin.

***

## Cấu hình Endpoint

Chatbot cần có endpoint ở trạng thái **Sẵn sàng** để AI Admin hoạt động.

### Kiểm tra trạng thái

| Trạng thái            | Ý nghĩa                  |
| --------------------- | ------------------------ |
| **Chưa khởi tạo**     | Chưa tạo endpoint        |
| **Đang tạo endpoint** | Đang tạo endpoint        |
| **Sẵn sàng**          | Sẵn sàng, có thể sử dụng |
| **Thất bại**          | Tạo endpoint thất bại    |

### Các bước cấu hình

1. Vào **Quản lý Chatbots** (`/manage/ai/chatbots`)
2. Chọn hoặc tạo chatbot mới
3. Chọn model hỗ trợ tool calling
4. Đợi endpoint status chuyển thành **Sẵn sàng**
5. Quay lại AI Admin và chọn chatbot vừa cấu hình

***

## Cài đặt AI Admin

Mỗi người dùng có cài đặt riêng cho AI Admin:

| Trường                    | Mô tả                                   | Mặc định                   |
| ------------------------- | --------------------------------------- | -------------------------- |
| **chatbotId**             | Chatbot đang sử dụng                    | (chatbot đầu tiên phù hợp) |
| **currentSessionId**      | Phiên hiện tại                          | (null)                     |
| **floatingPanelEnabled**  | Bật/tắt bảng nổi                        | `true`                     |
| **autoConfirmSimilar**    | Tự động xác nhận các hành động tương tự | `false`                    |
| **enabledToolCategories** | Danh sách danh mục công cụ đã bật       | (tất cả)                   |

### Danh mục công cụ

Bạn có thể bật/tắt từng danh mục công cụ:

| Danh mục          | Mô tả                                         |
| ----------------- | --------------------------------------------- |
| `organization`    | Nhân viên, phòng ban, chức vụ, khung năng lực |
| `training`        | Chương trình đào tạo, ghi danh                |
| `recruitment`     | Tuyển dụng, tin tuyển dụng, ứng viên          |
| `performance`     | Mục tiêu, chu kỳ đánh giá                     |
| `time_attendance` | Chấm công                                     |
| `compensation`    | Lương, phụ cấp                                |
| `announcement`    | Thông báo                                     |
| `community`       | Cộng đồng                                     |
| `automation`      | Tự động hóa                                   |
| `lms`             | Hệ thống quản lý học tập                      |
| `email`           | Gửi email                                     |
| `system`          | Hệ thống                                      |

***

## System Prompt

System prompt của AI Admin được **tự động tạo** bởi hệ thống thông qua hàm `generateAIAdminSystemPrompt()`. Prompt này bao gồm:

* Vai trò và phạm vi của AI Admin
* Danh sách công cụ khả dụng
* Quy tắc xử lý yêu cầu
* Hướng dẫn định dạng kết quả

> **Lưu ý:** System prompt của AI Admin được quản lý bởi hệ thống, không thể chỉnh sửa thủ công như chatbot thường.

***

## Định dạng kết quả

AI Admin trả về kết quả theo nhiều định dạng:

| Định dạng | Mô tả                   |
| --------- | ----------------------- |
| `table`   | Hiển thị dạng bảng      |
| `list`    | Hiển thị dạng danh sách |
| `card`    | Hiển thị dạng thẻ       |
| `tree`    | Hiển thị dạng cây       |
| `text`    | Văn bản thuần           |
| `json`    | Dữ liệu JSON            |

***

## Xử lý lỗi

Khi không có chatbot phù hợp, hệ thống hiển thị hướng dẫn cấu hình:

1. Vào trang Quản lý Chatbots
2. Tạo hoặc chỉnh sửa chatbot
3. Chọn model GPT-5 nano hoặc tương tự
4. Bật và cấu hình Endpoint
5. Đợi endpoint status = **Sẵn sàng**

Các lỗi thường gặp:

| Lỗi                      | Nguyên nhân                                       | Cách xử lý                    |
| ------------------------ | ------------------------------------------------- | ----------------------------- |
| Không có chatbot phù hợp | Không có chatbot nào có model hỗ trợ tool calling | Tạo chatbot với model phù hợp |
| Endpoint chưa sẵn sàng   | Endpoint đang provisioning hoặc failed            | Đợi hoặc tạo lại endpoint     |
| Hết credit               | Ví credit không đủ                                | Nạp thêm credit               |

***

## Lưu ý

* **Model mặc định là GPT-5 nano**, được khuyến nghị vì cân bằng tốt giữa chi phí và hiệu suất.
* **Endpoint phải ở trạng thái Sẵn sàng** để AI Admin hoạt động.
* **Cài đặt là riêng từng người dùng.** Mỗi admin có thể chọn chatbot và cấu hình khác nhau.
* **Danh mục công cụ** có thể tắt bớt để giới hạn phạm vi AI.
* **Chi phí** phụ thuộc vào model. Theo dõi sử dụng tại trang Credit.

***

## Xem thêm

* [Sử dụng AI Admin](https://docs.noova.vn/tri-tue-nhan-tao/07-ai-admin/su-dung) -- Cách ra lệnh và sử dụng AI Admin
* [Chính sách xác nhận](https://docs.noova.vn/tri-tue-nhan-tao/07-ai-admin/chinh-sach-xac-nhan) -- Cấu hình quy tắc xác nhận
