Passare il contesto del cliente a un chatbot IA per l'e-commerce

Crea il connector su un assistente TEST dedicato. Usa GET e l'endpoint controllato `https://dummyjson.com/http/200/Order_{order_id}_is_in_transit_eta_August_8`. Aggiungi un campo Text obbligatorio denominato `order_id`; il segnaposto e il nome del campo devono coincidere carattere per carattere.

Indica allo strumento di eseguirsi solo per la domanda fittizia sullo stato dell'ordine, di utilizzare l'esatto `order_id` corrente dal contesto del visitatore e di restituire solo ID ordine, stato normalizzato ed ETA. L'endpoint e un mock pubblico, non un'integrazione con un negozio reale. Non inserire mai un token di produzione o un record cliente nel prompt del connector.

Incorpora il widget senza `context-data`, apri una nuova conversazione e chiedi esattamente: “Where is my order?” Anche se il portale mostra visibilmente A-1023, il widget non puo leggere il testo arbitrario della pagina e dovrebbe richiedere l'ID dell'ordine.

Fermati se la risposta contiene gia A-1023, in transit o August 8. Cio indica uno stato di conversazione non aggiornato, dati trapelati nel prompt o una risposta non verificata. Cancella la conversazione e il contesto del browser prima di proseguire.

Per una pagina renderizzata lato server, aggiungi `context-data="Customer=Jane Doe;order_id=A-1023;locale=en-US"` a `<web-chat-agent>`. Sono supportate coppie separate da punto e virgola e un oggetto JSON piatto; gli oggetti nidificati non sostituiscono una richiesta di backend dedicata.

Il record normalizzato consente al massimo 20 chiavi, 64 caratteri per chiave, 500 per valore e 4,000 caratteri serializzati in totale. Usa chiavi macchina stabili come `order_id`, evita dati sensibili e mantieni facoltative le etichette di visualizzazione come Customer.

Avvia una nuova conversazione con contesto abilitato e ripeti “Where is my order?” L'assistente dovrebbe usare A-1023 per l'argomento richiesto dello strumento `order_id`, chiamare l'endpoint GET e rispondere che l'ordine fittizio e in transito con ETA August 8.

La dimostrazione combina tre osservazioni: l'embed contiene A-1023, l'URL del connector contiene il segnaposto `{order_id}` e la risposta live del mock contiene A-1023 piu il testo dello stato. Il contesto seleziona il record; la risposta dell'endpoint fornisce lo stato.

Quando il visitatore passa ad A-2048, invia l'evento `new CustomEvent('webchatagent:context', { detail: { Customer: 'Jane Doe', order_id: 'A-2048', locale: 'en-US' } })`. Esegui questa operazione solo dopo che lo stato della pagina e la sessione autorizzata concordano sul nuovo record.

La sostituzione e intenzionale: le chiavi omesse scompaiono anziche persistere. Al logout, invia un oggetto vuoto o `null`. Non unire i vecchi valori di cliente e ordine nel codice dell'applicazione a meno che tale comportamento non sia esplicitamente richiesto e testato.

Mantieni aperto il widget e chiedi: “What is the status of the order now shown on this page?” La risposta successiva deve contenere A-2048 e lo stato del mock, e non deve menzionare A-1023.

Salva questo test a tre stati come regressione: contesto mancante, contesto originale e sostituzione a runtime. Ripetilo dopo modifiche a connector, prompt di sistema, modello, widget o applicazione host. Registra domanda, contesto corrente, argomento dello strumento, risposta dell'endpoint e timestamp.

Usa l'attributo HTML per i valori renderizzati lato server. Imposta `window.webchatagentContext` prima dello script asincrono del widget quando JavaScript gestisce la sessione iniziale. Usa `webchatagent:context` per login, logout, account, carrello, prodotto o cambi di route successivi al caricamento.

In WordPress, usa il filtro `webchatagent_context_data` per i valori generati centralmente o `[webchatagent_inline context-data="order_id=A-1023"]` per un posizionamento inline. I client white-label utilizzano `window.chatWidgetContext` e l'evento `chat-widget:context` con una semantica di sostituzione identica.

Limita `allowedDomains` agli host esatti di produzione e staging. Non autorizzare la ricerca di un ordine solo perche il contesto contiene nome del cliente, email o numero d'ordine; un visitatore puo modificare ogni valore nei DevTools.

Fai in modo che il tuo backend emetta un token opaco a breve durata per la sessione autenticata, passa solo quel token come contesto e consenti al connector di chiamare un endpoint di lettura con privilegi minimi. L'endpoint convalida token, titolarita del cliente, scadenza e ambito richiesto lato server, quindi restituisce solo ID ordine, stato ed ETA. Revoca o fai scadere il token al logout.