VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite hodnotí kandidátní textové dokumenty pro dotaz a mění jejich pořadí se zaměřením na rychlou odezvu vyhledávání. Podporuje pokyny k relevanci a okno 32 000 tokenů pro dvojici dotaz–dokument, takže je užitečný po vektorovém vyhledávání nebo vyhledávání podle klíčových slov při hledání a v postupech RAG.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Voyage rerank-3-lite je edice řady Rerank 3 společnosti Voyage zaměřená na nízkou latenci. Přijímá textový dotaz a kandidátní dokumenty, vyhodnocuje každou dvojici dotaz–dokument společně a vrací skóre relevance v seřazeném pořadí. Slouží jako druhá fáze vyhledávání: vyhledávač založený na embeddingu nebo klíčových slovech najde kandidáty a Lite poté zpřesní jejich pořadí. Výsledkem je pořadí použitelné při vyhledávání nebo v postupu generování rozšířeného o vyhledávání.
Co se mění v Rerank 3 Lite Výrobce zdůrazňuje lepší vyhledávání v dlouhých dokumentech a kódu oproti rerank-2.5-lite. Obě edice Rerank 3 zachovávají dodržování pokynů a stejnou třídu kontextu 32K, zatímco Lite je navržen pro aplikace citlivé na latenci. Je tak praktickým kandidátem pro interaktivní vyhledávání ve znalostní bázi, hledání dokumentace podpory a kódu, když uživatelé potřebují relevantní výsledky rychle. Vybírejte jej podle požadavků na kvalitu a odezvu skutečné sbírky místo předpokladu, že menší edice znamená menší kontextové okno.
Usměrněte relevanci dotazem Dotaz mohou doprovázet pokyny v přirozeném jazyce vysvětlující, co se považuje za relevantní. Otázku i preferenci relevance formulujte stručně a vzájemně konzistentně. Pro vyhledávání v softwarové podpoře použijte „Najděte postup resetování zařízení; upřednostněte pokyny pro uvedenou revizi hardwaru.“ U nejednoznačného názvu produktu přidejte kategorii produktu, aby nepřevládly nesouvisející významy. Preference v dotazu usměrňuje sémantické hodnocení; před sestavením seznamu kandidátů vyberte správný produkt, verzi dokumentu nebo rozsah přístupu pomocí výslovných metadat sbírky.
Připravte užší seznam textových kandidátů Vstupní dokumenty jsou řetězce. Ze zdrojových podkladů vytěžte čitelný text a zachovejte užitečné názvy, nadpisy, identifikátory a okolní kontext. Udržujte stabilní mapování každé vstupní pozice na původní záznam. U článku pro řešení problémů přiložte příznak a příslušný postup, nejen vytrženou větu. Při vyhledávání ve zdrojovém kódu přiložte funkci a okolní informace potřebné k odlišení od podobně pojmenovaných funkcí. Opakující se navigaci nebo šablonovitý text odstraňte, pokud vytlačují užitečnou pasáž.
Model pro řazení podle relevance může změnit pořadí pouze dokumentů, které obdrží. Pokud první vyhledávání relevantní článek vůbec nenajde, tato fáze chybějícího kandidáta nezíská zpět. Zdá-li se výsledek chybný, prozkoumejte užší seznam i konečné pořadí. Pokud dlouhý dokument pokrývá mnoho témat, oddělte soudržné části a zachovejte odkazy na jejich nadřazený dokument, aby šlo vybrat relevantní část bez ztráty zdroje.
Limity kontextu a požadavku Aktuální průvodce výrobce uvádí maximum dotazu 8 000 tokenů a společné maximum 32 000 tokenů pro dotaz a každý jednotlivý dokument. Umožňuje až 1 000 kandidátních dokumentů a celkový rozpočet požadavku 600 000 tokenů, počítaný jako tokeny dotazu násobené počtem dokumentů plus všechny tokeny dokumentů. Dlouhý dotaz tedy spotřebovává prostor v každé dvojici a opakovaně přispívá k souhrnnému rozpočtu. Odesílaný text počítejte příslušným tokenizérem modelu místo považování znaků, slov a tokenů za zaměnitelné.
Například dotaz o 500 tokenech se 100 dokumenty po 4 000 tokenech představuje podle tohoto vzorce 450 000 vstupních tokenů. To ilustruje plánování rozpočtu, nikoli doporučenou velikost užšího seznamu nebo změřenou rychlost. Dokumentovaná volba zkracování je ve výchozím stavu zapnutá; příliš rozsáhlý text se může před hodnocením zkrátit. Důležité části připravte záměrně, aby zkrácení neodstranilo právě pasáž, kterou potřebujete přiřadit.
Čtení a použití výsledku Výsledky jsou seřazeny sestupně od nejvyššího skóre relevance. Každý výsledek označuje původní vstupní pozici dokumentu, což aplikaci umožňuje připojit vlastní název, identifikátor záznamu a zdroj. Nastavení top_k řídí počet vrácených seřazených kandidátů; bez něj se vracejí všichni kandidáti. Rozhraní REST výrobce může vracet také text dokumentu. Při zobrazení stránky vyhledávání nebo předávání podkladů do generování odpovědi zachovejte u vybraných výsledků původní identifikátory.
Skóre relevance vyjadřuje, jak dobře kandidát odpovídá dotazu; nedokládá správnost jeho tvrzení. Nejvýše umístěné položky porovnejte se skutečnou otázkou uživatele, včetně vyloučení a rozdílů mezi verzemi dokumentů. Pokud jsou všichni kandidáti nerelevantní, nejvýše umístěná položka stále existuje. Pomocí reprezentativních dotazů ze sbírky rozhodněte, jak vaše aplikace tento případ zpracuje.
Přechod a volba edice Výrobce popisuje rerank-3-lite jako vylepšení rerank-2.5-lite s nezměněnou sémantikou API a skóre kalibrovanými na rozdělení odpovídajícího předchůdce. Zachovejte stávající mapování záznamů a fázi vyhledávání a poté porovnejte výsledné pořadí na smysluplných dotazech, než se spolehnete na zavedenou prahovou hodnotu skóre. Lite použijte pro vyhledávání, kde záleží na odezvě; pokud má větší prioritu relevance u obtížných kandidátů, použijte k porovnání edici rerank-3 zaměřenou na kvalitu.
Ailoot Ultra · Přeřazení podle relevance POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteÚvod
Voyage rerank-3-lite hodnotí kandidátní textové dokumenty pro dotaz a mění jejich pořadí se zaměřením na rychlou odezvu vyhledávání. Podporuje pokyny k relevanci a okno 32 000 tokenů pro dvojici dotaz–dokument, takže je užitečný po vektorovém vyhledávání nebo vyhledávání podle klíčových slov při hledání a v postupech RAG.
- 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-3-lite | 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.00004 / 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-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
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-3-lite
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Jaká pole požadavek používá?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Jaké limity platí?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1