VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite pisteyttää ja järjestää ehdolla olevat tekstiasiakirjat hakukyselyn mukaan ja painottaa nopeasti vastaavaa hakua. Se tukee relevanssiohjeita ja 32 000 tokenin kysely–asiakirja-ikkunaa, joten se soveltuu vektori- tai avainsanahaun jälkeiseen vaiheeseen haku- ja RAG-työnkuluissa.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
Voyage rerank-3-lite on Voyagen Rerank 3 -sarjan viiveeseen keskittyvä versio. Se vastaanottaa tekstikyselyn ja ehdolla olevat asiakirjat, arvioi kunkin kysely–asiakirja-parin yhdessä ja palauttaa relevanssipisteet järjestettyinä. Se palvelee haun toista vaihetta: upotus- tai avainsanahaku löytää ehdokkaat, minkä jälkeen Lite tarkentaa niiden järjestystä. Tuloksena on järjestys käytettäväksi haussa tai hakua hyödyntävän generoinnin työnkulussa.
Mitä Rerank 3 Litessä muuttuu Valmistaja korostaa parempaa hakua pitkistä asiakirjoista ja koodista verrattuna rerank-2.5-liteen. Molemmat Rerank 3 -versiot säilyttävät ohjeiden noudattamisen ja saman 32K:n kontekstiluokan, kun taas Lite on suunniteltu viiveherkkiin sovelluksiin. Siksi se on käytännöllinen ehdokas interaktiiviseen tietopankkihakuun, tukiasiakirjojen hakuun ja koodihakuun, kun käyttäjät tarvitsevat olennaiset tulokset nopeasti. Valitse se todellisen kokoelman laatu- ja vasteaikavaatimusten mukaan sen sijaan, että olettaisit pienemmän version tarkoittavan pienempää konteksti-ikkunaa.
Ohjaa relevanssia kyselyllä Kyselyn mukana voi antaa luonnollisen kielen ohjeita siitä, mikä lasketaan olennaiseksi. Pidä kysymys ja relevanssitoive tiiviinä ja keskenään johdonmukaisina. Ohjelmistotuen haussa voit käyttää ohjetta: ”Etsi laitteen nollausmenettely; painota ilmoitetun laiteversion ohjeita.” Lisää monitulkintaiseen tuotenimeen tuoteluokka, jotta asiaan liittymättömät merkitykset eivät hallitse tuloksia. Kyselyn toive ohjaa semanttista pisteytystä; valitse oikea tuote, asiakirjaversio tai käyttöoikeusrajaus kokoelman selkeiden metatietojen avulla ennen ehdokasluettelon rakentamista.
Valmistele tekstiehdokkaiden rajattu luettelo Syöteasiakirjat ovat merkkijonoja. Poimi lähdeaineistosta luettava teksti ja säilytä hyödylliset otsikot, väliotsikot, tunnisteet ja ympäröivä konteksti. Säilytä pysyvä yhteys jokaisen syötepaikan ja alkuperäisen tietueen välillä. Liitä vianmääritysartikkelista oire ja olennainen menettely pelkän irrallisen lauseen sijaan. Liitä lähdekoodihaussa funktio ja sen läheltä tarvittavat tiedot, jotka erottavat sen samannimisistä funktioista. Poista toistuva navigointi tai vakioteksti, kun se syrjäyttää hyödyllisen tekstikohdan.
Uudelleenjärjestäjä voi järjestää vain saamansa asiakirjat. Jos ensimmäinen haku ei koskaan löydä olennaista artikkelia, tämä vaihe ei voi palauttaa puuttuvaa ehdokasta. Tarkista sekä ehdokasluettelo että lopullinen järjestys, kun tulos näyttää väärältä. Kun pitkä asiakirja kattaa monta aihetta, erota yhtenäiset osiot ja säilytä niiden viitteet pääasiakirjaan, jotta olennainen osio voidaan valita menettämättä lähdettä.
Konteksti- ja pyyntörajat Valmistajan nykyinen opas määrittää kyselyn enimmäiskooksi 8 000 tokenia ja kyselyn sekä kunkin yksittäisen asiakirjan yhteiseksi enimmäiskooksi 32 000 tokenia. Se sallii enintään 1 000 ehdokasasiakirjaa ja 600 000 tokenin kokonaisbudjetin pyynnölle. Budjetti lasketaan kertomalla kyselytokenit asiakirjojen määrällä ja lisäämällä kaikki asiakirjatokenit. Pitkä kysely kuluttaa siten tilaa jokaisessa parissa ja kasvattaa kokonaisbudjettia toistuvasti. Laske lähetetyn tekstin tokenit asianmukaisella mallitokenisoijalla sen sijaan, että pitäisit merkkejä, sanoja ja tokeneita keskenään vaihdettavina.
Esimerkiksi 500 tokenin kysely ja 100 asiakirjaa, joista jokainen sisältää 4 000 tokenia, muodostavat tämän kaavan mukaan 450 000 syötetokenia. Tämä havainnollistaa budjetointia eikä suositeltua ehdokasluettelon kokoa tai mitattua nopeustulosta. Dokumentoitu katkaisuvaihtoehto on oletusarvoisesti käytössä; liian pitkää tekstiä voidaan lyhentää ennen pisteytystä. Valmistele tärkeät osiot tarkoituksella, jotta katkaisu ei poista juuri sitä tekstikohtaa, jonka tulee vastata kyselyyn.
Lue ja käytä tulos Tulokset järjestetään suurimmasta relevanssipisteestä alaspäin. Kukin tulos yksilöi asiakirjan alkuperäisen syötepaikan, jolloin sovellus voi liittää siihen oman otsikkonsa, tietuetunnisteensa ja lähteensä. top_k-asetus määrää palautettavien järjestettyjen ehdokkaiden määrän; ilman sitä palautetaan kaikki ehdokkaat. Valmistajan REST-rajapinta voi palauttaa myös asiakirjatekstin. Säilytä alkuperäiset tunnisteet valittujen tulosten rinnalla, kun näytät hakusivun tai välität näyttöä vastausta generoivaan vaiheeseen.
Relevanssipiste ilmaisee, kuinka hyvin ehdokas vastaa kyselyä; se ei osoita ehdokkaan väitteiden olevan oikeita. Vertaa korkeimmalle sijoitettuja kohteita käyttäjän todelliseen kysymykseen, mukaan lukien poissulut ja asiakirjaversioiden erot. Jos jokainen ehdokas on epäolennainen, korkeimmalle sijoitettu kohde on silti olemassa. Päätä kokoelman edustavien kyselyjen avulla, miten sovelluksesi käsittelee tämän tilanteen.
Päivittäminen ja version valitseminen Valmistaja kuvaa rerank-3-liten rerank-2.5-liten päivitykseksi, jonka API-semantiikka on ennallaan ja pisteet on kalibroitu vastaavan edeltäjän jakaumaan. Säilytä nykyinen tietueiden kohdistus ja hakuvaihe ja vertaa sitten syntyvää järjestystä merkityksellisillä kyselyillä ennen vakiintuneeseen pisterajaan luottamista. Käytä Liteä hakukokemukseen, jossa vasteaika on tärkeä; käytä laatupainotteista rerank-3-versiota vertailukohtana, kun vaikeiden ehdokkaiden relevanssi on tärkeämpi prioriteetti.
Ailoot Ultra · Uudelleenjärjestys POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteAloitus
Voyage rerank-3-lite pisteyttää ja järjestää ehdolla olevat tekstiasiakirjat hakukyselyn mukaan ja painottaa nopeasti vastaavaa hakua. Se tukee relevanssiohjeita ja 32 000 tokenin kysely–asiakirja-ikkunaa, joten se soveltuu vektori- tai avainsanahaun jälkeiseen vaiheeseen haku- ja RAG-työnkuluissa.
- 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-lite | 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.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 →
Esimerkkipyynnöt
Ailoot Ultra · Uudelleenjärjestys
{
"documents": [
"Paris is the capital of France.",
"Berlin is the capital of Germany."
],
"model": "voyageai/rerank-3-lite",
"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-lite'
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-lite
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Mitä kenttiä pyyntö käyttää?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Mitä rajoja sovelletaan?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1