VoyageAI by MongoDB: rerank-2.5
rerank-2.5 mengurutkan ulang kumpulan kandidat teks yang diberikan berdasarkan relevansi terhadap kueri dan instruksi bahasa alami opsional. Ini adalah reranker multibahasa yang berorientasi pada kualitas, dengan konteks kueri-dokumen 32.000 token dan skor berperingkat yang terkait dengan indeks kandidat asli.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
rerank-2.5 adalah reranker Voyage AI yang mengikuti instruksi, dirancang untuk menyempurnakan kumpulan kandidat pencarian. Model ini memeriksa kueri dan setiap dokumen secara bersamaan sebagai cross-encoder, lalu mengembalikan urutan relevansi. Rilis pembuat menekankan kendali bahasa alami atas hal yang dianggap relevan, pengambilan informasi multibahasa, dan konteks kueri-dokumen yang lebih panjang daripada edisi rerank-2 sebelumnya.
Berikan kandidat yang perlu dibandingkan kepada model
Masukannya adalah kueri dan daftar dokumen teks kandidat. Kandidat dapat berupa bagian teks yang dipilih pencarian embedding atau pencarian leksikal tahap pertama. Reranker mengevaluasi teks yang diberikan, bukan membuat embedding korpus, sehingga tugas praktisnya adalah menyempurnakan kandidat yang sudah ditemukan pencarian awal.
Pertahankan urutan kandidat asli dan pengidentifikasi sumber saat menyiapkan daftar tersebut. Indeks yang dikembalikan merujuk pada posisi masukan itu. Untuk tugas RAG, berikan bagian teks yang mungkin benar-benar digunakan tahap jawaban, termasuk judul atau kondisi yang diperlukan untuk menafsirkannya. Dokumen relevan yang tidak ada dalam kumpulan kandidat yang dikirim tidak dapat muncul sebagai hasil yang baru ditemukan melalui pemeringkatan ulang.
Tentukan pengertian relevansi yang dituju
Instruksi dapat ditambahkan sesudah atau sebelum kueri. Rilis tersebut menjelaskan tiga peran yang berguna: menekankan bagian tertentu dari dokumen, mengutamakan jenis sumber, dan memperjelas kueri dengan konteks aplikasi. Ketiganya mengubah tugas relevansi yang disajikan kepada model.
Untuk pencarian teknis, contoh instruksinya adalah “Prioritaskan bagian teks yang menjelaskan perilaku kegagalan dan pemulihan; gambaran pengantar bersifat sekunder.” Untuk kumpulan riset, tentukan apakah judul, metode, atau hasil yang paling penting. Untuk istilah yang ambigu, nyatakan bidang subjek pencarian. Jaga pertanyaan dan instruksi tetap selaras agar yang satu tidak meminta topik luas sementara yang lain diam-diam mengubah tugas.
Preferensi ini memandu pemberian skor relevansi. Jika aplikasi memiliki persyaratan kelayakan ketat—seperti versi sumber, tanggal, atau cakupan akses—siapkan kumpulan kandidat yang memenuhi syarat secara terpisah. Instruksi relevansi model dan pembatasan koleksi deterministik melayani tujuan berbeda.
Keluaran berperingkat dan penggunaan hasil berikutnya
Hasil diurutkan berdasarkan relevansi menurun dan mencakup skor relevansi floating-point serta indeks masukan asli kandidat. Opsi top-k memilih jumlah hasil teratas yang dikembalikan; tanpa opsi tersebut, spesifikasi pembuat mengembalikan hasil untuk semua kandidat yang dikirim. Pengaturan return-documents opsional menyertakan teks sumber yang bersesuaian; jika tidak, respons memuat indeks dan skor.
Gunakan urutan tersebut untuk memilih bagian teks yang akan ditampilkan atau digunakan pada tahap jawaban berikutnya, dengan menjaga identitas sumbernya tetap utuh. Periksa teks aktual ketika mengevaluasi peringkat: skor adalah ukuran relevansi terhadap kueri yang dikirim, bukan jawaban yang dihasilkan atau verifikasi bahwa klaim dokumen benar. Ini membuat model berguna untuk menyempurnakan materi pencarian teknis, hukum, keuangan, medis, percakapan, dan multibahasa tanpa mengubah pemeringkatan menjadi kesimpulan bidang tersebut.
Konteks, anggaran total token, dan truncation
Batas kueri yang didokumentasikan adalah 8.000 token, termasuk instruksi yang ditempatkan dalam kueri. Kueri ditambah satu dokumen kandidat mana pun harus muat dalam 32.000 token, dan daftar dokumen dapat memuat paling banyak 1.000 item. Alokasi total adalah 600.000 token, dihitung sebagai token kueri dikalikan jumlah dokumen, ditambah seluruh token dokumen. Karena itu, instruksi panjang dihitung berulang di seluruh pasangan kandidat.
Jumlah top-k keluaran tidak mengubah jumlah kandidat dalam perhitungan token masukan tersebut. Truncation default memendekkan kueri atau dokumen yang terlalu panjang agar memenuhi batas konteks; menonaktifkannya membuat kueri atau pasangan yang terlalu panjang mengembalikan kesalahan. Siapkan bagian teks yang memuat jawaban secara sengaja dan jaga agar kondisi yang relevan tetap berada dalam teks yang akan dilihat model. Evaluasi urutan yang disempurnakan pada pertanyaan dan instruksi representatif, lalu teruskan bagian teks asli yang dipilih ke tahap berikutnya.
Ailoot Ultra · Pemeringkatan ulang POST /v1/rerank voyageai/rerank-2.5
voyageai/rerank-2.5Mulai
rerank-2.5 mengurutkan ulang kumpulan kandidat teks yang diberikan berdasarkan relevansi terhadap kueri dan instruksi bahasa alami opsional. Ini adalah reranker multibahasa yang berorientasi pada kualitas, dengan konteks kueri-dokumen 32.000 token dan skor berperingkat yang terkait dengan indeks kandidat asli.
- Masukan yang diterima
- Teks
- Hasil
- Hasil berperingkat
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Pemeringkatan ulang POST /v1/rerank
- Masukan
text- Keluaran
rerank- Format keluaran
- json
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolomdocuments | Jenisarray | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan voyageai/rerank-2.5 | Bawaan— |
Kolomprovider | Jenisschema | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomquery | Jenisstring | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolomsession_id | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomtop_n | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 | Bawaan— |
Kolomtrace | Jenisschema | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomuser | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomdocuments[].text | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomdocuments[].image | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kombinasi bahan masukan
text_rerank · Wajib: query, documents array with minItems1
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, query, documents |
Parametermaterial_types | Kontraktext |
Parameteroptional_controls | Kontrakprovider, session_id, top_n, trace, user |
Parametermultimodal_input_binding | Kontraknull |
Siklus hidup: synchronous
Kirim ID model yang persis dan simpan respons native secara utuh.
Paket
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Tarif Ailoot
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Satuan penagihan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Satuan penagihan— | Biaya Masukan · Token masukan — / 1K token Keluaran · Token keluaran — / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
| KonfigurasiUltra | Jadwal tarif— | Satuan penagihan/ 1K token | Biaya Masukan $0.0001 / 1K token |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Pemeringkatan ulang
{
"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
Terima dan simpan hasil
Ailoot Ultra · Pemeringkatan ulang
json
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan.
Setiap indeks hasil aktual, relevance_score yang bernilai berhingga, dan objek dokumen asli dipertahankan. Indeks mengacu pada array dokumen asli. Seluruh JSON asli disimpan dan hanya dikembalikan setelah penyelesaian tagihan.
Jika respons asli perlu diperiksa
Simpan operasi awal dan balasan lengkap/sebagian; jangan ulangi POST.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolommodel | Jenisstring |
Kolomid | Jenisstring |
Kolomprovider | Jenisstring |
Kolomresults[].index | Jenisinteger |
Kolomresults[].relevance_score | Jenisnumber |
Kolomresults[].document.text | Jenisstring |
Kolomresults[].document.image | Jenisstring |
Kolomusage.search_units | Jenisinteger |
Kolomusage.total_tokens | Jenisinteger |
Kolomusage.cost | Jenisnumber |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi, atau nilai tidak valid | Langkah berikutnyaPerbaiki bidang permintaan yang ditunjukkan. |
Alias
Alias model
Ailoot Ultra voyageai/rerank-2.5
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · VoyageAI by MongoDB: rerank-2.5
- Input dan hasil apa yang tersedia?
POST /v1/rerank·voyageai/rerank-2.5:text→rerank- Kolom apa yang digunakan permintaan?
POST /v1/rerank·voyageai/rerank-2.5:documents,model,provider,query,session_id,top_n,trace,user- Batasan apa yang berlaku?
POST /v1/rerank·voyageai/rerank-2.5:top_n.minimum:1