Ricerca ibrida
Una sola casella di ricerca che capisce sia «SKU-88213» sia «giacca leggera da corsa»: i termini esatti restano precisi, le descrizioni vaghe si confrontano per significato e le due classifiche si fondono in un solo elenco. Pagamento a consumo, senza abbonamento.
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.
Il risultato tiene conto di entrambi, utile quando un codice, un nome proprio o una sigla devono comparire esattamente e non solo per concetto vicino.
Perché unire parole chiave e significato
La ricerca per parole chiave è precisa sui termini esatti, come un codice prodotto, un numero di modello o un riferimento normativo, ma non riconosce una parafrasi. La ricerca semantica capisce le parafrasi, però a volte mette un concetto vagamente collegato sopra il documento che contiene proprio il termine digitato, soprattutto quando quel termine è raro. Nessuno dei due limiti è grave da solo, ma una casella che fa solo una delle due cose sbaglia in modo sistematico su una parte delle ricerche, e di rado si sa in anticipo di che tipo sarà la prossima.
Dove serve e cosa aspettarsi
Il caso più chiaro è il negozio online: un cliente scrive un numero di modello esatto e un minuto dopo «scarpe impermeabili da trekking», e tutte e due le ricerche devono funzionare dalla stessa casella. Lo stesso vale per la documentazione tecnica, dove si cercano nomi esatti e problemi descritti a parole, e per i ticket di assistenza che citano lo stesso codice o descrivono lo stesso guasto in modo diverso. Fondere classifiche ottenute in modo indipendente è una tecnica usata da anni; qui arriva pronta in un'unica operazione.
Il problema che risolve
La sola ricerca semantica a volte penalizza query con un codice tecnico o un nome esatto, perché privilegia il significato generale della frase. La sola ricerca per parola esatta, al contrario, ignora i sinonimi. Cercare “fattura FT-2026-0334” con un motore solo semantico rischia di far sparire quel codice tra risultati concettualmente vicini ma sbagliati: la ricerca ibrida pesa entrambi i segnali insieme.
Come si bilanciano i due criteri
Il motore calcola prima i risultati per corrispondenza testuale e poi quelli per vicinanza semantica, e combina i due elenchi in un unico ordinamento pesato secondo la query ricevuta. Non devi configurare pesi manualmente: la domanda stessa guida quanto conta ciascun criterio, con termini tecnici o codici che spingono verso l'esattezza e frasi discorsive che spingono di più verso il significato generale.
Casi d'uso
Il catalogo tecnico di Tecnoedil Verona
Un operaio cerca il codice esatto “TVR-4400” insieme alla descrizione “giunto per tubazione interrata”: la ricerca ibrida trova il pezzo giusto anche se il codice compare in poche righe del catalogo.
L'archivio fiscale dello Studio Bianchi
Lo Studio Commercialista Bianchi cerca “circolare 45/E” insieme al tema “rimborso IVA”: l'ibrida trova il documento con quel numero esatto senza perdersi tra circolari concettualmente simili ma diverse.
Il sito di Rossi & Figli S.r.l.
Un cliente cerca “SKU RF-1092” più “colore blu navy”: la ricerca ibrida restituisce esattamente quella scheda prodotto, non un articolo solo vagamente simile.
Domande frequenti
In cosa è diversa dalla ricerca semantica?
La ricerca semantica lavora solo sul significato; quella ibrida aggiunge anche la corrispondenza esatta delle parole chiave, utile per codici, sigle e nomi propri.
Devo scegliere io il peso tra i due criteri?
No, il motore lo calcola in base alla query stessa: termini tecnici pesano di più sull'esattezza, frasi discorsive pesano di più sul significato.
È utile per un catalogo con codici prodotto?
È proprio il caso d'uso tipico: quando serve trovare sia il codice esatto sia le schede concettualmente simili, l'ibrida evita di dover fare due ricerche separate.
Che cosa succede a un documento che va bene solo per uno dei due criteri?
Compare comunque, solo più in basso. Un documento che ottiene un buon punteggio su entrambi sale in cima; uno che convince un solo criterio non sparisce, come accadrebbe con un sistema a metodo unico.
Devo gestire due sistemi di ricerca separati?
No. La ricerca per parole chiave e quella per significato girano in parallelo nella stessa richiesta e i due ordinamenti vengono uniti in un unico punteggio per documento, senza dover fondere i risultati da sé.
Strumenti correlati
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/hybrid \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"SKU-88213 chaqueta impermeable"}'const res = await fetch("https://api.kit.forhosting.com/search/hybrid", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"query": "SKU-88213 chaqueta impermeable"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/search/hybrid",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"query": "SKU-88213 chaqueta impermeable"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/hybrid", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"query":"SKU-88213 chaqueta impermeable"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"query":"SKU-88213 chaqueta impermeable"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/hybrid", 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
{
"query": "SKU-88213 chaqueta impermeable"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "search.hybrid",
"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. |
Note tecniche
La ricerca ibrida combina due criteri in una sola query: la corrispondenza esatta delle parole chiave e la vicinanza di significato calcolata dal motore semantico.
Serve comunque un indice
Funziona sugli stessi identici dati, esattamente allo stesso modo, senza bisogno di indicizzare due volte con criteri diversi per ciascun tipo di ricerca che vuoi eseguire in seguito. Come la ricerca semantica, anche quella ibrida interroga un indice già costruito con index_text, index_document o index_url: prima costruisci l'archivio interrogabile con lo strumento adatto al tuo contenuto, poi lanci le query di ricerca.
Prezzo per query
Lo trovi come strumento separato perché la logica interna di combinazione è diversa da quella semantica pura, non perché costi di più al momento dell'uso effettivo sul tuo indice consultato. $0.002 a richiesta più $0.0015 ogni 1.000 token, esattamente come la ricerca semantica: la combinazione dei due criteri non comporta un sovrapprezzo aggiuntivo rispetto alla ricerca singola più semplice e diretta.
Domande tecniche
Serve un indice diverso rispetto alla ricerca semantica?
No, lo stesso indice creato con index_text, index_document o index_url funziona per entrambe le ricerche, semantica e ibrida.
Costa di più della ricerca semantica?
No, il prezzo è identico: $0.002 a richiesta più $0.0015 ogni 1.000 token, in dollari.
Posso usarla via API nella ricerca del mio e-commerce?
Sì, colleghi la query digitata dal cliente a questo strumento e mostri risultati che rispettano sia i codici sia il significato della frase.