Videresend kontekstvariabler fra en webside til en agent

Når din agent er installeret på et brugerdefineret websted, kan det være en god ide at overføre kontekstvariabler fra en webside til agenten og bruge disse variabler til at forbedre brugeroplevelsen. Kontekstvariabler giver din agent mulighed for at levere skræddersyede og mere meningsfulde interaktioner med besøgende på dit websted.

Hvornår kontekstvariabler skal videregives

Her er nogle eksempler på situationer, hvor det kan være nyttigt at overføre kontekst til en agent:

  • Overfør et sporings-id for webanalyse fra en webside til en agent, så de kan analysere web- og agentanalyser sammen.

  • Overfør et ordre-id fra en webside til agenten, så kunden ikke behøver at skrive ordre-id'et igen. Agenten kan blot hente ordre-id-oplysningerne fra websiden.

  • Overfør den aktuelle side på webstedet, så agenten kan tilpasse sin oplevelse efter hvilken side kunden besøger.

  • Videregiv sproget på websiden, så agenten kan tilpasse oplevelsen efter websidens sprog.

Overførsel af kontekstvariabler er en totrinsprocedure: Overfør først konteksten fra din webside til agenten, og gem derefter konteksten i agenten som en variabel.

Overfør konteksten fra din webside til agenten

I din JavaScript-kode, hvor du kalder agenten, skal du inkludere de værdier, der skal sendes som kontekst. Du kan videregive alle oplysninger fra dit websted til din agent. Følgende kodestykke sender f.eks. tre kontekstvariabler: Language, currentURL og OrderId.

{
Language: siteLanguage,
currentURL: window.location.href,
OrderId: '12345'
}

Læs mere i Tilføj globale variabler på et brugerdefineret lærred. For et komplet brugerdefineret lærred Webchat.js HTML/JavaScript-eksempelkodeblok, se Tilpas udseendet og funktionaliteten af en agent.

Gem kontekst som en variabel i agenten

I systememnet Samtalestart skal du tilføje en spørgsmålsnode. For at konfigurere emnet korrekt, fortsæt som følger:

  1. Lad spørgsmålet være tomt. Du kan kun bruge spørgsmålsnoden som et middel til at hente kontekst fra en ekstern kilde.

  2. For Identificer skal du erstatte standarden Indstillinger for flere svarmuligheder med Brugerens fulde svar eller den relevante datatype.

  3. Vælg standardvariabelnavnet, og erstat det med et repræsentativt navn i panelet Egenskaber for variabler.

  4. Vælg Global (ethvert emne kan få adgang).

  5. Vælg Eksterne kilder kan angive værdier.

    Skærmbillede af panelet 'Variable egenskaber', der viser konfigurationen for en global variabel i Copilot Studio.

  6. Sæt eventuelt den ønskede timeout-værdi, så variablen kan modtage sin værdi fra den eksterne kilde.

Bemærk!

I dette eksempel bruges systememnet Start samtale, men du kan gemme den kontekst, der modtages fra en webside, i et emne. En god praksis er at dedikere et enkelt emne, hvor du konfigurerer globale variabler til at holde den information, du forventer fra eksterne kilder. Læs mere under Angiv globale variabler fra eksterne kilder.

Din agent kan bruge disse variable til forskellige formål, for eksempel til at hente ordredetaljer for ordre-id'et eller til at tilpasse chatadfærden ud fra sproget. For et eksempel på, hvordan du kan bruge dette koncept til at kombinere dine web- og agentanalyser, se Kombinere web- og agentanalyser.

  • Last updated on