> ## Documentation Index
> Fetch the complete documentation index at: https://agentbase.vn/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Phân tích (Analytics)

> Theo dõi hiệu suất AI agent qua biểu đồ, thống kê hội thoại, phân tích chủ đề và cảm xúc khách hàng.

Trang Phân tích cung cấp cái nhìn tổng hợp về hiệu suất của AI agent — số lượng hội thoại, phản hồi của khách hàng, chủ đề phổ biến, và cảm xúc tổng thể. Mặc định hiển thị dữ liệu của **tất cả agents** trong workspace trong **7 ngày gần nhất**.

<Info>
  Dữ liệu trên trang Phân tích có **độ trễ 1 ngày** — phản ánh thông tin của ngày hôm trước. Để xem dữ liệu theo từng agent hoặc từng cuộc hội thoại cụ thể, dùng trang [Chat Logs](/docs/docs/user-guides/agent/chat-logs).
</Info>

## Truy cập

Trên sidebar, chọn **Phân tích**.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/analytics-overview.png" alt="Tổng quan trang Analytics" />
</Frame>

## Cuộc trò chuyện (Chats)

### Bộ lọc thời gian

Chọn khoảng thời gian phân tích ở góc phải trên:

* 7 ngày gần nhất
* 30 ngày gần nhất
* 3 tháng gần nhất
* 1 năm gần nhất

### Thẻ thống kê

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/analytics-stat-cards.png" alt="Thẻ thống kê" />
</Frame>

| Thẻ                      | Ý nghĩa                                     |
| ------------------------ | ------------------------------------------- |
| **Tổng cuộc trò chuyện** | Số hội thoại trong khoảng thời gian đã chọn |
| **Tổng tin nhắn**        | Tổng số tin nhắn (khách hàng + AI)          |
| **Phản hồi tích cực**    | Số lượt thumbs up                           |
| **Phản hồi tiêu cực**    | Số lượt thumbs down                         |

<Info>
  **Lưu ý về credits:** Tổng tin nhắn bao gồm tất cả lượt trao đổi, nhưng credits chỉ được tính cho các phản hồi do AI tạo ra — không tính tin nhắn của khách hàng.
</Info>

### Biểu đồ xu hướng

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/analytics-trend-chart.png" alt="Biểu đồ xu hướng" />
</Frame>

Biểu đồ đường hiển thị số hội thoại theo ngày. Di chuột để xem con số chính xác. Giúp bạn:

* Nhận biết xu hướng tăng/giảm sử dụng.
* Phát hiện ngày cao điểm.
* Đánh giá tác động sau khi triển khai kênh mới hoặc thêm dữ liệu.

### Bản đồ địa lý

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/analytics-world-map.png" alt="Bản đồ địa lý" />
</Frame>

Bản đồ thế giới hiển thị phân bố địa lý khách hàng (dựa trên IP). Bảng xếp hạng **Top quốc gia** hiển thị kèm bên cạnh.

### Phân bố theo kênh và trang

<Tabs>
  <Tab title="Theo kênh">
    Số hội thoại trên mỗi kênh triển khai: Chat Widget, Zalo OA, Facebook Messenger, API, Playground... Giúp biết kênh nào đang được dùng nhiều nhất.
  </Tab>

  <Tab title="Theo trang">
    Danh sách URL nơi khách hàng tương tác với chat widget. Giúp biết trang nào trên website thu hút nhiều câu hỏi nhất.
  </Tab>
</Tabs>

***

## Chủ đề (Topics)

Hệ thống tự động phân tích và phát hiện các chủ đề được nhắc đến nhiều nhất trong hội thoại.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/analytics-topics.png" alt="Phân tích chủ đề" />
</Frame>

<Info>
  Dữ liệu chủ đề chỉ có sau khi nâng cấp lên gói trả phí.
</Info>

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

| Cột                  | Mô tả                         |
| -------------------- | ----------------------------- |
| **Tên chủ đề**       | Tóm tắt chủ đề được phát hiện |
| **Số lần xuất hiện** | Tần suất chủ đề được nhắc đến |
| **Xu hướng**         | Tăng hay giảm so với kỳ trước |

### Quản lý chủ đề

* **Tìm kiếm:** Lọc nhanh theo tên chủ đề.
* **Thêm thủ công:** Thêm chủ đề bạn muốn theo dõi riêng.
* **Sửa / Xóa:** Chỉnh tên hoặc xóa chủ đề không cần thiết.
* **Đóng băng chủ đề (Freeze Topics):** Dừng việc agent tự động phát hiện chủ đề mới. Hữu ích khi bạn muốn chỉ theo dõi danh sách chủ đề cố định đã xác định.

### Ứng dụng phân tích chủ đề

<CardGroup cols={3}>
  <Card title="Nhu cầu khách hàng" icon="chart-bar">
    Chủ đề được hỏi nhiều nhất cho biết nhu cầu cần ưu tiên trong dữ liệu huấn luyện và sản phẩm.
  </Card>

  <Card title="Lỗ hổng kiến thức" icon="magnifying-glass">
    Chủ đề có nhiều câu hỏi nhưng ít phản hồi tích cực cho thấy agent đang thiếu dữ liệu về chủ đề đó.
  </Card>

  <Card title="Xu hướng mới" icon="arrow-trend-up">
    Chủ đề mới xuất hiện đột biến có thể báo hiệu vấn đề cần xử lý hoặc tính năng cần cập nhật thông tin.
  </Card>
</CardGroup>

***

## Cảm xúc (Sentiment)

Tự động phân tích cảm xúc tổng thể của khách hàng trong các cuộc hội thoại.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/analytics-sentiment.png" alt="Phân tích cảm xúc" />
</Frame>

<Info>
  Dữ liệu cảm xúc chỉ có sau khi nâng cấp lên gói trả phí.
</Info>

### Các mức cảm xúc

| Cảm xúc       | Mô tả                                         |
| ------------- | --------------------------------------------- |
| **Tích cực**  | Khách hàng hài lòng, cảm ơn, khen ngợi        |
| **Trung lập** | Hỏi đáp thông thường, không có cảm xúc rõ rệt |
| **Tiêu cực**  | Không hài lòng, phàn nàn, bực bội             |

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

* **Biểu đồ tròn (Pie chart) hoặc biểu đồ cột:** Tỷ lệ phần trăm mỗi mức cảm xúc.
* **Xu hướng theo thời gian:** Cảm xúc thay đổi thế nào theo ngày/tuần.

<Tip>
  Mục tiêu: duy trì tỷ lệ **tích cực trên 70%**, **tiêu cực dưới 10%**. Khi tỷ lệ tiêu cực tăng đột biến, kiểm tra [Chat Logs](/docs/docs/user-guides/agent/chat-logs) ngay để tìm nguyên nhân.
</Tip>

***

## Phân tích hiệu quả

<Steps>
  <Step title="Kiểm tra hàng tuần">
    Dành 15 phút mỗi tuần xem qua cả 3 tab analytics (Chats, Topics, Sentiment).
  </Step>

  <Step title="Phân biệt Analytics và Chat Logs">
    Analytics cho cái nhìn tổng hợp và xu hướng theo thời gian. Chat Logs cho chi tiết từng cuộc hội thoại. Dùng cả hai cùng nhau để có bức tranh đầy đủ.
  </Step>

  <Step title="Theo dõi sau triển khai">
    Khi triển khai kênh mới hoặc thêm dữ liệu, kiểm tra analytics sau 3–5 ngày để đánh giá tác động (nhớ trừ độ trễ 1 ngày).
  </Step>

  <Step title="So sánh theo kỳ">
    Dùng bộ lọc thời gian để so sánh tháng này với tháng trước, phát hiện xu hướng thay đổi sớm.
  </Step>
</Steps>