Tutorial

Ricerca AI sul sito web: come sostituire la casella di ricerca con risposte con fonti

Il team di Kopik7 min di lettura

Se la casella di ricerca del Suo sito restituisce spesso 'nessun risultato trovato' o elenchi di pagine poco pertinenti, il problema non è il contenuto ma il motore di ricerca. Sostituirla con una ricerca basata su intelligenza artificiale significa dare al visitatore una risposta diretta, scritta in linguaggio naturale e accompagnata dai passaggi dei Suoi documenti da cui proviene. In questo articolo vediamo come integrarla via API in poche ore e come misurare se funziona davvero.

Perché la casella di ricerca tradizionale non basta più

La ricerca a parole chiave funziona bene quando l'utente conosce il termine esatto usato nel Suo sito. Ma le persone cercano con domande, sinonimi e frasi colloquiali: 'quanto costa la spedizione' invece di 'tariffe di spedizione', 'posso disdire dopo 30 giorni' invece di 'recesso contrattuale'. Se l'indice non espande la query, il risultato è una pagina vuota e un visitatore che abbandona il sito per cercare altrove, magari dal concorrente.

Un motore di ricerca basato su AI legge la domanda, la confronta con il significato dei contenuti (non solo con le parole esatte) e restituisce una risposta sintetica con i riferimenti ai documenti o alle pagine originali. Non è un chatbot generico che inventa: è un sistema che risponde solo sulla base di ciò che Lei ha pubblicato, con citazioni verificabili.

Dalla ricerca a parole chiave alle risposte con fonti citate

Il meccanismo si chiama generazione aumentata dal recupero (RAG): il sistema recupera i passaggi più pertinenti dai Suoi documenti e li usa come contesto per generare una risposta, citando da dove arriva ogni affermazione. Questo cambia radicalmente l'esperienza: l'utente non deve più aprire tre pagine e leggerle per intero, legge la risposta e, se vuole approfondire o verificare, clicca sulla fonte citata.

Ricerca semantica e ricerca ibrida: perché contano entrambe

Una ricerca solo semantica rischia di perdere riferimenti precisi come codici prodotto, numeri di articolo o sigle normative, perché il significato vettoriale non sempre coglie l'esattezza lessicale. Per questo le basi di conoscenza più robuste combinano ricerca testuale classica e ricerca per significato: Ricerca semantica spiegata: come funziona, query expansion e quando fallisce approfondisce il tema, mentre Ricerca ibrida: perché BM25 e vettori insieme battono entrambi da soli spiega perché l'unione dei due approcci dà risultati più affidabili di ciascuno preso singolarmente.

Come integrare la ricerca AI sul Suo sito via API

Non serve costruire una pipeline di indicizzazione da zero. Un marketplace come Kopik permette di caricare i contenuti del sito (pagine esportate, PDF, FAQ, documentazione, manuali) e ottenere una base di conoscenza interrogabile via REST API in pochi minuti, senza gestire server o database vettoriali.

I passaggi pratici

  1. Raccolga i contenuti rilevanti: pagine prodotto, FAQ, condizioni di vendita, guide, documentazione tecnica, e li carichi su una base di conoscenza tramite /dashboard/bases/new.
  2. Decida se la base deve restare privata (solo il Suo sito la interroga con una chiave API) o pubblica (visibile nel catalogo e interrogabile anche da terzi a pagamento).
  3. Scelga la modalità di risposta: risposta sintetica con passaggi citati, oppure solo i passaggi grezzi se preferisce costruire Lei l'interfaccia di presentazione.
  4. Integri la chiamata via API REST con chiave API nel punto del sito dove oggi c'è la casella di ricerca: la guida API base di conoscenza: la guida per aggiungere ricerca e risposte con fonti alla Sua app mostra la struttura delle chiamate e come gestire la risposta.
  5. Progetti l'interfaccia: un riquadro di risposta sopra i risultati classici, un widget tipo chat in basso a destra, o una pagina dedicata 'Chiedi' nel menu principale.
  6. Preveda sempre un fallback verso il supporto umano quando la base di conoscenza non trova una risposta pertinente, per non lasciare l'utente bloccato.

La documentazione tecnica per chiavi API, endpoint e parametri è disponibile su /developers. Se preferisce testare prima manualmente il comportamento delle risposte, può farlo direttamente dall'interfaccia web della base prima di collegarla al sito.

Widget di ricerca, chatbot o motore di risposta: quale formato scegliere

Non esiste un formato giusto in assoluto: dipende dal tipo di sito e dall'intento di chi cerca. Un e-commerce con domande rapide su taglie e resi può preferire un widget di ricerca potenziato; un sito di documentazione tecnica o una scuola di formazione può beneficiare di un'esperienza più conversazionale.

Confronto tra i formati principali

FormatoEsperienza utenteQuando è più adatto
Casella di ricerca potenziataL'utente digita, vede una risposta sintetica sopra i risultati classiciSiti con molte pagine informative, documentazione, cataloghi prodotto
Widget chat persistenteConversazione continua, l'utente può fare domande di follow-upSupporto clienti, siti SaaS, assistenza pre-vendita
Pagina dedicata 'Chiedi'Esperienza focalizzata, utile per domande complesse o articolateSiti istituzionali, enti pubblici, contenuti normativi o tecnici

In molti casi la soluzione migliore combina due formati: il widget di ricerca per le domande rapide e un accesso via chat o MCP per chi usa strumenti come Claude, Cursor o ChatGPT per interrogare direttamente i Suoi contenuti. La guida Collegare Claude, Cursor o ChatGPT a una base di conoscenza: la guida passo passo spiega come abilitare anche questo canale.

Misurare i risultati: le metriche che contano davvero

Sostituire la ricerca non ha senso se poi non si verifica l'impatto. Prima di lanciare, definisca un piccolo set di metriche da monitorare nelle prime settimane.

  • Tasso di risposte utili: percentuale di domande per cui il sistema trova passaggi pertinenti e genera una risposta, rispetto a quelle senza risultato.
  • Tasso di escalation al supporto umano: quante conversazioni finiscono comunque con un contatto via email o modulo, segno che la base non copre quell'argomento.
  • Domande senza risposta: un log delle query che non trovano riscontro è la mappa più precisa dei buchi di contenuto da colmare.
  • Click sulle fonti citate: se gli utenti aprono i documenti originali, la fiducia nella risposta è alta; se non lo fanno mai, verifichi la qualità delle citazioni.
  • Tempo di permanenza e tasso di abbandono sulla pagina di ricerca, confrontati con i valori precedenti alla sostituzione.
  • Conversioni assistite: quante richieste di preventivo, acquisti o iscrizioni partono da una sessione di ricerca AI.

Il log delle domande senza risposta vale più di qualsiasi dashboard

Esporti periodicamente le domande per cui il sistema non trova contenuti pertinenti: è la lista delle pagine che Le mancano, già ordinata per priorità dagli utenti reali.

Per un approccio più sistematico alla valutazione, con metriche di precisione e richiamo e non solo osservazioni qualitative, può essere utile impostare un piccolo set di test come descritto in Come valutare un sistema RAG: metriche, test set e monitoraggio.

Privacy, trasparenza delle fonti e conformità

Mostrare la fonte di ogni risposta non è solo una questione di fiducia: aiuta anche a rispettare il principio di trasparenza richiesto dal GDPR quando il sistema tratta dati relativi a persone (ad esempio in un'area riservata clienti). Se la base di conoscenza include dati personali o se raccoglie le domande degli utenti per migliorare il servizio, verifichi base giuridica, informativa e tempi di conservazione prima del lancio: la checklist in GDPR e RAG: cosa verificare prima di partire copre i punti principali per un sito che opera in Italia e in Europa.

Pronto a sostituire la ricerca del Suo sito?

Crei una base di conoscenza gratuita con i contenuti del Suo sito, la testi dall'interfaccia web e poi la colleghi via API quando è soddisfatto dei risultati.

Domande frequenti

Domande frequenti

Quanto costa aggiungere una ricerca AI al sito web?

Il modello più diffuso è a crediti prepagati per domanda, oppure un abbonamento mensile con un tetto di utilizzo. I costi variano in base al volume di domande e alla lunghezza dei documenti indicizzati: per un approfondimento sulle voci di spesa reali vedi Quanto costa davvero il RAG: ingestione, storage, retrieval e generazione.

Serve sapere programmare per integrarla?

Per caricare i documenti e testare le risposte no, si fa tutto dall'interfaccia web. Per collegarla al sito serve invece una chiamata API, un'operazione che un sviluppatore front-end realizza di solito in poche ore seguendo la documentazione su /developers.

La ricerca AI sostituisce la SEO del sito?

No, sono complementari. La SEO porta traffico dai motori di ricerca esterni verso le pagine; la ricerca AI interna aiuta chi è già sul sito a trovare la risposta senza navigare pagina per pagina, riducendo l'abbandono.

Come si evita che il sistema inventi risposte non presenti nei documenti?

Impostando la modalità di risposta in modo che il sistema citi sempre i passaggi di origine e, se non trova contenuto pertinente, dichiari esplicitamente di non saperlo invece di generare un testo plausibile. Approfondimento in Come ridurre le allucinazioni dell'IA con risposte basate sulle fonti.

Posso usare la stessa base di conoscenza anche per il supporto clienti?

Sì, la stessa base indicizzata per la ricerca sul sito può alimentare anche risposte ai ticket di assistenza o un widget di chat dedicato, mantenendo coerenza tra le risposte pubbliche e quelle date al supporto.

Devo rendere pubblica la mia base di conoscenza?

No, può restare privata e accessibile solo dal Suo sito tramite chiave API. Renderla pubblica nel catalogo di /bases ha senso solo se vuole anche monetizzare l'accesso ai contenuti da parte di terzi.

Riceva la newsletter di Kopik

Nuove basi di conoscenza, guide sul RAG e novità del prodotto. Un'email ogni una o due settimane, disiscrizione con un clic.

Iscrivendosi accetta di ricevere la nostra newsletter. Il Suo indirizzo non viene mai condiviso.