VoyageAI by MongoDB: rerank-2.5
rerank-2.5 omordnar en tillhandahållen uppsättning textkandidater efter relevans för en fråga och valfria instruktioner på naturligt språk. Den är en flerspråkig kvalitetsinriktad omrangordnare med en fråga–dokument-kontext på 32 000 token och rangordnade poäng kopplade till de ursprungliga kandidatindexen.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
rerank-2.5 är Voyage AI:s instruktionsföljande omrangordnare, utformad för att förfina en uppsättning sökkandidater. Den granskar frågan och varje dokument tillsammans som en korsenkodare och returnerar sedan en relevansordning. Tillverkarens utgåva betonar kontroll på naturligt språk över vad som räknas som relevant, flerspråkig hämtning och en längre fråga–dokument-kontext än den föregående rerank-2-utgåvan.
Ge modellen kandidaterna som ska jämföras
Indata är en fråga och en lista med kandidatdokument i text. Dessa kan vara avsnitt valda genom embeddingsökning eller ett lexikalt första söksteg. Omrangordnaren bedömer den tillhandahållna texten i stället för att skapa embeddings för textsamlingen, så dess praktiska uppgift är att förfina kandidaterna som den första sökningen redan hittade.
Behåll den ursprungliga kandidatordningen och källidentifierarna när listan förbereds. De returnerade indexen hänvisar till dessa indatapositioner. För en RAG-uppgift tillhandahåller du textavsnitten som svarsteget faktiskt kan använda, inklusive titeln eller villkoren som behövs för att tolka dem. Ett relevant dokument som saknas i den inskickade kandidatuppsättningen kan inte dyka upp som ett nyfunnet resultat av omrangordningen.
Ange den avsedda innebörden av relevans
Instruktioner kan läggas till efter eller före frågan. Utgåvan beskriver tre användbara roller: betona en särskild del av ett dokument, föredra en källtyp och göra frågan entydig med applikationskontext. Dessa ändrar relevansuppgiften som presenteras för modellen.
För en teknisk sökning är en illustrativ instruktion ”Prioritera textavsnitt som förklarar fel- och återhämtningsbeteendet; inledande översikter är sekundära.” För en forskningssamling anger du om titeln, metoden eller resultatet spelar störst roll. För en tvetydig term anger du sökningens ämnesområde. Håll frågan och instruktionen samstämmiga så att den ena inte efterfrågar ett brett ämne medan den andra tyst ändrar uppgiften.
Dessa önskemål styr relevanspoängsättningen. Om applikationen har strikta behörighetskrav — som källversion, datum eller åtkomstomfattning — förbereder du den tillåtna kandidatuppsättningen separat. Modellens relevansinstruktion och en deterministisk samlingsbegränsning fyller olika syften.
Rangordnade utdata och senare användning av resultat
Resultaten ordnas efter fallande relevans och innehåller en relevanspoäng som flyttal och kandidatens ursprungliga indataindex. Alternativet top-k väljer hur många ledande resultat som returneras; utan det returnerar tillverkarens specifikation resultat för alla inskickade kandidater. En valfri inställning för return-documents inkluderar motsvarande källtext; annars innehåller svaret index och poäng.
Använd ordningen för att välja textavsnitt för visning eller ett senare svarssteg och håll deras källidentitet intakt. Granska den faktiska texten när rangordningen bedöms: poängen är ett mått på relevans för den inskickade frågan, inget genererat svar eller en verifiering av att dokumentets påståenden är korrekta. Det gör modellen användbar för att förfina tekniskt, juridiskt, finansiellt, medicinskt, konversationsbaserat och flerspråkigt sökmaterial utan att omvandla rangordning till en domänslutsats.
Kontext, total tokenbudget och trunkering
Den dokumenterade frågegränsen är 8 000 token, inklusive instruktioner som placerats i frågan. Frågan plus ett valfritt enskilt kandidatdokument måste rymmas inom 32 000 token och dokumentlistan får innehålla högst 1 000 objekt. Den totala tilldelningen är 600 000 token, räknat som frågetoken multiplicerat med antalet dokument plus alla dokumenttoken. En lång instruktion räknas därför upprepade gånger över kandidatparen.
Antalet utdata för top-k ändrar inte antalet kandidater i den indatatokenberäkningen. Standardtrunkering kortar för långa frågor eller dokument så att kontextgränsen uppfylls; att stänga av den gör att en för lång fråga eller ett för långt par returnerar ett fel. Förbered medvetet textavsnitt som innehåller svaret och håll relevanta villkor inom texten som modellen kommer att se. Bedöm den förfinade ordningen för representativa frågor och instruktioner och skicka sedan de valda originalavsnitten till nästa steg.
Ailoot Ultra · Omrangordning POST /v1/rerank voyageai/rerank-2.5
voyageai/rerank-2.5Start
rerank-2.5 omordnar en tillhandahållen uppsättning textkandidater efter relevans för en fråga och valfria instruktioner på naturligt språk. Den är en flerspråkig kvalitetsinriktad omrangordnare med en fråga–dokument-kontext på 32 000 token och rangordnade poäng kopplade till de ursprungliga kandidatindexen.
- Godkända indata
- Text
- Resultat
- Rangordnade resultat
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Omrangordning POST /v1/rerank
- Indatatyper
text- Utdatatyper
rerank- Utdataformat
- json
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältdocuments | Typarray | KravObligatoriskt | Värden & gränser | Standard— |
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser voyageai/rerank-2.5 | Standard— |
Fältprovider | Typschema | KravValfritt | Värden & gränser | Standard— |
Fältquery | Typstring | KravObligatoriskt | Värden & gränser | Standard— |
Fältsession_id | Typstring | KravValfritt | Värden & gränser | Standard— |
Fälttop_n | Typinteger | KravValfritt | Värden & gränser Minimum: 1 | Standard— |
Fälttrace | Typschema | KravValfritt | Värden & gränser | Standard— |
Fältuser | Typstring | KravValfritt | Värden & gränser | Standard— |
Fältdocuments[].text | Typstring | KravValfritt | Värden & gränser | Standard— |
Fältdocuments[].image | Typstring | KravValfritt | Värden & gränser | Standard— |
Kombinationer av indatamaterial
text_rerank · Krävs: query, documents array with minItems1
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, query, documents |
Parametermaterial_types | Avtaltext |
Parameteroptional_controls | Avtalprovider, session_id, top_n, trace, user |
Parametermultimodal_input_binding | Avtalnull |
Livscykel: synchronous
Skicka det exakta modell-ID:t och behåll hela svaret i leverantörens format.
Priser
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Ailoot-priser
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Debiteringsenhet | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Debiteringsenhet— | Avgift Indata · Indatatoken — / 1K token Utdata · Utdatatoken — / 1K token Indata · Cacheläsning — / 1K token Indata · Skrivning till cache — / 1K token Indata · Skrivning till cache, 1 tim — / 1K token |
| KonfigurationUltra | Prislista— | Debiteringsenhet/ 1K token | Avgift Indata $0.0001 / 1K token |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
Ailoot Ultra · Omrangordning
{
"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
Ta emot och spara resultat
Ailoot Ultra · Omrangordning
json
Behåll alla färdiga resultat
Behåll varje fullständigt returnerat svar, fil och innehållsdel.
Varje faktiskt resultatindex, ändligt relevance_score och ursprungligt dokumentobjekt behålls. Indexen knyter resultaten till den ursprungliga dokumentarrayen. Hela det ursprungliga JSON-svaret lagras och returneras först efter avräkning.
Om det ursprungliga svaret behöver kontrolleras
Bevara den ursprungliga operationen och hela eller det partiella svaret; upprepa inte POST.
Svarsfält
| Fält | Typ |
|---|---|
Fältmodel | Typstring |
Fältid | Typstring |
Fältprovider | Typstring |
Fältresults[].index | Typinteger |
Fältresults[].relevance_score | Typnumber |
Fältresults[].document.text | Typstring |
Fältresults[].document.image | Typstring |
Fältusage.search_units | Typinteger |
Fältusage.total_tokens | Typinteger |
Fältusage.cost | Typnumber |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltigt obligatoriskt fält, ogiltig representation eller ogiltigt värde | Nästa stegKorrigera det angivna fältet i begäran. |
Alias
Modellalias
Ailoot Ultra voyageai/rerank-2.5
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · VoyageAI by MongoDB: rerank-2.5
- Vilka indata och resultat finns?
POST /v1/rerank·voyageai/rerank-2.5:text→rerank- Vilka fält använder begäran?
POST /v1/rerank·voyageai/rerank-2.5:documents,model,provider,query,session_id,top_n,trace,user- Vilka gränser gäller?
POST /v1/rerank·voyageai/rerank-2.5:top_n.minimum:1