VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite bewertet und ordnet Textdokumentkandidaten für eine Suchanfrage neu, mit Schwerpunkt auf einer reaktionsschnellen Suche. Es unterstützt Relevanzanweisungen und ein Anfrage-Dokument-Fenster von 32’000 Token und eignet sich damit nach Vektor- oder Schlüsselwortabruf 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 von Voyages Rerank-3-Serie. Es nimmt eine Textanfrage und Dokumentkandidaten entgegen, bewertet jedes Anfrage-Dokument-Paar gemeinsam und liefert Relevanzwerte in Rangfolge zurück. Es dient der zweiten Suchstufe: Ein Embedding- oder Schlüsselwortabruf findet die Kandidaten, anschliessend verfeinert Lite ihre Reihenfolge. Das Ergebnis ist eine Rangfolge für die Suche oder einen retrievalgestützten Generierungsablauf.
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 bewahren Anweisungsbefolgung und dieselbe 32K-Kontextklasse; Lite ist dabei für latenzempfindliche Anwendungen ausgelegt. Das macht es zu einem praktischen Kandidaten für interaktive Wissensdatenbanksuche, den Abruf von Supportdokumenten und Codesuche, wenn Nutzende schnell relevante Ergebnisse brauchen. 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 Anfrage steuern Natürlichsprachliche Anweisungen können die Anfrage ergänzen und erklären, was als relevant gilt. Halten Sie Frage und Relevanzpräferenz knapp und widerspruchsfrei. Für eine Softwaresupportsuche verwenden Sie etwa: «Finde das Verfahren zum Zurücksetzen eines Geräts; bevorzuge Anweisungen für die angegebene Hardwareversion.» Bei einem mehrdeutigen Produktnamen ergänzen Sie die Produktkategorie, damit unverbundene Bedeutungen nicht überwiegen. Eine Präferenz in der Anfrage lenkt 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 kurze Liste von Textkandidaten vorbereiten Die Eingabedokumente sind Zeichenfolgen. Extrahieren Sie lesbaren Text aus dem Quellmaterial und bewahren Sie hilfreiche Titel, Überschriften, Kennungen und umgebenden Kontext. Halten Sie eine stabile Zuordnung jeder Eingabeposition zum ursprünglichen Datensatz. Bei einem Fehlerbehebungsartikel fügen Sie Symptom und relevantes Vorgehen hinzu, nicht nur einen losgelösten Satz. Bei einer Quellcodesuche liefern Sie die Funktion und die umliegenden Informationen, die sie von ähnlich benannten Funktionen unterscheiden. Entfernen Sie wiederholte Navigation oder Standardtexte, wenn diese die hilfreiche Passage 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 Vorauswahl als auch die endgültige Reihenfolge, wenn ein Ergebnis falsch erscheint. Behandelt ein langes Dokument viele Themen, trennen Sie zusammenhängende Abschnitte und bewahren ihre Verweise auf das übergeordnete Dokument, damit sich ein relevanter Abschnitt ohne Verlust seiner Quelle auswählen lässt.
Kontext- und Anfragegrenzen Der aktuelle Herstellerleitfaden legt maximal 8’000 Token für die Anfrage und insgesamt maximal 32’000 Token für die Anfrage plus jedes einzelne Dokument fest. Er erlaubt bis zu 1’000 Dokumentkandidaten und ein Gesamtbudget von 600’000 Token pro Anfrage, berechnet als Anfrage-Token multipliziert mit Dokumentanzahl plus alle Dokument-Token. Eine lange Anfrage beansprucht deshalb 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.
Eine Anfrage mit 500 Token und 100 Dokumenten zu je 4’000 Token ergibt nach dieser Formel beispielsweise 450’000 Eingabe-Token. Das veranschaulicht die Budgetierung und ist keine empfohlene Vorauswahlgrösse oder gemessene Geschwindigkeitsaussage. Die dokumentierte Kürzungsoption ist standardmässig aktiviert; übergrosser Text kann vor der Bewertung gekürzt werden. Bereiten Sie wichtige Abschnitte gezielt vor, damit die Kürzung nicht gerade die abzugleichende Passage entfernt.
Das Ergebnis lesen und verwenden Die Ergebnisse sind vom höchsten Relevanzwert abwärts sortiert. Jedes Ergebnis nennt die ursprüngliche Eingabeposition des Dokuments, sodass die Anwendung ihren eigenen Titel, ihre Datensatzkennung und Quelle zuordnen kann. Die Einstellung top_k steuert, wie viele geordnete Kandidaten zurückgegeben werden; ohne sie werden alle Kandidaten zurückgegeben. Die REST-Schnittstelle des Herstellers kann auch den Dokumenttext zurückgeben. Bewahren Sie die ursprünglichen Kennungen bei den ausgewählten Ergebnissen, wenn Sie eine Suchseite anzeigen oder Belege an einen Antwortgenerierungsschritt übergeben.
Ein Relevanzwert drückt aus, wie gut ein Kandidat zur Anfrage passt; er belegt nicht, dass dessen Aussagen richtig sind. Vergleichen Sie die höchstplatzierten Elemente mit der tatsächlichen Nutzerfrage, einschliesslich Ausschlüssen und Unterschieden zwischen Dokumentversionen. Sind alle Kandidaten irrelevant, gibt es dennoch ein höchstplatziertes Element. Entscheiden Sie anhand repräsentativer Anfragen aus der Sammlung, wie Ihre Anwendung diesen Fall behandelt.
Aktualisierung und Auswahl der Ausgabe Der Hersteller beschreibt rerank-3-lite als Aktualisierung von rerank-2.5-lite mit unveränderter API-Semantik und auf die Verteilung des entsprechenden Vorgängers kalibrierten Werten. Bewahren Sie die bestehende Datensatzzuordnung und Abrufstufe und vergleichen Sie die resultierende Reihenfolge bei aussagekräftigen Anfragen, bevor Sie sich auf einen etablierten Schwellenwert verlassen. Verwenden Sie Lite für ein Sucherlebnis, bei dem Antwortzeit zählt; ziehen Sie die qualitätsorientierte Ausgabe rerank-3 zum Vergleich heran, wenn 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 Textdokumentkandidaten für eine Suchanfrage neu, mit Schwerpunkt auf einer reaktionsschnellen Suche. Es unterstützt Relevanzanweisungen und ein Anfrage-Dokument-Fenster von 32’000 Token und eignet sich damit nach Vektor- oder Schlüsselwortabruf 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 |
|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken — / 1K Tokens Ausgabe · Ausgabetoken — / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · Cache schreiben — / 1K Tokens Eingabe · 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 abschliessenden 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 das ursprüngliche Dokumentobjekt bleiben erhalten. Die Indizes verweisen auf das ursprüngliche Dokumentarray. Das vollständige 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