Riordina i risultati
Il riordino prende un elenco di risultati già ottenuti — da un motore di ricerca, un database o un altro strumento — e li riclassifica secondo quanto rispondono davvero alla query. Non cerca da zero: migliora un ordinamento esistente, spesso spostando in cima un risultato che era sepolto in decima posizione.
Esegui online
Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.
Un secondo passaggio, non una ricerca nuova
Molti motori di ricerca restituiscono risultati ordinati in modo approssimativo, per parola chiave o per data. Il riordino prende quell'elenco — anche venti o trenta voci — e lo passa attraverso un modello più preciso, addestrato a stimare la pertinenza reale rispetto alla domanda. Il risultato è lo stesso elenco, ma con l'ordine corretto: quello che risponde meglio sale, quello marginale scende.
Quando conviene aggiungerlo
Ha senso quando il primo motore di ricerca — semantico, ibrido o anche un sistema esterno — restituisce troppi risultati simili tra loro e serve un criterio più fine per scegliere i primi tre o cinque da mostrare all'utente finale. È un passaggio opzionale, non obbligatorio: per archivi piccoli l'ordinamento della ricerca semantica è già più che sufficiente da solo.
Prezzo per query riordinata
$0.002 a richiesta più $0.0015 ogni 1.000 token dell'elenco passato, in dollari, senza costi legati al numero finale di posizioni riordinate dal motore semantico. Il costo dipende dalla lunghezza totale dei risultati da riordinare, non dal numero di voci contenute: un elenco di titoli brevi costa meno di uno con lunghi estratti di testo integrale allegati a ciascun risultato passato.
Come si collega agli altri strumenti
Lo usi dopo search.semantic, search.hybrid o anche dopo un tuo motore di ricerca esterno al KIT: gli passi i risultati grezzi ottenuti e ricevi lo stesso elenco riordinato secondo la pertinenza reale calcolata dal modello. Via API si inserisce come ultimo passaggio prima di mostrare i risultati; dalla pagina del KIT puoi incollare l'elenco per una prova rapida, senza integrazione tecnica.
Casi d'uso
I contratti dello Studio Commercialista Bianchi
Una ricerca su “recesso anticipato” restituisce dodici contratti simili; il riordino porta in cima quello con la clausola più specifica, invece di lasciare la selezione al primo criterio approssimativo.
Il catalogo di Rossi & Figli S.r.l.
Una ricerca prodotto restituisce trenta articoli concettualmente vicini; il riordino mostra per primi i tre che rispondono meglio alla domanda esatta del cliente, migliorando il tasso di clic sulla scheda giusta.
Un archivio di ricette tecniche
Un'azienda di Padova riordina i risultati di ricerca sulla propria documentazione interna per assicurarsi che la procedura più aggiornata compaia sempre prima delle versioni superate.
Domande frequenti
Sostituisce la ricerca semantica o si usa insieme?
Si usa insieme: prima ottieni i risultati con search.semantic o search.hybrid, poi li passi al riordino per affinare l'ordine finale.
Posso riordinare risultati che arrivano da un motore esterno al KIT?
Sì, l'input è semplicemente un elenco di testi con la query originale: la provenienza dei risultati non conta ai fini del riordino.
Da cosa dipende il prezzo?
Dalla lunghezza totale dell'elenco passato: $0.0015 ogni 1.000 token più $0.002 a richiesta, in dollari. Elenchi con estratti brevi costano poco.
Quanti risultati posso riordinare in una volta?
Fino a 20.000 token complessivi per esecuzione, sufficienti per elenchi di decine di risultati con estratti di media lunghezza.
Serve un account per usarlo?
No, si acquista direttamente senza registrazione: PayPal o carta, e il prezzo è pubblicato accanto allo strumento prima di lanciarlo.
Conviene per un archivio piccolo, con poche decine di documenti?
Di solito no: con pochi documenti l'ordinamento della ricerca semantica è già sufficiente. Il riordino rende di più su elenchi lunghi e simili tra loro.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/search/rerank \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/search/rerank", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/search/rerank",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/rerank", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/rerank", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"input": "…"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.rerank",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_chunks | 10000 |
max_tokens | 20000 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |