Klantcontext doorgeven aan een AI-chatbot voor e-commerce

Maak de connector aan op een speciale TEST-assistent. Gebruik GET en het gecontroleerde eindpunt `https://dummyjson.com/http/200/Order_{order_id}_is_in_transit_eta_August_8`. Voeg één vereist Text-veld toe met de naam `order_id`; de placeholder en veldnaam moeten teken voor teken overeenkomen.

Stel de tool zo in dat deze alleen wordt uitgevoerd voor de fictieve bestelstatusvraag, de exacte huidige `order_id` uit de bezoekerscontext gebruikt en alleen bestel-ID, genormaliseerde status en ETA retourneert. Het eindpunt is een openbare mock, geen winkelintegratie. Plaats nooit een productietoken of klantrecord in de connector-prompt.

Sluit de widget in zonder `context-data`, open een nieuw gesprek en vraag exact: “Where is my order?” Hoewel het portaal zichtbaar A-1023 toont, kan de widget geen willekeurige paginatekst lezen en moet deze om het bestel-ID vragen.

Stop als het antwoord al A-1023, in transit of August 8 vermeldt. Dat wijst op verouderde gespreksstatus, gelekte promptgegevens of een onveilige aanname. Wis het gesprek en de browsercontext voordat u verdergaat.

Voeg voor een server-rendered pagina `context-data="Customer=Jane Doe;order_id=A-1023;locale=en-US"` toe aan `<web-chat-agent>`. Door puntkomma's gescheiden paren en een plat JSON-object worden ondersteund; geneste objecten zijn geen vervanging voor een speciaal backend-verzoek.

Het genormaliseerde record staat maximaal 20 sleutels toe, 64 tekens per sleutel, 500 per waarde en 4,000 geserialiseerde tekens in totaal. Gebruik stabiele machinesleutels zoals `order_id`, vermijd geheimen en houd weergavelabels zoals Customer optioneel.

Start een nieuw gesprek met ingeschakelde context en herhaal “Where is my order?” De assistent moet A-1023 gebruiken voor het vereiste `order_id` tool-argument, het GET-eindpunt aanroepen en antwoorden dat de fictieve bestelling onderweg is met ETA August 8.

Het bewijs combineert drie waarnemingen: de insluiting bevat A-1023, de connector-URL bevat de `{order_id}`-placeholder en de live mock-respons bevat A-1023 plus de statustekst. Context selecteert het record; de eindpuntrespons levert de status.

Wanneer de bezoeker overschakelt naar A-2048, verzend dan `new CustomEvent('webchatagent:context', { detail: { Customer: 'Jane Doe', order_id: 'A-2048', locale: 'en-US' } })`. Doe dit pas nadat de paginastatus en de geautoriseerde sessie overeenstemmen over het nieuwe record.

Vervanging is bewust zo ontworpen: weggelaten sleutels verdwijnen in plaats van te blijven hangen. Verzend bij het uitloggen een leeg object of `null`. Voeg oude klant- en bestelwaarden niet samen in de applicatiecode, tenzij dat gedrag expliciet vereist en getest is.

Laat de widget open en vraag: “What is the status of the order now shown on this page?” Het volgende antwoord moet A-2048 en de mock-status bevatten, en mag A-1023 niet vermelden.

Bewaar deze test met drie statussen als regressietest: ontbrekende context, originele context en runtime-vervanging. Herhaal deze na wijzigingen aan de connector, systeemprompt, het model, de widget of de hostapplicatie. Leg de vraag, huidige context, het tool-argument, de eindpuntrespons en het tijdstempel vast.

Gebruik het HTML-attribuut voor server-rendered waarden. Stel `window.webchatagentContext` in vóór het asynchrone widget-script wanneer JavaScript de initiële sessie beheert. Gebruik `webchatagent:context` voor inloggen, uitloggen, account-, winkelwagen-, product- of routewijzigingen na het laden.

Gebruik in WordPress het `webchatagent_context_data`-filter voor centraal gegenereerde waarden of `[webchatagent_inline context-data="order_id=A-1023"]` voor een inline plaatsing. White-label-clients gebruiken `window.chatWidgetContext` en het `chat-widget:context`-event met identieke vervangingslogica.

Beperk `allowedDomains` tot exacte productie- en staginghosts. Autoriseer een bestel-lookup niet enkel omdat de context een klantnaam, e-mailadres of bestelnummer bevat; een bezoeker kan elke waarde in DevTools aanpassen.

Laat uw backend een kortlevend ondoorzichtig token uitgeven voor de ingelogde sessie, geef alleen dat token door als context en laat de connector een lees-eindpunt met minimale rechten aanroepen. Het eindpunt valideert token, klanteigendom, vervaldatum en aangevraagd bereik aan de serverzijde, en retourneert vervolgens uitsluitend bestel-ID, status en ETA. Trek het token in of laat het verlopen bij het uitloggen.