VoyageAI by MongoDB: rerank-2.5
rerank-2.5 herschikt een aangeleverde reeks tekstkandidaten op relevantie voor een zoekvraag en optionele instructies in natuurlijke taal. Het is een meertalige, op kwaliteit gerichte reranker met een zoekvraag-documentcontext van 32.000 tokens en gerangschikte scores gekoppeld aan de oorspronkelijke kandidaatindices.
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.
rerank-2.5 is de instructievolgende reranker van Voyage AI, ontworpen om een reeks zoekkandidaten te verfijnen. Het onderzoekt de zoekvraag en elk document gezamenlijk als cross-encoder en geeft daarna een relevantievolgorde terug. De release van de maker benadrukt controle in natuurlijke taal over wat als relevant geldt, meertalige retrieval en een langere zoekvraag-documentcontext dan de voorgaande rerank-2-editie.
Geef het model de te vergelijken kandidaten
De invoer is een zoekvraag en een lijst kandidaattekstdocumenten. Dit kunnen passages zijn die door embeddingzoeken of een lexicale eerste zoekfase zijn geselecteerd. De reranker beoordeelt de aangeleverde tekst in plaats van corpusembeddings te maken, dus zijn praktische taak is de kandidaten te verfijnen die de eerste zoekopdracht al vond.
Behoud de oorspronkelijke kandidaatvolgorde en bronidentificatoren bij het voorbereiden van die lijst. De teruggegeven indices verwijzen naar die invoerposities. Lever voor een RAG-taak de passages aan die de antwoordfase daadwerkelijk zou kunnen gebruiken, inclusief de titel of voorwaarden die voor de interpretatie nodig zijn. Een relevant document dat ontbreekt in de ingediende kandidatenreeks kan niet als nieuw gevonden resultaat van reranking verschijnen.
Specificeer de beoogde betekenis van relevantie
Instructies kunnen vóór of achter de zoekvraag worden toegevoegd. De release beschrijft drie bruikbare rollen: een bepaald deel van een document benadrukken, een brontype verkiezen en de zoekvraag met toepassingscontext verduidelijken. Deze veranderen de relevantietaak die aan het model wordt voorgelegd.
Een illustratieve instructie voor technisch zoeken is: “Geef voorrang aan passages die het fout- en herstelgedrag uitleggen; inleidende overzichten zijn ondergeschikt.” Specificeer voor een onderzoekscollectie of titel, methode of resultaat het belangrijkst is. Vermeld voor een dubbelzinnige term het vakgebied waarop de zoekopdracht betrekking heeft. Houd vraag en instructie verenigbaar, zodat de ene niet om een breed onderwerp vraagt terwijl de andere de taak stilzwijgend verandert.
Deze voorkeuren sturen de relevantiescoring. Als de toepassing strikte toelatingseisen heeft — zoals bronversie, datum of toegangsafbakening — bereid dan de toegelaten kandidatenreeks afzonderlijk voor. De relevantie-instructie van het model en een deterministische collectiebeperking dienen verschillende doelen.
Gerangschikte uitvoer en later gebruik van resultaten
Resultaten worden op aflopende relevantie geordend en bevatten een relevantiescore als drijvendekommagetal en de oorspronkelijke invoerindex van de kandidaat. De optie top-k kiest hoeveel best gerangschikte resultaten moeten worden teruggegeven; zonder die optie geeft de specificatie van de fabrikant resultaten voor alle ingediende kandidaten terug. Een optionele instelling return-documents neemt de bijbehorende brontekst op; anders bevat de respons indices en scores.
Gebruik de volgorde om passages te selecteren voor weergave of een latere antwoordfase en houd hun bronidentiteit intact. Controleer de daadwerkelijke tekst bij het beoordelen van de rangschikking: de score is een maat voor de relevantie voor de ingediende zoekvraag, geen gegenereerd antwoord of verificatie dat de beweringen in het document juist zijn. Dit maakt het model nuttig voor het verfijnen van technisch, juridisch, financieel, medisch, conversationeel en meertalig zoekmateriaal zonder rangschikking om te zetten in een inhoudelijke domeinconclusie.
Context, totaal tokenbudget en afkappen
De gedocumenteerde zoekvraaglimiet is 8.000 tokens, inclusief instructies in de zoekvraag. De zoekvraag plus één kandidaatdocument moet binnen 32.000 tokens passen en de documentlijst mag maximaal 1.000 items bevatten. De totale ruimte is 600.000 tokens, geteld als zoekvraagtokens vermenigvuldigd met het aantal documenten, plus alle documenttokens. Een lange instructie wordt dus herhaaldelijk meegeteld over de kandidatenparen.
Het aantal uitvoerresultaten bij top-k verandert het aantal kandidaten in die invoertokenberekening niet. Standaard afkappen verkort te lange zoekvragen of documenten om aan de contextlimiet te voldoen; uitschakelen zorgt dat een te lange zoekvraag of een te lang paar een fout teruggeeft. Bereid antwoorddragende passages bewust voor en houd de relevante voorwaarden binnen de tekst die het model zal zien. Beoordeel de verfijnde volgorde op representatieve vragen en instructies en geef daarna de geselecteerde oorspronkelijke passages door aan de volgende fase.
Ailoot Ultra · Opnieuw rangschikken POST /v1/rerank voyageai/rerank-2.5
voyageai/rerank-2.5Aan de slag
rerank-2.5 herschikt een aangeleverde reeks tekstkandidaten op relevantie voor een zoekvraag en optionele instructies in natuurlijke taal. Het is een meertalige, op kwaliteit gerichte reranker met een zoekvraag-documentcontext van 32.000 tokens en gerangschikte scores gekoppeld aan de oorspronkelijke kandidaatindices.
- 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-2.5 | 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.0001 / 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-2.5",
"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-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
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-2.5
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · VoyageAI by MongoDB: rerank-2.5
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/rerank·voyageai/rerank-2.5:text→rerank- Welke velden gebruikt het verzoek?
POST /v1/rerank·voyageai/rerank-2.5:documents,model,provider,query,session_id,top_n,trace,user- Welke limieten gelden?
POST /v1/rerank·voyageai/rerank-2.5:top_n.minimum:1