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

# Thử truy hồi

> Xem chính xác agent nhận được gì trước khi nó trả lời - Công cụ gỡ lỗi đầu tiên khi agent trả lời sai.

Agent trả lời sai thường không phải do mô hình, mà do nó nhận sai đoạn tài liệu. **Thử truy hồi** chạy đúng câu hỏi qua đúng kho với đúng cấu hình agent đang dùng, rồi cho bạn xem từng chunk trả về kèm điểm số và một bản chẩn đoán tự động.

## Bố cục màn hình

![Màn Thử truy hồi: cấu hình bên trái, chunk trả về ở giữa, Chẩn đoán bên phải](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/thu-truy-hoi.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=79fef1778a7d30acc167d917cf9039ab)

Màn Thử truy hồi: cấu hình bên trái, chunk trả về ở giữa, Chẩn đoán bên phải

| Vùng | Nội dung |
| - | - |
| Cấu hình truy vấn (bên trái) | Kho, phương pháp, bộ lọc, Top-K, ngưỡng điểm |
| Ô câu hỏi và nút **Truy hồi** | Nhập câu hỏi cần kiểm tra |
| Chunk được truy hồi (giữa) | Danh sách kết quả theo thứ hạng |
| Chẩn đoán (bên phải) | Nền tảng tự phân tích lượt truy hồi |

## Các tham số cấu hình

| Tham số | Ý nghĩa |
| - | - |
| Kho tri thức | Kho cần kiểm tra |
| Phương pháp truy vấn | Vector, BM25 hoặc *Hybrid Search + Rerank (70% Vector)* |
| Lọc metadata | Nhiều điều kiện cách nhau bằng `;`, toán tử `=`, `!=` hoặc `~` (chứa). Ví dụ: `phong_ban = HR;ten_tep~Quy_che` |
| Top-K | Số chunk trả về (mặc định 6) |
| Ngưỡng điểm tương đồng | Chunk dưới ngưỡng bị loại (mặc định 0,35) |

## Đọc kết quả

Mỗi chunk trả về hiện **thứ hạng**, **tiêu đề đoạn**, **điểm** (ví dụ 0,51), **tên tài liệu**, nội dung đoạn và **mã chunk**. Dòng đầu kết quả cho biết có bao nhiêu kết quả từ bao nhiêu ứng viên.

Khối **Chẩn đoán**:

| Chỉ số | Cách đọc |
| - | - |
| Số ứng viên | Bao nhiêu chunk được tìm thấy trước khi cắt còn Top-K |
| Điểm cao nhất | Điểm của chunk đứng đầu |
| Khoảng cách #1–#2 | Chênh lệch điểm giữa hai chunk đầu - Lớn thì kết quả *Rõ ràng*, nhỏ thì agent dễ chọn nhầm |
| Nguồn khác biệt | Kết quả đến từ bao nhiêu tài liệu |
| Bị lọc do hiệu lực | Số chunk bị loại vì văn bản hết hiệu lực |

Nhấn **Thêm vào bộ câu hỏi vàng** để lưu câu hỏi này vào bộ kiểm thử ở [Đánh giá chất lượng](https://docs-eos.fpt.ai/vi/screens/evaluation.md).

## Gỡ lỗi khi kết quả không đúng

**1. Không có chunk nào trả về**

Hạ ngưỡng điểm, kiểm tra tài liệu đã ở trạng thái *Đã xử lý* chưa, và bộ lọc metadata có quá chặt không.

**2. Chunk đúng nhưng xếp thấp**

Chuyển sang *Hybrid + rerank*, hoặc tăng trọng số BM25 nếu câu hỏi có số hiệu, mã số.

**3. Chunk bị cắt nửa chừng**

Bật **Mở rộng lên chunk cha** ở tab Cấu hình của kho, hoặc sửa tay chunk trong trình xem chunk.

**4. Trả về văn bản cũ**

Bật **Chỉ trả tài liệu còn hiệu lực** và điền trường ngày hiệu lực cho tài liệu.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.