VoyageAI by MongoDB: rerank-2.5
A rerank-2.5 egy megadott szöveges jelöltkészletet rendez át a lekérdezéshez és az opcionális természetes nyelvű utasításokhoz való relevancia alapján. Többnyelvű, minőségközpontú újrarangsoroló 32 000 tokenes lekérdezés–dokumentum kontextussal és az eredeti jelöltindexekhez kötött rangsorolt pontszámokkal.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A rerank-2.5 a Voyage AI utasításkövető újrarangsorolója, amely keresési jelöltkészlet pontosítására készült. Cross-encoderként együtt vizsgálja a lekérdezést és minden dokumentumot, majd relevanciasorrendet ad vissza. A készítő kiadása annak természetes nyelvű szabályozását hangsúlyozza, mi számít relevánsnak, továbbá a többnyelvű visszakeresést és az előző rerank-2 kiadásénál hosszabb lekérdezés–dokumentum kontextust.
Add meg a modellnek az összehasonlítandó jelölteket
A bemenet egy lekérdezés és jelölt szöveges dokumentumok listája. Ezek embeddingalapú keresés vagy lexikális első szakaszbeli keresés által kiválasztott szövegrészletek lehetnek. Az újrarangsoroló a megadott szöveget értékeli, nem korpuszembeddingeket készít, ezért gyakorlati feladata az első keresés által már megtalált jelöltek pontosítása.
A lista előkészítésekor tartsd meg az eredeti jelöltsorrendet és a forrásazonosítókat. A visszaadott indexek ezekre a bemeneti pozíciókra utalnak. RAG-feladatnál azokat a szövegrészleteket add meg, amelyeket a válaszadási szakasz ténylegesen használhat, beleértve az értelmezésükhöz szükséges címet vagy feltételeket. A beküldött jelöltkészletből hiányzó releváns dokumentum nem jelenhet meg az újrarangsorolás újonnan megtalált eredményeként.
Határozd meg a kívánt relevanciafogalmat
Az utasítások a lekérdezés mögé vagy elé illeszthetők. A kiadás három hasznos szerepet ír le: dokumentum egy konkrét részének hangsúlyozását, forrástípus előnyben részesítését és a lekérdezés egyértelműsítését az alkalmazás kontextusával. Ezek módosítják a modell elé állított relevanciafeladatot.
Műszaki keresésnél szemléltető utasítás lehet: „Részesítsd előnyben a hibát és a helyreállítási viselkedést magyarázó szövegrészleteket; a bevezető áttekintések másodlagosak.” Kutatási gyűjteménynél határozd meg, hogy a cím, a módszer vagy az eredmény a legfontosabb. Kétértelmű kifejezésnél nevezd meg a keresés tárgyterületét. A kérdés és az utasítás legyen összeegyeztethető, hogy az egyik ne tág témát kérjen, miközben a másik észrevétlenül megváltoztatja a feladatot.
Ezek a preferenciák a relevanciapontozást irányítják. Ha az alkalmazásnak szigorú jogosultsági követelményei vannak – például forrásverzió, dátum vagy hozzáférési hatókör –, a megfelelő jelöltkészletet külön készítsd elő. A modell relevanciautasítása és a gyűjtemény determinisztikus korlátozása eltérő célokat szolgál.
Rangsorolt kimenet és az eredmény későbbi felhasználása
Az eredmények csökkenő relevanciasorrendben érkeznek, és lebegőpontos relevanciapontszámot, valamint a jelölt eredeti bemeneti indexét tartalmazzák. A top-k lehetőség kiválasztja, hány vezető eredmény térjen vissza; nélküle a gyártó specifikációja minden beküldött jelölthöz visszaad eredményt. Az opcionális return-documents beállítás mellékeli a megfelelő forrásszöveget; egyébként a válasz indexeket és pontszámokat tartalmaz.
A sorrendet használd megjelenítendő vagy egy későbbi válaszadási szakasznak átadandó szövegrészletek kiválasztására, forrásazonosságuk megőrzésével. A rangsor értékelésekor vizsgáld meg a tényleges szöveget: a pontszám a beküldött lekérdezéshez való relevancia mértéke, nem generált válasz vagy annak igazolása, hogy a dokumentum állításai helyesek. Így a modell műszaki, jogi, pénzügyi, orvosi, társalgási és többnyelvű keresési anyagok pontosítására használható anélkül, hogy a rangsort szakterületi következtetéssé alakítaná.
Kontextus, teljes tokenkeret és csonkolás
A dokumentált lekérdezési korlát 8 000 token, a lekérdezésbe helyezett utasításokat is beleértve. A lekérdezésnek és bármely egyetlen jelölt dokumentumnak 32 000 tokenen belül kell elférnie, a dokumentumlista pedig legfeljebb 1 000 tételt tartalmazhat. A teljes keret 600 000 token, amely a lekérdezés tokenjeinek dokumentumszámmal vett szorzatából és az összes dokumentum tokenjeiből áll. A hosszú utasítás ezért ismételten beleszámít a jelöltpároknál.
A kimeneti top-k darabszám nem változtatja meg a bemeneti tokenszámításban szereplő jelöltek számát. Az alapértelmezett csonkolás a kontextuskorlát betartására rövidíti a túl hosszú lekérdezéseket vagy dokumentumokat; kikapcsolásakor a túl hosszú lekérdezés vagy pár hibát ad. Tudatosan készíts elő választ hordozó szövegrészleteket, és tartsd meg a releváns feltételt a modell által látott szövegen belül. Értékeld a pontosított sorrendet reprezentatív kérdéseken és utasításokon, majd add tovább a kiválasztott eredeti szövegrészleteket a következő szakasznak.
Ailoot Ultra · Újrarangsorolás POST /v1/rerank voyageai/rerank-2.5
voyageai/rerank-2.5Kezdő lépések
A rerank-2.5 egy megadott szöveges jelöltkészletet rendez át a lekérdezéshez és az opcionális természetes nyelvű utasításokhoz való relevancia alapján. Többnyelvű, minőségközpontú újrarangsoroló 32 000 tokenes lekérdezés–dokumentum kontextussal és az eredeti jelöltindexekhez kötött rangsorolt pontszámokkal.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Relevancia szerint rendezett eredmények
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Újrarangsorolás POST /v1/rerank
- Bemenet
text- Kimenet
rerank- Kimeneti formátum
- json
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Meződocuments | Típusarray | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok voyageai/rerank-2.5 | Alapértelmezett— |
Mezőprovider | Típusschema | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőquery | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezősession_id | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőtop_n | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 1 | Alapértelmezett— |
Mezőtrace | Típusschema | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőuser | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Meződocuments[].text | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Meződocuments[].image | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Bemeneti anyagok kombinációi
text_rerank · Kötelező: query, documents array with minItems1
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, query, documents |
Paramétermaterial_types | Szerződéstext |
Paraméteroptional_controls | Szerződésprovider, session_id, top_n, trace, user |
Paramétermultimodal_input_binding | Szerződésnull |
Életciklus: synchronous
Küldje el a pontos modellazonosítót, és őrizze meg a teljes natív választ.
Díjcsomagok
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Ailoot-díjak
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Elszámolási egység | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Elszámolási egység— | Díj Bemenet · Bemeneti tokenek — / 1K token Kimenet · Kimeneti tokenek — / 1K token Bemenet · Gyorsítótár olvasása — / 1K token Bemenet · Írás a gyorsítótárba — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra — / 1K token |
| BeállításUltra | Díjtáblázat— | Elszámolási egység/ 1K token | Díj Bemenet $0.0001 / 1K token |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot Ultra · Újrarangsorolás
{
"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
Eredmények fogadása és mentése
Ailoot Ultra · Újrarangsorolás
json
Őrizzen meg minden elkészült eredményt
Őrizzen meg minden teljes visszaadott választ, fájlt és tartalomrészt.
Minden tényleges eredményindex, véges relevance_score és eredeti dokumentumobjektum megmarad. Az indexek az eredeti dokumentumtömbhöz kapcsolódnak. A teljes eredeti JSON tárolásra kerül, és csak az elszámolás után adható vissza.
Ha az eredeti választ ellenőrizni kell
Őrizze meg az eredeti műveletet és a teljes vagy részleges választ; ne ismételje meg a POST kérést.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőmodel | Típusstring |
Mezőid | Típusstring |
Mezőprovider | Típusstring |
Mezőresults[].index | Típusinteger |
Mezőresults[].relevance_score | Típusnumber |
Mezőresults[].document.text | Típusstring |
Mezőresults[].document.image | Típusstring |
Mezőusage.search_units | Típusinteger |
Mezőusage.total_tokens | Típusinteger |
Mezőusage.cost | Típusnumber |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mező, megadási forma vagy érték | Következő lépésJavítsa a kérés megjelölt mezőjét. |
Álnevek
Modell álnevei
Ailoot Ultra voyageai/rerank-2.5
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · VoyageAI by MongoDB: rerank-2.5
- Milyen bemenetek és eredmények érhetők el?
POST /v1/rerank·voyageai/rerank-2.5:text→rerank- Mely mezőket használja a kérés?
POST /v1/rerank·voyageai/rerank-2.5:documents,model,provider,query,session_id,top_n,trace,user- Milyen korlátok érvényesek?
POST /v1/rerank·voyageai/rerank-2.5:top_n.minimum:1