Arbejd med globale variabler

1. Opret en variabel, eller brug Variabler-panelet til at åbne en eksisterende variabel.

2. I ruden Egenskaber for variabel under skal du vælge Global (ethvert emne kan få adgang). Variabelnavnet henter præfikset Global. for at skelne det fra variabler på emneniveau. Variablen UserName bliver Global.UserNamef.eks. .

3. Gem emnet.

1. Vælg den ønskede variabel.

2. I panelet Egenskaber for variabel under Anvendelse skal du vælge Robot (ethvert emne kan få adgang).

3. Variabelnavnet henter præfikset bot. for at skelne det fra variabler på emneniveau. Variablen UserEmail bliver bot.UserEmailf.eks. .

Når du skriver en meddelelse i en node af typen Meddelelse eller Spørgsmål , skal du vælge ikonet {x} for at få vist de variabler, som emnet kan få adgang til. Du kan også bruge globale variabler i Værktøjsnoder , der kalder prompter eller arbejdsprocesser. Globale variabler vises under fanen Brugerdefineret sammen med eventuelle emnevariabler. Variabler sorteres i alfabetisk rækkefølge.

Når du skriver en meddelelse i en node af typen Meddelelse eller Spørgsmål , skal du vælge ikonet {x} for at få vist de variabler, som emnet kan få adgang til. Variabler vises i alfabetisk rækkefølge, og alle globale variabler vises sammen, fordi de alle begynder med bot..

Når du bruger en betingelsesnode, en flowhandlingsnode eller en færdighedsnode, kan du også se globale variabler, der er tilgængelige her.

1. Vælg den globale variabel, du vil have, på oprettelseslærredet eller i panelet Variabler .

2. I panelet for Variabelegenskaber skal du i sektionen Reference vælge Vis alle referencer.

3. Skift til fanen Andet, og vælg et emne, hvor variablen bruges, for at gå direkte til det pågældende emne og node.

Vælg den ønskede variabel på oprettelseslærredet. Panelet Variabel egenskaber vises.

• Hvis du vil gå direkte til den node, hvor du oprettede den globale variabel, skal du vælge Gå til kilde.

• Hvis du vil gå til et emne, der bruger denne variabel, skal du vælge det ønskede emne i sektionen Brugt af.

En global variabelværdi bevares som standard, indtil sessionen slutter. Noden Ryd variabelværdier nulstiller værdierne for globale variabler. Emnet Nulstil samtalesystem bruger denne node. Når en omdirigering udløser emnet (eller når brugeren indtaster en sætning som "Start forfra"), nulstilles alle globale variabler.

Du kan få adgang til globale variabler fra et hvilket som helst emne, og deres værdi bevares i hele en session.

Værdien ryddes kun, når agentbrugeren omdirigeres til emnet Start forfra, eller når brugeren udløser dette emne direkte (for eksempel ved at skrive "Start forfra"). I dette tilfælde nulstilles alle globale variabler, og de har ingen værdier.

Initialisering af global variabel

Hvis en global variabel udløses, før den er blevet initialiseret (eller "udfyldt"), udløser agenten automatisk den del af emnet, hvor den globale variabel først defineres, selv når den er i et andet emne, før den returneres til det oprindelige emne. Dette giver agenten mulighed for at få udfyldt alle variable, uden at samtalen afbrydes.

Kunden starter f.eks. samtalen med emnet "Reservation af aftale", hvor der bruges en global variabel af typen bot.UserName. Variablen bot.UserName er dog først defineret i "Velkomst"-emnet.

Når samtalen når til det punkt i emnet "Reservation af aftale", hvor der henvises til bot.UserName, vil agenten uden videre blive pivoteret til den spørgsmålsnode, hvor bot.UserName er angivet først.

Når kunden har besvaret spørgsmålet, vil agenten fortsætte med emnet "Reservation af aftale".

Global variabeladfærd ved implementering af handlinger via Power Automate-flows eller færdigheder

Nogle gange ønsker du måske at bruge et flow eller en færdighed til at initialisere eller udfylde en variabel.

Når en bruger arbejder sammen med agenten, kan variablen dog være udfyldt på et tidligere tidspunkt i samtalen, eller du har måske allerede angivet variablerne eksternt.

I denne situation kører flowet eller færdigheden stadig og udfylder variablen, hvorved den overskriver, hvad der tidligere var gemt i variablen.

Hvis du vil sikre, at agenten starter en samtale med en kontekst, skal du bruge en global variabel og angive dens værdi fra en ekstern kilde. Lad os antage, at dit websted kræver, at brugerne logger på. Hvis du gemmer en brugers navn i en global variabel og videregiver det til din agent, kan agenten byde kunderne velkommen ved navn, før de begynder at skrive deres første spørgsmål. Et andet eksempelscenarie er at overføre kontekst fra Dynamics 365 Customer Service til en agent, så den kan starte samtalen med viden om, hvad kunden ønsker at opnå.

Hvis du vil forhindre uønsket ventetid, skal du angive, hvor længe din agent kan vente på en værdi. Du kan også angive en standardværdi, der skal bruges, når den eksterne kilde ikke svarer rettidigt.

1. Opret et dedikeret emne til at indeholde konfigurationen for alle de variabler, der er beregnet til at blive angivet fra eksterne kilder. Du kan f.eks. navngive dette emne "Indstil kontekstvariabler." Dette emne tjener ikke andre formål, så det behøver ikke at have udløserfraser angivet.

2. Føj noden Indstil variabelværdi til dit dedikerede emne.

3. Åbn variabelvælgeren under Indstil variabel, og vælg Opret en ny variabel.

4. Vælg standardnavnet på den nye variabel. Panelet Variabel egenskaber vises.

5. Erstat standardnavnet med et navn, der svarer nøjagtigt til navnet på den variabel, der overføres fra det eksterne system.

6. Under Forbrug skal du vælge Global (ethvert emne kan få adgang) og Eksterne kilder kan angive værdier.

7. Under Reference, vælg de tre prikker (⋮) i øverste højre hjørne, og vælg Hent værdi fra denne node, hvis den er tom.

8. (Valgfrit) Angiv en timeoutforsinkelse i millisekunder. Denne værdi bestemmer, hvor længe din agent kan vente på, at variablen angives af en ekstern kilde, før der opstår timeout og fortsætter med den standardværdi, du har angivet i noden Angiv variabel værdi. Denne indstilling er relevant i scenarier, hvor variablen afhænger af en langvarig eller asynkron proces, men din agent skal respektere en maksimal ventetid for at sikre en god brugeroplevelse.

   For variabler, der kommer fra Omnichannel til kundeservice, skal du bruge en værdi på 10 sekunder (10.000 ms) som en maksimal ventetid.

9. I noden Angiv variabelværdi skal du angive den standardværdi, der skal bruges, hvis timeout er nået. På kørselstidspunktet forventer din agent værdier med samme datatype. Hvis denne standardværdi skal være en tom streng, skal du bruge Text("") som formel.

   

10. For eventuelle andre værdier, du forventer kommer fra et eksternt system, skal du tilføje flere Angiv variabel værdi-noder til dit dedikerede emne og konfigurere de påkrævede globale variabler på samme måde.

Når du konfigurerer din agent på denne måde, er den klar til test. Når helpdesk-medarbejderen aktiveres, kan helpdesk-medarbejderen straks begynde at sende meddelelser, der ikke er afhængige af, at variablerne overføres, i stedet for at vente uendeligt på, at alle variabler udfyldes. Når din agent forsøger at få adgang til en variabel, der angives eksternt, afbrydes den midlertidigt, indtil værdien ankommer, eller der opstår timeout. Få mere at vide i Optimer agenter for at minimere ventetiden.

Du kan angive, at en global variabel skal initialiseres fra en ekstern kilde. Dette giver agenten mulighed for at starte samtalen med noget kontekst.

En kunde åbner f.eks. en agentchat på dit website, og websitet kender allerede kundens navn. Du skal oplyse agenten om brugerens navn, før du starter samtalen, og agenten kan derefter føre en mere intelligent samtale med kunden, uden at det er nødvendigt at bede om navnet igen.

1. Vælg den globale variabel, du vil bruge.

2. I panelet Egenskaber for variabel skal du vælge Eksterne kilder kan angive værdier.

Hvis du indlejrer din agent på en simpel webside, kan du føje variabler og deres definitioner til agentens URL-adresse. Eller hvis du vil have lidt mere kontrol, kan du bruge en <script>-kodeblok til at kalde og bruge variabler via programmering.

Variabelnavnet i forespørgselsstrengen for URL-adressen skal matche navnet for den globale variabel uden præfikset Global.. For en global variabel Global.UserName kan du f.eks. kun UserName bruge den i forespørgslen.

I følgende eksempler bruges en grundlæggende erklæring for variablerne. I et produktionsscenarie kan du angive en anden variabel, der allerede gemmer brugerens navn (f.eks. hvis du har brugernavnet fra et logonscript) som forespørgselsparameteren eller variabeldefinitionen.

Tilføj variablerne og deres definitioner til agentens URL-adresse som forespørgselsstrengparametre i formatet botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Eksempel:

• Du har en global variabel kaldet Global.UserName.
• URL-adressen til din agent er https://web.powerva.microsoft.com/webchat/bots/12345.
• Du kan indsætte brugernavnet, når du starter en agentsamtale på et websted, ved at vedhæfte UserName= forespørgselsstrengen som: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

Der skelnes mellem store og små bogstaver i parameternavnet: username=Ana fungerer også i dette eksempel.

Du kan tilføje variabler og deres definitioner, hvis du blot integrerer din agent på en simpel webside. Eller du kan bruge en <script> kodeblok til at kalde og bruge variabler programmeringsmæssigt.

I følgende eksempler bruges en grundlæggende erklæring for variablerne. I et produktionsscenarie kan du angive en anden variabel, der allerede gemmer brugerens navn (f.eks. hvis du har brugernavnet fra et logonscript) som forespørgselsparameteren eller variabeldefinitionen.

1. Tilføj variablerne og deres definitioner til agentens URL-adresse som forespørgselsstrengparametre (i formatet botURL?variableName1=variableDefinition1&variableName2=variableDefinition2), f.eks.:

   • Du har en global variabel kaldet bot.UserEmail.
   • URL-adressen til din agent er https://web.powerva.microsoft.com/webchat/bots/12345.
   • Hvis du vil overføre brugernavnet, når du starter en agentsamtale på et websted, skal du vedhæfte forespørgselsstrengen UserEmail= som: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. Der skelnes mellem store og små bogstaver i parameternavnet: useremail=Ana@contoso.com fungerer også i dette eksempel.

1. I sektionen <script> på siden, hvor du har din agent, skal du definere variablerne på følgende måde og erstatte variableName1 med variabelnavnet uden Global.-præfikset og variableDefinition1 med definitionen. Adskil flere variabler med kommaer (,).

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. I sektionen <script> skal du kalde store, når du integrerer din agent, som i følgende eksempel, hvor store kaldes lige før, hvor styleOptions blev kaldt (du skal erstatte BOT_ID med din agents id):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

1. I sektionen <script> på siden, hvor du har din agent, skal du definere variablerne på følgende måde og erstatte variableName1 med variabelnavnet uden bot.-præfikset og variableDefinition1 med definitionen. Adskil flere variabler med kommaer ,.

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. I sektionen <script> skal du kalde store, når du integrerer din agent, som i følgende eksempel, hvor store kaldes lige før, hvor styleOptions blev kaldt (du skal erstatte BOT_ID med din agents id):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));