VoyageAI by MongoDB: 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.
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-3Aloitus
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 | Tyyppiarray | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat voyageai/rerank-3 | Oletus— |
Kenttäprovider | Tyyppischema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäquery | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäsession_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätop_n | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: 1 | Oletus— |
Kenttätrace | Tyyppischema | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäuser | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttädocuments[].text | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttädocuments[].image | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Syöteaineistojen yhdistelmät
text_rerank · Pakollinen: query, documents array with minItems1
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, query, documents |
Parametrimaterial_types | Sopimustext |
Parametrioptional_controls | Sopimusprovider, session_id, top_n, trace, user |
Parametrimultimodal_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 →
Esimerkkipyynnöt
Ailoot Ultra · Uudelleenjärjestys
{
"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
}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
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
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