VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite vertina ir perrikiuoja tekstinius dokumentus kandidatus pagal užklausą, akcentuodamas greitai reaguojančią paiešką. Jis palaiko aktualumo nurodymus ir 32 000 žetonų užklausos bei dokumento langą, todėl tinka paieškos ir RAG darbo eigoms po vektorinės ar raktažodžių paieškos.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Voyage rerank-3-lite – tai į mažą delsą orientuotas Voyage Rerank 3 serijos leidimas. Jis priima tekstinę užklausą ir dokumentus kandidatus, kartu įvertina kiekvieną užklausos bei dokumento porą ir grąžina aktualumo balus reitingavimo tvarka. Jis skirtas antrajam paieškos etapui: įterpinių ar raktažodžių paieška randa kandidatus, o Lite patikslina jų eilę. Rezultatas – reitingas, naudojamas paieškoje ar paieška papildyto generavimo darbo eigoje.
Kas keičiasi Rerank 3 Lite Gamintojas pabrėžia geresnę ilgų dokumentų ir kodo paiešką, palyginti su rerank-2.5-lite. Abu Rerank 3 leidimai išlaiko nurodymų vykdymą ir tą pačią 32K konteksto klasę, o Lite skirtas delsai jautrioms programoms. Dėl to jis yra praktiškas kandidatas interaktyviai žinių bazės paieškai, pagalbos dokumentų paieškai ir kodo paieškai, kai naudotojams aktualių rezultatų reikia greitai. Rinkitės pagal tikrojo rinkinio kokybės ir atsako laiko reikalavimus, užuot manę, kad mažesnis leidimas reiškia mažesnį konteksto langą.
Aktualumą nukreipkite užklausa Prie užklausos galima pridėti natūralios kalbos nurodymus, paaiškinančius, kas laikoma aktualiu. Klausimas ir aktualumo nuostata turi būti glausti bei nuoseklūs. Programinės įrangos pagalbos paieškai naudokite: „Raskite įrenginio atkūrimo procedūrą; pirmenybę teikite nurodytai aparatinės įrangos revizijai skirtiems nurodymams.“ Dviprasmiškam produkto pavadinimui pridėkite produkto kategoriją, kad nedominuotų nesusijusios reikšmės. Užklausos nuostata nukreipia semantinį vertinimą; prieš sudarydami kandidatų sąrašą, aiškiais rinkinio metaduomenimis pasirinkite tinkamą produktą, dokumento versiją ar prieigos apimtį.
Parenkite trumpą tekstinių kandidatų sąrašą Įvesties dokumentai yra eilutės. Iš šaltinio medžiagos išgaukite įskaitomą tekstą ir išsaugokite naudingus pavadinimus, antraštes, identifikatorius bei aplinkinį kontekstą. Išlaikykite pastovią kiekvienos įvesties pozicijos sąsają su pradiniu įrašu. Trikčių šalinimo straipsniui įtraukite požymį ir aktualią procedūrą, o ne vien atskirtą sakinį. Šaltinio kodo paieškai įtraukite funkciją ir gretimą informaciją, reikalingą jai atskirti nuo panašiai pavadintų funkcijų. Pašalinkite pasikartojančią navigaciją ar šabloninį tekstą, kai jie išstumia naudingą ištrauką.
Perrikiavimo modelis gali perrikiuoti tik gautus dokumentus. Jei pirmoji paieška niekada neranda aktualaus straipsnio, šis etapas negali atkurti trūkstamo kandidato. Kai rezultatas atrodo neteisingas, tikrinkite ir trumpąjį sąrašą, ir galutinę eilę. Kai ilgas dokumentas apima daug temų, atskirkite vientisas dalis ir išsaugokite jų nuorodas į pagrindinį dokumentą, kad aktualią dalį būtų galima pasirinkti neprarandant šaltinio.
Konteksto ir užklausos ribos Dabartiniame gamintojo vadove nurodyta didžiausia 8 000 žetonų užklausa ir bendras 32 000 žetonų limitas užklausai bei kiekvienam atskiram dokumentui. Leidžiama iki 1 000 dokumentų kandidatų ir bendras 600 000 žetonų užklausos biudžetas, skaičiuojamas užklausos žetonus padauginus iš dokumentų skaičiaus ir pridėjus visų dokumentų žetonus. Todėl ilga užklausa užima vietą kiekvienoje poroje ir pakartotinai prisideda prie bendro biudžeto. Pateiktą tekstą skaičiuokite tinkamu modelio žetonizatoriumi, užuot simbolius, žodžius ir žetonus laikę sukeičiamais vienetais.
Pavyzdžiui, 500 žetonų užklausa su 100 dokumentų po 4 000 žetonų pagal šią formulę sudaro 450 000 įvesties žetonų. Tai iliustruoja biudžeto skaičiavimą, o ne rekomenduojamą trumpojo sąrašo dydį ar išmatuotą spartą. Dokumentuota nukirpimo parinktis įjungta pagal numatytuosius nustatymus; per didelis tekstas gali būti sutrumpintas prieš vertinimą. Svarbias dalis parenkite apgalvotai, kad nukirpimas nepašalintų būtent tos ištraukos, kurią reikia atitikti.
Perskaitykite ir naudokite rezultatą Rezultatai rikiuojami nuo didžiausio aktualumo balo žemyn. Kiekvienas rezultatas nurodo pradinę dokumento įvesties poziciją, todėl programa gali pridėti savo pavadinimą, įrašo identifikatorių ir šaltinį. Nustatymas top_k valdo grąžinamų reitinguotų kandidatų skaičių; jo nenurodžius, grąžinami visi kandidatai. Gamintojo REST sąsaja taip pat gali grąžinti dokumento tekstą. Rodydami paieškos puslapį ar perduodami įrodymus atsakymo generavimo etapui, su pasirinktais rezultatais išsaugokite pradinius identifikatorius.
Aktualumo balas išreiškia, kaip gerai kandidatas atitinka užklausą; jis nepagrindžia kandidato teiginių teisingumo. Aukščiausiai įvertintus elementus palyginkite su tikruoju naudotojo klausimu, įskaitant išimtis ir dokumentų versijų skirtumus. Jei visi kandidatai neaktualūs, aukščiausiai reitinguotas elementas vis tiek egzistuoja. Naudodami reprezentatyvias rinkinio užklausas nuspręskite, kaip programa turi elgtis tokiu atveju.
Atnaujinimas ir leidimo pasirinkimas Gamintojas rerank-3-lite apibūdina kaip rerank-2.5-lite atnaujinimą su nepakitusia API semantika ir balais, sukalibruotais pagal atitinkamo pirmtako pasiskirstymą. Išsaugokite esamą įrašų susiejimą bei paieškos etapą, tada prasmingomis užklausomis palyginkite gautą eilę, prieš pasikliaudami nustatytu balo slenksčiu. Lite naudokite paieškai, kur svarbus atsako laikas; į kokybę orientuotą rerank-3 leidimą naudokite palyginimui, kai svarbesnis prioritetas yra sudėtingų kandidatų aktualumas.
Ailoot Ultra · Perrikiavimas POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-litePradžia
Voyage rerank-3-lite vertina ir perrikiuoja tekstinius dokumentus kandidatus pagal užklausą, akcentuodamas greitai reaguojančią paiešką. Jis palaiko aktualumo nurodymus ir 32 000 žetonų užklausos bei dokumento langą, todėl tinka paieškos ir RAG darbo eigoms po vektorinės ar raktažodžių paieškos.
- Leidžiamos įvestys
- Tekstas
- Rezultatai
- Surikiuoti rezultatai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Perrikiavimas POST /v1/rerank
- Įvestis
text- Išvestis
rerank- Išvesties formatas
- json
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasdocuments | Tipasarray | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos voyageai/rerank-3-lite | Numatyta— |
Laukasprovider | Tipasschema | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasquery | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukassession_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukastop_n | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 1 | Numatyta— |
Laukastrace | Tipasschema | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasuser | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasdocuments[].text | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasdocuments[].image | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Įvesties medžiagos deriniai
text_rerank · Privaloma: query, documents array with minItems1
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, query, documents |
Parametrasmaterial_types | Specifikacijatext |
Parametrasoptional_controls | Specifikacijaprovider, session_id, top_n, trace, user |
Parametrasmultimodal_input_binding | Specifikacijanull |
Gyvavimo ciklas: synchronous
Siųskite tikslų modelio ID ir išsaugokite visą pirminį atsakymą.
Planai
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Ailoot įkainiai
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Apskaitos vienetas | Mokestis |
|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Apskaitos vienetas— | Mokestis Įvestis · Įvesties tokenai — / 1K tokenų Išvestis · Išvesties tokenai — / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
| KonfigūracijaUltra | Įkainių lentelė— | Apskaitos vienetas/ 1K tokenų | Mokestis Įvestis $0.00004 / 1K tokenų |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Užklausų pavyzdžiai
Ailoot Ultra · Perrikiavimas
{
"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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Perrikiavimas
json
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną visą grąžintą atsakymą, failą ir turinio dalį.
Išsaugomas kiekvienas tikras rezultato indeksas, baigtinė relevance_score reikšmė ir pradinis dokumento objektas. Indeksai susieja rezultatus su pradiniu dokumentų masyvu. Visas pradinis JSON saugomas ir grąžinamas tik atsiskaičius.
Jei reikia patikrinti pradinį atsakymą
Išsaugokite pradinę operaciją ir visą arba dalinį atsakymą; nekartokite POST.
Atsakymo laukai
| Laukas | Tipas |
|---|---|
Laukasmodel | Tipasstring |
Laukasid | Tipasstring |
Laukasprovider | Tipasstring |
Laukasresults[].index | Tipasinteger |
Laukasresults[].relevance_score | Tipasnumber |
Laukasresults[].document.text | Tipasstring |
Laukasresults[].document.image | Tipasstring |
Laukasusage.search_units | Tipasinteger |
Laukasusage.total_tokens | Tipasinteger |
Laukasusage.cost | Tipasnumber |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNegaliojantis privalomas laukas, pateikimo forma arba reikšmė | Kitas žingsnisPataisykite nurodytą užklausos lauką. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra voyageai/rerank-3-lite
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Kokios įvestys ir rezultatai prieinami?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Kokius laukus naudoja užklausa?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Kokie apribojimai taikomi?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1