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-3Introduzione
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
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campodocuments | Tipoarray | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti voyageai/rerank-3 | Predefinito— |
Campoprovider | Tiposchema | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campoquery | Tipostring | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Camposession_id | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campotop_n | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: 1 | Predefinito— |
Campotrace | Tiposchema | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campouser | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campodocuments[].text | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campodocuments[].image | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Combinazioni di materiali in input
text_rerank · Obbligatorio: query, documents array with minItems1
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, query, documents |
Parametromaterial_types | Contrattotext |
Parametrooptional_controls | Contrattoprovider, session_id, top_n, trace, user |
Parametromultimodal_input_binding | Contrattonull |
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.
| Configurazione | Listino delle tariffe | Unità di fatturazione | Costo |
|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Unità 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 |
| ConfigurazioneUltra | Listino delle tariffe— | Unità di fatturazione/ 1K token | Costo 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
{
"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
| Campo | Tipo |
|---|---|
Campomodel | Tipostring |
Campoid | Tipostring |
Campoprovider | Tipostring |
Camporesults[].index | Tipointeger |
Camporesults[].relevance_score | Tiponumber |
Camporesults[].document.text | Tipostring |
Camporesults[].document.image | Tipostring |
Campousage.search_units | Tipointeger |
Campousage.total_tokens | Tipointeger |
Campousage.cost | Tiponumber |
Errori e passaggi successivi
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneCampo obbligatorio, rappresentazione o valore non valido | Passaggio 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
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