Source: https://ailoot.ai/models/fi/bge-reranker-v2-m3/
Canonical: https://ailoot.ai/models/fi/bge-reranker-v2-m3/
Language: fi

# bge-reranker-v2-m3

[Markdown](https://ailoot.ai/models/fi/bge-reranker-v2-m3/index.md) · [JSON](https://ailoot.ai/models/fi/bge-reranker-v2-m3/facts.json)

## [bge-reranker-v2-m3](https://ailoot.ai/models/fi/bge-reranker-v2-m3/)

BAAI:n monikielinen ristienkooderi järjestää tekstijaksoehdokkaat kyselyn perusteella. Se lukee kunkin kysely–tekstijaksoparin yhdessä ja palauttaa relevanssipisteen. Näin se tarkentaa haun ehdokaslistaa tuottamatta vastausta tai luomatta asiakirjaupotuksia.

- [**Ailoot Ultra · Uudelleenjärjestys** `POST /v1/rerank` `bge-reranker-v2-m3`](https://ailoot.ai/models/fi/bge-reranker-v2-m3/#method-0)

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

BGE Reranker v2 M3 on BGE-M3:n pohjalle rakennettu monikielinen relevanssimalli. Se vastaanottaa yhdessä kyselyn ja ehdokastekstikatkelman sekä palauttaa pistearvon niiden suhteelle. BAAI asemoi tämän version tehokkaaksi monikieliseksi uudelleenjärjestelijäksi muun muassa kiinan- ja englanninkieliseen tiedonhakuun, kun hakusovelluksen täytyy tarkentaa olemassa olevaa ehdokasluetteloa.

#### Relevanssi kyselyn ja katkelman parista

Ristiinkooderi käsittelee molemmat tekstit yhdessä, jolloin niiden sisällöt voivat vaikuttaa toisiinsa ennen relevanssipisteen tuottamista. Tämä eroaa upotusmallista, joka koodaa tekstit erikseen uudelleenkäytettävää vektorivertailua varten. Uudelleenjärjestelijä tuottaa tietyn parin skalaarisen pistearvon, ei asiakirjavektoria tai kirjallista vastausta.

Käytä mallia sen jälkeen, kun ensimmäinen haku on valinnut mahdollisesti sopivat katkelmat. Yhdistä kysymys jokaiseen ehdokkaaseen ja järjestä ehdokkaat saatujen pisteiden perusteella. Näin yksityiskohtaisempi vertailu kohdistuu hallittavaan ehdokasjoukkoon sen sijaan, että ristiinkooderia pyydettäisiin tutkimaan suuren kokoelman kaikki katkelmat.

#### v2 M3 -versio

Valmistaja nimeää BGE-M3:n pohjamalliksi ja monikielisen tuen keskeiseksi ominaisuudeksi. Sen v2-uudelleenjärjestelijäperheessä M3 on tehokas monikielinen vaihtoehto; Gemma-pohjaiset ja kerrosvalintaa käyttävät variantit ovat eri malleja, joissa on erilaiset toteutusvalinnat. M3-nimi ei tässä tarkoita, että uudelleenjärjestelijä palauttaisi alkuperäisen upotusmallin tiheitä, harvoja ja monivektoriupotuksia.

Tämä ero on merkityksellinen, kun valitset sovelluksen tarvitsemaa tulosta. Valitse upotusmalli asiakirjakokoelman esittämiseen ja hakuun. Valitse tämä uudelleenjärjestelijä, kun sinulla on jo ehdokastekstit ja sinun on ratkaistava, mikä katkelma on nykyisen kyselyn kannalta olennaisin.

#### Hyödyllisesti järjestettävien ehdokkaiden valmistelu

Anna varsinainen kysymys ja sen tulkinnassa tarvittava ehdokasteksti kokonaisuudessaan. Säilytä otsikot tai lähellä olevat määritelmät, jos ne määräävät katkelman merkityksen. Julkaistussa Transformers-esimerkissä kysely ja katkelma tokenisoidaan yhdessä käyttäen katkaisua ja asetusta max\_length=512. Se on esimerkkiasetus, ei koko mallin yleinen raja. Pidä kysymys ja tarvittava näyttö valitun paribudjetin sisällä ja tarkista, mitä katkaisu poistaa. Tulos, joka mainitsee saman tuotteen kuin kysely, voi silti olla epäolennainen, jos se koskee väärää toimintoa tai ehtoa; valmistele hakulaadun arviointiin esimerkkejä, jotka erottavat nämä tapaukset.

Säilytä asiakirja-avustajassa ehdokkaiden tunnisteet tekstien rinnalla, pisteytä kysymys–katkelma-parit ja välitä valitut alkuperäiskatkelmat vastausvaiheeseen. Vastauksen tuottava malli saa silloin näytön eikä lähteetöntä relevanssipistettä. Tämä on havainnollistava tiedonhakutyönkulku; uudelleenjärjestelijä itse ei hae ulkoisesta kokoelmasta eikä kirjoita vastausta.

#### Pisteiden tulkinta ja normalisointi

Valmistaja palauttaa raakoja relevanssipisteitä, joissa suurempi arvo merkitsee läheisempää vastaavuutta. Dokumentoitu valinnainen normalisointi käyttää sigmoidifunktiota pisteen sijoittamiseksi välille 0–1. Normalisoidun pisteen vaihteluväli on kätevä, mutta pelkkä muunnos ei osoita kalibroitua todennäköisyyttä sille, että ehdokas on oikea.

Valitse järjestys- tai suodatuskynnykset työkuormaasi edustavilla kysely–katkelma-pareilla. Ota mukaan katkelmia, joissa on samoja avainsanoja mutta jotka vastaavat eri kysymykseen, sekä relevantteja katkelmia, joiden sanamuoto on erilainen. Näin valittu kynnys on merkityksellinen haettavassa kokoelmassa.

Määrittele Ailoot API -projektissa, mitä lopullisen kontekstin pitää sisältää ja kuinka monta ehdokasta voidaan tutkia tehokkaasti. Hyödyllinen tulos on paremmin järjestetty näyttöjoukko sovelluksen seuraavaa vaihetta varten. Pidä tämän version relevanssituloste erillään asiakirjaupotuksista, tuotetusta proosasta ja muiden uudelleenjärjestelijöiden dokumentoiduista kerrosvalinnan ohjaimista.

**Ailoot Ultra · Uudelleenjärjestys** `POST /v1/rerank` `bge-reranker-v2-m3`

[`bge-reranker-v2-m3`](https://ailoot.ai/models/fi/#m=bge-reranker-v2-m3&route=Ultra&caller=bge-reranker-v2-m3&fmt=rerank)

BAAI /`bge-reranker-v2-m3`

### Aloitus

BAAI:n monikielinen ristienkooderi järjestää tekstijaksoehdokkaat kyselyn perusteella. Se lukee kunkin kysely–tekstijaksoparin yhdessä ja palauttaa relevanssipisteen. Näin se tarkentaa haun ehdokaslistaa tuottamatta vastausta tai luomatta asiakirjaupotuksia.

Hyväksytyt syötteet

Teksti

Tulokset

Järjestetyt tulokset

### Saatavilla Ailootissa · syötteet & menetelmät

**Ailoot Ultra · Uudelleenjärjestys** `POST /v1/rerank`

Syötetyypit

`text`

Tulostyypit

`rerank`

| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
| --- | --- | --- | --- | --- |
| Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat bge-reranker-v2-m3 | Oletus— |
| Kenttä`query` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`documents` | Tyyppi`array` | VaatimusPakollinen | Arvot & rajat | Oletus— |

Menetelmän parametrit ja elinkaari

| Parametri | Sopimus |
| --- | --- |
| Parametri`content_type` | Sopimusapplication/json |
| Parametri`required` | Sopimusmodel, documents |
| Parametri`material_types` | Sopimustext |
| Parametri`material_conditions` | SopimusAnna todellinen hakukyselysi ja ei-tyhjä taulukko alkuperäisistä tekstiasiakirjoista. Tulosten indeksit viittaavat tähän alkuperäiseen taulukkoon. |

Elinkaari: `synchronous_result_then_owned_library`

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Hinnoittelu

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila

Ei määritetty Kun nopea tila on valittu

Flex-tila

Ei määritetty Kun flex-tila on valittu

Päättelyn enimmäisteho

Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

#### Ailoot-hinnat

#### Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

| Asetukset | Hinnasto | Laskutusyksikkö | Veloitus |
| --- | --- | --- | --- |
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Laskutusyksikkö— | Veloitus Syöte · Syötetokenit **—** / 1K tokenia Tuloste · Tulostokenit **—** / 1K tokenia Syöte · Välimuistin luku **—** / 1K tokenia Syöte · Välimuistiin kirjoitus **—** / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti **—** / 1K tokenia |
| Asetuksetkokonaistoken | Hinnasto— | Laskutusyksikkö/ 1K tokenia | Veloitus Syöte · kokonaistoken **$0.00004** / 1K tokenia |

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. [Varauksen ja lopullisen veloituksen toiminta →](https://ailoot.ai/docs/fi/billing/reserve/)

### Esimerkkipyynnöt

#### Ailoot Ultra · Uudelleenjärjestys

Käytä todellista syötettä ja säilytä koko tulos

```bash
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.
```

### Vastaanota ja tallenna tulokset

#### Ailoot Ultra · Uudelleenjärjestys

Koko alkuperäinen natiivi JSON-tulos, joka sisältää määritetyn vastausmallin, alkuperäisten asiakirjojen indeksit, osuvuusarvot, asiakirjamerkkijonot ja natiivit tokenien käyttötiedot. Säilytä jokainen todellinen tulos- ja käyttötietokenttä.

- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

##### Säilytä kaikki valmistuneet tulokset

Säilytä jokainen kokonainen palautettu vastaus, tiedosto ja sisällön osa.

Säilytä koko vastaus ja otsakkeet, jokainen todellinen tuloste, alkuperäiset palautetut tunnisteet ja kaikki käyttötietokentät. Selvitä alkuperäisen operaation tila lähettämättä luontipyyntöä uudelleen.

##### Jos alkuperäinen vastaus on tarkistettava

Säilytä todellinen X-Client-Request-ID ja koko vastaus. Lue alkuperäisiä käyttäjälle kuuluvia aineistoja ja niiden täsmällisiä allekirjoitettuja sisällön URL-osoitteita; älä koskaan lähetä epävarmaa luontipyyntöä uudelleen.

Vastauksen kentät

| Kenttä | Tyyppi | Merkitys |
| --- | --- | --- |
| Kenttä`model` | Tyyppistring | MerkitysMääritetyn lähdetoteutuksen vastauskäsittelijän edellyttämä täsmällinen vastausmalli. |
| Kenttä`results[].index` | Tyyppiinteger | MerkitysAlkuperäisen syöteasiakirjan yksilöllinen indeksi. |
| Kenttä`results[].relevance_score` | Tyyppinumber | MerkitysÄärellinen osuvuusarvo. |
| Kenttä`results[].document` | Tyyppistring | MerkitysTämän määritetyn vastauskäsittelijän edellyttämä alkuperäinen tekstiasiakirja. |
| Kenttä`usage.total_tokens` | Tyyppiinteger | MerkitysNykyisen hyväksytyn hinnaston edellyttämä äärellinen, ei-negatiivinen natiivi tokenimäärä. |

Virheet ja seuraavat vaiheet

| Vastaus | Ehto | Seuraava vaihe |
| --- | --- | --- |
| Vastaus400 · `invalid_request_error` | EhtoJSON-sisältö tai nimenomainen kanoninen mallin tunniste on virheellinen. | Seuraava vaiheSäilytä vastaus ja korjaa ilmoitettu pyyntökenttä. |
| Vastaus401 · `authentication_error` | EhtoAiloot API -avain on virheellinen. | Seuraava vaiheKäytä käyttöön oikeutettua Ailoot API -avaintasi. |
| Vastaus403 · `permission_error` | EhtoAvaimen ryhmällä ei ole käyttöoikeutta tähän menetelmään. | Seuraava vaiheSäilytä palautetut virheen lisätiedot. |
| Vastaus404 · `not_found_error` | EhtoValitulla menetelmällä ei ole käyttöön hyväksyttyä reittiä. | Seuraava vaiheSäilytä palautetut virheen lisätiedot. |
| Vastaus422 · `price_unavailable` | EhtoHyväksytyn hinnaston edellyttämää syötemäärää tai sen rajaa ei saada selville. | Seuraava vaiheSäilytä vastaus; käytä hyväksytyn hinnaston edellyttämää syötteen esitysmuotoa. |
| Vastaus503 · `` | EhtoVaadittu tallennustila, reitti, menetelmän hinta tai katevaraus ei ole saatavilla. | Seuraava vaiheSäilytä koko alkuperäinen vastaus. Epävarma katevaraus ei oikeuta uudelleenlähetykseen. |
| Vastaus502 · `billing_requires_check` | EhtoAlkuperäinen tulos, käyttötiedot tai veloituksen lopullinen kirjaus on tarkistettava. | Seuraava vaiheSäilytä todellinen pyynnön tunniste ja alkuperäinen vastaus. Lue olemassa olevaa käyttäjälle kuuluvaa tietuetta; älä lähetä luontipyyntöä uudelleen. |

### Aliakset

#### Mallin aliakset

**Ailoot Ultra** [`bge-reranker-v2-m3`](https://ailoot.ai/models/fi/#m=bge-reranker-v2-m3&route=Ultra&caller=bge-reranker-v2-m3&fmt=rerank)

#### Menetelmäpolkujen aliakset

Käytä yllä näytettyjä menetelmäpolkuja.

#### Liittyvät kutsujan ID:t

[`bge-reranker-v2-m3`](https://ailoot.ai/models/fi/#m=bge-reranker-v2-m3&route=Ultra&caller=bge-reranker-v2-m3&fmt=rerank)

FAQ · bge-reranker-v2-m3

Mitä syötteitä ja tuloksia on saatavilla?

`POST /v1/rerank` · `bge-reranker-v2-m3`: `text` → `rerank`

Mitä kenttiä pyyntö käyttää?

`POST /v1/rerank` · `bge-reranker-v2-m3`: `model`, `query`, `documents`

Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi.

## Yritys ja sen projektisalkku

Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.

## Osta tokenit alennuksella.

Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista.

Tilaus

Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten.

Kampanjakoodi jopa 50%

Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan.

Kulut historiassa

Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle.

[Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/)

## Yhdistä API tuotteeseen, jonka myyt.

SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi.

Kaupallinen sovellus

Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin.

Jälleenmyyjälisenssi

Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot.

Asiakirjat verkkosivustolla

Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä.

[Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.
