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-3Start
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
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Poledocuments | Typarray | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polemodel | Typstring | WymaganieWymagane | Wartości i limity voyageai/rerank-3 | Domyślnie— |
Poleprovider | Typschema | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polequery | Typstring | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polesession_id | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poletop_n | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 1 | Domyślnie— |
Poletrace | Typschema | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poleuser | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poledocuments[].text | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poledocuments[].image | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Kombinacje materiałów wejściowych
text_rerank · Wymagane: query, documents array with minItems1
Parametry i cykl życia 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 |
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.
| Konfiguracja | Tabela stawek | Jednostka rozliczeniowa | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Jednostka 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 |
| KonfiguracjaUltra | Tabela stawek— | Jednostka rozliczeniowa/ 1K tokenów | Opł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
{
"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
| 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 |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidł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
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