VoyageAI by MongoDB: rerank-3
Voyage rerank-3 ialah edisi Rerank 3 yang memfokuskan kualiti untuk penskoran kerelevanan pertanyaan-dokumen. Ia menyusun semula calon teks yang diperoleh, menyokong arahan kerelevanan bahasa semula jadi dan mengendalikan pasangan 32,000 token untuk carian dokumen panjang, kod dan pangkalan pengetahuan.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Voyage rerank-3 ialah pemeringkat semula teks yang direka untuk meningkatkan kualiti bukti yang diperoleh. Dengan pertanyaan dan senarai dokumen calon, ia memeriksa setiap pasangan bersama-sama serta mengembalikan calon yang disusun mengikut kerelevanan. Pembenaman dan carian kata kunci boleh terlebih dahulu mengecilkan koleksi besar kepada senarai pendek yang boleh diurus; rerank-3 kemudian menerapkan penilaian kerelevanan yang lebih terperinci pada senarai pendek itu. Outputnya ialah bukti carian berskor untuk dipaparkan oleh aplikasi atau diteruskan ke langkah penjanaan jawapan berasingan.
Rerank 3 yang memfokuskan kualiti Pengeluar menempatkan rerank-3 sebagai edisi yang memfokuskan ketepatan dan rerank-3-lite sebagai edisi untuk carian yang sensitif terhadap kependaman. Generasi ketiga mengemas kini tulang belakang dan campuran latihan, dengan penambahbaikan khusus pada pemerolehan dokumen panjang serta kod sumber berbanding pendahulu 2.5 yang sepadan. Pengeluar menilainya merentas dokumentasi teknikal, kod, bahan berbilang bahasa dan bidang dokumen lain. Hasil itu menyokong peranannya dalam pemerolehan maklumat; pilih edisi menggunakan soalan dan dokumen calon yang penting kepada koleksi anda sendiri.
Dokumen panjang dengan konteks yang mencukupi Calon yang panjang boleh mengandungi konteks berguna jauh melepasi perenggan pembukaannya. Bekalkan bahagian atau dokumen yang koheren bersama tajuk dan bahan sekeliling yang berkaitan, supaya model boleh menilai hubungan soalan sebenar dengan kandungan. Untuk carian dasar produk, kekalkan pengepala dan pengecualian di sekitar petikan yang diminati. Jika beberapa bahagian yang diperoleh datang daripada sumber yang sama, kekalkan pengecam dokumen dan bahagiannya; aplikasi kemudian boleh menunjukkan tempat asal bukti yang dipilih.
Tetingkap konteks dikongsi oleh pertanyaan dan setiap calon. Panduan semasa pengeluar menyatakan 32,000 token bagi pasangan itu, termasuk pertanyaan yang tidak melebihi 8,000 token. Oleh itu, pertanyaan 3,000 token meninggalkan paling banyak 29,000 token untuk setiap dokumen. Sediakan input supaya kandungan pentingnya muat, khususnya apabila mukadimah panjang atau teks templat berulang akan menggunakan tetingkap tersebut. Pilihan pemangkasan yang didokumenkan diaktifkan secara lalai dan boleh memendekkan pertanyaan atau teks dokumen yang terlalu besar sebelum penskoran. Periksa perkara yang dikekalkan apabila kedudukan petikan penting.
Pemerolehan kod dan bahan teknikal Untuk peringkat pemerolehan maklumat pembantu pengekodan, calon boleh mengandungi pelaksanaan fungsi, dokumentasi API atau penjelasan teknikal sebagai teks. Sertakan simbol, tandatangan dan konteks yang diperlukan untuk membezakan calon yang serupa. Pertanyaan seperti “Cari fungsi yang menormalkan laluan sambil mengekalkan pemisah di hujung” memberikan tingkah laku konkrit untuk dipadankan. Sertakan sebarang kekangan bahasa, platform atau versi yang berkaitan. Selepas pemeringkatan, periksa kod yang dipilih dan kebergantungannya sebelum menggunakannya sebagai konteks; skor kerelevanan tidak membuktikan bahawa pelaksanaan memenuhi setiap keperluan yang dinyatakan.
Arahan menetapkan kerelevanan Model mengekalkan keupayaan pemeringkatan semula yang mematuhi arahan, yang diperkenalkan dalam Rerank 2.5. Letakkan arahan ringkas sebelum atau selepas pertanyaan apabila niat pengguna memerlukan penjelasan. Untuk carian dokumen penyelidikan, terangkan sama ada tumpuannya pada tajuk, kaedah tertentu atau bidang aplikasi. Untuk katalog dalaman, nyatakan sama ada permintaan berkaitan pemasangan, penyelesaian masalah atau keserasian. Pastikan arahan itu selaras dengan soalan; keutamaan tambahan yang bercanggah dengan permintaan utama boleh mengubah perkara yang cuba dioptimumkan oleh pemeringkatan.
Sediakan dokumen calon dan belanjawan Input ialah senarai rentetan teks. Ekstrak teks yang boleh digunakan daripada dokumen sumber, kekalkan sempadan bahagian yang bermakna dan simpan peta rekod tersusun bersama senarai. Pengeluar membenarkan sehingga 1,000 dokumen dalam satu permintaan. Ia turut menetapkan had agregat input 600,000 token: token pertanyaan didarab bilangan dokumen, ditambah jumlah semua token dokumen. Ini berbeza daripada had konteks bagi setiap pasangan. Mengurangkan teks pertanyaan yang berlebihan boleh menjimatkan kapasiti pasangan dan keseluruhan belanjawan permintaan.
Kira token bagi model yang berkaitan, tanpa menganggap bilangan perkataan atau aksara sebagai bilangan token. Untuk calon besar, pilih petikan yang koheren atau bahagikan bahan mengikut pengepala yang berguna sambil mengekalkan maklumat sumber induk. Pemeringkatan semula paling berguna selepas carian pertama menemukan calon yang munasabah: ia tidak boleh memberi kedudukan kepada sumber yang tiada dan tidak pernah memasuki senarai.
Hasil berperingkat dan penggunaan hiliran Hasil mengandungi skor kerelevanan dan indeks yang merujuk dokumen input asal, disusun mengikut kerelevanan menurun. Pilihan top_k mengehadkan bilangan hasil berperingkat yang dikembalikan; jika tidak dinyatakan, semua calon input dikembalikan. Antara muka REST pengeluar turut membenarkan teks dokumen disertakan. Gunakan setiap indeks asal untuk mendapatkan kembali tajuk, pengecam sumber dan sebarang metadata yang diperlukan oleh aplikasi anda, kemudian paparkan item yang dipilih atau masukkan teks berkaitan ke dalam konteks bukti jawapan.
Periksa hasil teratas terhadap soalan dan pastikan identiti sumber kekal kelihatan. Kedudukan relatif yang tinggi tidak mengesahkan ketepatan fakta dokumen, dan senarai pendek yang mengandungi hanya calon lemah tetap mempunyai item pertama. Asingkan pemilihan kerelevanan daripada penentuan sama ada bukti yang dipilih mencukupi untuk menjawab pengguna.
Migrasi edisi Pengeluar menerangkan rerank-3 sebagai pengganti terus rerank-2.5, dengan semantik API yang sama dan skor yang ditentukur kepada taburan pendahulunya yang sepadan. Keserasian itu menyokong pengekalan peringkat pemerolehan maklumat dan pemetaan rekod sedia ada. Bandingkan susunan hasil yang bermakna dan sebarang ambang skor pada korpus semasa sebelum bergantung pada migrasi. Kekalkan rerank-3 dan rerank-3-lite sebagai pilihan yang berbeza: had yang dikongsi dan pematuhan arahan tidak menjadikan keutamaan kualiti serta kependaman kedua-duanya sama.
Ailoot Ultra · Pemeringkatan semula POST /v1/rerank voyageai/rerank-3
voyageai/rerank-3Pengenalan
Voyage rerank-3 ialah edisi Rerank 3 yang memfokuskan kualiti untuk penskoran kerelevanan pertanyaan-dokumen. Ia menyusun semula calon teks yang diperoleh, menyokong arahan kerelevanan bahasa semula jadi dan mengendalikan pasangan 32,000 token untuk carian dokumen panjang, kod dan pangkalan pengetahuan.
- Input yang diterima
- Teks
- Hasil
- Hasil mengikut kedudukan
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Pemeringkatan semula POST /v1/rerank
- Input
text- Output
rerank- Format output
- json
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medandocuments | Jenisarray | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had voyageai/rerank-3 | Lalai— |
Medanprovider | Jenisschema | KeperluanPilihan | Nilai & had | Lalai— |
Medanquery | Jenisstring | KeperluanDiperlukan | Nilai & had | Lalai— |
Medansession_id | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medantop_n | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 | Lalai— |
Medantrace | Jenisschema | KeperluanPilihan | Nilai & had | Lalai— |
Medanuser | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medandocuments[].text | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Medandocuments[].image | Jenisstring | KeperluanPilihan | Nilai & had | Lalai— |
Gabungan bahan input
text_rerank · Diperlukan: query, documents array with minItems1
Parameter kaedah dan kitar hayat
| 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 |
Kitar hayat: synchronous
Hantar ID model yang tepat dan simpan respons natif yang lengkap.
Pelan harga
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Kadar Ailoot
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Unit pengebilan | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Unit pengebilan— | Caj Input · Token input — / 1K token Output · Token output — / 1K token Input · Bacaan cache — / 1K token Input · Penulisan cache — / 1K token Input · Penulisan cache, 1 jam — / 1K token |
| KonfigurasiUltra | Jadual kadar— | Unit pengebilan/ 1K token | Caj Input $0.0001 / 1K token |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
Ailoot Ultra · Pemeringkatan semula
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "voyageai/rerank-3",
"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'
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 semula
json
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Setiap indeks hasil sebenar, relevance_score terhingga dan objek dokumen asal dikekalkan. Indeks mengikat tatasusunan dokumen asal. Keseluruhan JSON asal disimpan dan hanya dikembalikan selepas penyelesaian caj.
Jika respons asal perlu disemak
Simpan operasi asal dan balasan penuh/separa; jangan ulang POST.
Medan respons
| Medan | Jenis |
|---|---|
Medanmodel | Jenisstring |
Medanid | Jenisstring |
Medanprovider | Jenisstring |
Medanresults[].index | Jenisinteger |
Medanresults[].relevance_score | Jenisnumber |
Medanresults[].document.text | Jenisstring |
Medanresults[].document.image | Jenisstring |
Medanusage.search_units | Jenisinteger |
Medanusage.total_tokens | Jenisinteger |
Medanusage.cost | Jenisnumber |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, bentuk perwakilan atau nilai tidak sah | Langkah seterusnyaBetulkan medan permintaan yang dinyatakan. |
Alias
Alias model
Ailoot Ultra voyageai/rerank-3
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · VoyageAI by MongoDB: rerank-3
- Apakah input dan hasil yang tersedia?
POST /v1/rerank·voyageai/rerank-3:text→rerank- Apakah medan yang digunakan oleh permintaan?
POST /v1/rerank·voyageai/rerank-3:documents,model,provider,query,session_id,top_n,trace,user- Apakah had yang terpakai?
POST /v1/rerank·voyageai/rerank-3:top_n.minimum:1