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

# VoyageAI by MongoDB: rerank-3

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

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

Voyage rerank-3 on laatupainotteinen Rerank 3 -versio kyselyn ja asiakirjan relevanssin pisteyttämiseen. Se järjestää haetut tekstiehdokkaat uudelleen, tukee luonnollisen kielen relevanssiohjeita ja käsittelee 32 000 tokenin pareja pitkien asiakirjojen, koodin ja tietopankkien haussa.

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

Tietoa mallista

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

Voyage rerank-3 on tekstin uudelleenjärjestäjä, joka on suunniteltu parantamaan haetun näytön laatua. Se vastaanottaa kyselyn ja ehdokasasiakirjojen luettelon, tarkastelee jokaista paria yhdessä ja palauttaa ehdokkaat relevanssijärjestyksessä. Upotukset ja avainsanahaku voivat ensin rajata suuren kokoelman hallittavaan ehdokasluetteloon; rerank-3 soveltaa sitten tähän luetteloon tarkempaa relevanssiarviota. Sen tulos on pisteytettyä hakunäyttöä, jonka sovellus voi näyttää tai välittää erilliseen vastauksen generointivaiheeseen.

Laatupainotteinen Rerank 3 Valmistaja asemoi rerank-3:n tarkkuuteen keskittyväksi versioksi ja rerank-3-liten viiveherkän haun versioksi. Kolmas sukupolvi päivittää mallin rungon ja koulutusaineistoyhdistelmän ja parantaa erityisesti pitkien asiakirjojen ja lähdekoodin hakua verrattuna vastaaviin 2.5-edeltäjiin. Valmistaja arvioi sitä teknisessä dokumentaatiossa, koodissa, monikielisessä aineistossa ja muilla asiakirja-aloilla. Tulokset tukevat sen hakuroolia; valitse versio oman kokoelmasi kannalta tärkeiden kysymysten ja ehdokasasiakirjojen avulla.

Pitkät asiakirjat riittävällä kontekstilla Pitkä ehdokas voi sisältää hyödyllistä kontekstia paljon aloituskappaletta kauempana. Toimita yhtenäinen osio tai asiakirja otsikkoineen ja olennaisine ympäröivine aineistoineen, jotta malli voi arvioida varsinaisen kysymyksen suhdetta sisältöön. Tuotekäytäntöjen haussa säilytä kiinnostavan tekstikohdan ympärillä olevat otsikot ja poikkeukset. Jos useita haettuja osioita tulee samasta lähteestä, säilytä niiden asiakirja- ja osiotunnisteet; sovellus voi sitten näyttää valitun näytön alkuperän.

Konteksti-ikkuna jaetaan kyselyn ja kunkin ehdokkaan kesken. Valmistajan nykyinen opas määrittää parin kooksi 32 000 tokenia, joihin sisältyy enintään 8 000 tokenin kysely. Siksi 3 000 tokenin kysely jättää kullekin asiakirjalle enintään 29 000 tokenia. Valmistele syöte niin, että sen olennainen sisältö mahtuu mukaan, etenkin jos pitkä johdanto tai toistuva vakioteksti muuten kuluttaisi ikkunan. Dokumentoitu katkaisuvaihtoehto on oletusarvoisesti käytössä ja voi lyhentää liian pitkää kysely- tai asiakirjatekstiä ennen pisteytystä. Tarkasta säilyvä sisältö, kun tekstikohdan sijainnilla on merkitystä.

Koodin ja teknisen aineiston haku Ohjelmointiavustajan hakuvaiheessa ehdokkaat voivat sisältää funktiototeutuksia, API-dokumentaatiota tai teknisiä selityksiä tekstinä. Liitä mukaan symbolit, funktiosignatuurit ja konteksti, joita tarvitaan samankaltaisten ehdokkaiden erottamiseen. Esimerkiksi kysely ”Etsi funktio, joka normalisoi polut säilyttäen lopussa olevan erottimen” antaa konkreettisen täsmäytettävän toiminnan. Liitä olennaiset kieli-, alusta- tai versiorajoitteet. Tarkasta järjestämisen jälkeen valittu koodi ja sen riippuvuudet ennen sen käyttämistä kontekstina; relevanssipiste ei todista toteutuksen täyttävän jokaista ilmoitettua vaatimusta.

Ohjeet määrittävät relevanssin Malli säilyttää Rerank 2.5:ssä esitellyn ohjeita noudattavan uudelleenjärjestämisen kyvyn. Lisää tiivis ohje kyselyn alkuun tai loppuun, kun käyttäjän tarkoitus tarvitsee täsmennystä. Selitä tutkimusasiakirjojen haussa, painotetaanko otsikkoa, tiettyä menetelmää vai sovellusalaa. Määritä sisäisessä luettelossa, koskeeko pyyntö asennusta, vianmääritystä vai yhteensopivuutta. Pidä ohje linjassa kysymyksen kanssa; pääpyynnön kanssa ristiriitaiset lisätoiveet voivat muuttaa sitä, mitä järjestys pyrkii optimoimaan.

Valmistele ehdokasasiakirjat ja budjetit Syöte on tekstimerkkijonojen luettelo. Poimi lähdeasiakirjoista käyttökelpoinen teksti, säilytä mielekkäät osiorajat ja pidä luettelon rinnalla järjestettyä tietuekarttaa. Valmistaja sallii enintään 1 000 asiakirjaa yhdessä pyynnössä. Se määrittää myös 600 000 tokenin yhteisen syöterajan: kyselytokenit kerrottuna asiakirjojen määrällä sekä kaikkien asiakirjatokenien summa. Tämä eroaa parikohtaisesta kontekstirajasta. Ylimääräisen kyselytekstin vähentäminen voi säästää sekä parin kapasiteettia että pyynnön kokonaisbudjettia.

Laske tokenit asianmukaiselle mallille sen sijaan, että olettaisit sana- tai merkkimäärän olevan tokenimäärä. Valitse suurista ehdokkaista yhtenäiset tekstikohdat tai jaa aineisto hyödyllisten otsikoiden mukaan säilyttäen tiedot päälähteestä. Uudelleenjärjestäminen on hyödyllisintä sen jälkeen, kun ensimmäinen haku on jo löytänyt mahdollisia ehdokkaita: se ei voi sijoittaa puuttuvaa lähdettä, joka ei koskaan päätynyt luetteloon.

Järjestetyt tulokset ja jatkokäyttö Tulos sisältää relevanssipisteet ja alkuperäisiin syöteasiakirjoihin viittaavat indeksit laskevassa relevanssijärjestyksessä. top\_k-vaihtoehto rajaa palautettavien järjestettyjen tulosten määrää; muuten palautetaan kaikki syöte-ehdokkaat. Valmistajan REST-rajapinta sallii myös asiakirjatekstin sisällyttämisen. Käytä kutakin alkuperäistä indeksiä otsikon, lähdetunnisteen ja sovelluksesi tarvitsemien metatietojen hakemiseen ja näytä sitten valitut kohteet tai kokoa olennainen teksti vastauksen näyttökontekstiin.

Tarkasta ylimmät tulokset kysymystä vasten ja pidä lähteen identiteetti näkyvissä. Korkea suhteellinen sijoitus ei varmista asiakirjan tietojen oikeellisuutta, ja vain huonoja ehdokkaita sisältävällä luettelolla on silti ensimmäinen kohde. Erota relevanssin valitseminen sen päättämisestä, riittääkö valittu näyttö käyttäjälle vastaamiseen.

Version vaihtaminen Valmistaja kuvaa rerank-3:a suoraan käyttöön sopivaksi rerank-2.5:n seuraajaksi, jonka API-semantiikka on sama ja pisteet on kalibroitu vastaavan edeltäjän jakaumaan. Yhteensopivuus tukee nykyisen hakuvaiheen ja tietueiden kohdistuksen säilyttämistä. Vertaa merkityksellisiä tulosjärjestyksiä ja mahdollisia pisterajoja nykyisellä aineistolla ennen vaihtoon luottamista. Pidä rerank-3 ja rerank-3-lite erillisinä valintoina: yhteiset rajat ja ohjeiden noudattaminen eivät tee niiden laatu- ja viiveprioriteeteista samoja.

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

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

VoyageAI by MongoDB /`voyageai/rerank-3`

### Aloitus

Voyage rerank-3 on laatupainotteinen Rerank 3 -versio kyselyn ja asiakirjan relevanssin pisteyttämiseen. Se järjestää haetut tekstiehdokkaat uudelleen, tukee luonnollisen kielen relevanssiohjeita ja käsittelee 32 000 tokenin pareja pitkien asiakirjojen, koodin ja tietopankkien haussa.

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-3 | 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-3",
  "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-3'
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-3`](https://ailoot.ai/models/fi/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank)

#### Menetelmäpolkujen aliakset

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

#### Liittyvät kutsujan ID:t

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

FAQ · VoyageAI by MongoDB: rerank-3

Mitä syötteitä ja tuloksia on saatavilla?

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

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

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

Mitä rajoja sovelletaan?

`POST /v1/rerank` · `voyageai/rerank-3`: `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.