modely

VoyageAI by MongoDB: rerank-3

Markdown · JSON

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

VoyageAI by MongoDB /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
PoleTypPožadavekHodnoty a limityVýchozí
PoledocumentsTyparrayPožadavekPovinnéHodnoty a limityVýchozí—
PolemodelTypstringPožadavekPovinnéHodnoty a limity
voyageai/rerank-3
Výchozí—
PoleproviderTypschemaPožadavekVolitelnéHodnoty a limityVýchozí—
PolequeryTypstringPožadavekPovinnéHodnoty a limityVýchozí—
Polesession_idTypstringPožadavekVolitelnéHodnoty a limityVýchozí—
Poletop_nTypintegerPožadavekVolitelnéHodnoty a limity
Minimum: 1
Výchozí—
PoletraceTypschemaPožadavekVolitelnéHodnoty a limityVýchozí—
PoleuserTypstringPožadavekVolitelnéHodnoty a limityVýchozí—
Poledocuments[].textTypstringPožadavekVolitelnéHodnoty a limityVýchozí—
Poledocuments[].imageTypstringPožadavekVolitelnéHodnoty a limityVýchozí—
Kombinace vstupních materiálů

text_rerank · Povinné: query, documents array with minItems1

Parametry a životní cyklus metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, query, documents
Parametrmaterial_typesKontrakttext
Parametroptional_controlsKontraktprovider, session_id, top_n, trace, user
Parametrmultimodal_input_bindingKontraktnull

Ž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.

KonfiguraceTabulka sazebÚčtovací jednotkaPoplatek
KonfiguraceZákladní sazby za tokenyTabulka 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ů
KonfiguraceUltraTabulka 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

Uchovaná oficiální struktura požadavku; dokumentační příkladPoužijte skutečné podklady svého požadavku a uchovejte úplný výsledek
{
  "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
PoleTyp
PolemodelTypstring
PoleidTypstring
PoleproviderTypstring
Poleresults[].indexTypinteger
Poleresults[].relevance_scoreTypnumber
Poleresults[].document.textTypstring
Poleresults[].document.imageTypstring
Poleusage.search_unitsTypinteger
Poleusage.total_tokensTypinteger
Poleusage.costTypnumber
Chyby a další kroky
OdpověďPodmínkaDalší krok
Odpověď400 · invalid_request_errorPodmínkaNeplatné povinné pole, způsob zadání nebo hodnotaDalší 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ů

voyageai/rerank-3

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

Další podrobnosti

Připojte Ailoot k Claude Code, OpenCode, Hermes nebo vlastní aplikaci.

Společnost a její portfolio projektů

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

Nakupujte tokeny se slevou.

Sleva předplatného pro pravidelnou práci. Promo kódy až 50% na nákup tokenů.

Předplatné
Pro pravidelné požadavky vyberte tarif se slevou.
Promo kód až 50%
Při nákupu zadejte kód. Cena se přepočítá podle probíhající akce.
Výdaje v historii
U každého požadavku se uloží model, tokeny a částka.

Vybrat předplatné · Zobrazit ceny modelů

Připojte API k produktu, který prodáváte.

SaaS, aplikace a boti podle nabídky a licenční smlouvy Ailoot. Pro přeprodej požádejte o licenci přeprodejce.

Komerční aplikace
Začleňte generování textu, obrázků, videa a zvuku do placených funkcí své služby.
Licence pro přeprodejce
Pošlete popis projektu a způsob poskytování přístupu. Vyžádejte písemné podmínky použití a přeprodeje.
Dokumenty na webu
Nabídka, licenční smlouva a zásady zpracování dat jsou dostupné před připojením.

Požádat o licenci přeprodejce · Nabídka a licenční smlouva