VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite memberi skor dan mengurutkan ulang dokumen teks kandidat untuk suatu kueri, dengan fokus pada pencarian yang responsif. Model ini mendukung instruksi relevansi dan jendela kueri-dokumen 32.000 token, sehingga berguna setelah pengambilan informasi vektor atau kata kunci dalam alur pencarian dan RAG.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Voyage rerank-3-lite adalah edisi yang berfokus pada latensi dalam seri Rerank 3 Voyage. Model ini menerima kueri teks dan dokumen kandidat, mengevaluasi setiap pasangan kueri-dokumen secara bersamaan, dan mengembalikan skor relevansi dalam urutan peringkat. Model ini melayani tahap kedua pencarian: pengambil informasi berbasis embedding atau kata kunci menemukan kandidat, lalu Lite menyempurnakan urutannya. Hasilnya adalah peringkat untuk digunakan dalam pencarian atau alur kerja retrieval-augmented generation.
Perubahan dalam Rerank 3 Lite Pembuatnya menekankan pengambilan informasi yang lebih kuat pada dokumen panjang dan kode dibandingkan rerank-2.5-lite. Kedua edisi Rerank 3 mempertahankan kepatuhan terhadap instruksi dan kelas konteks 32K yang sama, sedangkan Lite dirancang untuk aplikasi yang sensitif terhadap latensi. Ini menjadikannya kandidat praktis untuk pencarian basis pengetahuan interaktif, pengambilan dokumen dukungan, dan pencarian kode ketika pengguna memerlukan hasil relevan dengan segera. Pilih model berdasarkan persyaratan kualitas dan waktu respons koleksi aktual, alih-alih menganggap edisi yang lebih kecil berarti jendela konteks lebih kecil.
Pandu relevansi melalui kueri Instruksi bahasa alami dapat menyertai kueri untuk menjelaskan apa yang dianggap relevan. Jaga pertanyaan dan preferensi relevansi tetap ringkas dan konsisten. Untuk pencarian dukungan perangkat lunak, gunakan “Temukan prosedur untuk mereset perangkat; prioritaskan instruksi untuk revisi perangkat keras yang disebutkan.” Untuk nama produk yang ambigu, sertakan kategori produk agar makna yang tidak berkaitan tidak mendominasi. Preferensi dalam kueri memandu penilaian semantik; gunakan metadata koleksi yang eksplisit untuk memilih produk, versi dokumen, atau cakupan akses yang benar sebelum menyusun daftar kandidat.
Siapkan daftar pendek kandidat teks Dokumen masukan berupa string. Ekstrak teks yang dapat dibaca dari materi sumber dan pertahankan judul, subjudul, pengidentifikasi, serta konteks di sekitarnya yang berguna. Jaga pemetaan yang stabil dari setiap posisi masukan ke catatan asli. Untuk artikel pemecahan masalah, sertakan gejala dan prosedur yang relevan, bukan hanya kalimat terlepas. Untuk pencarian kode sumber, sertakan fungsi dan informasi di sekitarnya yang diperlukan untuk membedakannya dari fungsi bernama serupa. Hapus navigasi atau teks standar berulang ketika memenuhi ruang yang seharusnya digunakan bagian teks yang berguna.
Reranker hanya dapat mengurutkan ulang dokumen yang diterimanya. Jika pencarian pertama tidak pernah mengambil artikel yang relevan, tahap ini tidak dapat memulihkan kandidat yang belum tersedia itu. Periksa daftar pendek dan urutan akhir ketika hasil tampak keliru. Ketika dokumen panjang mencakup banyak topik, pisahkan bagian yang koheren dan pertahankan referensi dokumen induknya agar bagian relevan dapat dipilih tanpa kehilangan sumbernya.
Batas konteks dan permintaan Panduan pembuat saat ini menetapkan maksimum kueri 8.000 token dan maksimum gabungan 32.000 token untuk kueri ditambah setiap dokumen individual. Panduan tersebut mengizinkan hingga 1.000 dokumen kandidat dan anggaran total permintaan 600.000 token, yang dihitung sebagai token kueri dikalikan jumlah dokumen, ditambah seluruh token dokumen. Karena itu, kueri panjang memakan ruang pada setiap pasangan dan berkontribusi berulang pada anggaran agregat. Hitung teks yang dikirim menggunakan tokenizer model yang sesuai, alih-alih memperlakukan karakter, kata, dan token sebagai hal yang dapat dipertukarkan.
Misalnya, kueri 500 token dengan 100 dokumen yang masing-masing berisi 4.000 token menghasilkan 450.000 token masukan berdasarkan rumus tersebut. Ini memperlihatkan penganggaran, bukan ukuran daftar pendek yang direkomendasikan atau hasil pengukuran kecepatan. Opsi truncation yang didokumentasikan aktif secara default; teks yang terlalu panjang dapat dipendekkan sebelum diberi skor. Siapkan bagian penting secara sengaja agar truncation tidak menghapus bagian yang justru perlu dicocokkan.
Baca dan gunakan hasil Hasil diurutkan dari skor relevansi tertinggi ke bawah. Setiap hasil mengidentifikasi posisi masukan asli dokumen, sehingga aplikasi dapat menambahkan judul, pengidentifikasi catatan, dan sumbernya sendiri. Pengaturan top_k mengendalikan jumlah kandidat berperingkat yang dikembalikan; tanpa pengaturan tersebut, semua kandidat dikembalikan. Antarmuka REST pembuat juga dapat mengembalikan teks dokumen. Pertahankan pengidentifikasi asli bersama hasil yang dipilih saat menampilkan halaman pencarian atau meneruskan bukti ke langkah pembuatan jawaban.
Skor relevansi menyatakan seberapa baik kandidat sesuai dengan kueri; skor itu tidak memastikan bahwa pernyataan kandidat benar. Bandingkan item berperingkat tertinggi dengan pertanyaan aktual pengguna, termasuk pengecualian dan perbedaan versi dokumen. Jika setiap kandidat tidak relevan, item dengan peringkat tertinggi tetap ada. Tentukan bagaimana aplikasi menangani kasus tersebut menggunakan kueri representatif dari koleksi.
Peningkatan versi dan pemilihan edisi Pembuatnya mendeskripsikan rerank-3-lite sebagai peningkatan dari rerank-2.5-lite dengan semantik API yang tidak berubah dan skor yang dikalibrasi terhadap distribusi pendahulunya yang bersesuaian. Pertahankan pemetaan catatan dan tahap pengambilan informasi yang ada, lalu bandingkan urutan yang dihasilkan pada kueri bermakna sebelum mengandalkan ambang skor yang sudah ditetapkan. Gunakan Lite untuk pengalaman pencarian ketika waktu respons penting; gunakan edisi rerank-3 yang berfokus pada kualitas sebagai pembanding ketika relevansi kandidat sulit menjadi prioritas yang lebih kuat.
Ailoot Ultra · Pemeringkatan ulang POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteMulai
Voyage rerank-3-lite memberi skor dan mengurutkan ulang dokumen teks kandidat untuk suatu kueri, dengan fokus pada pencarian yang responsif. Model ini mendukung instruksi relevansi dan jendela kueri-dokumen 32.000 token, sehingga berguna setelah pengambilan informasi vektor atau kata kunci dalam alur pencarian dan RAG.
- 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-3-lite | 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.00004 / 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-3-lite",
"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-3-lite'
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-3-lite
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Input dan hasil apa yang tersedia?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Kolom apa yang digunakan permintaan?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Batasan apa yang berlaku?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1