#Xếp hạng lại

Sử dụng tính năng xếp hạng lại để sắp xếp các tài liệu ứng viên theo mức độ liên quan đến truy vấn. Tính năng này thường được áp dụng sau bước truy xuất theo từ khóa hoặc vector.

POST https://getrouter.ai/v1/rerank

#Yêu cầu cơ bản

curl https://getrouter.ai/v1/rerank \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "query": "How do I authenticate API requests?",
    "documents": [
      "Send the API key as a Bearer token in the Authorization header.",
      "Video generation jobs are asynchronous.",
      "Image responses may contain a URL or Base64 data."
    ],
    "top_n": 2,
    "return_documents": true
  }'

Phản hồi chứa mảng results đã được xếp hạng. Mỗi kết quả xác định chỉ mục của tài liệu nguồn và gồm điểm mức độ liên quan; nội dung tài liệu cũng có thể được trả về khi bật return_documents.

#Các trường yêu cầu

#Quy trình truy xuất

User query
    ↓
Keyword or vector retrieval
    ↓
Candidate documents
    ↓
POST /v1/rerank
    ↓
Top-ranked context
    ↓
Generation model

#Khuyến nghị

• Giữ lại chỉ mục tài liệu ban đầu để có thể ánh xạ kết quả về đúng tài liệu một cách an toàn.
• Truy xuất một tập ứng viên có quy mô phù hợp trước khi xếp hạng lại.
• Dùng top_n để giới hạn ngữ cảnh được truyền cho model tạo sinh.
• Đánh giá chất lượng truy xuất bằng dữ liệu của riêng bạn thay vì dựa vào ngưỡng điểm sao chép từ model khác.
• Không so sánh điểm thô giữa các model xếp hạng lại khác nhau, trừ khi tài liệu của chúng nêu rõ rằng các thang điểm tương thích.

#Bước tiếp theo

• Nhúng
• Duyệt model xếp hạng lại
• Xem giá
• Mở Tài liệu tham chiếu API