Ricerca ibrida
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. 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.
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 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.
Serve comunque un indice
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. 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.
Prezzo per query
$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. 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.
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.
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.
È 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.
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.
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 '{"input":"…"}'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({
"input": "…"
})
});
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={
"input": "…"
},
)
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" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
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
{
"input": "…"
}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. |