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 mehrsprachiges Relevanzmodell auf Grundlage von BGE-M3. Es verarbeitet eine Anfrage und eine Kandidatenpassage gemeinsam und gibt einen Wert für ihre Beziehung zurück. BAAI positioniert diese Version als effizienten mehrsprachigen Reranker, auch für chinesische und englische Informationssuche, wenn eine Suchanwendung eine vorhandene Kandidatenliste verfeinern muss.
Relevanz aus einem Anfrage-Passage-Paar
Ein Cross-Encoder verarbeitet beide Texte gemeinsam, sodass ihre Inhalte vor der Ermittlung des Relevanzwerts miteinander interagieren können. Dies unterscheidet ihn von einem Embedding-Modell, das Texte unabhängig für wiederverwendbare Vektorvergleiche codiert. Der Reranker gibt einen skalaren Wert für ein bestimmtes Paar aus, keinen Dokumentvektor und keine schriftliche 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. Dadurch konzentriert sich der detailliertere Vergleich auf eine überschaubare Auswahl, statt einen Cross-Encoder jede Passage einer grossen Sammlung prüfen zu lassen.
Die Version v2 M3
Der Hersteller nennt BGE-M3 als Basismodell und Mehrsprachigkeit als Hauptmerkmal. Innerhalb seiner v2-Reranker-Familie ist M3 die effiziente mehrsprachige Option; die Gemma-basierten Varianten und Varianten mit Ebenenauswahl sind eigenständige Modelle mit anderen Implementierungsentscheidungen. Der Name M3 bedeutet hier nicht, dass der Reranker die dichten, dünn besetzten und Multi-Vektor-Embeddings des ursprünglichen Embedding-Modells zurückgibt.
Diese Unterscheidung ist bei der Wahl des von Ihrer Anwendung benötigten Ergebnisses wichtig. Wählen Sie ein Embedding-Modell, um eine Dokumentensammlung darzustellen und zu durchsuchen. Wählen Sie diesen Reranker, wenn bereits Kandidatentexte vorliegen und entschieden werden soll, welche Passage für die aktuelle Anfrage am relevantesten ist.
Kandidaten für eine sinnvolle Rangfolge vorbereiten
Stellen Sie die tatsächliche Frage und den vollständigen, für ihre Interpretation benötigten Kandidatentext bereit. 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. Dies ist eine Beispieleinstellung, keine modellweite Grenze. Halten Sie Frage und erforderliche Belege innerhalb des gewählten Paarbudgets und prüfen Sie, was durch Kürzung entfernt wird. Ein Ergebnis, das dasselbe Produkt wie die 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 für einen Dokumentassistenten die Kandidatenkennungen zusammen mit den Texten auf, bewerten Sie die Frage-Passage-Paare und geben Sie die ausgewählten Originalpassagen an den Antwortschritt weiter. Das Antwortmodell erhält so 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 bedeutet eine engere Übereinstimmung. Die dokumentierte optionale Normalisierung verwendet eine Sigmoidfunktion, um den Wert zwischen 0 und 1 abzubilden. Ein normalisierter Wert hat einen praktischen Bereich, doch diese Transformation allein begründet keine kalibrierte Wahrscheinlichkeit, dass der Kandidat korrekt ist.
Wählen Sie Schwellenwerte für Rangfolge oder Filterung anhand repräsentativer Anfrage-Passage-Paare aus Ihrer Arbeitslast. Berücksichtigen Sie sowohl Passagen mit gemeinsamen Schlüsselwörtern, die eine andere Frage beantworten, als auch relevante Passagen mit anderen Formulierungen. Dadurch erhält der gewählte Schwellenwert Bedeutung für die durchsuchte Sammlung.
Definieren Sie für ein Ailoot-API-Projekt den Inhalt des endgültigen Kontexts und die Anzahl effizient prüfbarer Kandidaten. Das nutzbare Ergebnis ist ein besser geordneter Belegsatz für den nächsten Anwendungsschritt. Trennen Sie die Relevanzausgabe dieser Version von Dokument-Embeddings, generiertem Fliesstext und den für andere Reranker dokumentierten Reglern zur Ebenenauswahl.
Ailoot Ultra · Neusortierung POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3Einstieg
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
- Eingabe
text- Ausgabe
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 |
|---|---|---|---|
| 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 |
| KonfigurationGesamttoken | Tarifstaffel— | Abrechnungseinheit/ 1K Tokens | Gebühr Eingabe · Gesamttoken $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
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, Dokumentzeichenketten und nativem Tokenverbrauch. 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; reichen Sie eine Erstellung mit unklarem Ausgang niemals erneut ein.
Antwortfelder
| Feld | Typ | Bedeutung |
|---|---|---|
Feldmodel | Typstring | BedeutungExaktes Antwortmodell, das der konfigurierte Verarbeiter im Quellcode benötigt. |
Feldresults[].index | Typinteger | BedeutungEindeutiger Index des ursprünglichen Eingabedokuments. |
Feldresults[].relevance_score | Typnumber | BedeutungEndlicher Relevanzwert. |
Feldresults[].document | Typstring | BedeutungUrsprüngliches Textdokument, das der konfigurierte Antwortverarbeiter benötigt. |
Feldusage.total_tokens | Typinteger | BedeutungEndliche, nicht negative native Tokenanzahl, die der derzeit akzeptierte Tarif verlangt. |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungDer JSON-Anfragetext oder die explizite kanonische Modell-ID ist ungültig. | Nächster SchrittBewahren Sie die Antwort auf und korrigieren Sie das angegebene Anfragefeld. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel von Ailoot ist ungültig. | Nächster SchrittVerwenden Sie Ihren autorisierten API-Schlüssel von Ailoot. |
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 | BedingungFür die ausgewählte Methode gibt es keine zugelassene Route. | Nächster SchrittBewahren Sie die zurückgegebenen Fehlerdetails auf. |
Antwort422 · price_unavailable | BedingungFür den akzeptierten Tarif lässt sich 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 ist nicht verfügbar. | Nächster SchrittBewahren Sie die vollständige ursprüngliche Antwort auf. Eine Reservierung mit unklarem Zustand ist keine Erlaubnis zum erneuten Einreichen. |
Antwort502 · billing_requires_check | BedingungDas ursprüngliche Ergebnis, der Verbrauch oder die Abrechnung muss geprüft werden. | Nächster SchrittBewahren Sie die tatsächliche Anfrage-ID und die ursprüngliche Antwort auf. Lesen Sie den bestehenden, Ihnen zugeordneten Eintrag; reichen Sie die Erstellung nicht erneut ein. |
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