Ricerca con IA
La ricerca con IA capisce una query scritta con parole comuni: «scarpe da running impermeabili fino a 100 euro, ma non Contoso», «regalo per chi corre», «borsa per portatile da 15 pollici». L'IA trasforma la query in filtri del catalogo (categorie, brand, caratteristiche, prezzo ed esclusioni) e la ricerca dei prodotti mostra i prodotti secondo questi filtri. Sopra i prodotti compaiono un breve consiglio dell'IA e i chip di affinamento: «più economico», «da donna», «altro colore». I risultati normali compaiono subito, come sempre, e quelli dell'IA li sostituiscono quando l'analisi è pronta. Se l'IA non risponde, restano i risultati normali.
La ricerca con IA fa parte della ricerca dei prodotti: servono il tracker, il catalogo e il widget di ricerca o un plugin per il negozio. L'IA è addebitata a consumo sul saldo del progetto e funziona con un piano a pagamento, veda Costi e limiti.
Come attivarla
Nella pagina Sito → Ricerca dei prodotti, nel blocco Ricerca con IA, scelga Quando usare l'IA. La scelta viene salvata subito.

| Modalità | Quando l'IA analizza la query |
|---|---|
| Disattivata | mai: la ricerca funziona come sempre |
| Automatica | query descrittiva, da tre parole o una domanda; le query brevi («sneakers», «nike») vengono cercate come sempre |
| Interruttore | solo quando il cliente ha premuto «Chieda all'IA» |
| Sempre | ogni query |
Nelle modalità Automatica e Interruttore il visitatore ha il pulsante Chieda all'IA, accanto all'ordinamento dei risultati e come riga nel livello di ricerca: con esso l'IA analizza anche una query breve.
- Breve risposta dell'IA sopra i prodotti: una o due frasi sui prodotti trovati, cosa si adatta meglio e in quale fascia di prezzo. La disattivi se servono solo i filtri.
- Verificare il beneficio dell'IA: metà dei visitatori riceve la ricerca normale e il report confronta clic e acquisti dei due gruppi, veda Verifica del beneficio dell'IA.
Verificare l'analisi
Il campo Verifica l'analisi mostra cosa l'IA ha capito dalla query: testo da cercare, categorie, brand, caratteristiche, prezzo, esclusioni, ordinamento e affinamenti. Inserisca la query come la scriverebbe un cliente e prema Analizza. L'analisi è addebitata come sul sito; un'analisi ripetuta della stessa query arriva gratis dalla cache e sotto il risultato compare «Dalla cache, senza chiamare il modello».
Se l'IA non ha trovato nella query nulla del catalogo, la ricerca avverrà per testo, come indicato sotto il campo. È un motivo per aggiungere al catalogo le categorie o le caratteristiche che i clienti cercano.
Cosa vede il cliente
- Il cliente inserisce una query: i risultati normali compaiono subito.
- Sopra i prodotti compare «L'IA sta scegliendo i prodotti…». Dopo un secondo o due i risultati dell'IA sostituiscono quelli normali.
- La risposta dell'IA viene scritta man mano che il modello risponde, sotto il titolo «Consiglio dell'IA».
- I chip L'IA ha capito: mostrano i filtri applicati: categoria, brand, caratteristiche, prezzo, esclusioni con il segno «−». Un chip si può rimuovere: i risultati si aggiornano subito, senza chiamare il modello.
- Gli affinamenti sono chip e il campo «Precisi: più economico, altro colore…». Un affinamento prosegue la query precedente: «più economico» dopo «scarpe da running Northwind» mantiene il brand e abbassa il prezzo.
- Chieda in chat apre la chat del sito con la query del cliente, se la chat è collegata.
- Ricerca normale riporta i risultati normali finché la query non cambia.
Se nel catalogo non c'è ciò che è stato chiesto, l'IA allenta i filtri: prima toglie caratteristiche ed esclusioni, poi il prezzo, poi cerca per il testo originale. Sopra i prodotti compare allora «Nessuna corrispondenza esatta: sono mostrati prodotti simili.».
Se il visitatore ha scelto da solo filtri o ordinamento nei risultati, l'IA non riscrive la sua scelta: l'ordinamento scelto si applica sopra i risultati dell'IA, mentre i filtri propri del visitatore riportano i risultati normali.
Come l'IA analizza la query
- Solo il catalogo. L'IA riceve le categorie, i brand e i valori delle caratteristiche del Suo catalogo e sceglie tra questi. Tutto ciò che non è nel catalogo viene scartato: l'IA non inventa un brand o una taglia.
- Lingua. La query si può scrivere in qualsiasi lingua: l'IA traduce il testo da cercare nella lingua del catalogo e scrive gli affinamenti nella lingua del cliente.
- Cache. L'analisi di una query è conservata 7 giorni: la stessa query nella stessa lingua viene analizzata senza modello e gratis. Ogni notte le ricerche popolari del sito degli ultimi 30 giorni vengono analizzate in anticipo, fino a 100 query per progetto, quindi le query frequenti ricevono risposta subito.
- La risposta sopra i prodotti si basa solo sulle schede dei prodotti trovati: nome, brand, prezzo, disponibilità e caratteristiche. Una frase con un numero che non è nelle schede (prezzo, sconto, tempi) viene eliminata. La risposta pronta per la stessa query e gli stessi prodotti è conservata 24 ore.
- L'ordine dei prodotti resta quello della ricerca: apprendimento dai clic, interessi del visitatore e ricerca per significato funzionano anche nei risultati dell'IA, veda Come vengono cercati i prodotti.
Plugin per i negozi
I plugin per WooCommerce e Magento 2 e il modulo per 1C-Bitrix in modalità di ricerca dei prodotti mostrano i risultati dell'IA nella pagina di ricerca del negozio. Il tema del negozio disegna i prodotti come di consueto e sopra di essi il tracker mostra il blocco dell'IA: il consiglio, i chip «L'IA ha capito», gli affinamenti e «Ricerca normale». La rimozione di un chip e un affinamento aprono la stessa pagina di ricerca con i nuovi parametri.
Il plugin attende l'analisi al massimo 2,5 secondi. Le query popolari sono analizzate di notte e si aprono subito; una nuova query descrittiva si apre 1–2 secondi più lentamente del solito. Se l'analisi non arriva in tempo, il negozio mostra i risultati normali. Servono il plugin per WooCommerce 1.18.0, per Magento 2 1.15.0 o il modulo per 1C-Bitrix 1.14.0 o versioni successive.
Pagina dei risultati propria
Se la pagina dei risultati è Sua, ottenga i risultati dell'IA dal tracker:
const result = await cdp.searchAi(q, { perPage: 24 });
if (result.ai) {
// result.items — prodotti, result.ai.understood — chip «L'IA ha capito», result.ai.refinements — affinamenti,
// result.ai.relaxed — filtri allentati, result.ai.state — analisi per la query successiva
await cdp.searchAiAnswer(q, result.items.slice(0, 6).map((item) => item.id), (text) => { answer.textContent = text; });
} else {
// l'IA non serve per la query, non è disponibile o non ha fatto in tempo: mostri i risultati normali cdp.search(q)
}
Opzioni di cdp.searchAi: previous — result.ai.state della risposta precedente insieme alla frase di affinamento («più economico»), state — analisi senza il chip rimosso (risultati senza chiamare il modello), asked: true — il visitatore ha premuto «Chieda all'IA», e inoltre sort, page, perPage. L'analisi attende la risposta del modello fino a 8 secondi. Serve il tracker 1.37.0.
I server possono effettuare la stessa richiesta con una chiave di scrittura: POST https://cdp.onetrace.pro/api/v1/search/ai; PHP SDK: search()->ai(). L'elenco completo dei parametri è nel riferimento dell'API: https://cdp.onetrace.pro/api/v1/openapi.json.
Report
Finché la ricerca con IA è attiva, sotto il report delle ricerche nella pagina Sito → Ricerca dei prodotti compare il report Ricerca con IA per lo stesso periodo.

| Indicatore | Cosa mostra |
|---|---|
| Ricerche con IA e Quota di tutte le ricerche | quanti risultati ha mostrato l'IA e quale parte delle ricerche del sito rappresentano |
| Dalla cache | quota dei risultati ottenuti senza chiamare il modello: gratuiti e immediati |
| Analisi: p50 / p95 | in quanto tempo il modello analizza la query nella metà e nel 95 % delle ricerche |
| Prime parole della risposta | dopo quanto tempo il cliente vede l'inizio del consiglio dell'IA |
| Allentate | quota di ricerche senza corrispondenze esatte in cui l'IA ha tolto alcuni filtri |
| Errori | analisi a cui il modello non ha risposto; in questi casi il cliente ha visto i risultati normali |
| Costo per 1000 ricerche | quanto è stato addebitato sul saldo per la ricerca con IA, rapportato a 1000 ricerche |
Sotto gli indicatori: quanti affinamenti sono avvenuti senza modello, quante risposte dell'IA ci sono state e quanto è stato addebitato nel periodo. Nella tabella: le query analizzate dall'IA, con il numero di prodotti trovati e la quota di allentamento; le query con un'alta quota di allentamento indicano cosa manca nell'assortimento.
Verifica del beneficio dell'IA
Attivi Verificare il beneficio dell'IA per sapere se l'IA aiuta a vendere. I visitatori a cui servirebbe l'IA vengono divisi equamente in due gruppi: uno riceve la ricerca con IA, l'altro la ricerca normale. Il visitatore resta sempre nel suo gruppo. Chi preme «Chieda all'IA» o affina la query riceve l'IA in qualsiasi gruppo. Le ricerche del gruppo con ricerca normale non vengono addebitate come IA.
Nel report il blocco Beneficio dell'IA confronta i gruppi:
- Clic sui risultati entro 30 minuti: quota di ricerche dopo le quali il visitatore ha cliccato un prodotto nei risultati di quella query;
- Acquisto entro 7 giorni dalla ricerca: quota di ricerche dopo le quali lo stesso cliente ha acquistato qualcosa. Compare se nelle impostazioni delle raccomandazioni è definito un evento di acquisto, veda Raccomandazioni e catalogo prodotti.
La conclusione funziona come negli altri confronti tra varianti: finché i dati sono pochi, il report lo dice; quando la differenza è statisticamente significativa, indica il vincitore. Se la ricerca normale è migliore, controlli l'analisi delle query frequenti nel campo Verifica l'analisi. I clic sui risultati sono registrati dal widget di ricerca; nella pagina di ricerca dei plugin il tema del negozio non registra i clic, quindi lì si confrontano solo gli acquisti. Dopo la disattivazione della verifica, il report mostra i risultati del periodo in cui era attiva.
Costi e limiti
Ogni analisi e risposta dell'IA costa in base alla quantità di testo (token) elaborata dal modello, con un ricarico della piattaforma. L'importo viene addebitato sul saldo del progetto, voce di spesa «Ricerca con IA». L'analisi dalla cache, la rimozione di un chip, le pagine successive e il cambio di ordinamento avvengono senza modello e sono gratuiti. Il modello è scelto dalla piattaforma; l'analisi di una query costa di solito una frazione di centesimo.
- La ricerca con IA funziona con un piano a pagamento che include la ricerca dei prodotti. Nel periodo di prova, senza fondi sul saldo o al raggiungimento del limite di spesa l'IA non si attiva: i clienti vedono la ricerca normale.
- Una richiesta all'IA è un'ulteriore richiesta di ricerca nel limite mensile del piano, veda Limite delle richieste. Il widget cerca contemporaneamente i risultati normali e quelli dell'IA, quindi una query descrittiva nel widget conta due volte; nei plugin per i negozi una volta sola. Le query per cui l'IA non è servita o non era disponibile e le ricerche del gruppo con ricerca normale nella verifica del beneficio non vengono contate una seconda volta.
- Un visitatore può chiamare il modello al massimo 10 volte al minuto e 100 volte al giorno; oltre questi limiti vede i risultati normali. Le risposte dalla cache non rientrano in questi limiti.
- Da uno stesso indirizzo non più di 30 chiamate al modello al minuto e 300 al giorno per tutte le funzioni di IA del sito; il server del negozio con il plugin e la chiave segreta non ha questo limite. Quanto può spendere al giorno l'IA del sito lo stabilisce il budget giornaliero: esaurito il budget, fino a mezzanotte funziona la ricerca normale.