Crea un assistente per il tuo negozio come la nostra demo

Guarda la demo

La demo retail trasforma il catalogo di un negozio in due esperienze di acquisto utili. Chiedi “un regalo per chi ama la vita all’aria aperta, sotto i 60 €” e ottieni un consiglio in linguaggio semplice con prodotti reali e link alle fonti.

Questa guida spiega la realizzazione nell’ordine che rende le decisioni più facili da seguire: parti dal catalogo, scegli le esperienze per i clienti, aggiungi dati in tempo reale dove servono e poi testa il risultato.

1. Parti dal catalogo

Il catalogo è la fonte di verità dell’assistente. Crea un dataset di memoria, poi esegui un job di acquisizione del sito web sulle pagine che rispondono a vere domande di acquisto.

Includi: pagine di prodotto e di categoria, guide alle taglie e alla vestibilità, informazioni su spedizioni e resi.

Escludi: carrello, checkout, account e pagine di marketing. Aggiungono rumore senza aiutare l’assistente a rispondere alla domanda di un cliente.

Al termine dell’acquisizione, controlla un campione di record. Nomi dei prodotti, prezzi, URL canonici, indicazioni sulle taglie e dettagli sui resi devono essere tutti presenti e leggibili. Un blocco di navigazione duplicato o un foglio di stile di stampa possono indebolire il recupero in tutta l’esperienza.

Consulta Creare una knowledge base e Configurare i job di acquisizione dati.

2. Dai a ogni intento del cliente l’interfaccia giusta

La demo usa due esperienze perché i clienti arrivano con esigenze diverse.

Il centro di ricerca compare nella homepage e in una pagina di ricerca dedicata. La chat flottante resta disponibile in tutto il negozio. Così una domanda rapida sul prodotto resta rapida, senza costringere chi ha bisogno di un consiglio a ricominciare da una casella di ricerca.

Mantieni condivisa la knowledge base

Le due esperienze hanno punti di accesso, modalità di visualizzazione e funzionalità diversi, ma usano un solo dataset. È una scelta voluta:

• Risposte coerenti. Un dato di prodotto non deve cambiare a seconda di dove viene chiesto.
• Catalogo mantenuto una sola volta. Reindicizzi una modifica una volta e la ricevono entrambe le esperienze.
• Funzionalità aggiunte senza dividere la conoscenza. La chat può usare moduli e consultazioni in tempo reale continuando a rispondere dallo stesso catalogo della ricerca.

Pensa alla knowledge base come all’archivio condiviso del negozio e alle due esperienze come a modi diversi di accedervi.

“Un catalogo, due modi per aiutare un cliente a decidere.”

Definisci un ruolo ristretto e utile

Lo stylist è un personal stylist di questo negozio, non un assistente generico. Le sue istruzioni di comportamento definiscono ruolo e tono, poi precisano i limiti:

• Consigliare solo articoli presenti nel catalogo.
• Citare il prodotto consigliato.
• Non dichiarare prezzi o disponibilità che non si possono verificare.
• Dirlo chiaramente quando le informazioni disponibili non rispondono alla domanda.

Aggiungi un nome, un avatar e un messaggio di benvenuto adatti al negozio. Istruzioni chiare e un ruolo mirato rendono l’assistente più affidabile di un vago prompt da “assistente disponibile”.

Consulta Creare un assistente e Lanciare un assistente.

3. Configura la ricerca per domande naturali

Crea un centro di ricerca intelligente sul dataset condiviso del catalogo. A differenza di una casella di ricerca solo per parole chiave, può restituire una risposta ragionata insieme alle schede prodotto che la supportano.

Usa un testo segnaposto che inviti a una domanda reale, ad esempio “Trova un regalo, un outfit o la taglia giusta…”. Quando la ricerca è vuota, mostra un breve messaggio di benvenuto e alcuni prodotti in evidenza. Così la pagina è utile ancora prima che il cliente scriva qualcosa.

Fai in modo che i suggerimenti mostrino capacità reali

I suggerimenti sono testi di prodotto. Ognuno deve portare a una risposta che il catalogo o un servizio in tempo reale possono davvero supportare.

• Un regalo per chi ama la vita all’aria aperta, sotto i 60 €
• Crea un outfit smart casual per meno di 150 €
• Qual è lo zaino migliore per andare al lavoro sotto la pioggia?
• Dov’è il mio ordine e quando arriverà?

Insieme, questi esempi mostrano regali, abbinamenti, confronto tra prodotti e assistenza sull’account in tempo reale. Consulta Creare un centro di ricerca, Creare un centro di ricerca dai contenuti del sito web e Scrivere suggerimenti utili per il centro di ricerca.

4. Usa i moduli quando qualche dettaglio migliora la risposta

Il testo basta per una domanda diretta come “Qual è lo zaino migliore per andare al lavoro sotto la pioggia?” Abbinamenti e taglie richiedono un po’ più di contesto. La demo usa brevi moduli all’interno della conversazione per raccoglierlo.

Per ogni modulo, configura tre cose: quando mostrarlo, i campi da chiedere e cosa succede all’invio. Un modulo ben posizionato trasforma una domanda aperta in una richiesta strutturata senza costringere il cliente a una lunga conversazione.

Consulta Acquisire lead e usare i moduli.

5. Collega azioni in tempo reale per le domande sull’account

I contenuti del catalogo rispondono a cosa vendete? Le azioni in tempo reale rispondono a dov’è il mio ordine?

Registra ogni consultazione in tempo reale come servizio collegato. L’assistente chiama il servizio tramite un ID breve; l’endpoint reale e gli eventuali header segreti restano lato server, quindi non arrivano al browser.

La configurazione è volutamente semplice:

1. Assegna al servizio un ID, un metodo e un URL.
2. Usa i segnaposto {{params.x}} per i valori dell’URL di ogni chiamata. Vengono codificati per l’URL.
3. Tieni ogni segreto in un header di autenticazione.
4. Passa l’ID del servizio come proxyId da un modulo, oppure chiamalo direttamente da un widget o da un pulsante.

// Look up the signed-in shopper's order, then render the reply in the conversation.
skdwn.instance.executeProxyRequest(
  'order-status',            // the linked-service ID
  { orderId },               // request body (POST)
  (res) => renderReply(res), // endpoint response
  { locale: 'en' }           // fills {{params.locale}} in the service URL
);

Fai in modo che l’endpoint restituisca una risposta breve e pronta da mostrare: un reply in markdown e un elenco references. È più semplice e affidabile che chiedere all’assistente di formattare il JSON grezzo del dominio.

Consulta Servizi collegati e Moduli dell’assistente.

6. Adatta l’esperienza alla pagina

Adatta la modalità di visualizzazione dell’assistente alla pagina in cui si trova il cliente.

Usa il template di base (overlay o integrato) e il pulsante di azione flottante per pagina. I metadati per pagina possono fornire una descrizione, suggerimenti e contesto aggiuntivo. In una pagina prodotto mantengono sul posto una domanda semplice; in una pagina account rendono la conversazione pertinente agli ordini del cliente.

Riprendi il linguaggio visivo del negozio

Imposta i colori del brand e di accento, le superfici, i testi, il pulsante principale e l’intestazione della ricerca in linea con il sito. L’aspetto si configura sull’entità e arriva all’integrazione live indipendentemente dal deploy del sito, quindi puoi regolarlo direttamente sulla pagina reale.

Consulta la sezione sull’aspetto di Lanciare un assistente.

7. Aggiungi l’integrazione e il contesto del cliente

Carica il runtime una sola volta, poi avvia l’assistente nel suo contenitore.

<div id="seekdown-assistant-root"></div>
<script src="https://saas.seekdown.ai/js/seekdown-assistant.js"></script>
<script>
  skdwn.startAssistant({ assistantId: 'your-assistant-id', accessToken: 'your-api-key' });
</script>

Per usare la ricerca nel negozio e lo stylist flottante nella stessa pagina, assegna a ciascuno un contenitore e avvialo con le proprie impostazioni di visualizzazione:

skdwn.startAssistant({ assistantId: 'store-search', container: '#store-search',
  config: { settings: { baseTemplate: 'overlay' } } });
skdwn.startAssistant({ assistantId: 'stylist', container: '#stylist',
  config: { settings: { floatingActionButton: { useFloatingActionButton: true } } } });

Per le domande sugli ordini, passa una sola volta il cliente che ha effettuato l’accesso quando l’assistente si carica. userId e una stringa additionalContext concisa sono poi disponibili per ogni risposta e per le analisi.

skdwn.startAssistant({ assistantId: 'stylist', accessToken: 'your-api-key',
  userId: shopper.id,
  additionalContext: 'Signed-in shopper: ' + shopper.name + ', 2 open orders.' });

Prima del lancio, genera una chiave API e aggiungi il tuo sito alle origini consentite. Consulta Pubblicare un assistente, inclusa la sezione sulle origini consentite.

8. Crealo e mantienilo con sicurezza

Gran parte di questa realizzazione è configurazione più una piccola quantità di codice di integrazione. Se usi un client MCP come Claude Code, GitHub Copilot o Codex, può lavorare direttamente con il tuo workspace Seekdown. Può aiutarti a impostare gli endpoint per ordini e disponibilità, scrivere l’integrazione, preparare istruzioni di comportamento e suggerimenti, e testare l’assistente live a partire da un brief chiaro. Consulta Collegare client MCP.

Testa le domande che i clienti faranno davvero

Non limitarti a prompt dimostrativi perfetti. Includi:

• Nomi esatti dei prodotti e richieste generiche come “un regalo per mio padre”.
• Domande su taglie e vestibilità.
• Domande sullo stato degli ordini.
• Domande su prodotti che non vendi.

Per ogni risultato, controlla sia la risposta scritta sia il prodotto collegato. Una risposta con la fonte sbagliata è comunque un difetto.

Mantieni aggiornata la risposta

Imposta una pianificazione di acquisizione in linea con la frequenza con cui cambia il catalogo. Dopo un aggiornamento di prezzo, prodotto o policy, conferma la modifica in tre punti: la pagina di origine, il record del dataset e la risposta dell’assistente.

Correlati: Creare una knowledge base · Creare un centro di ricerca · Creare un assistente · Servizi collegati · Pubblicare un assistente · Collegare client MCP. Per la versione di questa configurazione per un catalogo tecnico, consulta Come è stata creata la demo del catalogo industriale.