bge-reranker-v2-m3
Vícejazyčný cross-encoder od BAAI pro řazení kandidátních pasáží podle dotazu. Čte společně každou dvojici dotazu a pasáže a vrací skóre relevance, čímž zpřesňuje užší výběr výsledků vyhledávání, aniž by generoval odpověď nebo vytvářel embeddingy dokumentů.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
BGE Reranker v2 M3 je vícejazyčný model relevance postavený na BGE-M3. Přijímá společně dotaz a kandidátní pasáž a vrací skóre jejich vztahu. BAAI tuto variantu představuje jako úsporný vícejazyčný reranker, mimo jiné pro vyhledávání v čínštině a angličtině, kde vyhledávací aplikace potřebuje zpřesnit existující seznam kandidátů.
Relevance dvojice dotazu a pasáže
Cross-encoder zpracovává oba texty společně, takže jejich obsah může před vytvořením skóre relevance vzájemně působit. Tím se liší od embeddingového modelu, který texty kóduje nezávisle pro opakovaně použitelné vektorové porovnávání. Výstupem rerankeru je skalární skóre konkrétní dvojice, nikoli vektor dokumentu nebo písemná odpověď.
Model použijte až poté, co počáteční vyhledávání vybere pravděpodobně relevantní pasáže. Otázku spárujte s každým kandidátem a kandidáty seřaďte podle výsledných skóre. Podrobnější porovnávání se tak soustředí na zvládnutelný užší výběr místo toho, aby cross-encoder zkoumal všechny pasáže rozsáhlé kolekce.
Varianta v2 M3
Výrobce označuje BGE-M3 za základní model a mezi hlavními vlastnostmi uvádí vícejazyčnou podporu. V rodině rerankerů v2 je M3 úspornou vícejazyčnou volbou; varianty založené na Gemma a varianty s výběrem vrstev představují samostatné modely s odlišnými implementačními řešeními. Název M3 zde neznamená, že reranker vrací husté, řídké a vícevektorové embeddingy původního embeddingového modelu.
Tento rozdíl je důležitý při volbě výsledku, který aplikace vyžaduje. Pro reprezentaci a prohledávání kolekce dokumentů zvolte embeddingový model. Tento reranker zvolte, pokud už máte kandidátní text a potřebujete rozhodnout, která pasáž je pro aktuální dotaz nejrelevantnější.
Příprava kandidátů pro užitečné řazení
Dodejte skutečnou otázku a úplný kandidátní text potřebný pro její interpretaci. Zachovejte nadpisy nebo blízké definice, pokud určují význam pasáže. Ve zveřejněném příkladu Transformers se dotaz a pasáž tokenizují společně s ořezáváním a max_length=512. Jde o nastavení příkladu, nikoli limit platný pro celý model. Otázku a potřebné důkazy udržte v rámci zvoleného rozpočtu dvojice a zkontrolujte, co ořezávání odstraňuje. Výsledek zmiňující stejný produkt jako dotaz může být stále nerelevantní, pokud řeší jinou operaci nebo podmínku; při hodnocení kvality vyhledávání připravte příklady, které tyto situace odlišují.
U dokumentového asistenta uchovávejte identifikátory kandidátů společně s jejich textem, ohodnoťte dvojice otázky a pasáže a vybrané původní pasáže předejte kroku vytvářejícímu odpověď. Model vytvářející odpověď pak obdrží důkazy namísto samotného skóre relevance bez zdroje. Jde o ukázkový postup vyhledávání; reranker sám neprohledává externí kolekci ani nepíše odpověď.
Čtení a normalizace skóre
Výrobce vrací surová skóre relevance; vyšší hodnota znamená bližší shodu. Zdokumentovaná volitelná normalizace používá sigmoidní funkci, která převede skóre do intervalu od 0 do 1. Normalizované skóre má praktický rozsah, samotná transformace však nezajišťuje kalibrovanou pravděpodobnost správnosti kandidáta.
Prahy pro řazení nebo filtrování volte na reprezentativních dvojicích dotazu a pasáže z vlastní pracovní zátěže. Zahrňte pasáže se stejnými klíčovými slovy, které odpovídají na jinou otázku, i relevantní pasáže s odlišnou formulací. Zvolený práh tak bude smysluplný pro prohledávanou kolekci.
U projektu s Ailoot API určete obsah výsledného kontextu a počet kandidátů, které lze účinně posoudit. Užitečným výsledkem je lépe seřazená sada důkazů pro další krok aplikace. Výstup relevance této varianty oddělujte od embeddingů dokumentů, generovaného textu a ovládání výběru vrstev zdokumentovaného pro jiné rerankery.
Ailoot Ultra · Přeřazení podle relevance POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3Úvod
Vícejazyčný cross-encoder od BAAI pro řazení kandidátních pasáží podle dotazu. Čte společně každou dvojici dotazu a pasáže a vrací skóre relevance, čímž zpřesňuje užší výběr výsledků vyhledávání, aniž by generoval odpověď nebo vytvářel embeddingy dokumentů.
- Přijímané vstupy
- Text
- Výsledky
- Výsledky seřazené podle relevance
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Přeřazení podle relevance POST /v1/rerank
- Vstup
text- Výstup
rerank
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity bge-reranker-v2-m3 | Výchozí— |
Polequery | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poledocuments | Typarray | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, documents |
Parametrmaterial_types | Kontrakttext |
Parametrmaterial_conditions | KontraktZadejte svůj skutečný dotaz a neprázdné pole původních textových dokumentů. Indexy výsledků odkazují na toto původní pole. |
Životní cyklus: synchronous_result_then_owned_library
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarify
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Sazby Ailoot
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Účtovací jednotka | Poplatek |
|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Účtovací jednotka— | Poplatek Vstup · Vstupní tokeny — / 1K tokenů Výstup · Výstupní tokeny — / 1K tokenů Vstup · Čtení z mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina — / 1K tokenů |
| Konfiguracecelkový token | Tabulka sazeb— | Účtovací jednotka/ 1K tokenů | Poplatek Vstup · celkový token $0.00004 / 1K tokenů |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
Ailoot Ultra · Přeřazení podle relevance
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.
Přijímání a ukládání výsledků
Ailoot Ultra · Přeřazení podle relevance
Celý původní nativní výsledek JSON s nakonfigurovaným modelem odpovědi, indexy původních dokumentů, skóre relevance, řetězci dokumentů a nativními údaji o využití tokenů. Uchovejte každý skutečný výsledek a pole využití.
GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovejte všechny dokončené výsledky
Uchovejte každou úplnou vrácenou odpověď, soubor i část obsahu.
Uchovejte úplnou odpověď a hlavičky, všechny skutečné výstupy, původní vrácené identifikátory a všechna pole s údaji o využití. Obnovte původní operaci bez opětovného odeslání požadavku na vytvoření.
Pokud je nutné ověřit původní odpověď
Uchovejte skutečné X-Client-Request-ID a celou odpověď. Načítejte původní soubory spravované službou a jejich přesné podepsané URL obsahu; vytvoření s nejistým výsledkem nikdy znovu neodesílejte.
Pole odpovědi
| Pole | Typ | Význam |
|---|---|---|
Polemodel | Typstring | VýznamPřesný model odpovědi požadovaný nakonfigurovaným zpracovatelem zdroje. |
Poleresults[].index | Typinteger | VýznamJedinečný index původního vstupního dokumentu. |
Poleresults[].relevance_score | Typnumber | VýznamSkóre relevance s konečnou číselnou hodnotou. |
Poleresults[].document | Typstring | VýznamPůvodní textový dokument vyžadovaný tímto nakonfigurovaným zpracovatelem odpovědi. |
Poleusage.total_tokens | Typinteger | VýznamKonečný nezáporný počet nativních tokenů požadovaný aktuálním přijatým tarifem. |
Chyby a další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaTělo JSON nebo explicitně uvedené kanonické ID modelu jsou neplatné. | Další krokUchovejte odpověď a opravte označené pole požadavku. |
Odpověď401 · authentication_error | PodmínkaKlíč API Ailoot je neplatný. | Další krokPoužijte svůj autorizovaný klíč API Ailoot. |
Odpověď403 · permission_error | PodmínkaSkupina klíče nemá přístup k této metodě. | Další krokUchovejte vrácené podrobnosti chyby. |
Odpověď404 · not_found_error | PodmínkaVybraná metoda nemá žádnou trasu s povoleným přístupem. | Další krokUchovejte vrácené podrobnosti chyby. |
Odpověď422 · price_unavailable | PodmínkaPřijatý tarif nedokáže získat potřebné vstupní množství nebo jeho horní mez. | Další krokUchovejte odpověď; použijte způsob zadání vstupu požadovaný přijatým tarifem. |
Odpověď503 · | PodmínkaPotřebné úložiště, trasa, cena metody nebo rezervace nejsou dostupné. | Další krokUchovejte celou původní odpověď. Nejasná rezervace neopravňuje k opětovnému odeslání. |
Odpověď502 · billing_requires_check | PodmínkaPůvodní výsledek, údaje o využití nebo vyúčtování vyžadují kontrolu. | Další krokUchovejte skutečné ID požadavku a původní odpověď. Načítejte existující záznam spravovaný službou; požadavek na vytvoření znovu neodesílejte. |
Aliasy
Aliasy modelu
Ailoot Ultra bge-reranker-v2-m3
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · bge-reranker-v2-m3
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- Jaká pole požadavek používá?
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents