VoyageAI by MongoDB: rerank-3
Voyage rerank-3 ist die qualitätsorientierte Rerank-3-Ausgabe zur Bewertung der Relevanz von Anfrage-Dokument-Paaren. Es 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. Ausgehend von einer Anfrage und einer Liste von Dokumentkandidaten untersucht es jedes Paar gemeinsam und gibt die Kandidaten nach Relevanz geordnet zurück. Embeddings und Stichwortsuche können zunächst eine große Sammlung auf eine handhabbare engere Auswahl reduzieren; rerank-3 bewertet anschließend die Relevanz dieser Auswahl genauer. Seine Ausgabe sind bewertete Suchbelege, die eine Anwendung anzeigen oder an einen separaten Antwortgenerierungsschritt 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 Grundnetz und Trainingsmischung, mit besonderen Verbesserungen beim Abruf langer Dokumente und von Quellcode gegenüber den entsprechenden 2.5-Vorgängern. Der Hersteller bewertet das Modell anhand technischer Dokumentation, Code, mehrsprachigen Materials und anderer Dokumentbereiche. Diese Ergebnisse unterstützen seine Abrufrolle; wählen Sie die Ausgabe anhand der Fragen und Dokumentkandidaten aus, die für Ihre eigene Sammlung wichtig sind.
Lange Dokumente mit genügend Kontext Ein langer Kandidat kann weit über seinen ersten Absatz hinaus nützlichen Kontext enthalten. Stellen Sie einen zusammenhängenden Abschnitt oder ein Dokument mit Titel und relevantem umgebendem Material bereit, damit das Modell den Bezug der tatsächlichen Frage zum Inhalt bewerten kann. Erhalten Sie bei einer Suche nach Produktrichtlinien Überschriften und Ausnahmen rund um die interessante Textstelle. Stammen mehrere abgerufene Abschnitte aus derselben Quelle, bewahren Sie ihre Dokument- und Abschnittskennungen; die Anwendung kann dann zeigen, woher die ausgewählten Belege stammen.
Das Kontextfenster wird von der 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 daher höchstens 29.000 Token für jedes Dokument. Bereiten Sie die Eingabe so vor, dass ihr wesentlicher Inhalt hineinpasst, besonders wenn eine lange Einleitung oder wiederholter Standardtext sonst das Fenster belegen würde. Die dokumentierte Kürzungsoption ist standardmäßig aktiviert und kann übergroßen Anfrage- oder Dokumenttext vor der Bewertung kürzen. Prüfen Sie, was erhalten bleibt, wenn die Position einer Textstelle wichtig ist.
Code- und technischer Informationsabruf Für die Abrufstufe eines Programmierassistenten können Kandidaten Funktionsimplementierungen, API-Dokumentation oder technische Erklärungen als Text enthalten. Fügen Sie die zur Unterscheidung ähnlicher Kandidaten nötigen Symbole, Signaturen und Kontextinformationen bei. Eine Anfrage wie „Finde die Funktion, die Pfade normalisiert und dabei ein abschließendes Trennzeichen erhält“ nennt ein konkretes zuzuordnendes Verhalten. Ergänzen Sie relevante Sprach-, Plattform- oder Versionsbedingungen. Untersuchen Sie nach der Rangbildung den ausgewählten Code und seine Abhängigkeiten, bevor Sie ihn als Kontext verwenden; ein Relevanzwert beweist nicht, dass eine Implementierung jede genannte Anforderung erfüllt.
Anweisungen definieren Relevanz Das Modell behält die in Rerank 2.5 eingeführte Fähigkeit zum anweisungsgeführten Reranking bei. Stellen Sie der Anfrage eine kurze Anweisung voran oder hängen Sie sie an, wenn die Nutzerabsicht präzisiert werden muss. Erklären Sie bei der Suche in Forschungsdokumenten, ob der Schwerpunkt auf dem Titel, einer bestimmten Methode oder einem Anwendungsgebiet liegt. Geben Sie für einen internen Katalog an, ob die Anfrage Installation, Fehlerbehebung oder Kompatibilität betrifft. Halten Sie die Anweisung mit der Frage im Einklang; zusätzliche Präferenzen, die der Hauptanfrage widersprechen, können das Optimierungsziel der Rangfolge verändern.
Dokumentkandidaten und Budgets vorbereiten Die Eingabe ist eine Liste von Textzeichenfolgen. Extrahieren Sie nutzbaren Text aus Quelldokumenten, erhalten Sie sinnvolle Abschnittsgrenzen und führen Sie neben der Liste eine geordnete Datensatzzuordnung. Der Hersteller erlaubt bis zu 1.000 Dokumente in einer Anfrage. Außerdem nennt er 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. Weniger redundanter Anfragetext kann sowohl Paarkapazität als auch das gesamte Anfragebudget erhalten.
Zählen Sie Token für das relevante Modell, statt eine Wort- oder Zeichenzahl als Tokenzahl anzunehmen. Wählen Sie bei großen Kandidaten zusammenhängende Textstellen aus oder teilen Sie das Material nach nützlichen Überschriften auf und erhalten Sie Informationen zur übergeordneten Quelle. Reranking ist am nützlichsten, nachdem die erste Suche bereits plausible Kandidaten gefunden hat: Es kann keine fehlende Quelle einordnen, die nie in die Liste gelangt ist.
Eingeordnete Ergebnisse und nachgelagerte Nutzung Das Ergebnis enthält Relevanzwerte und Indizes, die auf die ursprünglichen Eingabedokumente verweisen, absteigend nach Relevanz sortiert. Die Option top_k begrenzt die Zahl zurückgegebener Ergebnisse; andernfalls werden alle Eingabekandidaten zurückgegeben. Die REST-Schnittstelle des Herstellers erlaubt auch die Aufnahme des Dokumenttexts. Verwenden Sie jeden ursprünglichen Index, um Titel, Quellenkennung und von Ihrer Anwendung benötigte Metadaten wiederzuerlangen, und zeigen Sie anschließend die ausgewählten Elemente an oder fügen Sie den relevanten Text in den Belegkontext einer Antwort ein.
Prüfen Sie die obersten Ergebnisse anhand der Frage und halten Sie die Quellenidentität sichtbar. Ein hoher relativer Rang verifiziert nicht die sachliche Richtigkeit eines Dokuments; auch eine engere Auswahl ausschließlich schlechter Kandidaten hat einen ersten Eintrag. Trennen Sie die Relevanzauswahl von der Entscheidung, ob die ausgewählten Belege zur Beantwortung der Nutzerfrage ausreichen.
Migration zwischen Ausgaben Der Hersteller beschreibt rerank-3 als direkt einsetzbaren Nachfolger von rerank-2.5, mit derselben API-Semantik und auf die Verteilung des entsprechenden Vorgängers kalibrierten Werten. Diese Kompatibilität unterstützt den Erhalt einer bestehenden Abrufstufe und Datensatzzuordnung. Vergleichen Sie aussagekräftige Ergebnisreihenfolgen und jeden Schwellenwert auf dem aktuellen Korpus, bevor Sie sich auf die Migration verlassen. Halten Sie rerank-3 und rerank-3-lite als eigenständige Optionen: 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-3Start
Voyage rerank-3 ist die qualitätsorientierte Rerank-3-Ausgabe zur Bewertung der Relevanz von Anfrage-Dokument-Paaren. Es 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
- 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 | 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.0001 / 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",
"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 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
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