Source: https://ailoot.ai/models/it/voyageai-rerank-3/ Canonical: https://ailoot.ai/models/it/voyageai-rerank-3/ Language: it # VoyageAI by MongoDB: rerank-3 [Markdown](https://ailoot.ai/models/it/voyageai-rerank-3/index.md) · [JSON](https://ailoot.ai/models/it/voyageai-rerank-3/facts.json) ## [VoyageAI by MongoDB: rerank-3](https://ailoot.ai/models/it/voyageai-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. - [**Ailoot Ultra · Riordinamento** `POST /v1/rerank` `voyageai/rerank-3`](https://ailoot.ai/models/it/voyageai-rerank-3/#method-0) 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`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank) 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 | Campo | Tipo | Requisito | Valori e limiti | Predefinito | | --- | --- | --- | --- | --- | | Campo`documents` | Tipo`array` | RequisitoObbligatorio | Valori e limiti | Predefinito— | | Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti voyageai/rerank-3 | Predefinito— | | Campo`provider` | Tipo`schema` | RequisitoFacoltativo | Valori e limiti | Predefinito— | | Campo`query` | Tipo`string` | RequisitoObbligatorio | Valori e limiti | Predefinito— | | Campo`session_id` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— | | Campo`top_n` | Tipo`integer` | RequisitoFacoltativo | Valori e limiti Minimo: 1 | Predefinito— | | Campo`trace` | Tipo`schema` | RequisitoFacoltativo | Valori e limiti | Predefinito— | | Campo`user` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— | | Campo`documents[].text` | Tipo`string` | RequisitoFacoltativo | Valori e limiti | Predefinito— | | Campo`documents[].image` | Tipo`string` | 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 | | --- | --- | | Parametro`content_type` | Contrattoapplication/json | | Parametro`required` | Contrattomodel, query, documents | | Parametro`material_types` | Contrattotext | | Parametro`optional_controls` | Contrattoprovider, session\_id, top\_n, trace, user | | Parametro`multimodal_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 →](https://ailoot.ai/docs/it/billing/reserve/) ### 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 ```json { "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 } ``` ```bash 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 | | --- | --- | | Campo`model` | Tipostring | | Campo`id` | Tipostring | | Campo`provider` | Tipostring | | Campo`results[].index` | Tipointeger | | Campo`results[].relevance_score` | Tiponumber | | Campo`results[].document.text` | Tipostring | | Campo`results[].document.image` | Tipostring | | Campo`usage.search_units` | Tipointeger | | Campo`usage.total_tokens` | Tipointeger | | Campo`usage.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`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank) #### Alias dei percorsi dei metodi Usa i percorsi dei metodi indicati sopra. #### ID di chiamata correlati [`voyageai/rerank-3`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-3&route=Ultra&caller=voyageai%2Frerank-3&fmt=rerank) 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` 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](https://ailoot.ai/docs/it/billing/subscriptions/) · [Consulta prezzi dei modelli](https://ailoot.ai/models/it/) ## 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](mailto:support@ailoot.ai) · [Offerta e accordo di licenza](https://ailoot.ai/legal/offer?lang=it) ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.