VoyageAI by MongoDB: rerank-3
Voyage rerank-3 je edícia Rerank 3 zameraná na kvalitu pri skórovaní relevancie dopytu a dokumentu. Preusporadúva získaných textových kandidátov, podporuje pokyny k relevancii v prirodzenom jazyku a spracúva páry s 32 000 tokenmi na vyhľadávanie v dlhých dokumentoch, kóde a znalostných bázach.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Voyage rerank-3 je textový reranker navrhnutý na zvýšenie kvality získaných dôkazov. Pri dopyte a zozname kandidátskych dokumentov spoločne skúma každý pár a vracia kandidátov zoradených podľa relevancie. Embeddingy a vyhľadávanie podľa kľúčových slov môžu najprv zúžiť veľkú zbierku na zvládnuteľný užší výber; rerank-3 potom na tento výber uplatní podrobnejšie posúdenie relevancie. Jeho výstupom sú skórované dôkazy z vyhľadávania, ktoré aplikácia môže zobraziť alebo odovzdať do samostatného kroku generovania odpovede.
Rerank 3 zameraný na kvalitu Výrobca predstavuje rerank-3 ako edíciu zameranú na presnosť a rerank-3-lite ako edíciu pre vyhľadávanie citlivé na latenciu. Tretia generácia aktualizuje základnú architektúru a tréningovú zmes, s osobitnými zlepšeniami vyhľadávania v dlhých dokumentoch a zdrojovom kóde oproti zodpovedajúcim predchodcom 2.5. Výrobca ju hodnotí na technickej dokumentácii, kóde, viacjazyčnom materiáli a ďalších dokumentových oblastiach. Tieto výsledky podporujú jej vyhľadávaciu úlohu; edíciu vyberajte podľa otázok a kandidátskych dokumentov dôležitých pre vlastnú zbierku.
Dlhé dokumenty s dostatočným kontextom Dlhý kandidát môže obsahovať užitočný kontext ďaleko za úvodným odsekom. Dodajte súdržnú časť alebo dokument s názvom a príslušným okolitým materiálom, aby model mohol posúdiť vzťah skutočnej otázky k obsahu. Pri vyhľadávaní produktových pravidiel zachovajte nadpisy a výnimky okolo dôležitého úryvku. Ak viacero získaných častí pochádza z toho istého zdroja, zachovajte ich identifikátory dokumentov a častí; aplikácia potom môže ukázať pôvod vybraných dôkazov.
Kontextové okno zdieľa dopyt a každý kandidát. Aktuálna príručka výrobcu uvádza 32 000 tokenov pre tento pár vrátane dopytu s najviac 8 000 tokenmi. Dopyt s 3 000 tokenmi teda necháva najviac 29 000 tokenov na každý dokument. Vstup pripravte tak, aby sa zmestil jeho podstatný obsah, najmä keď by okno inak spotreboval dlhý úvod alebo opakovaný šablónový text. Zdokumentovaná voľba skracovania je predvolene zapnutá a pred skórovaním môže skrátiť nadmerne dlhý text dopytu alebo dokumentu. Keď záleží na umiestnení úryvku, preskúmajte, čo zostáva zachované.
Vyhľadávanie v kóde a technickom obsahu Vo fáze získavania informácií pre programovacieho asistenta môžu kandidáti obsahovať implementácie funkcií, dokumentáciu API alebo technické vysvetlenia ako text. Uveďte symboly, signatúry a kontext potrebné na odlíšenie podobných kandidátov. Dopyt ako „Nájdite funkciu, ktorá normalizuje cesty a pritom zachováva koncový oddeľovač“ dáva konkrétne správanie na vyhľadanie. Pripojte príslušné obmedzenia jazyka, platformy alebo verzie. Po zoradení preskúmajte vybraný kód a jeho závislosti pred použitím ako kontextu; skóre relevancie nedokazuje, že implementácia spĺňa každú uvedenú požiadavku.
Pokyny definujú relevanciu Model zachováva schopnosť preusporiadania podľa pokynov zavedenú v Rerank 2.5. Ak zámer používateľa potrebuje spresnenie, na začiatok alebo koniec dopytu pridajte stručný pokyn. Pri vyhľadávaní rešeršných dokumentov vysvetlite, či je dôraz na názve, konkrétnej metóde alebo oblasti použitia. Pri internom katalógu určte, či sa požiadavka týka inštalácie, riešenia problémov alebo kompatibility. Pokyn udržte v súlade s otázkou; dodatočné preferencie, ktoré odporujú hlavnej požiadavke, môžu zmeniť cieľ optimalizácie poradia.
Pripravte kandidátske dokumenty a rozpočty Vstupom je zoznam textových reťazcov. Zo zdrojových dokumentov extrahujte použiteľný text, zachovajte zmysluplné hranice častí a pri zozname udržujte usporiadanú mapu záznamov. Výrobca povoľuje najviac 1 000 dokumentov v jednej požiadavke. Uvádza aj súhrnný strop vstupu 600 000 tokenov: tokeny dopytu krát počet dokumentov plus súčet všetkých tokenov dokumentov. To sa líši od kontextového limitu jedného páru. Obmedzenie nadbytočného textu dopytu môže zachovať kapacitu páru aj celkový rozpočet požiadavky.
Tokeny počítajte pre príslušný model a nepredpokladajte, že počet slov alebo znakov je počtom tokenov. Pri veľkých kandidátoch vyberte súdržné úryvky alebo rozdeľte materiál podľa užitočných nadpisov a zachovajte informácie o nadradenom zdroji. Preusporiadanie je najužitočnejšie po tom, ako prvé vyhľadávanie už našlo vierohodných kandidátov: nemôže zoradiť chýbajúci zdroj, ktorý sa nikdy nedostal do zoznamu.
Zoradené výsledky a následné použitie Výsledok obsahuje skóre relevancie a indexy odkazujúce na pôvodné vstupné dokumenty, zoradené zostupne podľa relevancie. Voľba top_k obmedzuje počet vrátených zoradených výsledkov; inak sa vracajú všetci vstupní kandidáti. Rozhranie REST výrobcu umožňuje zahrnúť aj text dokumentu. Pomocou každého pôvodného indexu obnovte názov, identifikátor zdroja a metadáta potrebné pre aplikáciu a potom vybrané položky zobrazte alebo príslušný text vložte do kontextu dôkazov pre odpoveď.
Najvyššie výsledky preskúmajte voči otázke a identitu zdroja udržujte viditeľnú. Vysoké relatívne umiestnenie neoveruje faktickú správnosť dokumentu a užší výber obsahujúci iba slabých kandidátov bude stále mať prvú položku. Výber podľa relevancie oddeľte od rozhodovania, či vybrané dôkazy postačujú na odpoveď používateľovi.
Migrácia edície Výrobca opisuje rerank-3 ako priamo zameniteľného nástupcu rerank-2.5 s rovnakou sémantikou API a skóre kalibrovaným na rozdelenie zodpovedajúceho predchodcu. Táto kompatibilita podporuje zachovanie existujúcej fázy získavania a mapovania záznamov. Pred spoľahnutím sa na migráciu porovnajte zmysluplné poradia výsledkov a prípadný prah skóre na aktuálnom korpuse. Rerank-3 a rerank-3-lite zachovajte ako odlišné voľby: spoločné limity a dodržiavanie pokynov nerobia ich priority kvality a latencie totožnými.
Ailoot Ultra · Opätovné zoradenie výsledkov POST /v1/rerank voyageai/rerank-3
voyageai/rerank-3Úvod
Voyage rerank-3 je edícia Rerank 3 zameraná na kvalitu pri skórovaní relevancie dopytu a dokumentu. Preusporadúva získaných textových kandidátov, podporuje pokyny k relevancii v prirodzenom jazyku a spracúva páry s 32 000 tokenmi na vyhľadávanie v dlhých dokumentoch, kóde a znalostných bázach.
- Povolené vstupy
- Text
- Výsledky
- Zoradené výsledky
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Opätovné zoradenie výsledkov POST /v1/rerank
- Vstup
text- Výstup
rerank- Výstupný formát
- json
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Poledocuments | Typarray | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity voyageai/rerank-3 | Predvolené— |
Poleprovider | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polequery | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polesession_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poletop_n | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 1 | Predvolené— |
Poletrace | Typschema | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleuser | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poledocuments[].text | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poledocuments[].image | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Kombinácie vstupných podkladov
text_rerank · Povinné: query, documents array with minItems1
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, query, documents |
Parametermaterial_types | Špecifikáciatext |
Parameteroptional_controls | Špecifikáciaprovider, session_id, top_n, trace, user |
Parametermultimodal_input_binding | Špecifikácianull |
Životný cyklus: synchronous
Odošlite presné ID modelu a zachovajte celú natívnu odpoveď.
Cenník
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Sadzby Ailoot
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Účtovacia jednotka | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Účtovacia jednotka— | Poplatok Vstup · Vstupné tokeny — / 1K tokenov Výstup · Výstupné tokeny — / 1K tokenov Vstup · Čítanie cache — / 1K tokenov Vstup · Zápis do cache — / 1K tokenov Vstup · Zápis do cache, 1 hod — / 1K tokenov |
| KonfiguráciaUltra | Sadzobník— | Účtovacia jednotka/ 1K tokenov | Poplatok Vstup $0.0001 / 1K tokenov |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Opätovné zoradenie výsledkov
{
"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
Prijať a uložiť výsledky
Ailoot Ultra · Opätovné zoradenie výsledkov
json
Uchovať všetky dokončené výsledky
Uložte každú úplnú vrátenú odpoveď, súbor a časť obsahu.
Zachováva sa každý skutočný index výsledku, konečná hodnota relevance_score a pôvodný objekt dokumentu. Indexy odkazujú na pôvodné pole dokumentov. Celý pôvodný JSON sa uloží a vráti až po zúčtovaní.
Ak treba overiť pôvodnú odpoveď
Zachovajte pôvodnú operáciu a úplnú alebo čiastočnú odpoveď; POST znova neodosielajte.
Polia odpovede
| Pole | Typ |
|---|---|
Polemodel | Typstring |
Poleid | Typstring |
Poleprovider | Typstring |
Poleresults[].index | Typinteger |
Poleresults[].relevance_score | Typnumber |
Poleresults[].document.text | Typstring |
Poleresults[].document.image | Typstring |
Poleusage.search_units | Typinteger |
Poleusage.total_tokens | Typinteger |
Poleusage.cost | Typnumber |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatné povinné pole, reprezentácia alebo hodnota | Ďalší krokOpravte označené pole požiadavky. |
Aliasy
Aliasy modelov
Ailoot Ultra voyageai/rerank-3
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · VoyageAI by MongoDB: rerank-3
- Aké vstupy a výsledky sú dostupné?
POST /v1/rerank·voyageai/rerank-3:text→rerank- Aké polia používa požiadavka?
POST /v1/rerank·voyageai/rerank-3:documents,model,provider,query,session_id,top_n,trace,user- Aké limity platia?
POST /v1/rerank·voyageai/rerank-3:top_n.minimum:1