VoyageAI by MongoDB: rerank-2.5
rerank-2.5 mění pořadí dodané sady textových kandidátů podle relevance k dotazu a volitelným pokynům v přirozeném jazyce. Jde o vícejazyčný model pro řazení podle relevance zaměřený na kvalitu s kontextem 32 000 tokenů pro dvojici dotaz–dokument a seřazenými skóre navázanými na původní indexy kandidátů.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
rerank-2.5 je model společnosti Voyage AI pro úpravu pořadí podle pokynů, navržený ke zpřesnění sady vyhledaných kandidátů. Společně zkoumá dotaz a každý dokument jako cross-encoder a poté vrací pořadí podle relevance. Vydání výrobce zdůrazňuje řízení toho, co se považuje za relevantní, přirozeným jazykem, vícejazyčné vyhledávání a delší kontext dvojice dotaz–dokument než u předchozí edice rerank-2.
Dodejte modelu kandidáty k porovnání
Vstupem je dotaz a seznam kandidátních textových dokumentů. Mohou to být pasáže vybrané embeddingovým vyhledáváním nebo lexikálním vyhledáváním první fáze. Model pro řazení podle relevance vyhodnocuje dodaný text místo vytváření embeddingů korpusu, takže jeho praktickou úlohou je zpřesnit kandidáty již nalezené počátečním vyhledáváním.
Při přípravě seznamu zachovejte původní pořadí kandidátů a identifikátory zdrojů. Vrácené indexy odkazují na tyto vstupní pozice. U úlohy RAG dodejte pasáže, které by fáze odpovědi mohla skutečně použít, včetně názvu nebo podmínek potřebných k jejich výkladu. Relevantní dokument, který v odeslané sadě kandidátů chybí, se nemůže objevit jako nově nalezený výsledek přehodnocení pořadí.
Určete zamýšlené pojetí relevance
Pokyny lze připojit za dotaz nebo před něj. Vydání popisuje tři užitečné role: zdůraznit konkrétní část dokumentu, upřednostnit typ zdroje a odstranit nejednoznačnost dotazu kontextem aplikace. Ty mění úlohu relevance předloženou modelu.
Pro technické vyhledávání je ilustračním pokynem „Upřednostněte pasáže, které vysvětlují chování při selhání a obnově; úvodní přehledy jsou vedlejší.“ U rešeršní sbírky určete, zda nejvíce záleží na názvu, metodě nebo výsledku. U nejednoznačného výrazu uveďte tematickou oblast vyhledávání. Otázku a pokyn udržujte slučitelné, aby jeden nežádal široké téma, zatímco druhý skrytě mění úlohu.
Tyto preference usměrňují hodnocení relevance. Pokud má aplikace přísné požadavky na způsobilost — například verzi zdroje, datum nebo rozsah přístupu — připravte způsobilou sadu kandidátů samostatně. Pokyn modelu k relevanci a deterministické omezení sbírky slouží různým účelům.
Seřazený výstup a pozdější použití výsledků
Výsledky jsou seřazeny sestupně podle relevance a obsahují skóre relevance ve formátu s plovoucí řádovou čárkou a původní vstupní index kandidáta. Volba top-k vybírá počet předních výsledků k vrácení; bez ní specifikace výrobce vrací výsledky pro všechny odeslané kandidáty. Volitelné nastavení return-documents zahrnuje odpovídající zdrojový text; jinak odpověď obsahuje indexy a skóre.
Pořadí použijte k výběru pasáží pro zobrazení nebo pozdější fázi odpovědi a zachovejte jejich zdrojovou identitu. Při hodnocení pořadí prozkoumejte skutečný text: skóre je mírou relevance k odeslanému dotazu, nikoli vygenerovanou odpovědí nebo ověřením správnosti tvrzení dokumentu. Model je tak užitečný pro zpřesňování technických, právních, finančních, zdravotnických, konverzačních i vícejazyčných vyhledávaných podkladů, aniž by se pořadí měnilo v odborný závěr.
Kontext, celkový rozpočet tokenů a zkracování
Dokumentovaný limit dotazu je 8 000 tokenů včetně pokynů vložených do dotazu. Dotaz a kterýkoli jednotlivý kandidátní dokument se musí vejít do 32 000 tokenů a seznam dokumentů může obsahovat nejvýše 1 000 položek. Celkový limit je 600 000 tokenů, počítaný jako tokeny dotazu násobené počtem dokumentů plus všechny tokeny dokumentů. Dlouhý pokyn se proto započítává opakovaně pro každou dvojici dotaz–dokument.
Počet výstupních výsledků top-k nemění počet kandidátů v tomto výpočtu vstupních tokenů. Výchozí zkracování zkrátí příliš dlouhé dotazy nebo dokumenty tak, aby splnily limit kontextu; jeho vypnutí způsobí u příliš dlouhého dotazu nebo dvojice chybu. Pasáže obsahující odpověď připravujte záměrně a příslušnou podmínku zachovejte v textu, který model uvidí. Zpřesněné pořadí posuďte na reprezentativních otázkách a pokynech a poté vybrané původní pasáže předejte do další fáze.
Ailoot Ultra · Přeřazení podle relevance POST /v1/rerank voyageai/rerank-2.5
voyageai/rerank-2.5Úvod
rerank-2.5 mění pořadí dodané sady textových kandidátů podle relevance k dotazu a volitelným pokynům v přirozeném jazyce. Jde o vícejazyčný model pro řazení podle relevance zaměřený na kvalitu s kontextem 32 000 tokenů pro dvojici dotaz–dokument a seřazenými skóre navázanými na původní indexy kandidátů.
- Přijímané vstupy
- Text
- Výsledky
- Výsledky seřazené podle relevance
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Přeřazení podle relevance POST /v1/rerank
- Vstup
text- Výstup
rerank- Výstupní formát
- json
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Poledocuments | Typarray | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity voyageai/rerank-2.5 | Výchozí— |
Poleprovider | Typschema | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polequery | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polesession_id | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poletop_n | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 1 | Výchozí— |
Poletrace | Typschema | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleuser | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poledocuments[].text | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poledocuments[].image | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Kombinace vstupních materiálů
text_rerank · Povinné: query, documents array with minItems1
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, query, documents |
Parametrmaterial_types | Kontrakttext |
Parametroptional_controls | Kontraktprovider, session_id, top_n, trace, user |
Parametrmultimodal_input_binding | Kontraktnull |
Životní cyklus: synchronous
Odešlete přesné ID modelu a uchovejte celou nativní odpověď.
Tarify
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Sazby Ailoot
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Účtovací jednotka | Poplatek |
|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Účtovací jednotka— | Poplatek Vstup · Vstupní tokeny — / 1K tokenů Výstup · Výstupní tokeny — / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
| KonfiguraceUltra | Tabulka sazeb— | Účtovací jednotka/ 1K tokenů | Poplatek Vstup $0.0001 / 1K tokenů |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
Ailoot Ultra · Přeřazení podle relevance
{
"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
Přijímání a ukládání výsledků
Ailoot Ultra · Přeřazení podle relevance
json
Uchovejte všechny dokončené výsledky
Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.
Zachovává se každý skutečný index výsledku, konečná hodnota relevance_score a původní objekt dokumentu. Indexy odkazují na původní pole dokumentů. Celý původní JSON se uloží a vrátí až po vyúčtování.
Pokud je nutné ověřit původní odpověď
Zachovejte původní operaci a úplnou či částečnou odpověď; požadavek POST neopakujte.
Pole odpovědi
| 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 další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatné povinné pole, způsob zadání nebo hodnota | Další krokOpravte označené pole požadavku. |
Aliasy
Aliasy modelu
Ailoot Ultra voyageai/rerank-2.5
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · VoyageAI by MongoDB: rerank-2.5
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/rerank·voyageai/rerank-2.5:text→rerank- Jaká pole požadavek používá?
POST /v1/rerank·voyageai/rerank-2.5:documents,model,provider,query,session_id,top_n,trace,user- Jaké limity platí?
POST /v1/rerank·voyageai/rerank-2.5:top_n.minimum:1