VoyageAI by MongoDB: rerank-3
Voyage rerank-3 je edice Rerank 3 zaměřená na kvalitu hodnocení relevance dvojice dotaz–dokument. Mění pořadí nalezených textových kandidátů, podporuje pokyny k relevanci v přirozeném jazyce a zpracovává dvojice o 32 000 tokenech pro vyhledávání v dlouhých dokumentech, kódu a znalostních bázích.
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 je model pro přehodnocení pořadí textových výsledků navržený ke zlepšení kvality nalezených podkladů. Z dotazu a seznamu kandidátních dokumentů společně zkoumá každou dvojici a vrací kandidáty seřazené podle relevance. Embeddingy a vyhledávání podle klíčových slov mohou nejprve zúžit rozsáhlou sbírku na zvládnutelný užší seznam; rerank-3 poté tento seznam podrobněji posoudí z hlediska relevance. Jeho výstupem jsou ohodnocené vyhledané podklady, které aplikace zobrazí nebo předá do samostatné fáze generování odpovědi.
Rerank 3 zaměřený na kvalitu Výrobce představuje rerank-3 jako edici zaměřenou na přesnost a rerank-3-lite jako edici pro vyhledávání citlivé na latenci. Třetí generace aktualizuje páteřní síť a trénovací směs se zvláštním zlepšením vyhledávání v dlouhých dokumentech a zdrojovém kódu oproti odpovídajícím předchůdcům 2.5. Výrobce ji hodnotí na technické dokumentaci, kódu, vícejazyčných podkladech a dalších dokumentových oblastech. Tyto výsledky podporují její vyhledávací roli; edici vybírejte podle otázek a kandidátních dokumentů důležitých pro vlastní sbírku.
Dlouhé dokumenty s dostatečným kontextem Dlouhý kandidát může obsahovat užitečný kontext daleko za úvodním odstavcem. Dodejte soudržnou část nebo dokument s názvem a relevantními okolními podklady, aby model mohl posoudit vztah skutečné otázky k obsahu. Při vyhledávání produktových pravidel zachovejte nadpisy a výjimky kolem zájmové pasáže. Pochází-li několik nalezených částí ze stejného zdroje, zachovejte jejich identifikátory dokumentu i části; aplikace pak může ukázat původ vybraných podkladů.
Kontextové okno sdílejí dotaz a každý kandidát. Aktuální průvodce výrobce uvádí 32 000 tokenů pro tuto dvojici včetně dotazu o nejvýše 8 000 tokenech. Dotaz o 3 000 tokenech tedy ponechává pro každý dokument nanejvýš 29 000 tokenů. Vstup připravte tak, aby se jeho zásadní obsah vešel, zvláště pokud by jinak dlouhý úvod nebo opakující se šablonovitý text spotřeboval okno. Dokumentovaná volba zkracování je ve výchozím stavu zapnutá a může před hodnocením zkrátit příliš rozsáhlý dotaz či dokument. Záleží-li na umístění pasáže, zkontrolujte, co zůstalo zachováno.
Vyhledávání kódu a technických informací Ve vyhledávací fázi programovacího asistenta mohou kandidáti obsahovat implementace funkcí, dokumentaci API nebo technická vysvětlení jako text. Přiložte symboly, signatury a kontext potřebné k odlišení podobných kandidátů. Dotaz typu „Najděte funkci, která normalizuje cesty a zachovává koncový oddělovač“ určuje konkrétní chování k přiřazení. Připojte příslušná omezení jazyka, platformy nebo verze. Po seřazení prozkoumejte vybraný kód a jeho závislosti před použitím jako kontextu; skóre relevance nedokazuje, že implementace splňuje všechny uvedené požadavky.
Pokyny vymezují relevanci Model zachovává schopnost upravovat pořadí podle pokynů zavedenou v Rerank 2.5. Pokud záměr uživatele potřebuje upřesnit, vložte před dotaz nebo za něj stručný pokyn. Při vyhledávání rešeršních dokumentů vysvětlete, zda je důležitý název, konkrétní metoda nebo oblast použití. U interního katalogu určete, zda se požadavek týká instalace, řešení problémů nebo kompatibility. Pokyn udržujte v souladu s otázkou; dodatečné preference odporující hlavnímu požadavku mohou změnit to, co se pořadí snaží optimalizovat.
Příprava kandidátních dokumentů a rozpočtů Vstupem je seznam textových řetězců. Ze zdrojových dokumentů vytěžte použitelný text, zachovejte smysluplné hranice částí a vedle seznamu uchovávejte uspořádané mapování záznamů. Výrobce umožňuje až 1 000 dokumentů v jednom požadavku. Uvádí také souhrnný vstupní strop 600 000 tokenů: tokeny dotazu násobené počtem dokumentů plus součet všech tokenů dokumentů. To se liší od limitu kontextu pro jednotlivou dvojici. Omezení nadbytečného textu dotazu může zachovat kapacitu dvojice i celkový rozpočet požadavku.
Počítejte tokeny pro příslušný model místo předpokladu, že počet slov nebo znaků je počtem tokenů. U rozsáhlých kandidátů vyberte soudržné pasáže nebo rozdělte podklady podle užitečných nadpisů a zachovejte informace o nadřazeném zdroji. Přehodnocování pořadí je nejužitečnější poté, co první vyhledávání již našlo vhodné kandidáty: nemůže zařadit chybějící zdroj, který se nikdy nedostal do seznamu.
Seřazené výsledky a další použití Výsledek obsahuje skóre relevance a indexy odkazující na původní vstupní dokumenty, seřazené sestupně podle relevance. Volba top_k omezuje počet vrácených seřazených výsledků; jinak se vracejí všichni vstupní kandidáti. Rozhraní REST výrobce umožňuje přiložit také text dokumentu. Pomocí každého původního indexu dohledáte název, identifikátor zdroje a případná metadata potřebná pro aplikaci; poté vybrané položky zobrazte nebo vložte příslušný text do kontextu podkladů odpovědi.
Nejlepší výsledky porovnejte s otázkou a identitu zdroje ponechte viditelnou. Vysoké relativní pořadí neověřuje faktickou správnost dokumentu a užší seznam obsahující jen slabé kandidáty bude mít stále první položku. Výběr podle relevance oddělte od rozhodnutí, zda vybrané podklady stačí k zodpovězení otázky uživatele.
Přechod mezi edicemi Výrobce popisuje rerank-3 jako přímo zaměnitelného nástupce rerank-2.5 se stejnou sémantikou API a skóre kalibrovanými na rozdělení odpovídajícího předchůdce. Tato kompatibilita podporuje zachování stávající vyhledávací fáze a mapování záznamů. Než se na přechod spolehnete, porovnejte smysluplná pořadí výsledků a případný práh skóre na aktuálním korpusu. Rerank-3 a rerank-3-lite ponechte jako odlišné volby: společné limity a dodržování pokynů neznamenají totožné priority kvality a latence.
Ailoot Ultra · Přeřazení podle relevance POST /v1/rerank voyageai/rerank-3
voyageai/rerank-3Úvod
Voyage rerank-3 je edice Rerank 3 zaměřená na kvalitu hodnocení relevance dvojice dotaz–dokument. Mění pořadí nalezených textových kandidátů, podporuje pokyny k relevanci v přirozeném jazyce a zpracovává dvojice o 32 000 tokenech pro vyhledávání v dlouhých dokumentech, kódu a znalostních bázích.
- 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 | 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-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
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
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · VoyageAI by MongoDB: rerank-3
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/rerank·voyageai/rerank-3:text→rerank- Jaká pole požadavek používá?
POST /v1/rerank·voyageai/rerank-3:documents,model,provider,query,session_id,top_n,trace,user- Jaké limity platí?
POST /v1/rerank·voyageai/rerank-3:top_n.minimum:1