modele

VoyageAI by MongoDB: rerank-3

Markdown · JSON

VoyageAI by MongoDB: rerank-3

Voyage rerank-3 to wydanie Rerank 3 nastawione na jakość oceny trafności par zapytanie–dokument. Ponownie porządkuje znalezione teksty kandydujące, obsługuje instrukcje trafności w języku naturalnym i pary do 32 000 tokenów przy wyszukiwaniu w długich dokumentach, kodzie i bazach wiedzy.

O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

Voyage rerank-3 to tekstowy reranker zaprojektowany do poprawy jakości znalezionych dowodów. Otrzymawszy zapytanie i listę dokumentów kandydujących, wspólnie bada każdą parę i zwraca kandydatów uporządkowanych według trafności. Embeddingi i wyszukiwanie według słów kluczowych mogą najpierw zawęzić duży zbiór do listy o rozsądnym rozmiarze; rerank-3 stosuje następnie dokładniejszą ocenę trafności do tej listy. Wyjściem jest oceniony materiał z wyszukiwania, który aplikacja może wyświetlić lub przekazać do osobnego etapu generowania odpowiedzi.

Rerank 3 nastawiony na jakość Producent pozycjonuje rerank-3 jako wydanie nastawione na dokładność, a rerank-3-lite jako wydanie do wyszukiwania wrażliwego na opóźnienia. Trzecia generacja aktualizuje architekturę bazową i mieszankę treningową, ze szczególną poprawą wyszukiwania w długich dokumentach i kodzie źródłowym względem odpowiednich poprzedników 2.5. Producent ocenia ją na dokumentacji technicznej, kodzie, materiale wielojęzycznym i innych dziedzinach dokumentów. Wyniki wspierają jej rolę w wyszukiwaniu; dobierz wydanie na podstawie pytań i dokumentów kandydujących ważnych dla własnego zbioru.

Długie dokumenty z wystarczającym kontekstem Długi kandydat może zawierać przydatny kontekst znacznie poza pierwszym akapitem. Dostarcz spójną sekcję lub dokument z tytułem i odpowiednim otaczającym materiałem, aby model mógł ocenić związek rzeczywistego pytania z treścią. W wyszukiwaniu zasad dotyczących produktu zachowaj nagłówki i wyjątki wokół interesującego fragmentu. Jeśli kilka pobranych sekcji pochodzi z tego samego źródła, zachowaj identyfikatory dokumentu i sekcji; aplikacja będzie mogła pokazać pochodzenie wybranych dowodów.

Okno kontekstu jest współdzielone przez zapytanie i każdego kandydata. Bieżący poradnik producenta podaje 32 000 tokenów dla tej pary, w tym zapytanie o maksymalnie 8 000 tokenach. Zapytanie o 3 000 tokenów pozostawia więc najwyżej 29 000 tokenów na każdy dokument. Przygotuj wejście tak, aby istotna treść się mieściła, zwłaszcza gdy długi wstęp lub powtarzalny tekst szablonowy zajmowałby okno. Udokumentowana opcja obcinania jest domyślnie włączona i może skracać zbyt obszerne zapytanie lub tekst dokumentu przed oceną. Sprawdź, co zostaje zachowane, gdy położenie fragmentu ma znaczenie.

Wyszukiwanie kodu i treści technicznych Na etapie wyszukiwania dla asystenta programowania kandydaci mogą zawierać implementacje funkcji, dokumentację API lub wyjaśnienia techniczne jako tekst. Uwzględnij symbole, sygnatury i kontekst potrzebne do odróżnienia podobnych kandydatów. Zapytanie takie jak „Znajdź funkcję normalizującą ścieżki z zachowaniem końcowego separatora” daje konkretne zachowanie do dopasowania. Dołącz istotne ograniczenia języka, platformy lub wersji. Po uporządkowaniu zbadaj wybrany kod i jego zależności przed użyciem go jako kontekstu; ocena trafności nie dowodzi, że implementacja spełnia wszystkie podane wymagania.

Instrukcje definiują trafność Model zachowuje możliwość ponownego porządkowania według instrukcji wprowadzoną w Rerank 2.5. Dodaj zwięzłą instrukcję przed zapytaniem lub po nim, gdy intencja użytkownika wymaga doprecyzowania. W wyszukiwaniu dokumentów badawczych wyjaśnij, czy najważniejszy jest tytuł, konkretna metoda czy obszar zastosowań. W katalogu wewnętrznym określ, czy prośba dotyczy instalacji, rozwiązywania problemów czy zgodności. Utrzymuj tę instrukcję w zgodzie z pytaniem; dodatkowe preferencje sprzeczne z główną prośbą mogą zmienić cel optymalizacji rankingu.

Przygotuj dokumenty kandydujące i budżety Wejściem jest lista ciągów tekstowych. Wyodrębnij użyteczny tekst z dokumentów źródłowych, zachowaj znaczące granice sekcji i utrzymuj uporządkowaną mapę rekordów przy liście. Producent dopuszcza do 1 000 dokumentów w jednym żądaniu. Podaje też łączny limit wejścia 600 000 tokenów: tokeny zapytania pomnożone przez liczbę dokumentów, plus suma tokenów wszystkich dokumentów. Różni się to od limitu kontekstu pojedynczej pary. Ograniczenie zbędnego tekstu zapytania może oszczędzić zarówno pojemność pary, jak i całkowity budżet żądania.

Licz tokeny dla odpowiedniego modelu, zamiast zakładać, że liczba słów lub znaków jest liczbą tokenów. Przy dużych kandydatach wybieraj spójne fragmenty lub dziel materiał według przydatnych nagłówków, zachowując informacje o źródle nadrzędnym. Ponowne porządkowanie jest najbardziej użyteczne, gdy pierwsze wyszukiwanie już ujawniło wiarygodnych kandydatów: nie może ocenić brakującego źródła, które nigdy nie trafiło na listę.

Wyniki rankingu i dalsze wykorzystanie Wynik zawiera oceny trafności i indeksy odnoszące się do oryginalnych dokumentów wejściowych, posortowane malejąco według trafności. Opcja top_k ogranicza liczbę zwracanych wyników rankingu; w przeciwnym razie zwracani są wszyscy kandydaci wejściowi. Interfejs REST producenta umożliwia również dołączenie tekstu dokumentu. Użyj każdego oryginalnego indeksu, aby odzyskać tytuł, identyfikator źródła i metadane potrzebne aplikacji, a następnie przedstaw wybrane pozycje lub umieść odpowiedni tekst w kontekście dowodowym odpowiedzi.

Sprawdź czołowe wyniki względem pytania i zachowuj widoczną tożsamość źródeł. Wysoka pozycja względna nie weryfikuje poprawności faktograficznej dokumentu, a lista zawierająca tylko słabych kandydatów nadal ma pierwszą pozycję. Oddziel wybór według trafności od decyzji, czy wybrane dowody wystarczają do odpowiedzi użytkownikowi.

Migracja wydania Producent opisuje rerank-3 jako bezpośredniego następcę rerank-2.5, z tą samą semantyką API i ocenami skalibrowanymi do rozkładu odpowiedniego poprzednika. Ta zgodność wspiera zachowanie istniejącego etapu wyszukiwania i mapowania rekordów. Porównaj znaczące kolejności wyników i ewentualny próg ocen na bieżącym korpusie, zanim oprzesz się na migracji. Traktuj rerank-3 i rerank-3-lite jako odrębne wybory: wspólne limity i wykonywanie instrukcji nie czynią ich priorytetów jakości i opóźnień identycznymi.

Ailoot Ultra · Ponowne rankowanie POST /v1/rerank voyageai/rerank-3

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

Start

Voyage rerank-3 to wydanie Rerank 3 nastawione na jakość oceny trafności par zapytanie–dokument. Ponownie porządkuje znalezione teksty kandydujące, obsługuje instrukcje trafności w języku naturalnym i pary do 32 000 tokenów przy wyszukiwaniu w długich dokumentach, kodzie i bazach wiedzy.

Akceptowane dane wejściowe
Tekst
Wyniki
Wyniki uporządkowane według trafności

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Ponowne rankowanie POST /v1/rerank
Wejście
text
Wyjście
rerank
Format wyjściowy
json
PoleTypWymaganieWartości i limityDomyślnie
PoledocumentsTyparrayWymaganieWymaganeWartości i limityDomyślnie—
PolemodelTypstringWymaganieWymaganeWartości i limity
voyageai/rerank-3
Domyślnie—
PoleproviderTypschemaWymaganieOpcjonalneWartości i limityDomyślnie—
PolequeryTypstringWymaganieWymaganeWartości i limityDomyślnie—
Polesession_idTypstringWymaganieOpcjonalneWartości i limityDomyślnie—
Poletop_nTypintegerWymaganieOpcjonalneWartości i limity
Minimum: 1
Domyślnie—
PoletraceTypschemaWymaganieOpcjonalneWartości i limityDomyślnie—
PoleuserTypstringWymaganieOpcjonalneWartości i limityDomyślnie—
Poledocuments[].textTypstringWymaganieOpcjonalneWartości i limityDomyślnie—
Poledocuments[].imageTypstringWymaganieOpcjonalneWartości i limityDomyślnie—
Kombinacje materiałów wejściowych

text_rerank · Wymagane: query, documents array with minItems1

Parametry i cykl życia metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, query, documents
Parametrmaterial_typesKontrakttext
Parametroptional_controlsKontraktprovider, session_id, top_n, trace, user
Parametrmultimodal_input_bindingKontraktnull

Cykl życia: synchronous

Wyślij dokładny identyfikator modelu i zachowaj kompletną natywną odpowiedź.

Cennik

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki
Nie określono Gdy wybrany jest tryb szybki
Tryb flex
Nie określono Gdy wybrany jest tryb flex
Maksymalna intensywność rozumowania
Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)

Stawki Ailoot

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

KonfiguracjaTabela stawekJednostka rozliczeniowaOpłata
KonfiguracjaBazowe stawki za tokenyTabela stawekStawka podstawowaJednostka rozliczeniowa—Opłata
Wejście · Tokeny wejściowe — / 1K tokenów
Wyjście · Tokeny wyjściowe — / 1K tokenów
Wejście · Odczyt cache — / 1K tokenów
Wejście · Zapis do cache — / 1K tokenów
Wejście · Zapis do cache, 1 godz. — / 1K tokenów
KonfiguracjaUltraTabela stawek—Jednostka rozliczeniowa/ 1K tokenówOpłata
Wejście $0.0001 / 1K tokenów

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →

Przykładowe żądania

Ailoot Ultra · Ponowne rankowanie

Zachowana oficjalna struktura żądania; przykład z dokumentacjiUżyj rzeczywistych materiałów do swojego żądania i zachowaj kompletny wynik
{
  "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

Odbieranie i zapisywanie wyników

Ailoot Ultra · Ponowne rankowanie

json

Zachowaj wszystkie ukończone wyniki

Zachowaj każdą kompletną zwróconą odpowiedź, plik i część treści.

Zachowywany jest każdy rzeczywisty indeks wyniku, skończona wartość relevance_score i oryginalny obiekt dokumentu. Indeksy wskazują na pierwotną tablicę dokumentów. Cały oryginalny JSON jest zapisywany i zwracany dopiero po rozliczeniu.

Jeśli trzeba sprawdzić pierwotną odpowiedź

Zachowaj pierwotną operację oraz pełną lub częściową odpowiedź; nie ponawiaj POST.

Pola odpowiedzi
PoleTyp
PolemodelTypstring
PoleidTypstring
PoleproviderTypstring
Poleresults[].indexTypinteger
Poleresults[].relevance_scoreTypnumber
Poleresults[].document.textTypstring
Poleresults[].document.imageTypstring
Poleusage.search_unitsTypinteger
Poleusage.total_tokensTypinteger
Poleusage.costTypnumber
Błędy i dalsze kroki
OdpowiedźWarunekNastępny krok
Odpowiedź400 · invalid_request_errorWarunekNieprawidłowe wymagane pole, reprezentacja lub wartośćNastępny krokPopraw wskazane pole żądania.

Aliasy

Aliasy modelu

Ailoot Ultra voyageai/rerank-3

Aliasy ścieżek metod

Użyj ścieżek metod podanych powyżej.

Powiązane ID modeli

voyageai/rerank-3

FAQ · VoyageAI by MongoDB: rerank-3
Jakie dane wejściowe i wyniki są dostępne?

POST /v1/rerank · voyageai/rerank-3: text → rerank

Jakich pól używa żądanie?

POST /v1/rerank · voyageai/rerank-3: documents, model, provider, query, session_id, top_n, trace, user

Jakie limity obowiązują?

POST /v1/rerank · voyageai/rerank-3: top_n.minimum: 1

Więcej szczegółów

Połącz Ailoot z Claude Code, OpenCode, Hermes albo własną aplikacją.

Firma i jej portfel projektów

Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.

Kupuj tokeny z rabatem.

Rabat subskrypcji do regularnej pracy. Kody promocyjne — do 50% na tokeny.

Subskrypcja
Wybierz plan z rabatem do regularnych żądań.
Kod promocyjny do 50%
Wpisz kod przy zakupie. Cena zostanie przeliczona według aktualnej promocji.
Koszty w historii
Model, tokeny i kwota są zapisywane dla każdego żądania.

Wybierz subskrypcję · Sprawdź ceny modeli

Połącz API z produktem, który sprzedajesz.

SaaS, aplikacje i boty na warunkach oferty i umowy licencyjnej Ailoot. Do odsprzedaży poproś o licencję resellerską.

Aplikacja komercyjna
Wbuduj generowanie tekstu, obrazów, wideo i dźwięku w płatne funkcje usługi.
Licencja resellerska
Prześlij opis projektu i schemat dostępu. Poproś o pisemne warunki używania i odsprzedaży.
Dokumenty na stronie
Oferta, umowa licencyjna i polityka przetwarzania danych są dostępne przed połączeniem.

Poproś o licencję resellerską · Oferta i umowa licencyjna