VoyageAI by MongoDB: rerank-3
Voyage rerank-3 ist die qualitätsorientierte Rerank-3-Ausgabe zur Bewertung der Relevanz von Anfrage-Dokument-Paaren. Sie ordnet abgerufene Textkandidaten neu, unterstützt natürlichsprachliche Relevanzanweisungen und verarbeitet Paare mit 32.000 Token für die Suche in langen Dokumenten, Code und Wissensbasen.
Ü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 ist ein Text-Reranker zur Verbesserung der Qualität abgerufener Belege. Es erhält eine Anfrage und eine Liste von Kandidatendokumenten, untersucht jedes Paar gemeinsam und gibt die Kandidaten nach Relevanz geordnet zurück. Embeddings und Stichwortsuche können eine große Sammlung zunächst auf eine handhabbare engere Auswahl begrenzen; rerank-3 bewertet deren Relevanz anschließend detaillierter. Seine Ausgabe sind bewertete Suchbelege, die eine Anwendung anzeigen oder an eine separate Antwortgenerierungsstufe weitergeben kann.
Qualitätsorientiertes Rerank 3 Der Hersteller positioniert rerank-3 als genauigkeitsorientierte Ausgabe und rerank-3-lite als Ausgabe für latenzempfindliche Suche. Die dritte Generation aktualisiert Grundarchitektur und Trainingsmischung, mit besonderen Verbesserungen beim Abruf langer Dokumente und von Quellcode gegenüber den jeweiligen 2.5-Vorgängern. Der Anbieter bewertet das Modell anhand von technischer Dokumentation, Code, mehrsprachigem Material und anderen Dokumentbereichen. Diese Ergebnisse stützen seine Abrufrolle; wählen Sie die Ausgabe anhand der Fragen und Kandidatendokumente, die für Ihre eigene Sammlung wichtig sind.
Lange Dokumente mit genügend Kontext Ein langer Kandidat kann weit über seinen einleitenden Absatz hinaus hilfreichen Kontext enthalten. Stellen Sie einen zusammenhängenden Abschnitt oder ein Dokument mit Titel und relevantem umgebendem Material bereit, damit das Modell beurteilen kann, wie die tatsächliche Frage zum Inhalt passt. Bewahren Sie bei einer Suche nach Produktrichtlinien die Überschriften und Ausnahmen rund um die betreffende Textstelle. Stammen mehrere abgerufene Abschnitte aus derselben Quelle, behalten Sie Dokument- und Abschnittskennungen bei; die Anwendung kann dann zeigen, woher die ausgewählten Belege stammen.
Das Kontextfenster wird von Anfrage und jedem Kandidaten gemeinsam genutzt. Der aktuelle Herstellerleitfaden nennt 32.000 Token für dieses Paar, einschließlich einer Anfrage mit höchstens 8.000 Token. Eine Anfrage mit 3.000 Token lässt somit höchstens 29.000 Token für jedes Dokument übrig. Bereiten Sie die Eingabe so vor, dass ihre wesentlichen Inhalte hineinpassen, besonders wenn eine lange Einleitung oder wiederholte Standardtexte sonst das Fenster belegen würden. Die dokumentierte Kürzungsoption ist standardmäßig aktiviert und kann übergroße Anfrage- oder Dokumenttexte vor der Bewertung kürzen. Prüfen Sie, was erhalten bleibt, wenn die Position einer Textstelle wichtig ist.
Code und technischer Abruf Für die Abrufstufe eines Programmierassistenten können Kandidaten Funktionsimplementierungen, API-Dokumentation oder technische Erklärungen als Text enthalten. Ergänzen Sie die Symbole, Signaturen und den Kontext, die zur Unterscheidung ähnlicher Kandidaten nötig sind. Eine Anfrage wie „Finde die Funktion, die Pfade normalisiert und dabei ein abschließendes Trennzeichen beibehält“ nennt ein konkretes abzugleichendes Verhalten. Fügen Sie relevante Sprach-, Plattform- oder Versionsbedingungen hinzu. Prüfen Sie nach dem Ranking den ausgewählten Code und seine Abhängigkeiten, bevor Sie ihn als Kontext verwenden; ein Relevanzwert belegt nicht, dass eine Implementierung jede genannte Anforderung erfüllt.
Anweisungen definieren Relevanz Das Modell behält die mit Rerank 2.5 eingeführte Fähigkeit zum anweisungsbasierten Reranking bei. Stellen Sie der Anfrage eine knappe Anweisung voran oder hängen Sie sie an, wenn die Nutzerabsicht präzisiert werden muss. Erklären Sie bei der Suche nach Forschungsdokumenten, ob Titel, eine bestimmte Methode oder ein Anwendungsbereich im Mittelpunkt stehen. Geben Sie für einen internen Katalog an, ob die Anfrage Installation, Fehlerbehebung oder Kompatibilität betrifft. Halten Sie diese Anweisung mit der Frage im Einklang; zusätzliche Präferenzen, die der Hauptanfrage widersprechen, können verändern, was das Ranking zu optimieren versucht.
Kandidatendokumente und Budgets vorbereiten Die Eingabe ist eine Liste von Textzeichenfolgen. Extrahieren Sie verwendbaren Text aus Quelldokumenten, bewahren Sie sinnvolle Abschnittsgrenzen und halten Sie neben der Liste eine geordnete Datensatzzuordnung vor. Der Hersteller erlaubt bis zu 1.000 Dokumente in einer Anfrage. Er nennt außerdem eine gesamte Eingabeobergrenze von 600.000 Token: Anfrage-Token multipliziert mit der Dokumentanzahl plus die Summe aller Dokument-Token. Dies unterscheidet sich von der Kontextgrenze pro Paar. Das Reduzieren redundanten Anfragetexts kann sowohl Paarkapazität als auch Gesamtbudget der Anfrage bewahren.
Zählen Sie Token für das betreffende Modell, statt Wort- oder Zeichenzahl mit Tokenzahl gleichzusetzen. Wählen Sie bei großen Kandidaten zusammenhängende Textstellen aus oder teilen Sie das Material nach hilfreichen Überschriften auf und behalten Sie Angaben zur übergeordneten Quelle bei. Reranking ist am hilfreichsten, nachdem die erste Suche bereits plausible Kandidaten gefunden hat: Es kann keine fehlende Quelle reihen, die nie in die Liste gelangt ist.
Gereihte Ergebnisse und nachgelagerte Nutzung Das Ergebnis enthält Relevanzwerte und Indizes, die sich auf die ursprünglichen Eingabedokumente beziehen, sortiert in absteigender Relevanzreihenfolge. Die Option top_k begrenzt die Anzahl der zurückgegebenen gereihten Ergebnisse; andernfalls werden alle Eingabekandidaten zurückgegeben. Die REST-Schnittstelle des Herstellers erlaubt außerdem, den Dokumenttext einzuschließen. Verwenden Sie jeden ursprünglichen Index, um Titel, Quellenkennung und alle von Ihrer Anwendung benötigten Metadaten wiederzufinden, und zeigen Sie anschließend die ausgewählten Elemente an oder nehmen Sie den relevanten Text in den Belegkontext einer Antwort auf.
Prüfen Sie die besten Ergebnisse anhand der Frage und halten Sie die Quellenidentität sichtbar. Ein hoher relativer Rang bestätigt nicht die sachliche Richtigkeit eines Dokuments, und eine engere Auswahl ausschließlich schlechter Kandidaten hat trotzdem ein erstes Element. Trennen Sie die Relevanzauswahl von der Entscheidung, ob die ausgewählten Belege zur Beantwortung der Nutzerfrage ausreichen.
Wechsel der Ausgabe Der Hersteller beschreibt rerank-3 als direkt einsetzbaren Nachfolger von rerank-2.5 mit derselben API-Semantik und Werten, die auf die Verteilung des jeweiligen Vorgängers kalibriert sind. Diese Kompatibilität unterstützt das Beibehalten einer vorhandenen Abrufstufe und Datensatzzuordnung. Vergleichen Sie aussagekräftige Ergebnisreihenfolgen und jeden Schwellenwert anhand des aktuellen Korpus, bevor Sie sich auf den Wechsel verlassen. Halten Sie rerank-3 und rerank-3-lite als getrennte Auswahlmöglichkeiten bei: Gemeinsame Grenzen und das Befolgen von Anweisungen machen ihre Qualitäts- und Latenzprioritäten nicht identisch.
Ailoot Ultra · Neusortierung POST /v1/rerank voyageai/rerank-3
voyageai/rerank-3Einstieg
Voyage rerank-3 ist die qualitätsorientierte Rerank-3-Ausgabe zur Bewertung der Relevanz von Anfrage-Dokument-Paaren. Sie ordnet abgerufene Textkandidaten neu, unterstützt natürlichsprachliche Relevanzanweisungen und verarbeitet Paare mit 32.000 Token für die Suche in langen Dokumenten, Code und Wissensbasen.
- 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 | 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.0001 / 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",
"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
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
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · VoyageAI by MongoDB: rerank-3
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/rerank·voyageai/rerank-3:text→rerank- Welche Felder verwendet die Anfrage?
POST /v1/rerank·voyageai/rerank-3:documents,model,provider,query,session_id,top_n,trace,user- Welche Grenzen gelten?
POST /v1/rerank·voyageai/rerank-3:top_n.minimum:1