> ## 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.

# Chat Logs (Nhật ký hội thoại)

> Xem lại toàn bộ lịch sử hội thoại, kiểm tra chất lượng phản hồi, sửa câu trả lời sai và quản lý leads.

Chat Logs cung cấp cái nhìn chi tiết về tất cả cuộc trò chuyện giữa AI agent và người dùng. Đây là công cụ quan trọng nhất để theo dõi chất lượng, phát hiện vấn đề và cải thiện agent liên tục.

## Truy cập

Trên sidebar, chọn **Hoạt động**.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/chat-logs-overview.png" alt="Giao diện Chat Logs" />
</Frame>

## Giao diện 2 panel

### Panel trái — Danh sách cuộc hội thoại

Danh sách tất cả cuộc trò chuyện sắp xếp theo thời gian (mới nhất trước). Mỗi item hiển thị:

* **Tin nhắn đầu tiên** của khách hàng (hoặc tóm tắt).
* **Thời gian** bắt đầu cuộc hội thoại.
* **Kênh** (chat widget, playground, Zalo, API...).
* **Điểm tin cậy** và **trạng thái phản hồi** (thumbs up/down).

### Panel phải — Chi tiết hội thoại

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/chat-logs-detail.png" alt="Chi tiết cuộc hội thoại" />
</Frame>

Khi chọn một cuộc trò chuyện:

* Toàn bộ tin nhắn theo thứ tự thời gian.
* Tin nhắn khách hàng (bên phải) và tin nhắn AI (bên trái).
* Phản hồi đã nhận (thumbs up/down).
* Thông tin: Conversation ID, Visitor ID, kênh, thời gian, số tin nhắn.

## Tìm kiếm và lọc

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/chat-logs-filter.png" alt="Bộ lọc Chat Logs" />
</Frame>

| Bộ lọc           | Mô tả                                               |
| ---------------- | --------------------------------------------------- |
| **Tìm kiếm**     | Gõ từ khóa để tìm hội thoại chứa nội dung liên quan |
| **Ngày**         | Lọc theo khoảng thời gian cụ thể                    |
| **Điểm tin cậy** | Lọc theo mức độ tin cậy của phản hồi                |
| **Kênh nguồn**   | Chat Widget, Playground, Zalo, Facebook, API...     |
| **Phản hồi**     | Lọc theo thumbs up, thumbs down                     |
| **Cảm xúc**      | Tích cực, trung lập, tiêu cực                       |
| **Chủ đề**       | Lọc theo chủ đề đã được phân loại                   |

<Tip>
  Lọc theo **Thumbs down** hoặc **Điểm tin cậy thấp** để nhanh chóng tìm các
  cuộc hội thoại cần cải thiện.
</Tip>

## Điểm tin cậy (Confidence Score)

Điểm tin cậy phản ánh mức độ chắc chắn của AI agent với câu trả lời, dựa trên độ liên quan của dữ liệu đã huấn luyện với câu hỏi được hỏi.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/chat-logs-confidence.png" alt="Điểm tin cậy" />
</Frame>

| Điểm                    | Ý nghĩa                                             | Hành động đề xuất                        |
| ----------------------- | --------------------------------------------------- | ---------------------------------------- |
| **Cao (80–100%)**       | Agent trả lời rất tự tin, dữ liệu liên quan rõ ràng | Không cần can thiệp                      |
| **Trung bình (50–79%)** | Agent trả lời được nhưng không chắc chắn            | Kiểm tra câu trả lời                     |
| **Thấp (\< 50%)**       | Agent không tìm được dữ liệu liên quan              | Bổ sung dữ liệu, xem xét sửa câu trả lời |

Lọc theo **Điểm tin cậy thấp** để ưu tiên cải thiện những câu hỏi agent đang yếu nhất.

## Sửa câu trả lời (Improve Answer)

Khi phát hiện câu trả lời không chính xác hoặc chưa đủ, bạn có thể sửa trực tiếp từ Chat Logs.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/chat-logs-revise.png" alt="Sửa câu trả lời" />
</Frame>

<Steps>
  <Step title="Tìm tin nhắn cần sửa">
    Trong chi tiết hội thoại, tìm tin nhắn agent trả lời sai hoặc thiếu
    chính xác.
  </Step>

  <Step title="Nhấn Sửa câu trả lời">
    Nhấn nút **"Sửa câu trả lời"** trên tin nhắn đó. Hộp soạn thảo hiện ra
    với: - Câu hỏi gốc của khách hàng - Câu trả lời hiện tại của agent - Ô
    nhập câu trả lời đúng
  </Step>

  <Step title="Nhập câu trả lời chính xác">
    Viết câu trả lời đúng. Hỗ trợ định dạng văn bản phong phú.
  </Step>

  <Step title="Lưu">
    Nhấn **Lưu**. Câu trả lời được sửa tự động thêm vào **Nguồn dữ liệu →
    Q\&A**, giúp agent trả lời đúng cho câu hỏi tương tự về sau.
  </Step>
</Steps>

<Info>
  Câu trả lời được sửa qua tính năng này trở thành dữ liệu Q\&A có độ ưu tiên
  cao. Agent sẽ dùng chúng trước khi tìm trong các nguồn dữ liệu khác.
</Info>

## Xuất dữ liệu

Tải xuống lịch sử hội thoại để phân tích hoặc lưu trữ.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/chat-logs-export.png" alt="Xuất dữ liệu" />
</Frame>

Nhấn nút **Xuất** ở góc trên bên phải để chọn định dạng:

| Định dạng | Phù hợp cho                                 |
| --------- | ------------------------------------------- |
| **JSON**  | Phân tích dữ liệu, import vào hệ thống khác |
| **CSV**   | Mở bằng Excel, Google Sheets                |
| **PDF**   | Lưu trữ, báo cáo                            |

## Leads

Mục **Leads** hiển thị danh sách khách hàng tiềm năng đã để lại thông tin liên hệ qua hành động Thu thập leads.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/agent/chat-logs-leads.png" alt="Danh sách Leads" />
</Frame>

### Thông tin leads

Mỗi lead hiển thị:

* **Thông tin liên hệ:** Tên, email, số điện thoại (theo cấu hình của hành động).
* **Thời gian gửi:** Khi nào khách hàng điền form.
* **Cuộc hội thoại liên quan:** Link đến chat log gốc.

### Lọc và xuất leads

* **Lọc theo ngày:** Xem leads trong khoảng thời gian cụ thể.
* **Xuất CSV hoặc PDF:** Tải xuống để import vào CRM hoặc báo cáo.

<Tip>
  Kết hợp với **Webhooks** (trong Cài đặt) để tự động đẩy leads mới vào CRM
  hoặc Google Sheets ngay lập tức khi có lead mới.
</Tip>

## Cách sử dụng Chat Logs hiệu quả

<Steps>
  <Step title="Kiểm tra chất lượng hàng ngày">
    Dành 5–10 phút mỗi ngày đọc qua hội thoại mới. Chú ý đến các cuộc có
    **thumbs down** và **điểm tin cậy thấp**.
  </Step>

  <Step title="Phát hiện và bổ sung kiến thức thiếu">
    Khi agent nói "Tôi không có thông tin về vấn đề này", đó là cơ hội thêm
    dữ liệu mới vào [Nguồn dữ liệu](/docs/docs/user-guides/agent/data-sources).
  </Step>

  <Step title="Phát hiện câu hỏi phổ biến chưa có Q&A">
    Nếu nhiều khách hàng hỏi cùng một câu hỏi và agent trả lời không ổn,
    thêm cặp Q\&A cho câu hỏi đó.
  </Step>

  <Step title="Dùng Sửa câu trả lời thay vì chỉnh dữ liệu">
    Khi agent trả lời sai một câu cụ thể, dùng tính năng **Sửa câu trả lời**
    — nhanh hơn và hiệu quả hơn việc tìm và chỉnh sửa tài liệu gốc.
  </Step>
</Steps>

<Info>
  Chat Logs là vòng lặp cải tiến quan trọng nhất. Agent sẽ ngày càng thông
  minh hơn nếu bạn thường xuyên kiểm tra và bổ sung dữ liệu từ hội thoại thực
  tế.
</Info>