VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite scoort en herschikt kandidaattekstdocumenten voor een zoekvraag, met de nadruk op snel reagerende zoekfuncties. Het ondersteunt relevantie-instructies en een zoekvraag-documentvenster van 32.000 tokens, waardoor het bruikbaar is na vector- of trefwoordretrieval in zoek- en RAG-workflows.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Voyage rerank-3-lite is de op lage latentie gerichte editie van de Rerank 3-serie van Voyage. Het neemt een tekstuele zoekvraag en kandidaatdocumenten aan, beoordeelt elk zoekvraag-documentpaar gezamenlijk en geeft relevantiescores in gerangschikte volgorde terug. Het verzorgt de tweede zoekfase: een embedding- of trefwoordzoekfunctie vindt de kandidaten en daarna verfijnt Lite hun volgorde. Het resultaat is een rangschikking voor gebruik in zoeken of een retrieval-augmented generation-workflow.
Wat verandert in Rerank 3 Lite De producent benadrukt sterkere retrieval voor lange documenten en code vergeleken met rerank-2.5-lite. Beide Rerank 3-edities behouden instructievolging en dezelfde contextklasse van 32K, terwijl Lite is ontworpen voor toepassingen die gevoelig zijn voor latentie. Dit maakt het een praktische kandidaat voor interactieve zoekfuncties in kennisbanken, retrieval van ondersteuningsdocumenten en het opzoeken van code wanneer gebruikers snel relevante resultaten nodig hebben. Kies op basis van de kwaliteits- en responstijdeisen van de daadwerkelijke collectie, in plaats van aan te nemen dat een kleinere editie een kleiner contextvenster betekent.
Stuur relevantie met de zoekvraag Instructies in natuurlijke taal kunnen de zoekvraag aanvullen om uit te leggen wat als relevant geldt. Houd de vraag en de relevantievoorkeur beknopt en consistent. Gebruik voor een zoekopdracht naar softwareondersteuning: “Vind de procedure om een apparaat te resetten; geef voorrang aan instructies voor de vermelde hardwarerevisie.” Voeg bij een dubbelzinnige productnaam de productcategorie toe, zodat niet-gerelateerde betekenissen niet overheersen. Een voorkeur in de zoekvraag stuurt de semantische scoring; gebruik expliciete collectiemetadata om het juiste product, de documentversie of de toegangsafbakening te selecteren voordat je de kandidatenlijst opbouwt.
Bereid een shortlist van tekstkandidaten voor De invoerdocumenten zijn strings. Extraheer leesbare tekst uit bronmateriaal en behoud bruikbare titels, koppen, identificatoren en omringende context. Houd een stabiele koppeling van elke invoerpositie naar de oorspronkelijke registratie bij. Neem voor een probleemoplossingsartikel het symptoom en de relevante procedure op, niet alleen een losse zin. Neem voor broncodezoeken de functie en nabijgelegen informatie op die nodig is om haar van gelijknamige functies te onderscheiden. Verwijder herhaalde navigatie of standaardtekst wanneer die de bruikbare passage verdringt.
De reranker kan alleen de documenten herschikken die hij ontvangt. Als de eerste zoekopdracht het relevante artikel nooit ophaalt, kan deze fase die ontbrekende kandidaat niet terughalen. Controleer zowel de shortlist als de uiteindelijke volgorde wanneer een resultaat onjuist lijkt. Splits een lang document met veel onderwerpen in samenhangende secties en behoud de verwijzingen naar het bovenliggende document, zodat een relevante sectie kan worden geselecteerd zonder de bron te verliezen.
Context en verzoeklimieten De huidige gids van de maker specificeert een zoekvraagmaximum van 8.000 tokens en een gecombineerd maximum van 32.000 tokens voor de zoekvraag plus elk afzonderlijk document. Er zijn maximaal 1.000 kandidaatdocumenten en een totaal verzoekbudget van 600.000 tokens toegestaan, berekend als zoekvraagtokens vermenigvuldigd met het aantal documenten, plus alle documenttokens. Een lange zoekvraag verbruikt dus ruimte in elk paar en telt herhaaldelijk mee in het totale budget. Tel de ingediende tekst met de juiste modeltokenizer in plaats van tekens, woorden en tokens als uitwisselbaar te beschouwen.
Een zoekvraag van 500 tokens met 100 documenten van elk 4.000 tokens komt volgens die formule bijvoorbeeld op 450.000 invoertokens. Dit illustreert budgettering, geen aanbevolen shortlistgrootte of gemeten snelheidsresultaat. De gedocumenteerde afkapoptie staat standaard aan; te grote tekst kan vóór de scoring worden ingekort. Bereid belangrijke secties bewust voor, zodat afkappen niet precies de passage verwijdert die je wilt laten overeenkomen.
Lees en gebruik het resultaat Resultaten worden gesorteerd van de hoogste relevantiescore naar beneden. Elk resultaat identificeert de oorspronkelijke invoerpositie van het document, zodat de toepassing haar eigen titel, registratie-ID en bron kan toevoegen. De instelling top_k bepaalt hoeveel gerangschikte kandidaten worden teruggegeven; zonder die instelling worden alle kandidaten teruggegeven. De REST-interface van de maker kan ook de documenttekst teruggeven. Bewaar de oorspronkelijke identificatoren bij de geselecteerde resultaten wanneer je een zoekpagina toont of bewijs doorgeeft aan een stap voor antwoordgeneratie.
Een relevantiescore drukt uit hoe goed een kandidaat bij de zoekvraag past; zij stelt niet vast dat de beweringen van die kandidaat juist zijn. Vergelijk de hoogst gerangschikte items met de daadwerkelijke vraag van de gebruiker, inclusief uitsluitingen en verschillen tussen documentversies. Als elke kandidaat irrelevant is, bestaat er nog steeds een hoogst gerangschikt item. Bepaal met representatieve zoekvragen uit de collectie hoe de toepassing dat geval afhandelt.
Upgraden en de editie kiezen De maker beschrijft rerank-3-lite als een upgrade van rerank-2.5-lite met ongewijzigde API-semantiek en scores die zijn gekalibreerd op de verdeling van de overeenkomstige voorganger. Behoud de bestaande registratiekoppeling en retrievalfase en vergelijk vervolgens de resulterende volgorde voor betekenisvolle zoekvragen voordat je vertrouwt op een bestaande scoredrempel. Gebruik Lite voor een zoekervaring waarin responstijd belangrijk is; gebruik de op kwaliteit gerichte rerank-3-editie ter vergelijking wanneer relevantie bij lastige kandidaten de grotere prioriteit heeft.
Ailoot Ultra · Opnieuw rangschikken POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteAan de slag
Voyage rerank-3-lite scoort en herschikt kandidaattekstdocumenten voor een zoekvraag, met de nadruk op snel reagerende zoekfuncties. Het ondersteunt relevantie-instructies en een zoekvraag-documentvenster van 32.000 tokens, waardoor het bruikbaar is na vector- of trefwoordretrieval in zoek- en RAG-workflows.
- Toegestane invoer
- Tekst
- Resultaten
- Resultaten op relevantie
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Opnieuw rangschikken POST /v1/rerank
- Invoertypen
text- Uitvoertypen
rerank- Uitvoerformaat
- json
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Velddocuments | Typearray | VereisteVereist | Waarden en limieten | Standaard— |
Veldmodel | Typestring | VereisteVereist | Waarden en limieten voyageai/rerank-3-lite | Standaard— |
Veldprovider | Typeschema | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldquery | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldsession_id | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Veldtop_n | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 1 | Standaard— |
Veldtrace | Typeschema | VereisteOptioneel | Waarden en limieten | Standaard— |
Velduser | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Velddocuments[].text | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Velddocuments[].image | Typestring | VereisteOptioneel | Waarden en limieten | Standaard— |
Combinaties van invoermaterialen
text_rerank · Vereist: query, documents array with minItems1
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, query, documents |
Parametermaterial_types | Contracttext |
Parameteroptional_controls | Contractprovider, session_id, top_n, trace, user |
Parametermultimodal_input_binding | Contractnull |
Levenscyclus: synchronous
Verstuur de exacte model-ID en bewaar het volledige native antwoord.
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Rekeneenheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Rekeneenheid— | Kosten Invoer · Invoertokens — / 1K tokens Uitvoer · Uitvoertokens — / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| ConfiguratieUltra | Tariefstaffel— | Rekeneenheid/ 1K tokens | Kosten Invoer $0.00004 / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Opnieuw rangschikken
{
"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
Resultaten ophalen en opslaan
Ailoot Ultra · Opnieuw rangschikken
json
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Elke daadwerkelijke resultaatindex, eindige relevance_score en elk oorspronkelijk documentobject blijven behouden. De indices koppelen aan de oorspronkelijke documentarray. De volledige oorspronkelijke JSON wordt opgeslagen en pas na afrekening geretourneerd.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke operatie en het volledige of gedeeltelijke antwoord; herhaal POST niet.
Antwoordvelden
| Veld | Type |
|---|---|
Veldmodel | Typestring |
Veldid | Typestring |
Veldprovider | Typestring |
Veldresults[].index | Typeinteger |
Veldresults[].relevance_score | Typenumber |
Veldresults[].document.text | Typestring |
Veldresults[].document.image | Typestring |
Veldusage.search_units | Typeinteger |
Veldusage.total_tokens | Typeinteger |
Veldusage.cost | Typenumber |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeOngeldig vereist veld, ongeldige weergave of waarde | Volgende stapCorrigeer het aangegeven verzoekveld. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra voyageai/rerank-3-lite
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Welke velden gebruikt het verzoek?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Welke limieten gelden?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1