bge-reranker-v2-m3
BAAI daugiakalbis kryžminis koduotuvas, skirtas kandidatų ištraukoms rikiuoti pagal užklausą. Jis kartu skaito kiekvieną užklausos ir ištraukos porą bei grąžina aktualumo įvertį, patikslindamas paieškos atranką, tačiau negeneruodamas atsakymo ir nekurdamas dokumentų įterpinių.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
BGE Reranker v2 M3 – daugiakalbis aktualumo modelis, sukurtas BGE-M3 pagrindu. Jis kartu gauna užklausą ir vertinamą ištrauką bei grąžina jų ryšio įvertį. BAAI šį leidimą pristato kaip efektyvų daugiakalbį perrikiavimo modelį, tinkamą ir kinų bei anglų kalbų paieškai, kai paieškos programai reikia patikslinti esamą kandidatų sąrašą.
Aktualumas pagal užklausos ir ištraukos porą
Kryžminis koduotuvas apdoroja abu tekstus kartu, leisdamas jų turiniui sąveikauti prieš nustatant aktualumo įvertį. Tai skiriasi nuo įterpinių modelio, kuris tekstus koduoja atskirai pakartotinai naudojamam vektorių palyginimui. Perrikiavimo modelio išvestis yra konkrečios poros skaliarinis įvertis, o ne dokumento vektorius arba rašytinis atsakymas.
Modelį naudokite po pradinės paieškos, atrinkusios tikėtinas ištraukas. Suporuokite klausimą su kiekvienu kandidatu ir rikiuokite kandidatus pagal gautus įverčius. Taip išsamesnis palyginimas sutelkiamas į valdomą atranką, užuot prašius kryžminio koduotuvo patikrinti kiekvieną didelio rinkinio ištrauką.
v2 M3 leidimas
Gamintojas nurodo BGE-M3 kaip bazinį modelį ir daugiakalbystę išskiria kaip pagrindinę savybę. v2 perrikiavimo šeimoje M3 yra efektyvus daugiakalbis variantas; Gemma pagrindu sukurti ir sluoksnių pasirinkimo variantai yra atskiri modeliai su kitokiais įgyvendinimo sprendimais. M3 pavadinimas čia nereiškia, kad perrikiavimo modelis grąžina pirminio įterpinių modelio tankiuosius, retuosius ir daugiavektorius įterpinius.
Šis skirtumas svarbus renkantis programai reikalingą rezultatą. Dokumentų rinkiniui atvaizduoti ir jame ieškoti rinkitės įterpinių modelį. Šį perrikiavimo modelį rinkitės, kai jau turite kandidatų tekstus ir reikia nuspręsti, kuri ištrauka aktualiausia dabartinei užklausai.
Parenkite kandidatus prasmingam rikiavimui
Pateikite tikrą klausimą ir visą kandidato tekstą, reikalingą jam interpretuoti. Išsaugokite antraštes arba šalia esančius apibrėžimus, kai jie lemia ištraukos reikšmę. Paskelbtame Transformers pavyzdyje užklausa ir ištrauka kartu skaidomos žetonais, taikant trumpinimą ir max_length=512. Tai pavyzdžio nustatymas, o ne viso modelio limitas. Klausimą ir reikalingus įrodymus sutalpinkite į pasirinktą poros limitą ir patikrinkite, kas pašalinama trumpinant. Rezultatas, minintis tą patį produktą kaip užklausa, vis tiek gali būti neaktualus, jei nagrinėja kitą operaciją arba sąlygą; vertindami paieškos kokybę parenkite šiuos atvejus atskiriančius pavyzdžius.
Dokumentų asistentui prie kandidatų teksto išsaugokite identifikatorius, įvertinkite klausimo ir ištraukos poras bei perduokite pasirinktas originalias ištraukas atsakymo žingsniui. Tuomet atsakantis modelis gauna įrodymus, o ne aktualumo įvertį be šaltinio. Tai pavyzdinė paieškos darbo eiga; pats perrikiavimo modelis nei ieško išoriniame rinkinyje, nei rašo atsakymą.
Įverčių skaitymas ir normalizavimas
Gamintojas grąžina neapdorotus aktualumo įverčius; didesnė reikšmė rodo artimesnį atitikimą. Dokumentuotas pasirenkamas normalizavimas taiko sigmoidinę funkciją ir perkelia įvertį į intervalą nuo 0 iki 1. Normalizuotas įvertis turi patogų intervalą, tačiau vien ši transformacija nepatvirtina kalibruotos tikimybės, kad kandidatas teisingas.
Rikiavimo arba filtravimo slenksčius pasirinkite pagal reprezentatyvias jūsų darbo krūvio užklausų ir ištraukų poras. Įtraukite ištraukas, turinčias bendrų raktažodžių, bet atsakančias į kitą klausimą, ir aktualias kitaip suformuluotas ištraukas. Taip pasirinktas slenkstis tampa prasmingas ieškomam rinkiniui.
Ailoot API projektui apibrėžkite galutinio konteksto turinį ir kiek kandidatų galima efektyviai patikrinti. Naudingas rezultatas – geriau surikiuotas įrodymų rinkinys kitam programos žingsniui. Šio leidimo aktualumo išvestį atskirkite nuo dokumentų įterpinių, generuojamos prozos ir kitiems perrikiavimo modeliams dokumentuotų sluoksnių pasirinkimo valdiklių.
Ailoot Ultra · Perrikiavimas POST /v1/rerank bge-reranker-v2-m3
bge-reranker-v2-m3Pradžia
BAAI daugiakalbis kryžminis koduotuvas, skirtas kandidatų ištraukoms rikiuoti pagal užklausą. Jis kartu skaito kiekvieną užklausos ir ištraukos porą bei grąžina aktualumo įvertį, patikslindamas paieškos atranką, tačiau negeneruodamas atsakymo ir nekurdamas dokumentų įterpinių.
- Leidžiamos įvestys
- Tekstas
- Rezultatai
- Surikiuoti rezultatai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Perrikiavimas POST /v1/rerank
- Įvestis
text- Išvestis
rerank
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos bge-reranker-v2-m3 | Numatyta— |
Laukasquery | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasdocuments | Tipasarray | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, documents |
Parametrasmaterial_types | Specifikacijatext |
Parametrasmaterial_conditions | SpecifikacijaNurodykite savo tikrą paieškos užklausą ir netuščią pradinių tekstinių dokumentų masyvą. Rezultatų indeksai nurodo elementus tame pradiniame masyve. |
Gyvavimo ciklas: synchronous_result_then_owned_library
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Planai
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Ailoot įkainiai
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Apskaitos vienetas | Mokestis |
|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Apskaitos vienetas— | Mokestis Įvestis · Įvesties tokenai — / 1K tokenų Išvestis · Išvesties tokenai — / 1K tokenų Įvestis · Talpyklos skaitymas — / 1K tokenų Įvestis · Rašymas į talpyklą — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val — / 1K tokenų |
| Konfigūracijažetonai iš viso | Įkainių lentelė— | Apskaitos vienetas/ 1K tokenų | Mokestis Įvestis · žetonai iš viso $0.00004 / 1K tokenų |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Užklausų pavyzdžiai
Ailoot Ultra · Perrikiavimas
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.
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Perrikiavimas
Visas pradinis pirminio formato JSON rezultatas su sukonfigūruotu atsakymo modeliu, pradinių dokumentų indeksais, aktualumo balais, dokumentų eilutėmis ir pirminiais žetonų naudojimo duomenimis. Išsaugokite kiekvieną tikrą rezultato ir naudojimo lauką.
GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną visą grąžintą atsakymą, failą ir turinio dalį.
Išsaugokite visą atsakymą ir antraštes, visus faktiškai gautus rezultatus, pradinius grąžintus identifikatorius ir visus naudojimo apskaitos laukus. Atkurkite prieigą prie pradinės operacijos pakartotinai neteikdami kūrimo užklausos.
Jei reikia patikrinti pradinį atsakymą
Išsaugokite tikrąjį X-Client-Request-ID ir visą atsakymą. Skaitykite pradinių jums priklausančių išteklių duomenis ir naudokite tikslius jų pasirašytus turinio URL; niekada neteikite kūrimo užklausos dar kartą, kai jos baigtis neaiški.
Atsakymo laukai
| Laukas | Tipas | Reikšmė |
|---|---|---|
Laukasmodel | Tipasstring | ReikšmėTikslus atsakymo modelis, privalomas sukonfigūruotam Source apdorojimo komponentui. |
Laukasresults[].index | Tipasinteger | ReikšmėUnikalus pradinio įvesties dokumento indeksas. |
Laukasresults[].relevance_score | Tipasnumber | ReikšmėBaigtinė aktualumo balo reikšmė. |
Laukasresults[].document | Tipasstring | ReikšmėPradinis tekstinis dokumentas, privalomas šiam sukonfigūruotam atsakymo apdorojimo komponentui. |
Laukasusage.total_tokens | Tipasinteger | ReikšmėBaigtinis neneigiamas pirminis žetonų skaičius, privalomas pagal šiuo metu priimtą tarifą. |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaJSON turinys arba aiškiai nurodytas kanoninis modelio ID netinkamas. | Kitas žingsnisIšsaugokite atsakymą ir pataisykite nurodytą užklausos lauką. |
Atsakymas401 · authentication_error | SąlygaAiloot API raktas negalioja. | Kitas žingsnisNaudokite savo įgaliotą Ailoot API raktą. |
Atsakymas403 · permission_error | SąlygaRakto grupei nesuteikta prieiga prie šio metodo. | Kitas žingsnisIšsaugokite grąžintą išsamią klaidos informaciją. |
Atsakymas404 · not_found_error | SąlygaPasirinktas metodas neturi leistino maršruto. | Kitas žingsnisIšsaugokite grąžintą išsamią klaidos informaciją. |
Atsakymas422 · price_unavailable | SąlygaPagal priimtą tarifą nepavyksta gauti privalomo įvesties kiekio ar jo ribos. | Kitas žingsnisIšsaugokite atsakymą; naudokite priimtam tarifui reikalingą įvesties pateikimo formą. |
Atsakymas503 · | SąlygaPrivaloma saugykla, maršrutas, metodo kaina arba rezervavimas nepasiekiami. | Kitas žingsnisIšsaugokite visą pradinį atsakymą. Neaiškus lėšų rezervavimas nėra leidimas teikti užklausą pakartotinai. |
Atsakymas502 · billing_requires_check | SąlygaPradinį rezultatą, naudojimo duomenis arba atsiskaitymą reikia patikrinti. | Kitas žingsnisIšsaugokite tikrą užklausos ID ir pradinį atsakymą. Skaitykite esamą jums priklausantį įrašą; neteikite kūrimo užklausos pakartotinai. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra bge-reranker-v2-m3
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · bge-reranker-v2-m3
- Kokios įvestys ir rezultatai prieinami?
POST /v1/rerank·bge-reranker-v2-m3:text→rerank- Kokius laukus naudoja užklausa?
POST /v1/rerank·bge-reranker-v2-m3:model,query,documents