VoyageAI by MongoDB: rerank-3-lite
A Voyage rerank-3-lite egy lekérdezéshez pontozza és újrarendezi a jelölt szöveges dokumentumokat, a gyors reakciójú keresésre összpontosítva. Támogatja a relevanciautasításokat és a 32 000 tokenes lekérdezés–dokumentum ablakot, ezért vektoros vagy kulcsszavas visszakeresés után hasznos keresési és RAG-munkafolyamatokban.
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 Voyage rerank-3-lite a Voyage Rerank 3 sorozatának késleltetésre összpontosító kiadása. Szöveges lekérdezést és jelölt dokumentumokat fogad, együtt értékel minden lekérdezés–dokumentum párt, és rangsorolt sorrendben ad vissza relevanciapontszámokat. A keresés második szakaszát szolgálja: egy embeddingalapú vagy kulcsszavas visszakereső megtalálja a jelölteket, majd a Lite pontosítja a sorrendjüket. Az eredmény keresésben vagy visszakereséssel kiegészített generálási munkafolyamatban használható rangsor.
Mi változik a Rerank 3 Lite kiadásban A készítő a rerank-2.5-lite modellhez képest jobb visszakeresést hangsúlyoz hosszú dokumentumokon és kódon. Mindkét Rerank 3 kiadás megtartja az utasításkövetést és ugyanazt a 32K kontextusosztályt, míg a Lite késleltetésérzékeny alkalmazásokhoz készült. Így gyakorlati jelölt interaktív tudásbázis-kereséshez, támogatási dokumentumok visszakereséséhez és kódkereséshez, amikor a felhasználóknak gyorsan kellenek releváns találatok. A tényleges gyűjtemény minőségi és válaszidő-követelményei alapján válaszd, ne abból indulj ki, hogy a kisebb kiadás kisebb kontextusablakot jelent.
Irányítsd a relevanciát a lekérdezéssel A lekérdezést természetes nyelvű utasítások kísérhetik, amelyek elmagyarázzák, mi számít relevánsnak. A kérdés és a relevanciapreferencia legyen tömör és egymással összhangban. Szoftvertámogatási keresésnél használhatod ezt: „Keresd meg az eszköz visszaállításának eljárását; részesítsd előnyben a megadott hardverrevízióhoz tartozó utasításokat.” Kétértelmű terméknévnél add meg a termékkategóriát, hogy az oda nem tartozó jelentések ne kerüljenek túlsúlyba. A lekérdezés preferenciája a szemantikai pontozást irányítja; a jelöltlista összeállítása előtt kifejezett gyűjteménymetaadatokkal válaszd ki a helyes terméket, dokumentumverziót vagy hozzáférési hatókört.
Készíts rövid listát a szöveges jelöltekből A bemeneti dokumentumok karakterláncok. Nyerj ki olvasható szöveget a forrásanyagból, és őrizd meg a hasznos címeket, címsorokat, azonosítókat és környező kontextust. Tarts stabil megfeleltetést minden bemeneti pozíció és az eredeti rekord között. Hibaelhárítási cikknél a tünetet és a releváns eljárást is add meg, ne csak egy kiragadott mondatot. Forráskódkeresésnél mellékeld a függvényt és a közeli információt, amely megkülönbözteti a hasonló nevű függvényektől. Távolítsd el az ismétlődő navigációt vagy sablonszöveget, ha kiszorítja a hasznos szövegrészletet.
Az újrarangsoroló csak a megkapott dokumentumokat tudja átrendezni. Ha az első keresés nem találja meg a releváns cikket, ez a szakasz nem tudja visszahozni a hiányzó jelöltet. Ha egy eredmény hibásnak tűnik, a rövid listát és a végső sorrendet is vizsgáld meg. Ha egy hosszú dokumentum sok témát fed le, bontsd összefüggő szakaszokra, és őrizd meg az eredeti dokumentumra mutató hivatkozásaikat, hogy a releváns szakasz a forrás elvesztése nélkül kiválasztható legyen.
Kontextus és kérési korlátok A készítő jelenlegi útmutatója legfeljebb 8 000 tokent ad meg a lekérdezéshez, és összesen legfeljebb 32 000 tokent a lekérdezés és minden egyes dokumentum együtteséhez. Legfeljebb 1 000 jelölt dokumentumot és 600 000 token teljes kérési keretet enged, amelyet a lekérdezés tokenjeinek dokumentumszámmal vett szorzata és az összes dokumentum tokenjeinek összege ad. A hosszú lekérdezés ezért minden párban helyet fogyaszt, és ismételten beleszámít az összesített keretbe. A beküldött szöveget a megfelelő modelltokenizálóval számold, ne kezeld felcserélhetőként a karaktereket, szavakat és tokeneket.
Például egy 500 tokenes lekérdezés 100, egyenként 4 000 tokenes dokumentummal e képlet szerint 450 000 bemeneti tokent jelent. Ez a kerettervezést szemlélteti, nem ajánlott listaméret vagy mért sebességi eredmény. A dokumentált csonkolási lehetőség alapértelmezés szerint engedélyezett; a túlméretes szöveg pontozás előtt rövidülhet. A fontos szakaszokat tudatosan készítsd elő, hogy a csonkolás ne éppen az egyeztetni kívánt szövegrészletet távolítsa el.
Olvasd és használd az eredményt Az eredmények a legmagasabb relevanciapontszámtól lefelé rendezve érkeznek. Minden eredmény megadja a dokumentum eredeti bemeneti pozícióját, így az alkalmazás hozzárendelheti a saját címét, rekordazonosítóját és forrását. A top_k beállítás szabályozza, hány rangsorolt jelöltet kap vissza; nélküle minden jelölt visszatér. A készítő REST-felülete a dokumentumszöveget is visszaadhatja. Az eredeti azonosítókat őrizd meg a kiválasztott eredmények mellett keresőoldal megjelenítésekor vagy bizonyíték válaszgenerálási lépésnek történő átadásakor.
A relevanciapontszám azt fejezi ki, mennyire illik egy jelölt a lekérdezéshez; nem igazolja, hogy a jelölt állításai helyesek. A legelőrébb sorolt tételeket vesd össze a felhasználó tényleges kérdésével, a kizárásokat és dokumentumverzió-eltéréseket is beleértve. Ha minden jelölt irreleváns, akkor is lesz legelőrébb sorolt tétel. A gyűjtemény reprezentatív lekérdezéseivel döntsd el, hogyan kezelje ezt az alkalmazás.
Frissítés és kiadásválasztás A készítő a rerank-3-lite modellt a rerank-2.5-lite frissítéseként írja le, változatlan API-szemantikával és az adott előd eloszlásához kalibrált pontszámokkal. Őrizd meg a meglévő rekordmegfeleltetést és visszakeresési szakaszt, majd érdemi lekérdezéseken hasonlítsd össze a kapott sorrendet, mielőtt egy korábban beállított pontszámküszöbre hagyatkozol. A Lite kiadást olyan keresési élményhez használd, ahol a válaszidő fontos; a minőségre összpontosító rerank-3 kiadást pedig összehasonlításként, ha a nehéz jelöltek relevanciája az erősebb prioritás.
Ailoot Ultra · Újrarangsorolás POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteKezdő lépések
A Voyage rerank-3-lite egy lekérdezéshez pontozza és újrarendezi a jelölt szöveges dokumentumokat, a gyors reakciójú keresésre összpontosítva. Támogatja a relevanciautasításokat és a 32 000 tokenes lekérdezés–dokumentum ablakot, ezért vektoros vagy kulcsszavas visszakeresés után hasznos keresési és RAG-munkafolyamatokban.
- 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-3-lite | 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.00004 / 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-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
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-3-lite
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Milyen bemenetek és eredmények érhetők el?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Mely mezőket használja a kérés?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Milyen korlátok érvényesek?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1