# Quản lý phiên chat

> Xem và quản lý các phiên hội thoại giữa người dùng và Trợ lý AI.

**Quyền truy cập:** Cần quyền quản trị viên **Điều hướng:** `Trợ lý AI > Phiên chat` hoặc `/manage/ai/chat-sessions`

***

## Tổng quan

Trang **Phiên chat** cho phép quản trị viên theo dõi và quản lý tất cả các phiên hội thoại giữa người dùng và Trợ lý AI. Bạn có thể xem nội dung cuộc trò chuyện, kết thúc phiên đang hoạt động, hoặc xóa phiên cũ.

***

## Giao diện

Trang Phiên chat có 1 tab chính: **Danh sách**.

### Thanh bộ lọc

| Bộ lọc          | Mô tả                                             |
| --------------- | ------------------------------------------------- |
| **Tìm userId**  | Tìm kiếm theo ID người dùng                       |
| **Chatbot**     | Lọc theo chatbot cụ thể hoặc tất cả chatbot       |
| **Trạng thái**  | Lọc theo trạng thái: Đang hoạt động / Đã kết thúc |
| **Khoảng ngày** | Lọc theo khoảng thời gian (dùng date-time picker) |

Nhấn **Lọc** để áp dụng các bộ lọc. Nhấn **Reset** để xóa tất cả bộ lọc.

### Bảng dữ liệu

| Cột            | Mô tả                                                                |
| -------------- | -------------------------------------------------------------------- |
| **STT**        | Số thứ tự                                                            |
| **Chatbot**    | Tên và ảnh đại diện của chatbot                                      |
| **Người dùng** | Tên và avatar của người dùng (hoặc "Ẩn danh" nếu không có thông tin) |
| **Trạng thái** | `Đang hoạt động` (xanh) hoặc `Đã kết thúc` (xám)                     |
| **Tin nhắn**   | Số lượng tin nhắn trong phiên. Badge vàng nếu vượt quá 30 tin nhắn   |
| **Lần cuối**   | Thời gian tin nhắn cuối cùng                                         |
| **Tạo lúc**    | Thời gian tạo phiên                                                  |
| **Hành động**  | Xem, Kết thúc, Xóa                                                   |

***

## Xem phiên chat

1. Nhấp vào hàng trong bảng hoặc nhấp nút **Xem**
2. Hộp thoại mở ra hiển thị toàn bộ cuộc hội thoại
3. Giao diện xem phiên sử dụng chế độ **chỉ đọc** (view-only), không thể gửi tin nhắn mới

***

## Kết thúc phiên

1. Tìm phiên có trạng thái **Đang hoạt động**
2. Nhấp vào menu **...** của hàng đó
3. Chọn **Kết thúc**
4. Xác nhận trong hộp thoại: "Bạn có chắc muốn kết thúc phiên này?"

> **Lưu ý:** Chỉ có thể kết thúc phiên đang ở trạng thái **Đang hoạt động**. Phiên đã kết thúc không thể kết thúc lại.

***

## Xóa phiên

1. Nhấp vào menu **...** của hàng cần xóa
2. Chọn **Xóa** (màu đỏ)
3. Xác nhận xóa

> **Cảnh báo:** Xóa phiên là vĩnh viễn. Tất cả dữ liệu hội thoại sẽ bị mất.

***

## Phân trang

* Chọn số dòng hiển thị mỗi trang: **10**, **20**, hoặc **50**
* Sử dụng nút **Trước** / **Sau** để chuyển trang
* Góc trái hiển thị số trang hiện tại và trạng thái "còn nữa" nếu có thêm dữ liệu

***

## Trạng thái phiên

| Trạng thái         | Ý nghĩa                                               | Hiển thị                    |
| ------------------ | ----------------------------------------------------- | --------------------------- |
| **Đang hoạt động** | Phiên đang hoạt động, người dùng có thể tiếp tục chat | Badge xanh "Đang hoạt động" |
| **Đã kết thúc**    | Phiên đã kết thúc                                     | Badge xám "Đã kết thúc"     |

***

## Thao tác hàng loạt

Hệ thống hỗ trợ kết thúc và xóa nhiều phiên cùng lúc thông qua chức năng bulk operations:

* **Kết thúc hàng loạt:** Kết thúc nhiều phiên đang hoạt động
* **Xóa hàng loạt:** Xóa nhiều phiên đã chọn

***

## Lưu ý

* **Mỗi phiên chat** liên kết với một chatbot và một người dùng cụ thể.
* **Tìm kiếm** hỗ trợ tìm theo userId với độ trễ (debounce) 400ms.
* **Thông tin người dùng** hiển thị tên và avatar. Nếu không có thông tin, hiển thị "Ẩn danh".
* **Số tin nhắn** vượt quá 30 sẽ được đánh dấu bằng màu vàng để cảnh báo phiên dài.
* **Thời gian** hiển thị theo định dạng địa phương của trình duyệt.

***

## Xem thêm

* [Tạo trợ lý AI](https://docs.noova.vn/tri-tue-nhan-tao/06-ai-tro-ly/tao-chatbot) -- Tạo chatbot mới
* [Credits](https://docs.noova.vn/tri-tue-nhan-tao/06-ai-tro-ly/credits) -- Theo dõi chi phí sử dụng