modelli

VoyageAI by MongoDB: rerank-3

Markdown · JSON

VoyageAI by MongoDB: rerank-3

Voyage rerank-3 è l'edizione Rerank 3 incentrata sulla qualità per assegnare punteggi alla pertinenza query-documento. Riordina i candidati testuali recuperati, supporta istruzioni di pertinenza in linguaggio naturale e gestisce coppie di 32.000 token per la ricerca in documenti lunghi, codice e basi di conoscenza.

Informazioni sul modello

Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.

Voyage rerank-3 è un reranker testuale progettato per migliorare la qualità delle prove recuperate. Data una query e un elenco di documenti candidati, esamina congiuntamente ogni coppia e restituisce i candidati ordinati per pertinenza. Embedding e ricerca per parole chiave possono prima ridurre una raccolta ampia a un elenco ristretto gestibile; rerank-3 applica poi una valutazione più dettagliata della pertinenza a quell'elenco. Il suo output è costituito da prove di ricerca con punteggio, che un'applicazione può mostrare o passare a una fase separata di generazione della risposta.

Rerank 3 incentrato sulla qualità Il produttore colloca rerank-3 come edizione orientata all'accuratezza e rerank-3-lite come edizione per ricerche sensibili alla latenza. La terza generazione aggiorna l'architettura principale e la miscela di addestramento, con miglioramenti particolari nel recupero di documenti lunghi e codice sorgente rispetto ai predecessori 2.5 corrispondenti. Il produttore la valuta su documentazione tecnica, codice, materiale multilingue e altri ambiti documentali. Questi risultati sostengono il suo ruolo nel recupero; seleziona l'edizione usando le domande e i documenti candidati rilevanti per la tua raccolta.

Documenti lunghi con contesto sufficiente Un candidato lungo può contenere contesto utile ben oltre il paragrafo iniziale. Fornisci una sezione o un documento coerente con titolo e materiale circostante pertinente, così il modello può valutare come la domanda effettiva si collega al contenuto. Per una ricerca su una policy di prodotto, conserva titoli ed eccezioni intorno al brano di interesse. Se più sezioni recuperate provengono dalla stessa fonte, mantieni gli identificatori di documento e sezione; l'applicazione può quindi mostrare l'origine delle prove selezionate.

La finestra di contesto è condivisa dalla query e da ogni candidato. La guida corrente del produttore specifica 32.000 token per quella coppia, inclusa una query di massimo 8.000 token. Una query di 3.000 token lascia quindi al massimo 29.000 token per ciascun documento. Prepara l'input in modo che il contenuto essenziale rientri, soprattutto quando un lungo preambolo o testo standard ripetuto consumerebbero la finestra. L'opzione di troncamento documentata è abilitata per impostazione predefinita e può accorciare query o documenti troppo lunghi prima del punteggio. Esamina ciò che viene conservato quando conta la posizione dei brani.

Recupero di codice e contenuti tecnici Per la fase di recupero di un assistente di programmazione, i candidati possono contenere implementazioni di funzioni, documentazione API o spiegazioni tecniche come testo. Includi simboli, firme e contesto necessari a distinguere candidati simili. Una query come «Trova la funzione che normalizza i percorsi mantenendo un separatore finale» fornisce un comportamento concreto da individuare. Aggiungi i vincoli pertinenti di linguaggio, piattaforma o versione. Dopo la classificazione, esamina il codice selezionato e le sue dipendenze prima di usarlo come contesto; un punteggio di pertinenza non prova che un'implementazione soddisfi ogni requisito dichiarato.

Le istruzioni definiscono la pertinenza Il modello conserva la capacità di reranking guidata da istruzioni introdotta in Rerank 2.5. Anteponi o aggiungi alla query un'istruzione concisa quando l'intento dell'utente richiede chiarimenti. Per cercare documenti di ricerca, spiega se l'attenzione riguarda il titolo, un metodo specifico o un ambito applicativo. Per un catalogo interno, specifica se la richiesta riguarda installazione, risoluzione dei problemi o compatibilità. Mantieni l'istruzione allineata alla domanda; preferenze aggiuntive in conflitto con la richiesta principale possono cambiare ciò che la classifica cerca di ottimizzare.

Prepara documenti candidati e budget L'input è un elenco di stringhe testuali. Estrai testo utilizzabile dai documenti originali, conserva confini significativi tra le sezioni e mantieni una mappa ordinata dei record accanto all'elenco. Il produttore consente fino a 1.000 documenti in una richiesta. Specifica anche un tetto aggregato dell'input di 600.000 token: token della query moltiplicati per il numero di documenti, più la somma di tutti i token dei documenti. Questo differisce dal limite di contesto per coppia. Ridurre il testo ridondante della query può preservare sia la capacità della coppia sia il budget totale della richiesta.

Conta i token per il modello pertinente, invece di presumere che il conteggio di parole o caratteri sia un conteggio di token. Per candidati grandi, seleziona brani coerenti o dividi il materiale secondo titoli utili, conservando le informazioni della fonte padre. Il reranking è più utile dopo che la prima ricerca ha già fatto emergere candidati plausibili: non può classificare una fonte mancante che non è mai entrata nell'elenco.

Risultati classificati e uso a valle Il risultato contiene punteggi di pertinenza e indici riferiti ai documenti di input originali, ordinati per pertinenza decrescente. L'opzione top_k limita il numero di risultati classificati restituiti; altrimenti vengono restituiti tutti i candidati di input. L'interfaccia REST del produttore consente anche di includere il testo dei documenti. Usa ogni indice originale per recuperare titolo, identificatore della fonte e metadati necessari all'applicazione, poi presenta gli elementi selezionati o inserisci il testo pertinente nel contesto di prove di una risposta.

Esamina i primi risultati rispetto alla domanda e mantieni visibile l'identità della fonte. Una posizione relativa alta non verifica l'accuratezza fattuale di un documento e un elenco ristretto contenente solo candidati scadenti avrà comunque un primo elemento. Separa la selezione della pertinenza dalla decisione se le prove selezionate siano sufficienti a rispondere all'utente.

Migrazione dell'edizione Il produttore descrive rerank-3 come un successore di rerank-2.5 sostituibile direttamente, con la stessa semantica API e punteggi calibrati sulla distribuzione del predecessore corrispondente. Questa compatibilità permette di conservare una fase di recupero e una mappatura dei record esistenti. Confronta ordini di risultati significativi e ogni soglia di punteggio sul corpus corrente prima di affidarti alla migrazione. Mantieni rerank-3 e rerank-3-lite come scelte distinte: limiti condivisi e rispetto delle istruzioni non rendono identiche le loro priorità di qualità e latenza.

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

voyageai/rerank-3

VoyageAI by MongoDB /voyageai/rerank-3

Introduzione

Voyage rerank-3 è l'edizione Rerank 3 incentrata sulla qualità per assegnare punteggi alla pertinenza query-documento. Riordina i candidati testuali recuperati, supporta istruzioni di pertinenza in linguaggio naturale e gestisce coppie di 32.000 token per la ricerca in documenti lunghi, codice e basi di conoscenza.

Input accettati
Testo
Risultati
Risultati ordinati

Disponibile in Ailoot · input e metodi

Ailoot Ultra · Riordinamento POST /v1/rerank
Tipi di input
text
Tipi di output
rerank
Formato di output
json
CampoTipoRequisitoValori e limitiPredefinito
CampodocumentsTipoarrayRequisitoObbligatorioValori e limitiPredefinito—
CampomodelTipostringRequisitoObbligatorioValori e limiti
voyageai/rerank-3
Predefinito—
CampoproviderTiposchemaRequisitoFacoltativoValori e limitiPredefinito—
CampoqueryTipostringRequisitoObbligatorioValori e limitiPredefinito—
Camposession_idTipostringRequisitoFacoltativoValori e limitiPredefinito—
Campotop_nTipointegerRequisitoFacoltativoValori e limiti
Minimo: 1
Predefinito—
CampotraceTiposchemaRequisitoFacoltativoValori e limitiPredefinito—
CampouserTipostringRequisitoFacoltativoValori e limitiPredefinito—
Campodocuments[].textTipostringRequisitoFacoltativoValori e limitiPredefinito—
Campodocuments[].imageTipostringRequisitoFacoltativoValori e limitiPredefinito—
Combinazioni di materiali in input

text_rerank · Obbligatorio: query, documents array with minItems1

Parametri e ciclo di vita del metodo
ParametroContratto
Parametrocontent_typeContrattoapplication/json
ParametrorequiredContrattomodel, query, documents
Parametromaterial_typesContrattotext
Parametrooptional_controlsContrattoprovider, session_id, top_n, trace, user
Parametromultimodal_input_bindingContrattonull

Ciclo di vita: synchronous

Invia l'ID esatto del modello e conserva l'intera risposta nativa.

Tariffe

Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.

Modalità rapida
Non specificato Quando è selezionata la modalità rapida
Modalità flex
Non specificato Quando è selezionata la modalità flex
Sforzo massimo di ragionamento
Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)

Tariffe Ailoot

Prezzi per configurazione

Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.

ConfigurazioneListino delle tariffeUnità di fatturazioneCosto
ConfigurazioneTariffe base dei tokenListino delle tariffeTariffa baseUnità di fatturazione—Costo
Input · Token in input — / 1K token
Output · Token in output — / 1K token
Input · Lettura dalla cache — / 1K token
Input · Scrittura nella cache — / 1K token
Input · Scrittura nella cache, 1 ora — / 1K token
ConfigurazioneUltraListino delle tariffe—Unità di fatturazione/ 1K tokenCosto
Input $0.0001 / 1K token

Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →

Esempi di richieste

Ailoot Ultra · Riordinamento

Struttura ufficiale della richiesta conservata; esempio per la documentazioneUsa il materiale effettivo della tua richiesta e conserva il risultato completo
{
  "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

Ricevi e salva i risultati

Ailoot Ultra · Riordinamento

json

Conserva tutti i risultati completati

Conserva ogni risposta, file e parte di contenuto restituiti per intero.

Vengono conservati ogni indice effettivo dei risultati, ogni relevance_score finito e l'oggetto documento originale. Gli indici corrispondono all'array di documenti originale. L'intero JSON originale viene memorizzato e restituito solo dopo il conguaglio dell'addebito.

Se occorre verificare la risposta originale

Conserva l'operazione originale e la risposta completa o parziale; non ripetere POST.

Campi della risposta
CampoTipo
CampomodelTipostring
CampoidTipostring
CampoproviderTipostring
Camporesults[].indexTipointeger
Camporesults[].relevance_scoreTiponumber
Camporesults[].document.textTipostring
Camporesults[].document.imageTipostring
Campousage.search_unitsTipointeger
Campousage.total_tokensTipointeger
Campousage.costTiponumber
Errori e passaggi successivi
RispostaCondizionePassaggio successivo
Risposta400 · invalid_request_errorCondizioneCampo obbligatorio, rappresentazione o valore non validoPassaggio successivoCorreggi il campo della richiesta indicato.

Alias

Alias del modello

Ailoot Ultra voyageai/rerank-3

Alias dei percorsi dei metodi

Usa i percorsi dei metodi indicati sopra.

ID di chiamata correlati

voyageai/rerank-3

FAQ · VoyageAI by MongoDB: rerank-3
Quali input e risultati sono disponibili?

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

Quali campi usa la richiesta?

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

Quali limiti si applicano?

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

Maggiori dettagli

Collega Ailoot a Claude Code, OpenCode, Hermes o alla tua applicazione.

L’azienda e il suo portafoglio di progetti

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Acquista token con uno sconto.

Sconto con abbonamento per lavoro regolare. Codici fino al 50% sull’acquisto di token.

Abbonamento
Scegli un piano scontato per richieste regolari.
Codice fino al 50%
Inserisci il codice all’acquisto. Il prezzo si aggiorna secondo la promozione.
Spese nella cronologia
Modello, token e importo sono salvati per ogni richiesta.

Scegli abbonamento · Consulta prezzi dei modelli

Collega l’API al prodotto che vendi.

SaaS, app e bot secondo offerta e accordo di licenza Ailoot. Per rivendere, richiedi una licenza reseller.

Applicazione commerciale
Integra generazione di testo, immagini, video e suono nelle funzioni a pagamento.
Licenza reseller
Invia descrizione del progetto e schema di accesso. Richiedi condizioni scritte per uso e rivendita.
Documenti sul sito
Offerta, accordo di licenza e politica sui dati sono disponibili prima della connessione.

Richiedi licenza reseller · Offerta e accordo di licenza