Source: https://ailoot.ai/models/it/voyageai-rerank-2-5/ Canonical: https://ailoot.ai/models/it/voyageai-rerank-2-5/ Language: it # VoyageAI by MongoDB: rerank-2.5 [Markdown](https://ailoot.ai/models/it/voyageai-rerank-2-5/index.md) · [JSON](https://ailoot.ai/models/it/voyageai-rerank-2-5/facts.json) ## [VoyageAI by MongoDB: rerank-2.5](https://ailoot.ai/models/it/voyageai-rerank-2-5/) rerank-2.5 riordina un insieme fornito di candidati testuali per pertinenza rispetto a una query e a istruzioni opzionali in linguaggio naturale. È un reranker multilingue orientato alla qualità, con un contesto query-documento di 32.000 token e punteggi classificati legati agli indici originali dei candidati. - [**Ailoot Ultra · Riordinamento** `POST /v1/rerank` `voyageai/rerank-2.5`](https://ailoot.ai/models/it/voyageai-rerank-2-5/#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. rerank-2.5 è il reranker di Voyage AI che segue istruzioni, progettato per perfezionare un insieme di candidati di ricerca. Esamina congiuntamente la query e ogni documento come cross-encoder, poi restituisce un ordine di pertinenza. Il rilascio del produttore evidenzia il controllo in linguaggio naturale su cosa conta come pertinente, il recupero multilingue e un contesto query-documento più lungo rispetto alla precedente edizione rerank-2. #### Fornisci al modello i candidati da confrontare L'input è una query e un elenco di documenti testuali candidati. Possono essere brani selezionati da una ricerca basata su embedding o da una ricerca lessicale iniziale. Il reranker valuta il testo fornito anziché creare embedding del corpus, quindi il suo compito pratico è perfezionare i candidati già trovati dalla ricerca iniziale. Mantieni l'ordine originale dei candidati e gli identificatori delle fonti quando prepari l'elenco. Gli indici restituiti si riferiscono a quelle posizioni di input. Per un'attività RAG, fornisci i brani che la fase di risposta potrebbe effettivamente usare, inclusi titolo o condizioni necessari a interpretarli. Un documento pertinente assente dall'insieme inviato non può apparire come risultato appena trovato dal reranking. #### Specifica la nozione di pertinenza desiderata Le istruzioni possono essere aggiunte prima o dopo la query. Il rilascio descrive tre ruoli utili: evidenziare una parte specifica di un documento, preferire un tipo di fonte e disambiguare la query con il contesto applicativo. Questi modificano il compito di pertinenza presentato al modello. Per una ricerca tecnica, un'istruzione esemplificativa è «Dai priorità ai brani che spiegano il comportamento in caso di errore e di ripristino; le panoramiche introduttive sono secondarie». Per una raccolta di ricerca, specifica se contino di più titolo, metodo o risultato. Per un termine ambiguo, indica l'ambito a cui si riferisce la ricerca. Mantieni compatibili domanda e istruzione, così una non chiede un argomento ampio mentre l'altra modifica silenziosamente l'attività. Queste preferenze guidano il punteggio di pertinenza. Se l'applicazione ha requisiti rigidi di ammissibilità — come versione della fonte, data o ambito di accesso — prepara separatamente l'insieme dei candidati ammissibili. L'istruzione di pertinenza del modello e una restrizione deterministica della raccolta servono a scopi diversi. #### Output classificato e uso successivo dei risultati I risultati sono ordinati per pertinenza decrescente e comprendono un punteggio di pertinenza a virgola mobile e l'indice originale di input del candidato. L'opzione top-k seleziona quanti primi risultati restituire; senza di essa, la specifica del produttore restituisce risultati per tutti i candidati inviati. Un'impostazione opzionale return-documents include il testo originale corrispondente; altrimenti la risposta contiene indici e punteggi. Usa l'ordine per selezionare brani da mostrare o per una fase successiva di risposta, mantenendo intatta l'identità della fonte. Esamina il testo effettivo quando valuti la classifica: il punteggio misura la pertinenza alla query inviata, non è una risposta generata né una verifica della correttezza delle affermazioni del documento. Questo rende il modello utile per perfezionare materiale di ricerca tecnico, legale, finanziario, medico, conversazionale e multilingue senza trasformare la classifica in una conclusione di settore. #### Contesto, budget totale di token e troncamento Il limite documentato della query è di 8.000 token, incluse le istruzioni inserite nella query. La query più un singolo documento candidato devono rientrare in 32.000 token e l'elenco dei documenti può contenere al massimo 1.000 elementi. Il totale consentito è di 600.000 token, conteggiati come token della query moltiplicati per il numero di documenti, più tutti i token dei documenti. Un'istruzione lunga viene quindi contata ripetutamente nelle coppie candidate. Il numero top-k dell'output non cambia il numero di candidati in quel calcolo dei token di input. Il troncamento predefinito accorcia query o documenti troppo lunghi per rispettare il limite di contesto; disabilitarlo fa restituire un errore per una query o una coppia troppo lunga. Prepara deliberatamente brani che contengano la risposta e mantieni le condizioni pertinenti nel testo che il modello vedrà. Valuta l'ordine perfezionato su domande e istruzioni rappresentative, poi passa i brani originali selezionati alla fase successiva. **Ailoot Ultra · Riordinamento** `POST /v1/rerank` `voyageai/rerank-2.5` [`voyageai/rerank-2.5`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) VoyageAI by MongoDB /`voyageai/rerank-2.5` ### Introduzione rerank-2.5 riordina un insieme fornito di candidati testuali per pertinenza rispetto a una query e a istruzioni opzionali in linguaggio naturale. È un reranker multilingue orientato alla qualità, con un contesto query-documento di 32.000 token e punteggi classificati legati agli indici originali dei candidati. 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-2.5 | 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-2.5", "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-2.5' 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-2.5`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) #### Alias dei percorsi dei metodi Usa i percorsi dei metodi indicati sopra. #### ID di chiamata correlati [`voyageai/rerank-2.5`](https://ailoot.ai/models/it/#m=voyageai%2Frerank-2.5&route=Ultra&caller=voyageai%2Frerank-2.5&fmt=rerank) FAQ · VoyageAI by MongoDB: rerank-2.5 Quali input e risultati sono disponibili? `POST /v1/rerank` · `voyageai/rerank-2.5`: `text` → `rerank` Quali campi usa la richiesta? `POST /v1/rerank` · `voyageai/rerank-2.5`: `documents`, `model`, `provider`, `query`, `session_id`, `top_n`, `trace`, `user` Quali limiti si applicano? `POST /v1/rerank` · `voyageai/rerank-2.5`: `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.