Source: https://ailoot.ai/models/fi/voyageai-rerank-2-5/
Canonical: https://ailoot.ai/models/fi/voyageai-rerank-2-5/
Language: fi

# VoyageAI by MongoDB: rerank-2.5

[Markdown](https://ailoot.ai/models/fi/voyageai-rerank-2-5/index.md) · [JSON](https://ailoot.ai/models/fi/voyageai-rerank-2-5/facts.json)

## [VoyageAI by MongoDB: rerank-2.5](https://ailoot.ai/models/fi/voyageai-rerank-2-5/)

rerank-2.5 järjestää toimitetun tekstiehdokkaiden joukon kyselyn ja valinnaisten luonnollisen kielen ohjeiden mukaisen relevanssin perusteella. Se on monikielinen, laatupainotteinen uudelleenjärjestäjä, jossa on 32 000 tokenin kysely–asiakirja-konteksti ja alkuperäisiin ehdokasindekseihin kytketyt järjestetyt pisteet.

- [**Ailoot Ultra · Uudelleenjärjestys** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/fi/voyageai-rerank-2-5/#method-0)

Tietoa mallista

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

rerank-2.5 on Voyage AI:n ohjeita noudattava uudelleenjärjestäjä, joka on suunniteltu hakuehdokkaiden joukon tarkentamiseen. Se tarkastelee kyselyä ja kutakin asiakirjaa yhdessä cross-encoderina ja palauttaa sitten relevanssijärjestyksen. Valmistajan julkaisu korostaa luonnollisella kielellä ohjattavaa relevanssia, monikielistä hakua ja pidempää kysely–asiakirja-kontekstia kuin edeltävässä rerank-2-versiossa.

#### Anna mallille vertailtavat ehdokkaat

Syöte on kysely ja tekstimuotoisten ehdokasasiakirjojen luettelo. Ne voivat olla upotushaun tai sanapohjaisen ensimmäisen vaiheen haun valitsemia tekstikohtia. Uudelleenjärjestäjä arvioi toimitettua tekstiä eikä luo aineiston upotuksia, joten sen käytännön tehtävä on tarkentaa alkuhaun jo löytämiä ehdokkaita.

Säilytä alkuperäinen ehdokasjärjestys ja lähdetunnisteet luetteloa valmistellessasi. Palautetut indeksit viittaavat näihin syötepaikkoihin. Anna RAG-tehtävään tekstikohdat, joita vastausvaihe saattaa todella käyttää, mukaan lukien niiden tulkintaan tarvittava otsikko tai ehdot. Lähetetystä ehdokasjoukosta puuttuva olennainen asiakirja ei voi ilmestyä uudelleenjärjestämisen uutena hakutuloksena.

#### Määritä tavoiteltu relevanssin käsite

Ohjeita voi lisätä kyselyn loppuun tai alkuun. Julkaisu kuvaa kolme hyödyllistä roolia: asiakirjan tietyn osan korostaminen, lähdetyypin suosiminen ja kyselyn täsmentäminen sovelluskontekstilla. Ne muuttavat mallille annettavaa relevanssitehtävää.

Teknisessä haussa havainnollistava ohje on: ”Painota tekstikohtia, jotka selittävät virhe- ja palautumistoiminnan; esittelevät yleiskatsaukset ovat toissijaisia.” Määritä tutkimuskokoelmassa, onko otsikko, menetelmä vai tulos tärkein. Määritä monitulkintaiselle termille haun aihealue. Pidä kysymys ja ohje yhteensopivina, jotta toinen ei pyydä laajaa aihetta samalla kun toinen muuttaa tehtävää huomaamatta.

Nämä toiveet ohjaavat relevanssipisteytystä. Jos sovelluksella on tiukat kelpoisuusvaatimukset, kuten lähdeversio, päivämäärä tai käyttöoikeusrajaus, valmistele kelvollinen ehdokasjoukko erikseen. Mallin relevanssiohje ja deterministinen kokoelmarajaus palvelevat eri tarkoituksia.

#### Järjestetty tulos ja myöhempi käyttö

Tulokset ovat laskevassa relevanssijärjestyksessä ja sisältävät liukulukumuotoisen relevanssipisteen ja ehdokkaan alkuperäisen syöteindeksin. top-k-vaihtoehto valitsee palautettavien kärkisijojen määrän; ilman sitä valmistajan määritys palauttaa kaikkien lähetettyjen ehdokkaiden tulokset. Valinnainen return-documents-asetus sisällyttää vastaavan lähdetekstin; muuten vastaus sisältää indeksit ja pisteet.

Käytä järjestystä näyttämiseen tai myöhempään vastausvaiheeseen valittavien tekstikohtien poimintaan ja pidä niiden lähdeidentiteetti ehjänä. Tarkasta varsinainen teksti järjestystä arvioidessasi: piste mittaa relevanssia lähetettyyn kyselyyn nähden eikä ole generoitu vastaus tai varmistus asiakirjan väitteiden oikeellisuudesta. Tämä tekee mallista hyödyllisen teknisen, oikeudellisen, taloudellisen, lääketieteellisen, keskustelu- ja monikielisen hakuaineiston tarkentamiseen muuttamatta järjestystä toimialaa koskevaksi johtopäätökseksi.

#### Konteksti, kokonaistokenbudjetti ja katkaisu

Dokumentoitu kyselyraja on 8 000 tokenia, mukaan lukien kyselyyn sijoitetut ohjeet. Kyselyn ja minkä tahansa yhden ehdokasasiakirjan on mahduttava 32 000 tokeniin, ja asiakirjaluettelo voi sisältää enintään 1 000 kohdetta. Kokonaisvaraus on 600 000 tokenia, joka lasketaan kertomalla kyselytokenit asiakirjojen määrällä ja lisäämällä kaikki asiakirjatokenit. Pitkä ohje lasketaan siten toistuvasti ehdokaspareissa.

Tuloksen top-k-määrä ei muuta ehdokkaiden määrää tässä syötetokenlaskennassa. Oletuskatkaisu lyhentää liian pitkät kyselyt tai asiakirjat kontekstirajaan; sen poistaminen käytöstä aiheuttaa virheen liian pitkästä kyselystä tai parista. Valmistele vastauksen sisältävät tekstikohdat tarkoituksella ja pidä olennainen ehto mallin näkemässä tekstissä. Arvioi tarkennettua järjestystä edustavilla kysymyksillä ja ohjeilla ja välitä sitten valitut alkuperäiset tekstikohdat seuraavaan vaiheeseen.

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

[`voyageai/rerank-2.5`](https://ailoot.ai/models/fi/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank)

VoyageAI by MongoDB /`voyageai/rerank-2.5`

### Aloitus

rerank-2.5 järjestää toimitetun tekstiehdokkaiden joukon kyselyn ja valinnaisten luonnollisen kielen ohjeiden mukaisen relevanssin perusteella. Se on monikielinen, laatupainotteinen uudelleenjärjestäjä, jossa on 32 000 tokenin kysely–asiakirja-konteksti ja alkuperäisiin ehdokasindekseihin kytketyt järjestetyt pisteet.

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`

Tulosteen muoto

json

| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
| --- | --- | --- | --- | --- |
| Kenttä`documents` | Tyyppi`array` | VaatimusPakollinen | Arvot & rajat | Oletus— |
| Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat voyageai/rerank-2.5 | Oletus— |
| Kenttä`provider` | Tyyppi`schema` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`query` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat | Oletus— |
| Kenttä`session_id` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`top_n` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 | Oletus— |
| Kenttä`trace` | Tyyppi`schema` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`user` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`documents[].text` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`documents[].image` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |

Syöteaineistojen yhdistelmät

**text\_rerank** · Pakollinen: query, documents array with minItems1

Menetelmän parametrit ja elinkaari

| Parametri | Sopimus |
| --- | --- |
| Parametri`content_type` | Sopimusapplication/json |
| Parametri`required` | Sopimusmodel, query, documents |
| Parametri`material_types` | Sopimustext |
| Parametri`optional_controls` | Sopimusprovider, session\_id, top\_n, trace, user |
| Parametri`multimodal_input_binding` | Sopimusnull |

Elinkaari: `synchronous`

Lähetä täsmällinen mallin tunniste ja säilytä koko natiivivastaus.

### 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 |
| AsetuksetUltra | Hinnasto— | Laskutusyksikkö/ 1K tokenia | Veloitus Syöte **$0.0001** / 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

Säilytetty virallinen pyyntörakenne; dokumentaatioesimerkkiKäytä todellista pyyntöaineistoasi ja säilytä koko tulos

```json
{
  "documents": [
    "Paris is the capital of France.",
    "Berlin is the capital of Germany."
  ],
  "model": "voyageai/rerank-2.5",
  "query": "What is the capital of France?",
  "top_n": 3
}
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='voyageai/rerank-2.5'
Path('request.json').write_text(json.dumps(p,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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT
```

### Vastaanota ja tallenna tulokset

#### Ailoot Ultra · Uudelleenjärjestys

json

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

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

Jokainen todellinen tulosindeksi, äärellinen relevance\_score ja alkuperäinen asiakirjaolio säilytetään. Indeksit sitovat tulokset alkuperäiseen asiakirjataulukkoon. Koko alkuperäinen JSON tallennetaan ja palautetaan vasta veloituksen lopullisen kirjauksen jälkeen.

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

Säilytä alkuperäinen operaatio ja kokonainen tai osittainen vastaus; älä toista POST-pyyntöä.

Vastauksen kentät

| Kenttä | Tyyppi |
| --- | --- |
| Kenttä`model` | Tyyppistring |
| Kenttä`id` | Tyyppistring |
| Kenttä`provider` | Tyyppistring |
| Kenttä`results[].index` | Tyyppiinteger |
| Kenttä`results[].relevance_score` | Tyyppinumber |
| Kenttä`results[].document.text` | Tyyppistring |
| Kenttä`results[].document.image` | Tyyppistring |
| Kenttä`usage.search_units` | Tyyppiinteger |
| Kenttä`usage.total_tokens` | Tyyppiinteger |
| Kenttä`usage.cost` | Tyyppinumber |

Virheet ja seuraavat vaiheet

| Vastaus | Ehto | Seuraava vaihe |
| --- | --- | --- |
| Vastaus400 · `invalid_request_error` | EhtoVirheellinen pakollinen kenttä, esitysmuoto tai arvo | Seuraava vaiheKorjaa ilmoitettu pyyntökenttä. |

### Aliakset

#### Mallin aliakset

**Ailoot Ultra** [`voyageai/rerank-2.5`](https://ailoot.ai/models/fi/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank)

#### Menetelmäpolkujen aliakset

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

#### Liittyvät kutsujan ID:t

[`voyageai/rerank-2.5`](https://ailoot.ai/models/fi/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank)

FAQ · VoyageAI by MongoDB: rerank-2.5

Mitä syötteitä ja tuloksia on saatavilla?

`POST /v1/rerank` · `voyageai/rerank-2.5`: `text` → `rerank`

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

`POST /v1/rerank` · `voyageai/rerank-2.5`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user`

Mitä rajoja sovelletaan?

`POST /v1/rerank` · `voyageai/rerank-2.5`: `top_n.minimum`: `1`

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.