VoyageAI by MongoDB: rerank-2.5

rerank-2.5 sắp lại tập ứng viên văn bản cung cấp theo độ liên quan với truy vấn và chỉ dẫn ngôn ngữ tự nhiên tùy chọn. Đây là bộ xếp hạng lại đa ngôn ngữ hướng chất lượng, có ngữ cảnh truy vấn–tài liệu 32,000 token và điểm xếp hạng gắn chỉ số ứng viên gốc.

Ailoot Ultra · Xếp hạng lại POST /v1/rerank voyageai/rerank-2.5

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

rerank-2.5 là bộ xếp hạng lại tuân thủ chỉ dẫn của Voyage AI, thiết kế để tinh chỉnh tập ứng viên tìm kiếm. Mô hình xem đồng thời truy vấn và từng tài liệu như cross-encoder, rồi trả thứ tự liên quan. Bản phát hành nhấn mạnh điều khiển bằng ngôn ngữ tự nhiên về thế nào là liên quan, truy xuất đa ngôn ngữ và ngữ cảnh truy vấn–tài liệu dài hơn rerank-2 trước.

Cung cấp ứng viên để mô hình so sánh

Đầu vào là truy vấn và danh sách tài liệu văn bản ứng viên. Chúng có thể là đoạn chọn bởi tìm embedding hoặc tìm từ vựng giai đoạn đầu. Bộ xếp hạng lại đánh giá văn bản cung cấp, không tạo embedding cho tập tài liệu, nên nhiệm vụ thực tiễn là tinh chỉnh ứng viên tìm kiếm ban đầu đã tìm thấy.

Giữ thứ tự ứng viên ban đầu và mã định danh nguồn khi chuẩn bị danh sách. Chỉ số trả về chỉ vị trí đầu vào đó. Với RAG, cung cấp đoạn bước trả lời thực sự có thể dùng, gồm tiêu đề hoặc điều kiện cần để hiểu. Tài liệu liên quan vắng khỏi tập ứng viên gửi không thể xuất hiện như kết quả mới tìm được qua xếp lại.

Nêu khái niệm độ liên quan dự kiến

Chỉ dẫn có thể thêm sau hoặc trước truy vấn. Bản phát hành mô tả ba vai trò hữu ích: nhấn phần tài liệu, ưu tiên loại nguồn và làm rõ truy vấn bằng bối cảnh ứng dụng. Chúng đổi tác vụ liên quan được giao cho mô hình.

Với tìm kỹ thuật, chỉ dẫn minh họa là “Ưu tiên đoạn giải thích hành vi khi lỗi và khôi phục; tổng quan nhập môn là thứ yếu.” Với bộ nghiên cứu, nêu tiêu đề, phương pháp hay kết quả quan trọng nhất. Với từ mơ hồ, nêu lĩnh vực tìm kiếm. Giữ câu hỏi và chỉ dẫn tương thích để một bên không hỏi chủ đề rộng trong khi bên kia âm thầm đổi tác vụ.

Các ưu tiên hướng dẫn chấm độ liên quan. Nếu ứng dụng có yêu cầu đủ tư cách chặt — như phiên bản nguồn, ngày hoặc phạm vi truy cập — chuẩn bị tập ứng viên hợp lệ riêng. Chỉ dẫn liên quan của mô hình và hạn chế tập tài liệu xác định bằng quy tắc phục vụ mục đích khác nhau.

Đầu ra xếp hạng và sử dụng kết quả sau

Kết quả sắp độ liên quan giảm dần, có điểm liên quan số thực dấu phẩy động và chỉ số đầu vào gốc của ứng viên. Tùy chọn top-k chọn số kết quả đầu trả; thiếu nó, đặc tả nhà sản xuất trả mọi ứng viên gửi. Cài đặt return-documents tùy chọn kèm văn bản nguồn tương ứng; nếu không, phản hồi chứa chỉ số, điểm.

Dùng thứ tự để chọn đoạn hiển thị hoặc cho bước trả lời sau, giữ danh tính nguồn nguyên. Xem văn bản thực khi đánh giá thứ hạng: điểm đo độ liên quan với truy vấn gửi, không phải câu trả lời tạo ra hay xác minh khẳng định tài liệu đúng. Điều này hữu ích để tinh chỉnh tài liệu tìm kiếm kỹ thuật, pháp lý, tài chính, y tế, hội thoại và đa ngôn ngữ mà không biến xếp hạng thành kết luận chuyên môn.

Ngữ cảnh, tổng ngân sách token và cắt ngắn

Giới hạn truy vấn được tài liệu hóa là 8,000 token, gồm chỉ dẫn trong truy vấn. Truy vấn cộng một tài liệu ứng viên bất kỳ phải vừa 32,000 token, danh sách tối đa 1,000 mục. Tổng cho phép 600,000 token, tính bằng token truy vấn nhân số tài liệu cộng mọi token tài liệu. Vì vậy chỉ dẫn dài được tính lặp qua các cặp ứng viên.

Số top-k đầu ra không đổi số ứng viên trong phép tính token đầu vào đó. Cắt ngắn mặc định rút truy vấn hoặc tài liệu quá dài cho vừa giới hạn; tắt thì truy vấn hoặc cặp quá dài trả lỗi. Chuẩn bị chủ đích đoạn chứa câu trả lời, giữ điều kiện liên quan trong văn bản mô hình thấy. Đánh giá thứ tự tinh chỉnh trên câu hỏi, chỉ dẫn đại diện, rồi chuyển đoạn gốc chọn sang bước tiếp.

Ailoot Ultra · Xếp hạng lại POST /v1/rerank voyageai/rerank-2.5

voyageai/rerank-2.5

VoyageAI by MongoDB /voyageai/rerank-2.5

Bắt đầu

Đầu vào được chấp nhận: Văn bản
Kết quả: Kết quả đã xếp hạng

Có trên Ailoot · đầu vào & phương thức

Ailoot Ultra · Xếp hạng lại POST /v1/rerank

Đầu vào: text
Đầu ra: rerank
Định dạng đầu ra: json

Trường	Loại	Yêu cầu	Giá trị & giới hạn	Mặc định
Trường`documents`	Loại`array`	Yêu cầuBắt buộc	Giá trị & giới hạn	Mặc định—
Trường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn voyageai/rerank-2.5	Mặc định—
Trường`provider`	Loại`schema`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—
Trường`query`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn	Mặc định—
Trường`session_id`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—
Trường`top_n`	Loại`integer`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn Tối thiểu: 1	Mặc định—
Trường`trace`	Loại`schema`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—
Trường`user`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—
Trường`documents[].text`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—
Trường`documents[].image`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—

Tổ hợp tư liệu đầu vào

text_rerank · Bắt buộc: query, documents array with minItems1

Tham số phương thức và vòng đời

Tham số	Hợp đồng
Tham số`content_type`	Hợp đồngapplication/json
Tham số`required`	Hợp đồngmodel, query, documents
Tham số`material_types`	Hợp đồngtext
Tham số`optional_controls`	Hợp đồngprovider, session_id, top_n, trace, user
Tham số`multimodal_input_binding`	Hợp đồngnull

Vòng đời: synchronous

Gửi ID mô hình chính xác và giữ lại toàn bộ phản hồi gốc.

Bảng giá

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh: Chưa chỉ định Khi chọn chế độ nhanh
Chế độ Flex: Chưa chỉ định Khi chọn chế độ flex
Mức độ suy luận tối đa: Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

Mức phí Ailoot

Giá theo cấu hình

Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.

Cấu hình	Biểu mức phí	Đơn vị tính phí	Phí
Cấu hìnhGiá cơ sở cho token	Biểu mức phíMức phí cơ bản	Đơn vị tính phí—	Phí Đầu vào · Token đầu vào — / 1K token Đầu ra · Token đầu ra — / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token
Cấu hìnhUltra	Biểu mức phí—	Đơn vị tính phí/ 1K token	Phí Đầu vào $0.0001 / 1K token

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →

Ví dụ yêu cầu

Ailoot Ultra · Xếp hạng lại

Cấu trúc yêu cầu chính thức được giữ nguyên; ví dụ trong tài liệuSử dụng dữ liệu yêu cầu thực tế của bạn và giữ lại kết quả đầy đủ

{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-2.5",
  "query": "What is the capital of France?",
  "top_n": 3
}

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='voyageai/rerank-2.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/rerank \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT

Nhận và lưu kết quả

Ailoot Ultra · Xếp hạng lại

json

Lưu tất cả kết quả đã hoàn tất

Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.

Giữ lại mọi chỉ số kết quả thực tế, relevance_score hữu hạn và đối tượng tài liệu gốc. Các chỉ số liên kết với mảng tài liệu gốc. Toàn bộ JSON gốc chỉ được lưu và trả về sau khi quyết toán.

Nếu cần kiểm tra phản hồi gốc

Giữ nguyên thao tác ban đầu và phản hồi đầy đủ/một phần; không gửi lại POST.

Trường phản hồi

Trường	Loại
Trường`model`	Loạistring
Trường`id`	Loạistring
Trường`provider`	Loạistring
Trường`results[].index`	Loạiinteger
Trường`results[].relevance_score`	Loạinumber
Trường`results[].document.text`	Loạistring
Trường`results[].document.image`	Loạistring
Trường`usage.search_units`	Loạiinteger
Trường`usage.total_tokens`	Loạiinteger
Trường`usage.cost`	Loạinumber

Lỗi và bước tiếp theo

Phản hồi	Điều kiện	Bước tiếp theo
Phản hồi400 · `invalid_request_error`	Điều kiệnTrường bắt buộc, biểu diễn hoặc giá trị không hợp lệ	Bước tiếp theoSửa trường yêu cầu được chỉ ra.

Bí danh

Bí danh mô hình

Ailoot Ultra voyageai/rerank-2.5

Bí danh đường dẫn phương thức

Dùng các đường dẫn phương thức hiển thị ở trên.

ID gọi liên quan

voyageai/rerank-2.5

FAQ · VoyageAI by MongoDB: rerank-2.5

Có những đầu vào và kết quả nào?: POST /v1/rerank · voyageai/rerank-2.5: text → rerank
Yêu cầu sử dụng những trường nào?: POST /v1/rerank · voyageai/rerank-2.5: documents, model, provider, query, session_id, top_n, trace, user
Áp dụng những giới hạn nào?: POST /v1/rerank · voyageai/rerank-2.5: top_n.minimum: 1

VoyageAI by MongoDB: rerank-2.5