Arbeid med globale variabler

1. Opprett en variabel, eller bruk Variabler-panelet til å åpne en eksisterende variabel.

2. I panelet Egenskaper for variabel velger du Global (alle emner har tilgang). Variabelnavnet får prefikset Global. til å skille det fra variabler på emnenivå. Variabelen UserName blir Global.UserNamefor eksempel .

3. Lagre temaet.

1. Velg variabelen du vil bruke.

2. I panelet Egenskaper for variabel under Bruk velger du Robot (alle emner har tilgang).

3. Variabelnavnet får prefikset bot. til å skille det fra variablene på emnenivå. Variabelen UserEmail blir bot.UserEmailfor eksempel .

Når du skriver en melding i en meldingsnode eller en spørsmålsnode , velger du {x} -ikonet for å vise variablene som emnet har tilgang til. Du kan også bruke globale variabler i verktøynoder som kaller opp ledetekster eller arbeidsflyter. Globale variabler vises på Egendefinert-fanen sammen med eventuelle emnevariabler. Variabler er oppført i alfabetisk rekkefølge.

Når du skriver en melding i en meldingsnode eller en spørsmålsnode , velger du {x} -ikonet for å vise variablene som emnet har tilgang til. Variabler er oppført i alfabetisk rekkefølge, og alle globale variabler vises sammen fordi alle starter med bot.

Når du bruker en betingelsesnode, en flythandlingsnode eller en ferdighetsnode, vises også globale variabler som er tilgjengelige der.

1. Velg den globale variabelen du vil bruke på redigeringslerretet eller i Variabler-panelet .

2. I panelet Egenskaper for variabel, i Referanse-delen, velg Vis alle referanser.

3. Bytt til Annet-fanen, og velg et emne der variabelen brukes til å gå direkte til emnet og noden.

Velg variabelen du vil bruke på redigeringslerretet. Panelet Variabelegenskaper vises.

• Hvis du vil gå direkte til noden der du opprettet den globale variabelen, velger du Gå til kilde.

• Hvis du vil gå til et emne som bruker denne variabelen, velger du ønsket emne i delen Brukt av.

Som standard beholdes en global variabelverdi til økten avsluttes. Noden Clear-variabelverdier tilbakestiller verdiene for globale variabler. Emnet Tilbakestill samtalesystem bruker denne noden. Når en omadressering utløser dette emnet (eller når brukeren skriver inn et uttrykk som "Start på nytt"), tilbakestilles alle globale variabler.

Du kan få tilgang til globale variabler fra et hvilket som helst emne, og verdien beholdes gjennom en økt.

Verdien tømmes bare når agentbrukeren omdirigeres til systememnet Start på nytt, eller når brukeren utløser dette emnet direkte (for eksempel ved å skrive inn "Start på nytt"). I dette tilfellet tilbakestilles alle globale variabler, og de vil ikke ha noen verdi.

Initialisering av global variabel

Hvis en global variabel utløses før den er initialisert (eller "fylt ut"), utløser agenten automatisk delen av emnet der den globale tvariabelen først er definert – selv når den er i et annet emne – før den returneres til det opprinnelige emnet. Denne virkemåten gjør det mulig for agenten å ha alle variablene fylt ut uten å avbryte diskusjonen.

Kunden starter for eksempel diskusjonen på "Avtalebestilling"-emnet, der en global variabel bot.UserName brukes. Variabelen bot.UserName defineres imidlertid først i «Velkommen»-emnet.

Når diskusjonen kommer til punktet i emnet «Avtalebestilling» der det refereres til bot.UserName, vil agenten sømløst gå til spørsmålsnoden der bot.UserName er først definert.

Etter at kunden har svart på spørsmålet, vil agenten gjenoppta emnet «Avtalebestilling».

Global variabel oppførsel ved implementering av handlinger via Power Automate-flyter eller ferdigheter

Noen ganger kan det hende at du bruker en flyt eller ferdighet til å initialisere eller fylle ut en variabel.

Når en bruker samhandler med agenten, kan det imidlertid være at variabelen ble fylt ut på et tidligere tidspunkt i samtalen, eller at du allerede har konfigurert variablene eksternt .

I slike tilfeller vil flyten eller ferdigheten fremdeles kjøre og fylle ut variabelen, og overskrive det som tidligere var lagret i variabelen.

Hvis du vil sikre at agenten starter en samtale med en kontekst, bruker du en global variabel og angir verdien fra en ekstern kilde. La oss si at nettstedet krever at brukere logger på. Hvis du lagrer en brukers navn i en global variabel og sender det til agenten din, kan agenten hilse på kunder med navn før de begynner å skrive inn sitt første spørsmål. Et annet eksempelscenario er å sende kontekst fra Dynamics 365 Customer Service til en agent, slik at den kan starte samtalen med kunnskap om hva kunden ønsker å oppnå.

Hvis du vil forhindre uønsket ventetid, angir du hvor lenge agenten kan vente på en verdi. Du kan også angi en standardverdi som skal brukes når den eksterne kilden ikke svarer i tide.

1. Opprett et dedikert emne for å holde konfigurasjonen for alle variablene som skal angis fra eksterne kilder. Du kan for eksempel kalle dette emnet «Angi kontekstvariabler». Dette emnet brukes ikke til andre formål, så det trenger ikke å ha angitt utløseruttrykk.

2. Legg til noden Angi variabelverdi i det dedikerte emnet.

3. Under Angi variabel åpner du variabelvelgeren og velger Opprett ny variabel.

4. Velg standardnavnet på den nye variabelen. Panelet Variabelegenskaper vises.

5. Erstatt standardnavnet med et som samsvarer nøyaktig med navnet på variabelen som sendes inn fra det eksterne systemet.

6. Under Bruk velger du Global (alle emner har tilgang) og Eksterne kilder kan angi verdier.

7. Under Referanse velger du de tre prikkene (⋮) i øvre høyre hjørne og deretter Hent verdi fra denne noden hvis tom.

8. (Valgfritt) Angi en forsinkelse for tidsavbrudd i millisekunder. Denne verdien fastsetter hvor lenge agenten kan vente på at variabelen angis av en ekstern kilde før den blir tidsavbrutt og fortsetter med standardverdien du angir i noden Angi variabelverdi. Denne innstillingen er relevant i scenarier der variabelen avhenger av en langvarig eller asynkron prosess, men agenten må respektere maksimal ventetid for å sikre en god brukeropplevelse.

   For variabler som kommer fra Omnichannel for Kundeservice, kan du bruke en verdi på 10 sekunder (10 000 ms) som en maksimal ventetid.

9. Angi standardverdien som skal brukes hvis tidsavbruddet er nådd, i noden Angi variabelverdi . Ved kjøring forventer agenten verdier med samme datatype. Hvis du vil at denne standardverdien skal være en tom streng, bruker du Text("") som formel.

   

10. Når det gjelder andre verdier du forventer vil komme fra et eksternt system, legger du til flere Angi variabelverdi-noder i det dedikerte emnet og konfigurerer de nødvendige globale variablene på samme måte.

Når du konfigurerer agenten på denne måten, er den klar til å testes. Når agenten startes, kan agenten umiddelbart begynne å sende meldinger som ikke er avhengige av variablene som sendes inn, i stedet for å vente på ubestemt tid på at alle variablene skal fylles ut. Når agenten prøver å få tilgang til en variabel som angis eksternt, stanses den midlertidig til verdien kommer eller tidsavbruddet inntreffer. Finn ut mer i Optimaliser agenter for å minimere ventetiden.

Du kan angi at en global variabel skal initialiseres fra en ekstern kilde. Med denne handlingen kan agenten starte samtalen med en del kontekst.

En kunde henter for eksempel inn en agentsamtale fra nettstedet ditt, og nettstedet kjenner allerede kundens navn. Du lar agenten få vite navnet på brukeren før den starter samtalen, og agenten kan dermed ha en mer intelligent samtale med kunden uten å måtte spørre etter navnet på nytt.

1. Velg den globale variabelen du vil bruke.

2. I panelet Egenskaper for variabel velger du Eksterne kilder kan angi verdier.

Hvis du bygger inn agenten på en enkel nettside, kan du legge til variabler og tilhørende definisjoner i agentens nettadresse. Hvis du vil ha litt mer kontroll, kan du også bruke en <script>-kodeblokk til å kalle opp og bruke variabler programmatisk.

Variabelnavnet i spørringsstrengen for nettadressen må samsvare med navnet på den globale variabelen uten Global.-prefikset. For en global variabel Global.UserName brukes for eksempel bare UserName i spørringen.

Eksemplene nedenfor bruker en grunnleggende deklarasjon for variablene. I et produksjonsscenario kan du sende inn en annen variabel som allerede lagrer brukerens navn (for eksempel hvis du har brukernavnet fra et påloggingsskript) som spørringsparameter eller variabeldefinisjon.

Legg til variablene og definisjonene i nettadressen til agenten som spørringsstrengparametere i formatet botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Eksempel:

• Du har en global variabel kalt Global.UserName.
• Agentens nettadresse er https://web.powerva.microsoft.com/webchat/bots/12345.
• Hvis du vil sende inn brukerens navn når du starter en agentsamtale på nettstedet, legger du ved spørringsstrengen UserName= som https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

Parameternavnet skilles ikke mellom store og små bokstaver: username=Ana fungerer også i dette eksemplet.

Du kan legge til variabler og deres definisjoner hvis du bare bygger inn agenten på en enkel nettside. Du kan også bruke en <script> kodeblokk til å ringe og bruke variabler programmatisk.

Eksemplene nedenfor bruker en grunnleggende deklarasjon for variablene. I et produksjonsscenario kan du sende inn en annen variabel som allerede lagrer brukerens navn (for eksempel hvis du har brukernavnet fra et påloggingsskript) som spørringsparameter eller variabeldefinisjon.

1. Legg til variablene og definisjonene på agentens nettadresse som spørringsstrengparametere (i formatet botURL?variableName1=variableDefinition1&variableName2=variableDefinition2), for eksempel slik:

   • Du har en global variabel kalt bot.UserEmail.
   • Agentens nettadresse er https://web.powerva.microsoft.com/webchat/bots/12345.
   • Hvis du vil sende brukernavnet når du starter en agentsamtale på et nettsted, legger du ved spørringsstrengen UserEmail= som: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. Parameternavnet skilles ikke mellom store og små bokstaver: useremail=Ana@contoso.com fungerer også i dette eksemplet.

1. I <script>-delen på siden der du har agenten, definerer du variablene som følger, og erstatter variableName1 med variabelnavnet uten Global.-prefikset og variableDefinition1 for definisjonen. Skill flere variabler med komma (,).

      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 <script>-delen kaller du store når du bygger inn agenten, som i følgende eksempel hvor store kalles like før der styleOptions kalles (du må erstatte BOT_ID med ID-en til agenten din):

   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 <script>-delen på siden der du har agenten, definerer du variablene som følger, og erstatter variableName1 med variabelnavnet uten bot.-prefikset og variableDefinition1 for definisjonen. Skill flere variabler med komma ,.

      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 <script>-delen kaller du store når du bygger inn agenten, som i følgende eksempel hvor store kalles like før der styleOptions kalles (du må erstatte BOT_ID med ID-en din):

   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));