VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite bewertet Textdokumentkandidaten für eine Suchanfrage und ordnet sie neu, mit Schwerpunkt auf schnellen Suchantworten. 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-Workflows.
Ü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 Dokumentkandidaten entgegen, bewertet jedes Anfrage-Dokument-Paar gemeinsam und gibt Relevanzwerte in Rangfolge zurück. Es bildet die zweite Suchstufe: Ein Embedding- oder Stichwort-Retriever findet die Kandidaten, anschließend verfeinert Lite deren Reihenfolge. Das Ergebnis ist eine Rangfolge für die Suche oder einen Workflow mit Retrieval-Augmented Generation.
Was sich in Rerank 3 Lite ändert Der Hersteller betont einen stärkeren Abruf langer Dokumente und von Code gegenüber 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. Das macht es zu einem praktischen Kandidaten für interaktive Wissensbasissuche, den Abruf von Supportdokumenten und Codesuche, wenn Nutzende zeitnah relevante Ergebnisse benötigen. Wählen Sie es anhand der Qualitäts- und Antwortzeitanforderungen der tatsächlichen Sammlung, statt anzunehmen, dass eine kleinere Ausgabe ein kleineres Kontextfenster bedeutet.
Relevanz mit der Suchanfrage steuern Natürlichsprachliche Anweisungen können die Anfrage ergänzen und erklären, was als relevant gilt. Halten Sie Frage und Relevanzpräferenz kurz und widerspruchsfrei. Verwenden Sie für eine Software-Supportsuche etwa: „Finde das Verfahren zum Zurücksetzen eines Geräts; priorisiere Anleitungen für die angegebene Hardwareversion.“ Ergänzen Sie bei einem mehrdeutigen Produktnamen die Produktkategorie, damit unverbundene Bedeutungen nicht überwiegen. Eine Präferenz in der Anfrage steuert die semantische Bewertung; verwenden Sie ausdrückliche Sammlungsmetadaten, um das richtige Produkt, die Dokumentversion oder den Zugriffsbereich auszuwählen, bevor Sie die Kandidatenliste aufbauen.
Eine engere Auswahl von Textkandidaten vorbereiten Die Eingabedokumente sind Zeichenfolgen. Extrahieren Sie lesbaren Text aus dem Ausgangsmaterial und erhalten Sie nützliche Titel, Überschriften, Kennungen und umgebenden Kontext. Halten Sie eine stabile Zuordnung jeder Eingabeposition zum ursprünglichen Datensatz aufrecht. Fügen Sie bei einem Fehlerbehebungsartikel das Symptom und das relevante Verfahren bei, nicht nur einen isolierten Satz. Nehmen Sie bei Quellcodesuche die Funktion und die benachbarten Informationen auf, die zur Unterscheidung von ähnlich benannten Funktionen nötig sind. Entfernen Sie wiederholte Navigation oder Standardtext, wenn sie die nützliche Textstelle verdrängen.
Der Reranker kann nur 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, teilen Sie es in zusammenhängende Abschnitte auf und erhalten Sie deren Verweise auf das übergeordnete Dokument, damit ein relevanter Abschnitt ohne Verlust seiner Quelle ausgewählt werden kann.
Kontext- und Anfragegrenzen Der aktuelle Herstellerleitfaden nennt maximal 8.000 Token für die Anfrage und insgesamt maximal 32.000 Token für Anfrage plus jedes einzelne Dokument. Er erlaubt bis zu 1.000 Dokumentkandidaten und ein gesamtes Anfragebudget von 600.000 Token, berechnet als Anfrage-Token multipliziert mit der Dokumentanzahl plus alle Dokument-Token. Eine lange Anfrage belegt daher in jedem Paar Platz und trägt wiederholt zum Gesamtbudget bei. Zählen Sie den eingereichten Text mit dem passenden Modell-Tokenizer, statt Zeichen, Wörter und Token als austauschbar zu behandeln.
Beispielsweise ergibt eine Anfrage mit 500 Token und 100 Dokumenten mit jeweils 4.000 Token nach dieser Formel 450.000 Eingabe-Token. Dies veranschaulicht die Budgetplanung, 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 bewusst vor, damit die Kürzung nicht genau die Textstelle entfernt, die Sie zuordnen müssen.
Das Ergebnis lesen und verwenden Die Ergebnisse sind absteigend nach Relevanzwert geordnet. Jedes Ergebnis bezeichnet die ursprüngliche Eingabeposition des Dokuments, sodass die Anwendung ihren eigenen Titel, ihre Datensatzkennung und Quelle anhängen kann. Die Einstellung top_k steuert, wie viele eingeordnete Kandidaten zurückgegeben werden; ohne sie werden alle Kandidaten zurückgegeben. Die REST-Schnittstelle des Herstellers kann auch den Dokumenttext zurückgeben. Erhalten Sie die ursprünglichen Kennungen neben den ausgewählten Ergebnissen, wenn Sie eine Suchseite anzeigen oder Belege an eine Antwortgenerierungsstufe übergeben.
Ein Relevanzwert drückt aus, wie gut ein Kandidat zur Anfrage passt; er belegt nicht die Richtigkeit seiner Aussagen. Vergleichen Sie die höchstplatzierten Elemente mit der tatsächlichen Nutzerfrage, einschließlich Ausschlüssen und Unterschieden zwischen Dokumentversionen. Sind alle Kandidaten irrelevant, gibt es dennoch einen höchstplatzierten Eintrag. Entscheiden Sie anhand repräsentativer Anfragen aus der Sammlung, wie Ihre Anwendung mit diesem Fall umgeht.
Aktualisieren und die Ausgabe auswählen Der Hersteller beschreibt rerank-3-lite als Upgrade von rerank-2.5-lite mit unveränderter API-Semantik und auf die Verteilung des jeweiligen Vorgängers kalibrierten Werten. Erhalten Sie die vorhandene Datensatzzuordnung und Abrufstufe und vergleichen Sie anschließend die entstehende Reihenfolge für aussagekräftige Anfragen, bevor Sie sich auf einen etablierten Schwellenwert verlassen. Verwenden Sie Lite für eine Sucherfahrung, bei der die Antwortzeit zählt; ziehen Sie die qualitätsorientierte Ausgabe rerank-3 zum Vergleich heran, wenn Relevanz bei schwierigen Kandidaten die höhere Priorität hat.
Ailoot Ultra · Neusortierung POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteStart
Voyage rerank-3-lite bewertet Textdokumentkandidaten für eine Suchanfrage und ordnet sie neu, mit Schwerpunkt auf schnellen Suchantworten. 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-Workflows.
- Zulässige Eingaben
- Text
- Ergebnisse
- Nach Relevanz geordnete Ergebnisse
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Neusortierung POST /v1/rerank
- Eingabetypen
text- Ausgabetypen
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 genaue 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 Token | TarifstaffelGrundtarif | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken — / 1K Token Ausgabe · Ausgabetoken — / 1K Token Eingabe · Cache-Lesen — / 1K Token Eingabe · Cache-Schreiben — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde — / 1K Token |
| KonfigurationUltra | Tarifstaffel— | Abrechnungseinheit/ 1K Token | Gebühr Eingabe $0.00004 / 1K Token |
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 beziehen sich 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 sowie 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