VoyageAI by MongoDB: rerank-3
Voyage rerank-3 is de kwaliteitsgerichte Rerank 3-editie voor het scoren van de relevantie tussen zoekvraag en document. Het herschikt opgehaalde tekstkandidaten, ondersteunt relevantie-instructies in natuurlijke taal en verwerkt paren van 32.000 tokens voor zoeken in lange documenten, code en kennisbanken.
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 is een tekstreranker die de kwaliteit van opgehaald bewijsmateriaal moet verbeteren. Met een zoekvraag en een lijst kandidaatdocumenten onderzoekt het elk paar samen en geeft het de kandidaten geordend op relevantie terug. Embeddings en trefwoordzoeken kunnen eerst een grote verzameling tot een beheersbare shortlist beperken; rerank-3 past vervolgens een gedetailleerdere relevantiebeoordeling op die shortlist toe. De uitvoer is gescoord zoekbewijsmateriaal dat een toepassing kan tonen of aan een afzonderlijke antwoordgeneratiestap kan doorgeven.
Kwaliteitsgerichte Rerank 3 De maker positioneert rerank-3 als de op nauwkeurigheid gerichte editie en rerank-3-lite als de editie voor latentiegevoelig zoeken. De derde generatie werkt de basisarchitectuur en trainingsmix bij, met specifieke verbeteringen voor het ophalen uit lange documenten en broncode ten opzichte van de overeenkomstige 2.5-voorgangers. De producent evalueert het op technische documentatie, code, meertalig materiaal en andere documentdomeinen. Die resultaten ondersteunen de ophaalrol; selecteer de editie op basis van de vragen en kandidaatdocumenten die voor je eigen verzameling belangrijk zijn.
Lange documenten met voldoende context Een lange kandidaat kan nuttige context bevatten die ver voorbij de openingsalinea ligt. Lever een samenhangende sectie of een document met de titel en relevant omliggend materiaal aan, zodat het model kan beoordelen hoe de werkelijke vraag zich tot de inhoud verhoudt. Behoud bij zoeken in productbeleid de koppen en uitzonderingen rond de relevante passage. Als meerdere opgehaalde secties uit dezelfde bron komen, behoud dan hun document- en sectie-identifiers; de toepassing kan zo tonen waar het geselecteerde bewijsmateriaal vandaan komt.
De zoekvraag en elke kandidaat delen het contextvenster. De huidige gids van de maker specificeert 32.000 tokens voor dat paar, inclusief een zoekvraag van maximaal 8.000 tokens. Een zoekvraag van 3.000 tokens laat dus maximaal 29.000 tokens voor elk document over. Bereid de invoer zo voor dat de essentiële inhoud past, vooral wanneer een lange inleiding of herhaalde standaardtekst anders het venster zou vullen. De gedocumenteerde afkapoptie is standaard ingeschakeld en kan te lange zoekvragen of documenttekst vóór het scoren inkorten. Onderzoek wat behouden blijft wanneer de plaats van een passage van belang is.
Code en technische informatie ophalen Voor de ophaalfase van een programmeerassistent kunnen kandidaten functie-implementaties, API-documentatie of technische uitleg als tekst bevatten. Voeg de symbolen, signatures en context toe die nodig zijn om vergelijkbare kandidaten te onderscheiden. Een zoekvraag zoals “Vind de functie die paden normaliseert met behoud van een afsluitend scheidingsteken” geeft concreet gedrag om op te matchen. Voeg eventuele relevante taal-, platform- of versievoorwaarden toe. Onderzoek na de rangschikking de geselecteerde code en de afhankelijkheden voordat je die als context gebruikt; een relevantiescore bewijst niet dat een implementatie aan elke opgegeven vereiste voldoet.
Instructies bepalen relevantie Het model behoudt de mogelijkheid voor instructiegestuurd herschikken die in Rerank 2.5 werd ingevoerd. Plaats een beknopte instructie vóór of na de zoekvraag wanneer de gebruikersbedoeling verduidelijking vereist. Leg bij zoeken in onderzoeksdocumenten uit of de nadruk op de titel, een bepaalde methode of een toepassingsdomein ligt. Specificeer voor een interne catalogus of de aanvraag over installatie, probleemoplossing of compatibiliteit gaat. Houd die instructie in lijn met de vraag; extra voorkeuren die met de hoofdvraag botsen, kunnen veranderen wat de rangschikking probeert te optimaliseren.
Bereid kandidaatdocumenten en budgetten voor De invoer is een lijst tekststrings. Haal bruikbare tekst uit brondocumenten, behoud betekenisvolle sectiegrenzen en houd een geordende registratiekoppeling naast de lijst bij. De maker staat maximaal 1.000 documenten in één aanvraag toe. Hij specificeert ook een totaal invoerplafond van 600.000 tokens: zoekvraagtokens vermenigvuldigd met het aantal documenten, plus de som van alle documenttokens. Dit verschilt van de contextlimiet per paar. Overbodige zoekvraagtekst verminderen kan zowel de paarcapaciteit als het totale aanvraagbudget behouden.
Tel tokens voor het relevante model in plaats van aan te nemen dat een woord- of tekentelling een tokentelling is. Selecteer voor grote kandidaten samenhangende passages of deel het materiaal op volgens nuttige koppen en behoud daarbij informatie over de bovenliggende bron. Herschikken is het nuttigst wanneer de eerste zoekopdracht al aannemelijke kandidaten heeft gevonden: het kan een ontbrekende bron die nooit in de lijst kwam niet rangschikken.
Gerangschikte resultaten en verder gebruik Het resultaat bevat relevantiescores en indices die naar de oorspronkelijke invoerdocumenten verwijzen, gesorteerd op aflopende relevantie. De optie top_k beperkt het aantal teruggegeven gerangschikte resultaten; anders worden alle invoerkandidaten teruggegeven. De REST-interface van de maker laat ook toe de documenttekst op te nemen. Gebruik elke oorspronkelijke index om de titel, bronidentifier en eventuele metagegevens die je toepassing nodig heeft terug te vinden en toon vervolgens de geselecteerde items of neem de relevante tekst op in de bewijscontext van een antwoord.
Toets de bovenste resultaten aan de vraag en houd de bronidentiteit zichtbaar. Een hoge relatieve rang verifieert de feitelijke juistheid van een document niet en een shortlist met alleen slechte kandidaten heeft nog steeds een eerste item. Scheid relevantieselectie van de beslissing of het geselecteerde bewijsmateriaal volstaat om de gebruiker te antwoorden.
Editiemigratie De maker beschrijft rerank-3 als een rechtstreeks vervangbare opvolger van rerank-2.5, met dezelfde API-semantiek en scores die op de verdeling van de overeenkomstige voorganger zijn gekalibreerd. Die compatibiliteit ondersteunt het behoud van een bestaande ophaalfase en registratiekoppeling. Vergelijk betekenisvolle resultaatvolgordes en eventuele scoredrempels op het huidige corpus voordat je op de migratie vertrouwt. Houd rerank-3 en rerank-3-lite als afzonderlijke keuzes: gedeelde limieten en de mogelijkheid om instructies te volgen maken hun prioriteiten voor kwaliteit en latentie niet identiek.
Ailoot Ultra · Opnieuw rangschikken POST /v1/rerank voyageai/rerank-3
voyageai/rerank-3Aan de slag
Voyage rerank-3 is de kwaliteitsgerichte Rerank 3-editie voor het scoren van de relevantie tussen zoekvraag en document. Het herschikt opgehaalde tekstkandidaten, ondersteunt relevantie-instructies in natuurlijke taal en verwerkt paren van 32.000 tokens voor zoeken in lange documenten, code en kennisbanken.
- Toegestane invoer
- Tekst
- Resultaten
- Resultaten op relevantie
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Opnieuw rangschikken POST /v1/rerank
- Invoer
text- Uitvoer
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 | 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 natieve antwoord.
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus geselecteerd is
- Flex-modus
- Niet opgegeven Wanneer de flex-modus geselecteerd is
- Maximale redeneerinspanning
- Niet opgegeven Wanneer voor 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-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
Resultaten ophalen en opslaan
Ailoot Ultra · Opnieuw rangschikken
json
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Elke werkelijke resultaatindex, eindige relevance_score en elk oorspronkelijk documentobject blijven behouden. De indexen verwijzen naar de oorspronkelijke documentarray. De volledige oorspronkelijke JSON wordt opgeslagen en pas na de afrekening teruggestuurd.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke operatie en het volledige of gedeeltelijke antwoord; voer POST niet opnieuw uit.
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 verplicht veld, ongeldige weergave of ongeldige waarde | Volgende stapCorrigeer het aangegeven aanvraagveld. |
Aliasnamen
Modelaliasnamen
Ailoot Ultra voyageai/rerank-3
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · VoyageAI by MongoDB: rerank-3
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/rerank·voyageai/rerank-3:text→rerank- Welke velden gebruikt het verzoek?
POST /v1/rerank·voyageai/rerank-3:documents,model,provider,query,session_id,top_n,trace,user- Welke limieten gelden?
POST /v1/rerank·voyageai/rerank-3:top_n.minimum:1