Rerank

Xếp hạng lại theo mức độ liên quan bằng truy vấn và các tài liệu ứng viên.

Tổng quan

Rerank nhận một truy vấn và một nhóm tài liệu ứng viên, rồi trả về kết quả được sắp xếp theo mức độ liên quan. Chức năng này thường được dùng sau truy xuất vector, truy xuất từ khóa hoặc truy xuất kết hợp để chọn nội dung liên quan hơn từ số ứng viên giới hạn.

Tích hợp API

Base URL

https://api.agtcloud.cn/v1

Thực hiện xếp hạng lại

Ví dụ dưới đây sử dụng yêu cầu POST /v1/rerank theo định dạng Jina.

curl 'https://api.agtcloud.cn/v1/rerank' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "query": "Nên lưu API Key như thế nào?",
    "documents": [
      "Lưu API Key trong biến môi trường phía máy chủ hoặc dịch vụ quản lý khóa.",
      "Danh mục mô hình dùng để xem các mô hình hiện có.",
      "Không đưa API Key thật vào mã phía trình duyệt hoặc kho mã công khai."
    ],
    "top_n": 2
  }'

Tham số	Bắt buộc	Mô tả
`model`	Không	ID mô hình Rerank; có thể bỏ qua hay không tùy thuộc vào định dạng đã chọn
`query`	Có	Văn bản truy vấn dùng để đánh giá mức độ liên quan
`documents`	Có	Mảng tài liệu ứng viên cần xếp hạng lại
`top_n`	Không	Số lượng kết quả trả về

Đọc kết quả

Kết quả được sắp xếp theo mức độ liên quan. Sử dụng results[].index để đối chiếu với documents ban đầu và đọc điểm liên quan từ results[].relevance_score.

Chọn định dạng yêu cầu

Định dạng	Đường dẫn yêu cầu	API Reference
Jina	`POST /v1/rerank`	Jina Rerank
Cohere	`POST /v1/rerank`	Cohere Rerank
Xinference	`POST /v1/rerank`	Xinference Rerank

Hiểu điểm liên quan

Điểm liên quan không phải là xác suất.
Điểm số chủ yếu dùng để so sánh thứ tự các ứng viên trong cùng một yêu cầu.
Ngưỡng và top_n cần được đánh giá bằng dữ liệu nghiệp vụ.