VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite bewertet und ordnet mögliche Textdokumente für eine Suchanfrage neu, mit Schwerpunkt auf reaktionsschneller Suche. Es unterstützt Relevanzanweisungen und ein Anfrage-Dokument-Fenster von 32.000 Token und eignet sich damit nach Vektor- oder Stichwortabruf für Such- und RAG-Abläufe.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Voyage rerank-3-lite ist die auf geringe Latenz ausgerichtete Ausgabe der Rerank-3-Serie von Voyage. Es nimmt eine Textanfrage und Kandidatendokumente entgegen, bewertet jedes Anfrage-Dokument-Paar gemeinsam und gibt Relevanzwerte in Rangfolge zurück. Es dient der zweiten Suchstufe: Ein Embedding- oder Stichwortabruf findet die Kandidaten, anschließend verfeinert Lite ihre Reihenfolge. Das Ergebnis ist eine Rangfolge zur Verwendung in der Suche oder einem Arbeitsablauf mit Retrieval-Augmented Generation.
Was sich mit Rerank 3 Lite ändert Der Anbieter betont einen stärkeren Abruf bei langen Dokumenten und Code im Vergleich zu rerank-2.5-lite. Beide Rerank-3-Ausgaben behalten das Befolgen von Anweisungen und dieselbe 32K-Kontextklasse bei; Lite ist für latenzempfindliche Anwendungen ausgelegt. Damit ist es ein praktischer Kandidat für interaktive Wissensbasissuche, den Abruf von Supportdokumenten und Codesuche, wenn Nutzende rasch relevante Ergebnisse benötigen. Wählen Sie es anhand der Qualitäts- und Antwortzeitanforderungen der tatsächlichen Sammlung, statt aus einer kleineren Ausgabe auf ein kleineres Kontextfenster zu schließen.
Relevanz mit der Anfrage steuern Natürlichsprachliche Anweisungen können die Anfrage ergänzen und erklären, was als relevant zählt. Halten Sie Frage und Relevanzpräferenz knapp und stimmig. Für eine Software-Supportsuche können Sie formulieren: „Finde die Vorgehensweise zum Zurücksetzen eines Geräts; priorisiere Anweisungen für die angegebene Hardware-Revision.“ Ergänzen Sie bei einem mehrdeutigen Produktnamen die Produktkategorie, damit sachfremde Bedeutungen nicht überwiegen. Eine Präferenz in der Anfrage steuert die semantische Bewertung; verwenden Sie ausdrückliche Sammlungsmetadaten, um vor dem Aufbau der Kandidatenliste das richtige Produkt, die Dokumentversion oder den Zugriffsbereich auszuwählen.
Eine engere Auswahl an Textkandidaten vorbereiten Die Eingabedokumente sind Zeichenfolgen. Extrahieren Sie lesbaren Text aus dem Ausgangsmaterial und erhalten Sie hilfreiche Titel, Überschriften, Kennungen und umgebenden Kontext. Bewahren Sie eine stabile Zuordnung jeder Eingabeposition zum ursprünglichen Datensatz. Bei einem Artikel zur Fehlerbehebung fügen Sie Symptom und relevante Vorgehensweise hinzu, nicht nur einen losgelösten Satz. Für die Quellcodesuche ergänzen Sie die Funktion und nahe gelegene Informationen, die sie von ähnlich benannten Funktionen unterscheiden. Entfernen Sie wiederholte Navigation oder Standardtexte, wenn sie die hilfreiche Textstelle verdrängen.
Der Reranker kann nur die Dokumente neu ordnen, die er erhält. Ruft die erste Suche den relevanten Artikel nie ab, kann diese Stufe den fehlenden Kandidaten nicht wiederherstellen. Prüfen Sie sowohl die engere Auswahl als auch die endgültige Reihenfolge, wenn ein Ergebnis falsch erscheint. Deckt ein langes Dokument viele Themen ab, trennen Sie zusammenhängende Abschnitte und erhalten Sie ihre Verweise auf das übergeordnete Dokument. So kann ein relevanter Abschnitt ausgewählt werden, ohne seine Quelle zu verlieren.
Kontext- und Anfragegrenzen Der aktuelle Leitfaden des Herstellers nennt maximal 8.000 Token für die Anfrage und insgesamt maximal 32.000 Token für die Anfrage plus jedes einzelne Dokument. Er erlaubt bis zu 1.000 Kandidatendokumente und ein Gesamtbudget von 600.000 Token pro Anfrage, berechnet als Anfrage-Token multipliziert mit der Dokumentanzahl plus sämtliche Dokument-Token. Eine lange Anfrage belegt somit Platz in jedem Paar und geht wiederholt in das Gesamtbudget ein. Zählen Sie den eingereichten Text mit dem passenden Modell-Tokenizer, statt Zeichen, Wörter und Token als austauschbar zu behandeln.
Eine Anfrage mit 500 Token und 100 Dokumenten mit jeweils 4.000 Token ergibt nach dieser Formel beispielsweise 450.000 Eingabe-Token. Dies veranschaulicht die Budgetierung, keine empfohlene Größe der engeren Auswahl und kein gemessenes Geschwindigkeitsergebnis. Die dokumentierte Kürzungsoption ist standardmäßig aktiviert; übergroßer Text kann vor der Bewertung gekürzt werden. Bereiten Sie wichtige Abschnitte gezielt vor, damit die Kürzung nicht genau die Textstelle entfernt, die abgeglichen werden soll.
Das Ergebnis lesen und verwenden Ergebnisse sind absteigend nach Relevanzwert sortiert. Jedes Ergebnis benennt die ursprüngliche Eingabeposition des Dokuments, sodass die Anwendung eigenen Titel, Datensatzkennung und Quelle zuordnen kann. Die Einstellung top_k steuert, wie viele gereihte Kandidaten zurückgegeben werden; ohne diese Angabe werden alle Kandidaten zurückgegeben. Die REST-Schnittstelle des Herstellers kann außerdem den Dokumenttext zurückgeben. Behalten Sie die ursprünglichen Kennungen neben den ausgewählten Ergebnissen bei, wenn Sie eine Suchseite anzeigen oder Belege an eine Antwortgenerierungsstufe weitergeben.
Ein Relevanzwert drückt aus, wie gut ein Kandidat zur Anfrage passt; er belegt nicht die Richtigkeit seiner Aussagen. Vergleichen Sie die bestgereihten Elemente mit der tatsächlichen Nutzerfrage einschließlich Ausschlüssen und Unterschieden zwischen Dokumentversionen. Sind alle Kandidaten irrelevant, existiert trotzdem ein bestgereihtes Element. Entscheiden Sie anhand repräsentativer Anfragen aus der Sammlung, wie Ihre Anwendung diesen Fall behandelt.
Aufrüsten und die Ausgabe wählen Der Hersteller beschreibt rerank-3-lite als Nachfolger von rerank-2.5-lite mit unveränderter API-Semantik und Werten, die auf die Verteilung des entsprechenden Vorgängers kalibriert sind. Bewahren Sie die bestehende Datensatzzuordnung und Abrufstufe und vergleichen Sie anschließend die resultierende Reihenfolge bei aussagekräftigen Anfragen, bevor Sie sich auf einen etablierten Schwellenwert verlassen. Verwenden Sie Lite für eine Suche, bei der die Antwortzeit zählt; ziehen Sie die qualitätsorientierte Ausgabe rerank-3 zum Vergleich heran, wenn die Relevanz bei schwierigen Kandidaten höhere Priorität hat.
Ailoot Ultra · Neusortierung POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteEinstieg
Voyage rerank-3-lite bewertet und ordnet mögliche Textdokumente für eine Suchanfrage neu, mit Schwerpunkt auf reaktionsschneller Suche. Es unterstützt Relevanzanweisungen und ein Anfrage-Dokument-Fenster von 32.000 Token und eignet sich damit nach Vektor- oder Stichwortabruf für Such- und RAG-Abläufe.
- Zulässige Eingaben
- Text
- Ergebnisse
- Nach Relevanz geordnete Ergebnisse
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Neusortierung POST /v1/rerank
- Eingabe
text- Ausgabe
rerank- Ausgabeformat
- json
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Felddocuments | Typarray | AnforderungErforderlich | Werte und Limits | Standard— |
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits voyageai/rerank-3-lite | Standard— |
Feldprovider | Typschema | AnforderungOptional | Werte und Limits | Standard— |
Feldquery | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldtop_n | Typinteger | AnforderungOptional | Werte und Limits Minimum: 1 | Standard— |
Feldtrace | Typschema | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Felddocuments[].text | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Felddocuments[].image | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Kombinationen von Eingabematerialien
text_rerank · Erforderlich: query, documents array with minItems1
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, query, documents |
Parametermaterial_types | Vertragtext |
Parameteroptional_controls | Vertragprovider, session_id, top_n, trace, user |
Parametermultimodal_input_binding | Vertragnull |
Lebenszyklus: synchronous
Senden Sie die exakte Modell-ID und bewahren Sie die vollständige native Antwort auf.
Tarife
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Ailoot-Tarife
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Abrechnungseinheit | Gebühr |
|---|---|---|---|
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken — / 1K Tokens Ausgabe · Ausgabetoken — / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · In Cache schreiben — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde — / 1K Tokens |
| KonfigurationUltra | Tarifstaffel— | Abrechnungseinheit/ 1K Tokens | Gebühr Eingabe $0.00004 / 1K Tokens |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Neusortierung
{
"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
Ergebnisse abrufen und speichern
Ailoot Ultra · Neusortierung
json
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Jeder tatsächliche Ergebnisindex, jeder endliche relevance_score und jedes ursprüngliche Dokumentobjekt bleiben erhalten. Die Indizes verweisen auf das ursprüngliche Dokumentarray. Das gesamte ursprüngliche JSON wird gespeichert und erst nach der Abrechnung zurückgegeben.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie den ursprünglichen Vorgang und die vollständige oder teilweise Antwort auf; wiederholen Sie POST nicht.
Antwortfelder
| Feld | Typ |
|---|---|
Feldmodel | Typstring |
Feldid | Typstring |
Feldprovider | Typstring |
Feldresults[].index | Typinteger |
Feldresults[].relevance_score | Typnumber |
Feldresults[].document.text | Typstring |
Feldresults[].document.image | Typstring |
Feldusage.search_units | Typinteger |
Feldusage.total_tokens | Typinteger |
Feldusage.cost | Typnumber |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungUngültiges Pflichtfeld, ungültige Darstellung oder ungültiger Wert | Nächster SchrittKorrigieren Sie das angegebene Anfragefeld. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra voyageai/rerank-3-lite
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Welche Felder verwendet die Anfrage?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Welche Grenzen gelten?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1