VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite ocenia i ponownie porządkuje kandydujące dokumenty tekstowe względem zapytania, z naciskiem na szybkie wyszukiwanie. Obsługuje instrukcje trafności i okno zapytanie–dokument 32 000 tokenów, dzięki czemu przydaje się po wyszukiwaniu wektorowym lub według słów kluczowych w procesach wyszukiwania i RAG.
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-lite to wydanie serii Rerank 3 firmy Voyage nastawione na niskie opóźnienia. Przyjmuje zapytanie tekstowe i kandydujące dokumenty, ocenia wspólnie każdą parę zapytanie–dokument i zwraca oceny trafności w kolejności rankingu. Służy drugiemu etapowi wyszukiwania: mechanizm oparty na embeddingach lub słowach kluczowych znajduje kandydatów, a Lite dopracowuje ich kolejność. Wynikiem jest ranking do wykorzystania w wyszukiwaniu lub procesie generowania wspomaganego wyszukiwaniem.
Co zmienia się w Rerank 3 Lite Producent podkreśla lepsze wyszukiwanie w długich dokumentach i kodzie w porównaniu z rerank-2.5-lite. Oba wydania Rerank 3 zachowują wykonywanie instrukcji i tę samą klasę kontekstu 32K, natomiast Lite jest zaprojektowany dla aplikacji wrażliwych na opóźnienia. Czyni go to praktycznym kandydatem do interaktywnego przeszukiwania baz wiedzy, wyszukiwania dokumentacji wsparcia i kodu, gdy użytkownicy potrzebują szybkich, trafnych wyników. Wybieraj go według wymagań jakości i czasu odpowiedzi dla rzeczywistego zbioru, zamiast zakładać, że mniejsze wydanie oznacza mniejsze okno kontekstu.
Kieruj trafnością za pomocą zapytania Zapytaniu mogą towarzyszyć instrukcje w języku naturalnym wyjaśniające, co uznać za trafne. Pytanie i preferencja trafności powinny być zwięzłe i spójne. W wyszukiwaniu wsparcia oprogramowania użyj: „Znajdź procedurę resetowania urządzenia; nadaj pierwszeństwo instrukcjom dla podanej rewizji sprzętu”. Przy niejednoznacznej nazwie produktu uwzględnij jego kategorię, aby nie dominowały niepowiązane znaczenia. Preferencja w zapytaniu kieruje oceną semantyczną; używaj jawnych metadanych zbioru do wyboru właściwego produktu, wersji dokumentu lub zakresu dostępu przed utworzeniem listy kandydatów.
Przygotuj krótką listę kandydatów tekstowych Dokumenty wejściowe są ciągami tekstowymi. Wyodrębnij czytelny tekst z materiału źródłowego i zachowaj przydatne tytuły, nagłówki, identyfikatory oraz kontekst. Utrzymuj stałe mapowanie każdej pozycji wejściowej na oryginalny rekord. W artykule o rozwiązywaniu problemów uwzględnij objaw i odpowiednią procedurę, a nie tylko oderwane zdanie. W wyszukiwaniu kodu źródłowego uwzględnij funkcję i pobliskie informacje potrzebne do odróżnienia jej od podobnie nazwanych funkcji. Usuń powtarzalną nawigację lub szablonowy tekst, gdy wypierają przydatny fragment.
Reranker może zmienić kolejność tylko otrzymanych dokumentów. Jeśli pierwsze wyszukiwanie nie pobierze odpowiedniego artykułu, ten etap nie odzyska brakującego kandydata. Gdy wynik wydaje się błędny, sprawdź zarówno listę kandydatów, jak i końcową kolejność. Jeśli długi dokument obejmuje wiele tematów, rozdziel spójne sekcje i zachowaj ich odwołania do dokumentu nadrzędnego, aby można było wybrać trafną sekcję bez utraty źródła.
Kontekst i limity żądania Bieżący poradnik producenta określa maksimum zapytania na 8 000 tokenów i łączne maksimum zapytania z każdym pojedynczym dokumentem na 32 000 tokenów. Dopuszcza do 1 000 dokumentów kandydujących i łączny budżet żądania 600 000 tokenów, obliczany jako liczba tokenów zapytania pomnożona przez liczbę dokumentów, plus tokeny wszystkich dokumentów. Długie zapytanie zużywa więc miejsce w każdej parze i wielokrotnie powiększa budżet łączny. Licz tokeny przesyłanego tekstu odpowiednim tokenizerem modelu, zamiast traktować znaki, słowa i tokeny jako zamienne.
Na przykład zapytanie o 500 tokenach ze 100 dokumentami po 4 000 tokenów daje według tej formuły 450 000 tokenów wejściowych. Ilustruje to budżetowanie, a nie zalecaną wielkość listy kandydatów lub zmierzony wynik szybkości. Udokumentowana opcja obcinania jest domyślnie włączona; zbyt obszerny tekst może zostać skrócony przed oceną. Świadomie przygotuj ważne sekcje, aby obcinanie nie usunęło właśnie tego fragmentu, który ma zostać dopasowany.
Odczytaj i wykorzystaj wynik Wyniki są sortowane od najwyższej oceny trafności w dół. Każdy wynik wskazuje pierwotną pozycję dokumentu na wejściu, co pozwala aplikacji dołączyć własny tytuł, identyfikator rekordu i źródło. Ustawienie top_k określa liczbę zwracanych kandydatów w rankingu; bez niego zwracani są wszyscy kandydaci. Interfejs REST producenta może także zwracać tekst dokumentu. Zachowuj pierwotne identyfikatory przy wybranych wynikach podczas wyświetlania strony wyszukiwania lub przekazywania dowodów do etapu generowania odpowiedzi.
Ocena trafności wyraża stopień dopasowania kandydata do zapytania; nie potwierdza prawdziwości jego stwierdzeń. Porównaj najwyżej ocenione pozycje z rzeczywistym pytaniem użytkownika, uwzględniając wykluczenia i różnice wersji dokumentów. Jeśli każdy kandydat jest nietrafny, nadal istnieje pozycja najwyżej sklasyfikowana. Ustal, jak aplikacja obsłuży ten przypadek, korzystając z reprezentatywnych zapytań dla zbioru.
Aktualizacja i wybór wydania Producent opisuje rerank-3-lite jako następcę rerank-2.5-lite z niezmienioną semantyką API i ocenami skalibrowanymi do rozkładu odpowiedniego poprzednika. Zachowaj istniejące mapowanie rekordów i etap wyszukiwania, a następnie porównaj uzyskaną kolejność na znaczących zapytaniach przed poleganiem na ustalonym progu ocen. Używaj Lite tam, gdzie ważny jest czas odpowiedzi; porównaj go z wydaniem rerank-3 nastawionym na jakość, gdy trafność trudnych kandydatów ma większy priorytet.
Ailoot Ultra · Ponowne rankowanie POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteStart
Voyage rerank-3-lite ocenia i ponownie porządkuje kandydujące dokumenty tekstowe względem zapytania, z naciskiem na szybkie wyszukiwanie. Obsługuje instrukcje trafności i okno zapytanie–dokument 32 000 tokenów, dzięki czemu przydaje się po wyszukiwaniu wektorowym lub według słów kluczowych w procesach wyszukiwania i RAG.
- 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-lite | 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.00004 / 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-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
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-lite
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Jakich pól używa żądanie?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Jakie limity obowiązują?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1