modeller

VoyageAI by MongoDB: rerank-3

Markdown · JSON

VoyageAI by MongoDB: rerank-3

Voyage rerank-3 är den kvalitetsinriktade Rerank 3-utgåvan för poängsättning av relevansen mellan fråga och dokument. Den omordnar hämtade textkandidater, stöder relevansinstruktioner på naturligt språk och hanterar par på 32 000 token för sökning i långa dokument, kod och kunskapsbaser.

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.

Voyage rerank-3 är en omrangordnare för text utformad för att förbättra kvaliteten på hämtade underlag. Med en fråga och en lista med kandidatdokument granskar den varje par tillsammans och returnerar kandidaterna ordnade efter relevans. Embeddings och nyckelordssökning kan först begränsa en stor samling till ett hanterbart urval; rerank-3 tillämpar sedan en mer detaljerad relevansbedömning på urvalet. Utdata är poängsatta sökunderlag som en applikation kan visa eller skicka vidare till ett separat svarsgenereringssteg.

Kvalitetsinriktad Rerank 3 Tillverkaren positionerar rerank-3 som den noggrannhetsinriktade utgåvan och rerank-3-lite som utgåvan för latenskänslig sökning. Den tredje generationen uppdaterar basarkitekturen och träningsblandningen, med särskilda förbättringar för hämtning av långa dokument och källkod jämfört med motsvarande 2.5-föregångare. Tillverkaren utvärderar den över teknisk dokumentation, kod, flerspråkigt material och andra dokumentdomäner. Dessa resultat stöder dess hämtningsroll; välj utgåva utifrån de frågor och kandidatdokument som spelar roll i din egen samling.

Långa dokument med tillräcklig kontext En lång kandidat kan innehålla användbar kontext långt bortom det inledande stycket. Tillhandahåll ett sammanhängande avsnitt eller dokument med titel och relevant omgivande material så att modellen kan bedöma hur den faktiska frågan hänger ihop med innehållet. För en sökning om produktpolicy bevarar du rubriker och undantag kring det intressanta avsnittet. Om flera hämtade avsnitt kommer från samma källa behåller du deras dokument- och avsnittsidentifierare; applikationen kan då visa var det valda underlaget kom ifrån.

Kontextfönstret delas av frågan och varje kandidat. Tillverkarens aktuella guide anger 32 000 token för paret, inklusive en fråga på högst 8 000 token. En fråga på 3 000 token lämnar därför högst 29 000 token för varje dokument. Förbered indata så att det väsentliga innehållet ryms, särskilt när en lång inledning eller upprepad standardtext annars skulle förbruka fönstret. Det dokumenterade trunkeringsalternativet är aktiverat som standard och kan korta för stor fråge- eller dokumenttext före poängsättningen. Granska vad som behålls när avsnittets placering spelar roll.

Kod och teknisk hämtning För en kodassistents hämtningssteg kan kandidater innehålla funktionsimplementationer, API-dokumentation eller tekniska förklaringar som text. Ta med symboler, signaturer och kontext som behövs för att skilja liknande kandidater åt. En fråga som ”Hitta funktionen som normaliserar sökvägar och samtidigt bevarar en avslutande avgränsare” ger ett konkret beteende att matcha. Lägg till eventuella relevanta språk-, plattforms- eller versionskrav. Efter rangordning granskar du den valda koden och dess beroenden innan den används som kontext; en relevanspoäng bevisar inte att en implementation uppfyller varje angivet krav.

Instruktioner definierar relevans Modellen behåller den instruktionsföljande omrangordningsförmåga som infördes i Rerank 2.5. Lägg en kort instruktion före eller efter frågan när användarens avsikt behöver förtydligas. För sökning i forskningsdokument förklarar du om fokus ligger på titeln, en viss metod eller ett tillämpningsområde. För en intern katalog anger du om förfrågan gäller installation, felsökning eller kompatibilitet. Håll instruktionen i linje med frågan; extra önskemål som står i konflikt med huvudförfrågan kan ändra vad rangordningen försöker optimera.

Förbered kandidatdokument och budgetar Indata är en lista med textsträngar. Extrahera användbar text ur källdokumenten, bevara meningsfulla avsnittsgränser och behåll en ordnad postkarta tillsammans med listan. Tillverkaren tillåter upp till 1 000 dokument i en förfrågan. Den anger även ett sammanlagt indatatak på 600 000 token: frågetoken multiplicerat med antalet dokument plus summan av alla dokumenttoken. Detta skiljer sig från kontextgränsen per par. Att minska överflödig frågetext kan bevara både parkapacitet och total förfrågningsbudget.

Räkna token för den relevanta modellen i stället för att anta att ett ord- eller teckenantal är ett tokenantal. För stora kandidater väljer du sammanhängande textavsnitt eller delar materialet efter användbara rubriker samtidigt som information om överordnad källa behålls. Omrangordning är mest användbar när den första sökningen redan har hittat rimliga kandidater: den kan inte rangordna en saknad källa som aldrig kom med i listan.

Rangordnade resultat och efterföljande användning Resultatet innehåller relevanspoäng och index som hänvisar till de ursprungliga indatadokumenten, sorterade i fallande relevansordning. Alternativet top_k begränsar antalet rangordnade resultat som returneras; annars returneras alla indatakandidater. Tillverkarens REST-gränssnitt tillåter även att dokumenttexten inkluderas. Använd varje ursprungligt index för att återfinna titel, källidentifierare och eventuella metadata som applikationen behöver och presentera sedan de valda objekten eller lägg den relevanta texten i svarets beläggskontext.

Granska toppresultaten mot frågan och håll källidentiteten synlig. En hög relativ placering verifierar inte ett dokuments faktiska korrekthet och ett urval med bara dåliga kandidater får ändå ett förstaplacerat objekt. Skilj relevansurval från beslutet om huruvida det valda underlaget är tillräckligt för att besvara användaren.

Migrering mellan utgåvor Tillverkaren beskriver rerank-3 som en direkt ersättare till rerank-2.5, med samma API-semantik och poäng kalibrerade mot motsvarande föregångares fördelning. Kompatibiliteten stöder att behålla ett befintligt hämtningssteg och postkoppling. Jämför meningsfulla resultatordningar och eventuella poängtrösklar på den aktuella samlingen innan du förlitar dig på migreringen. Håll rerank-3 och rerank-3-lite som separata val: gemensamma gränser och instruktionsföljning gör inte deras kvalitets- och latensprioriteringar identiska.

Ailoot Ultra · Omrangordning POST /v1/rerank voyageai/rerank-3

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

Start

Voyage rerank-3 är den kvalitetsinriktade Rerank 3-utgåvan för poängsättning av relevansen mellan fråga och dokument. Den omordnar hämtade textkandidater, stöder relevansinstruktioner på naturligt språk och hanterar par på 32 000 token för sökning i långa dokument, kod och kunskapsbaser.

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ältTypKravVärden & gränserStandard
FältdocumentsTyparrayKravObligatorisktVärden & gränserStandard—
FältmodelTypstringKravObligatorisktVärden & gränser
voyageai/rerank-3
Standard—
FältproviderTypschemaKravValfrittVärden & gränserStandard—
FältqueryTypstringKravObligatorisktVärden & gränserStandard—
Fältsession_idTypstringKravValfrittVärden & gränserStandard—
Fälttop_nTypintegerKravValfrittVärden & gränser
Minimum: 1
Standard—
FälttraceTypschemaKravValfrittVärden & gränserStandard—
FältuserTypstringKravValfrittVärden & gränserStandard—
Fältdocuments[].textTypstringKravValfrittVärden & gränserStandard—
Fältdocuments[].imageTypstringKravValfrittVärden & gränserStandard—
Kombinationer av indatamaterial

text_rerank · Krävs: query, documents array with minItems1

Metodparametrar och livscykel
ParameterAvtal
Parametercontent_typeAvtalapplication/json
ParameterrequiredAvtalmodel, query, documents
Parametermaterial_typesAvtaltext
Parameteroptional_controlsAvtalprovider, session_id, top_n, trace, user
Parametermultimodal_input_bindingAvtalnull

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.

KonfigurationPrislistaDebiteringsenhetAvgift
KonfigurationGrundpriser för tokenPrislistaGrundprisDebiteringsenhet—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
KonfigurationUltraPrislista—Debiteringsenhet/ 1K tokenAvgift
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

Bevarad officiell begärandestruktur; dokumentationsexempelAnvänd ditt faktiska underlag för begäran och bevara hela resultatet
{
  "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

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ältTyp
FältmodelTypstring
FältidTypstring
FältproviderTypstring
Fältresults[].indexTypinteger
Fältresults[].relevance_scoreTypnumber
Fältresults[].document.textTypstring
Fältresults[].document.imageTypstring
Fältusage.search_unitsTypinteger
Fältusage.total_tokensTypinteger
Fältusage.costTypnumber
Fel och nästa steg
SvarVillkorNästa steg
Svar400 · invalid_request_errorVillkorOgiltigt obligatoriskt fält, ogiltig representation eller ogiltigt värdeNästa stegKorrigera det angivna fältet i begäran.

Alias

Modellalias

Ailoot Ultra voyageai/rerank-3

Alias för metodsökvägar

Använd metodsökvägarna som visas ovan.

Relaterade anropar-ID:n

voyageai/rerank-3

FAQ · VoyageAI by MongoDB: rerank-3
Vilka indata och resultat finns?

POST /v1/rerank · voyageai/rerank-3: text → rerank

Vilka fält använder begäran?

POST /v1/rerank · voyageai/rerank-3: documents, model, provider, query, session_id, top_n, trace, user

Vilka gränser gäller?

POST /v1/rerank · voyageai/rerank-3: top_n.minimum: 1

Fler detaljer

Anslut Ailoot till Claude Code, OpenCode, Hermes eller din app.

Företaget och dess projektportfölj

Företaget och dess projektportfölj: miljontals kunder; månatlig försäljning för miljarder.

Köp token med rabatt.

Prenumerationsrabatt för återkommande arbete. Kampanjkoder ger upp till 50% vid tokenköp.

Prenumeration
Välj en rabatterad plan för återkommande anrop.
Kampanjkod upp till 50%
Ange koden vid köpet. Priset räknas om enligt kampanjen.
Kostnader i historiken
Modell, token och belopp sparas för varje anrop.

Välj prenumeration · Se modellpriser

Anslut API till produkten som du säljer.

SaaS, appar och botar enligt Ailoots officiella villkor och licensavtal. Begär återförsäljarlicens för vidareförsäljning.

Kommersiell applikation
Bygg text-, bild-, video- och ljudgenerering i tjänstens betalda funktioner.
Återförsäljarlicens
Skicka projektbeskrivning och åtkomstupplägg. Begär skriftliga villkor för användning och vidareförsäljning.
Dokument på webbplatsen
Officiella villkor, licensavtal och databehandlingspolicy finns tillgängliga före anslutning.

Begär återförsäljarlicens · Officiella villkor och licensavtal