VoyageAI by MongoDB: rerank-3-lite
Voyage rerank-3-lite assegna punteggi ai documenti testuali candidati e li riordina per una query, con attenzione alla rapidità della ricerca. Supporta istruzioni di pertinenza e una finestra query-documento di 32.000 token, risultando utile dopo il recupero vettoriale o per parole chiave nei flussi di ricerca e RAG.
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-lite è l'edizione della serie Rerank 3 di Voyage incentrata sulla latenza. Riceve una query testuale e documenti candidati, valuta insieme ogni coppia query-documento e restituisce punteggi di pertinenza in ordine di classifica. Serve la seconda fase della ricerca: un sistema di recupero basato su embedding o parole chiave trova i candidati, poi Lite ne perfeziona l'ordine. Il risultato è una classifica da usare nella ricerca o in un flusso di generazione aumentata dal recupero di informazioni.
Cosa cambia in Rerank 3 Lite Il produttore evidenzia un recupero più efficace su documenti lunghi e codice rispetto a rerank-2.5-lite. Entrambe le edizioni Rerank 3 mantengono il rispetto delle istruzioni e la stessa classe di contesto 32K, mentre Lite è progettata per applicazioni sensibili alla latenza. Questo la rende un candidato pratico per ricerca interattiva in basi di conoscenza, recupero di documenti di supporto e ricerca di codice quando gli utenti necessitano rapidamente di risultati pertinenti. Sceglila in base ai requisiti di qualità e tempo di risposta della raccolta effettiva, senza presumere che un'edizione più piccola significhi una finestra di contesto più piccola.
Guida la pertinenza con la query Istruzioni in linguaggio naturale possono accompagnare la query per spiegare cosa conta come pertinente. Mantieni domanda e preferenza di pertinenza concise e coerenti. Per una ricerca di supporto software, usa «Trova la procedura per ripristinare un dispositivo; dai priorità alle istruzioni per la revisione hardware indicata». Per un nome di prodotto ambiguo, includi la categoria del prodotto, così significati estranei non prevalgono. Una preferenza nella query guida il punteggio semantico; usa metadati espliciti della raccolta per selezionare il prodotto, la versione del documento o l'ambito di accesso corretti prima di costruire l'elenco dei candidati.
Prepara un elenco ristretto di candidati testuali I documenti di input sono stringhe. Estrai testo leggibile dal materiale originale e conserva titoli, intestazioni, identificatori e contesto circostante utili. Mantieni una corrispondenza stabile da ogni posizione di input al record originale. Per un articolo di risoluzione dei problemi, includi il sintomo e la procedura pertinente, non solo una frase isolata. Per la ricerca nel codice sorgente, includi la funzione e le informazioni vicine necessarie a distinguerla da funzioni con nomi simili. Rimuovi navigazione o formule standard ripetitive quando sottraggono spazio al brano utile.
Il reranker può riordinare soltanto i documenti che riceve. Se la prima ricerca non recupera mai l'articolo pertinente, questa fase non può recuperare quel candidato mancante. Esamina sia l'elenco ristretto sia l'ordine finale quando un risultato sembra errato. Quando un documento lungo copre molti argomenti, separa sezioni coerenti e mantieni i riferimenti al documento padre, così una sezione pertinente può essere selezionata senza perdere la fonte.
Contesto e limiti della richiesta La guida corrente del produttore specifica un massimo di 8.000 token per la query e un massimo combinato di 32.000 token per la query più ogni singolo documento. Consente fino a 1.000 documenti candidati e un budget totale di richiesta di 600.000 token, calcolato come token della query moltiplicati per il numero di documenti, più tutti i token dei documenti. Una query lunga consuma quindi spazio in ogni coppia e contribuisce ripetutamente al budget aggregato. Conta il testo inviato con il tokenizer del modello appropriato, senza trattare caratteri, parole e token come intercambiabili.
Ad esempio, una query di 500 token con 100 documenti da 4.000 token ciascuno corrisponde a 450.000 token di input secondo quella formula. Questo illustra il calcolo del budget, non una dimensione raccomandata dell'elenco ristretto o un risultato di velocità misurato. L'opzione di troncamento documentata è abilitata per impostazione predefinita; il testo troppo lungo può essere accorciato prima dell'assegnazione del punteggio. Prepara deliberatamente le sezioni importanti, così il troncamento non elimina proprio il brano da individuare.
Leggi e usa il risultato I risultati sono ordinati dal punteggio di pertinenza più alto al più basso. Ogni risultato identifica la posizione originale di input del documento, consentendo all'applicazione di aggiungere titolo, identificatore del record e fonte propri. L'impostazione top_k controlla quanti candidati classificati vengono restituiti; se omessa, vengono restituiti tutti i candidati. L'interfaccia REST del produttore può anche restituire il testo del documento. Conserva gli identificatori originali insieme ai risultati selezionati quando mostri una pagina di ricerca o passi prove a una fase di generazione della risposta.
Un punteggio di pertinenza esprime quanto un candidato corrisponde alla query; non dimostra che le sue affermazioni siano corrette. Confronta gli elementi ai primi posti con la domanda effettiva dell'utente, incluse esclusioni e differenze di versione dei documenti. Se ogni candidato è irrilevante, esiste comunque un elemento al primo posto. Decidi come l'applicazione gestisce questo caso usando query rappresentative della raccolta.
Aggiornare e scegliere l'edizione Il produttore descrive rerank-3-lite come un aggiornamento di rerank-2.5-lite con semantica API invariata e punteggi calibrati sulla distribuzione del predecessore corrispondente. Conserva la mappatura dei record e la fase di recupero esistenti, poi confronta l'ordine ottenuto su query significative prima di affidarti a una soglia di punteggio già stabilita. Usa Lite per un'esperienza di ricerca in cui conta il tempo di risposta; usa l'edizione rerank-3 incentrata sulla qualità come confronto quando la pertinenza di candidati difficili è la priorità maggiore.
Ailoot Ultra · Riordinamento POST /v1/rerank voyageai/rerank-3-lite
voyageai/rerank-3-liteIntroduzione
Voyage rerank-3-lite assegna punteggi ai documenti testuali candidati e li riordina per una query, con attenzione alla rapidità della ricerca. Supporta istruzioni di pertinenza e una finestra query-documento di 32.000 token, risultando utile dopo il recupero vettoriale o per parole chiave nei flussi di ricerca e RAG.
- 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-lite | 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.00004 / 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-lite",
"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-lite'
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-lite
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · VoyageAI by MongoDB: rerank-3-lite
- Quali input e risultati sono disponibili?
POST /v1/rerank·voyageai/rerank-3-lite:text→rerank- Quali campi usa la richiesta?
POST /v1/rerank·voyageai/rerank-3-lite:documents,model,provider,query,session_id,top_n,trace,user- Quali limiti si applicano?
POST /v1/rerank·voyageai/rerank-3-lite:top_n.minimum:1