bge-reranker-v2-m3
BAAIs mehrsprachiger Cross-Encoder zur Bewertung möglicher Textpassagen anhand einer Abfrage. Er liest jedes Paar aus Abfrage und Passage gemeinsam und gibt einen Relevanzwert zurück, um eine engere Suchauswahl zu verfeinern, ohne eine Antwort zu erzeugen oder Dokument-Embeddings zu erstellen.
Ü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.
BGE Reranker v2 M3 ist ein auf BGE-M3 aufgebautes mehrsprachiges Relevanzmodell. Es erhält gemeinsam eine Suchanfrage und eine potenziell passende Passage und gibt einen Wert für deren Beziehung zurück. BAAI positioniert diese Edition als effizienten mehrsprachigen Reranker, auch für chinesisch- und englischsprachige Suche, bei der eine Suchanwendung eine bestehende Kandidatenliste verfeinern muss.
Relevanz aus einem Anfrage-Passage-Paar
Ein Cross-Encoder verarbeitet beide Texte gemeinsam, sodass ihre Inhalte miteinander interagieren können, bevor der Relevanzwert erzeugt wird. Das unterscheidet ihn von einem Embedding-Modell, das Texte unabhängig voneinander für wiederverwendbare Vektorvergleiche kodiert. Die Ausgabe des Rerankers ist ein skalarer Wert für ein bestimmtes Paar statt eines Dokumentvektors oder einer schriftlichen Antwort.
Verwenden Sie das Modell, nachdem eine erste Suche plausible Passagen ausgewählt hat. Kombinieren Sie die Frage mit jedem Kandidaten und ordnen Sie die Kandidaten nach den erhaltenen Werten. Damit konzentriert sich der detailliertere Vergleich auf eine überschaubare Vorauswahl, statt einen Cross-Encoder jede Passage einer großen Sammlung untersuchen zu lassen.
Die Edition v2 M3
Der Hersteller nennt BGE-M3 als Basismodell und mehrsprachige Unterstützung als ein Hauptmerkmal. Innerhalb seiner v2-Reranker-Familie ist M3 die effiziente mehrsprachige Option; die Gemma-basierten Varianten und Varianten mit Layer-Auswahl sind eigenständige Modelle mit anderen Implementierungsentscheidungen. Der Name M3 bedeutet hier nicht, dass der Reranker die Dense-, Sparse- und Multi-Vektor-Embeddings des ursprünglichen Embedding-Modells zurückgibt.
Diese Unterscheidung ist wichtig bei der Auswahl des von Ihrer Anwendung benötigten Ergebnisses. Wählen Sie ein Embedding-Modell, um eine Dokumentensammlung zu repräsentieren und zu durchsuchen. Wählen Sie diesen Reranker, wenn bereits Kandidatentexte vorliegen und Sie entscheiden müssen, welche Passage für die aktuelle Anfrage am relevantesten ist.
Kandidaten für eine sinnvolle Rangfolge vorbereiten
Geben Sie die tatsächliche Frage und den vollständigen Kandidatentext an, der zu ihrer Interpretation nötig ist. Bewahren Sie Überschriften oder benachbarte Definitionen, wenn sie die Bedeutung einer Passage bestimmen. Im veröffentlichten Transformers-Beispiel werden Anfrage und Passage gemeinsam mit Kürzung und max_length=512 tokenisiert. Das ist eine Beispieleinstellung und keine modellweite Grenze. Halten Sie Frage und benötigte Belege innerhalb des gewählten Paarbudgets und prüfen Sie, was die Kürzung entfernt. Ein Ergebnis, das dasselbe Produkt wie eine Anfrage nennt, kann dennoch irrelevant sein, wenn es die falsche Operation oder Bedingung behandelt; bereiten Sie bei der Bewertung der Suchqualität Beispiele vor, die solche Fälle unterscheiden.
Bewahren Sie bei einem Dokumentassistenten die Kandidatenkennungen zusammen mit ihren Texten auf, bewerten Sie die Frage-Passage-Paare und geben Sie die ausgewählten Originalpassagen an den Antwortschritt weiter. Das antwortende Modell erhält dann die Belege statt eines Relevanzwerts ohne Quelle. Dies ist ein beispielhafter Suchablauf; der Reranker selbst durchsucht weder eine externe Sammlung noch schreibt er die Antwort.
Werte lesen und normalisieren
Der Hersteller gibt rohe Relevanzwerte zurück; ein höherer Wert weist auf eine engere Übereinstimmung hin. Seine dokumentierte optionale Normalisierung verwendet eine Sigmoidfunktion, um den Wert zwischen 0 und 1 abzubilden. Ein normalisierter Wert hat einen praktischen Wertebereich, doch diese Umwandlung allein begründet keine kalibrierte Wahrscheinlichkeit dafür, dass der Kandidat korrekt ist.
Wählen Sie Schwellenwerte für Rangfolge oder Filterung anhand repräsentativer Anfrage-Passage-Paare aus Ihrer Arbeitslast. Nehmen Sie sowohl Passagen auf, die Schlüsselwörter teilen, aber eine andere Frage beantworten, als auch relevante Passagen mit abweichenden Formulierungen. So erhält der gewählte Schwellenwert eine sinnvolle Bedeutung für die durchsuchte Sammlung.
Definieren Sie für ein Ailoot-API-Projekt, was der abschließende Kontext enthalten soll und wie viele Kandidaten sich effizient prüfen lassen. Das nützliche Ergebnis ist eine besser geordnete Belegsammlung für den nächsten Anwendungsschritt. Halten Sie die Relevanzausgabe dieser Edition getrennt von Dokument-Embeddings, erzeugter Prosa und den für andere Reranker dokumentierten Steuerelementen zur Layer-Auswahl.
Ailoot Ultra · Neusortierung POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3Start
BAAIs mehrsprachiger Cross-Encoder zur Bewertung möglicher Textpassagen anhand einer Abfrage. Er liest jedes Paar aus Abfrage und Passage gemeinsam und gibt einen Relevanzwert zurück, um eine engere Suchauswahl zu verfeinern, ohne eine Antwort zu erzeugen oder Dokument-Embeddings zu erstellen.
- 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
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits bge-reranker-v2-m3 | Standard— |
Feldquery | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Felddocuments | Typarray | AnforderungErforderlich | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, documents |
Parametermaterial_types | Vertragtext |
Parametermaterial_conditions | VertragGeben Sie Ihre tatsächliche Suchanfrage und ein nicht leeres Array der ursprünglichen Textdokumente an. Die Ergebnisindizes beziehen sich auf dieses ursprüngliche Array. |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
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 |
| KonfigurationGesamttoken | Tarifstaffel— | Abrechnungseinheit/ 1K Token | Gebühr Eingabe · Gesamttoken $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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_QUERY:?Set the actual documented input value}"
export AILOOT_QUERY
: "${AILOOT_DOCUMENTS_JSON:?Set the actual documented input value}"
export AILOOT_DOCUMENTS_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'bge-reranker-v2-m3', 'query': '${ACTUAL_QUERY}', 'documents': '${ACTUAL_DOCUMENTS}'}
request['query']=os.environ['AILOOT_QUERY']
request['documents']=json.loads(os.environ['AILOOT_DOCUMENTS_JSON'])
Path('request.json').write_text(json.dumps(request,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 response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Ergebnisse abrufen und speichern
Ailoot Ultra · Neusortierung
Vollständiges ursprüngliches natives JSON-Ergebnis mit dem konfigurierten Antwortmodell, ursprünglichen Dokumentindizes, Relevanzwerten, Dokumentzeichenfolgen und nativen Tokenverbrauchsdaten. Bewahren Sie jedes tatsächliche Ergebnis- und Verbrauchsfeld auf.
GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie die tatsächliche X-Client-Request-ID und die vollständige Antwort auf. Lesen Sie die ursprünglichen, Ihnen zugeordneten Assets und ihre exakten signierten Inhalts-URLs aus; übermitteln Sie eine Erstellung mit unklarem Ausgang niemals erneut.
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldmodel | Typstring | BedeutungExaktes Antwortmodell, das der konfigurierte Quellverarbeiter benötigt. |
Feldresults[].index | Typinteger | BedeutungEindeutiger Index des ursprünglichen Eingabedokuments. |
Feldresults[].relevance_score | Typnumber | BedeutungEndlicher Relevanzwert. |
Feldresults[].document | Typstring | BedeutungUrsprüngliches Textdokument, das dieser konfigurierte Antwortverarbeiter benötigt. |
Feldusage.total_tokens | Typinteger | BedeutungEndliche, nicht negative native Tokenzahl, die der aktuell akzeptierte Tarif erfordert. |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungDer JSON-Inhalt oder die ausdrücklich angegebene kanonische Modell-ID ist ungültig. | Nächster SchrittBewahren Sie die Antwort auf und korrigieren Sie das angegebene Anfragefeld. |
Antwort401 · authentication_error | BedingungDer Ailoot-API-Schlüssel ist ungültig. | Nächster SchrittVerwenden Sie Ihren autorisierten Ailoot-API-Schlüssel. |
Antwort403 · permission_error | BedingungDie Schlüsselgruppe lässt diese Methode nicht zu. | Nächster SchrittBewahren Sie die zurückgegebenen Fehlerdetails auf. |
Antwort404 · not_found_error | BedingungDie ausgewählte Methode hat keine zugelassene Route. | Nächster SchrittBewahren Sie die zurückgegebenen Fehlerdetails auf. |
Antwort422 · price_unavailable | BedingungDer akzeptierte Tarif kann die erforderliche Eingabemenge oder deren Grenze nicht ermitteln. | Nächster SchrittBewahren Sie die Antwort auf; verwenden Sie die vom akzeptierten Tarif verlangte Eingabedarstellung. |
Antwort503 · | BedingungErforderlicher Speicher, Route, Methodenpreis oder Reservierung sind nicht verfügbar. | Nächster SchrittBewahren Sie die vollständige ursprüngliche Antwort auf. Eine unklare Reservierung berechtigt nicht zur erneuten Übermittlung. |
Antwort502 · billing_requires_check | BedingungDas ursprüngliche Ergebnis, der Verbrauch oder die Abrechnung müssen geprüft werden. | Nächster SchrittBewahren Sie die tatsächliche Anfrage-ID und die ursprüngliche Antwort auf. Lesen Sie den vorhandenen, Ihnen zugeordneten Datensatz aus; übermitteln Sie die Erstellung nicht erneut. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra bge-reranker-v2-m3
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · bge-reranker-v2-m3
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- Welche Felder verwendet die Anfrage?
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents