Globaalien muuttujien käsitteleminen

1. Luo muuttuja tai avaa olemassa oleva muuttuja Muuttujat-paneelia käyttäen.

2. Valitse Muuttujan ominaisuudet -paneelin kohdassa Yleinen (minkä tahansa aiheen käytettävissä). Muuttujan nimi saa etuliitteen Global. sen erottamiseksi aihetason muuttujista. Esimerkiksi muuttujasta UserName tulee Global.UserName.

3. Tallenna aihe.

1. Valitse haluamasi muuttuja.

2. Valitse Muuttujan ominaisuudet -paneelin kohdassa KäyttöBotti (minkä tahansa aiheen käytettävissä).

3. Muuttujan nimi saa etuliitteen bot. sen erottamiseksi aihetason muuttujista. Esimerkiksi muuttujasta UserEmail tulee bot.UserEmail.

Kun kirjoitat viestin Viesti-solmussa tai kysymyssolmussa, valitse {x}-kuvake, niin näet muuttujat, joita aihe voi käyttää. Työkalusolmuissa voi myös käyttää yleisiä muuttujia, jotka kutsuvat kehotteita tai työnkulkuja. Yleiset muuttujat näkyvät Mukautettu-välilehdessä aiheen muuttujien kanssa. Muuttujat luetellaan aakkosjärjestyksessä.

Kun kirjoitat viestin Viesti-solmussa tai kysymyssolmussa, valitse {x}-kuvake, niin näet muuttujat, joita aihe voi käyttää. Muuttujat ovat aakkosjärjestyksessä, ja kaikki globaalit muuttujat näkyvät yhdessä, koska kaikkien niiden alussa on bot..

Kun käytät ehtosolmua, työnkulkutoimintosolmua tai taitosolmua, näet myös siellä käytettävissä olevat yleiset muuttujat.

1. Valitse yleinen muuttuja, jonka haluat luoda luontipohjalla tai Muuttujat-paneelissa .

2. Valitse Muuttujan ominaisuudet -paneelin Viite-osasta Näytä kaikki viittaukset.

3. Siirry Muu-välilehteen ja valitse aihe, jossa muuttujan avulla siirrytään suoraan aiheeseen ja solmuun.

Valitse piirtoalustalla muuttuja, jonka haluat luoda. Näkyviin tulee Muuttujan ominaisuudet -ruutu.

• Jos haluat siirtyä suoraan solmuun, johon loit yleisen muuttujan, valitse Siirry lähteeseen.

• Jos haluat siirtyä tätä muuttujaa käyttävään aiheeseen, valitse haluamasi aihe Käytössä-osassa.

Yleinen muuttujan arvo säilyy oletusarvoisesti siihen asti, kunnes istunto päättyy. Clear variable values -solmu nollaa globaaleiden muuttujien arvot. Reset Conversation -järjestelmän aihe käyttää tätä solmua. Kun uudelleenohjaus käynnistää kyseisen aiheen (tai kun käyttäjä kirjoittaa lauseen, kuten "Aloita alusta"), kaikki yleiset muuttujat nollataan.

Voit käyttää yleisiä muuttujia mistä tahansa aiheesta, ja niiden arvo säilyy koko istunnon ajan.

Arvo tyhjennetään vain, kun agentin käyttäjä ohjataan uudelleen Aloita alusta -järjestelmäaiheeseen tai käyttäjä käynnistää tämän aiheen suoraan (esimerkiksi kirjoittamalla Aloita alusta). Tällöin kaikki yleiset muuttujat nollataan, eikä niillä ole arvoa.

Globaali muuttujan alustaminen

Jos yleinen muuttuja käynnistetään ennen sen alustamista (tai "täyttämistä"), agentti käynnistää automaattisesti sen aiheen osan, jossa yleinen muuttuja on määritetty ensimmäistä kertaa – vaikka se olisi eri aiheessa – ennen kuin se palaa alkuperäiseen aiheeseen. Tämän toiminnan avulla agentti voi täyttää kaikki muuttujat keskeyttämättä keskustelua.

Otetaan esimerkiksi se, että asiakas aloittaa keskustelun "Tapaamisen varaus"-aiheessa, jossa käytetään yleistä muuttujaa bot.UserName. Muuttuja bot.UserName on kuitenkin määritetty ensimmäistä kertaa "Tervetuloa"-aiheessa.

Kun keskustelu saavuttaa sen "Tapaamisen varaaminen" -aiheen kohtaan, jossa viitataan muuttujaan bot.UserName, agentti ohjautuu saumattomasti kysymyssolmuun, jossa bot.UserName on määritetty ensimmäisen kerran.

Kun asiakas vastaa kysymykseen, agentti jatkaa aihetta "Tapahtuman varaaminen".

Yleinen muuttujatoiminta, kun toteutat toimintoja Power Automate työnkulkujen tai taitojen kautta

Joskus saatat käyttää työnkulkua tai taitoa muuttujan alustamiseen tai täyttämiseen.

Kun käyttäjä kuitenkin on vuorovaikutuksessa agentin kanssa, muuttuja saatetaan täyttää aikaisemmassa keskustelun kohdassa tai olet ehkä jo määrittänyt muuttujat ulkoisesti.

Tässä tilanteessa prosessi tai toiminta suoritetaan edelleen ja täyttää muuttujan, korvaten kaiken muuttujaan aiemmin tallennetun.

Varmista, että agentti aloittaa keskustelun jossakin kontekstissa, käyttämällä yleistä muuttujaa ja määrittämällä sen arvo ulkoisesta lähteestä. Oletetaan, että sivustosi edellyttää sisäänkirjautumista käyttäjiltä. Jos tallennat käyttäjän nimen yleiseen muuttujaan ja välität sen asiakaspalvelijalle, asiakaspalvelija voi tervehtiä asiakkaita nimeltä, ennen kuin he alkavat kirjoittaa ensimmäistä kysymystään. Toinen esimerkkiskenaario on kontekstin välittäminen Dynamics 365 Customer Service agentille, jotta se voi aloittaa keskustelun tietäen, mitä asiakas haluaa saavuttaa.

Jos haluat estää epätoivotun viiveen, määritä kuinka kauan agenttisi voi odottaa arvoa. Voit myös määrittää oletusarvon, jota käytetään, kun ulkoinen lähde ei vastaa ajoissa.

1. Luo erillinen aihe, joka sisältää määrityksen kaikille ulkoisista lähteistä asetettaville muuttujille. Voit antaa tälle aiheelle nimeksi esimerkiksi Määritä kontekstimuuttujat. Tämä ohjeaihe ei palvele muita tarkoituksia, joten siinä ei tarvitse olla käynnistinlauseita.

2. Lisää Määritä muuttujan arvo -solmu erilliseen aiheeseesi.

3. Avaa Määritä muuttuja -kohdassa muuttujavalitsin ja valitse Luo uusi muuttuja.

4. Valitse uuden muuttujan oletusnimi. Näkyviin tulee Muuttujan ominaisuudet -ruutu.

5. Korvaa oletusnimi nimellä, joka vastaa täysin ulkoisesta järjestelmästä välitettyjen muuttujien nimeä.

6. Valitse Käyttö-kohdassa Yleinen (mikä tahansa aihe voi käyttää) ja Ulkoiset lähteet voivat määrittää arvoja.

7. Valitse Viittaus-kohdassa oikeassa yläkulmassa olevat kolme pistettä (⋮) ja valitse Nouda arvo tästä solmusta, jos arvo on tyhjä.

8. (Valinnainen) Määritä aikakatkaisuviive millisekunteihin. Tämä arvo määrittää, kuinka kauan agentti voi odottaa ennen aikakatkaisua ja Määritä muuttujan arvo -solmussa määritetyllä oletusarvolla jatkamista, että ulkoinen lähde määrittää muuttujan. Tämä asetus on tärkeä tilanteissa, joissa muuttuja riippuu pitkäkestoisesta tai asynkronisesta prosessista, mutta asiakaspalvelijan on noudatettava enimmäisviivettä hyvän käyttökokemuksen varmistamiseksi.

   Customer Servicen monikanavan muuttujien enimmäisodotusaika on 10 sekuntia (10 000 ms).

9. Anna Määritä muuttujan arvo -solmussa oletusarvo, jota käytetään, jos aikakatkaisu saavutetaan. Ajon aikana agenttisi odottaa arvoja, joilla on sama tietotyyppi. Jos haluat tämän oletusarvon olevan tyhjä merkkijono, käytä kaavaa Text("").

   

10. Lisää erilliseen aiheeseesi lisää Määritä muuttujan arvo -solmuja kullekin muulle ulkoisesta järjestelmästä saapuvaksi odotettavalle arvolle ja määritä tarvittavat yleiset muuttujat samalla tavalla.

Kun määrität agentin tällä tavalla, se on valmis testattavaksi. Kun asiakaspalvelija käynnistetään, asiakaspalvelija voi sen sijaan, että odottaisi loputtomiin kaikkien muuttujien täyttämistä, aloittaa välittömästi sellaisten viestien lähettämisen, jotka eivät riipu välitettävistä muuttujista. Kun agenttisi yrittää käyttää muuttujaa, joka on määritetty ulkoisesti, se keskeytetään, kunnes arvo saapuu tai aikakatkaistaan. Lue lisää artikkelista Agenttien optimointi viiveen minimoimiseksi.

Voit määrittää yleisen muuttujan alustettavaksi ulkoisesta lähteestä. Tämä toiminto antaa agentin aloittaa keskustelun siten, että sillä on taustatietoja.

Otetaan esimerkiksi se, että asiakas avaa agenttikeskustelun verkkosivustollasi ja sivusto tietää jo asiakkaan nimen. Sinä kerrot agentille käyttäjän nimen ennen keskustelun aloittamista, jolloin agentti voi käydä älykkäämpää keskustelua asiakkaan kanssa ilman tarvetta kysyä hänen nimeänsä uudelleen.

1. Valitse haluamasi yleinen muuttuja.

2. Valitse Muuttujan ominaisuudet -paneelissa Ulkoiset lähteet voivat määrittää arvoja.

Jos agentti upotetaan yksinkertaiseen verkkosivuun, voit liittää muuttujat ja niiden määritykset agentin URL-osoitteeseen. Jos haluat hieman enemmän hallintaa, voit kutsua ja käyttää muuttujia ohjelmallisesti <script> -koodilohkon avulla.

URL-osoitteen kyselymerkkijonon muuttujan nimen on vastattava yleisen muuttujan nimeä ilman Global.-etuliitettä. Esimerkiksi yleisessä muuttujassa Global.UserName käytetään vain UserName kyselyssä.

Seuraavissa esimerkeissä käytetään muuttujien perusmääritystä. Tuotantoskenaariossa saatat välittää toisen muuttujan, joka tallentaa jo käyttäjän nimen (jos sinulla on esimerkiksi kirjautumiskomentosarjan käyttäjänimi) kyselyparametrina tai muuttujan määrityksenä.

Liitä muuttujat ja niiden määritelmät agentin URL-osoitteeseen kyselymerkkijonoparametreina muodossa botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Esimerkkejä:

• Sinulla on yleinen muuttuja nimellä Global.UserName.
• Agenttisi URL-osoite on https://web.powerva.microsoft.com/webchat/bots/12345.
• Voit välittää käyttäjän nimen agentin keskustelun alkaessa sivustossa liittämällä UserName=-kyselymerkkijonon muodossa https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

Parametrin nimessä kirjainkoolla ei ole merkitystä: username=Ana se toimii myös tässä esimerkissä.

Voit lisätä muuttujia ja niiden määritelmiä, jos olet yksinkertaisesti upottamassa agenttisi yksinkertaiselle verkkosivulle. Koodilohkon <script> avulla voit myös kutsua ja käyttää muuttujia ohjelmallisesti.

Seuraavissa esimerkeissä käytetään muuttujien perusmääritystä. Tuotantoskenaariossa saatat välittää toisen muuttujan, joka tallentaa jo käyttäjän nimen (jos sinulla on esimerkiksi kirjautumiskomentosarjan käyttäjänimi) kyselyparametrina tai muuttujan määrityksenä.

1. Liitä muuttujat ja niiden määritelmät agentin URL-osoitteeseen kyselymerkkijonoparametreina (muodossa botURL?variableName1=variableDefinition1&variableName2=variableDefinition2). Esimerkki:

   • Sinulla on yleinen muuttuja nimellä bot.UserEmail.
   • Agenttisi URL-osoite on https://web.powerva.microsoft.com/webchat/bots/12345.
   • Jos haluat välittää käyttäjänimen aloittaessasi agenttikeskustelua sivustossa, liitä UserEmail= kyselymerkkijono seuraavasti: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. Parametrin nimessä kirjainkoolla ei ole merkitystä: useremail=Ana@contoso.com se toimii myös tässä esimerkissä.

1. Määritä muuttujat <script>-osassa sillä sivulla, jolla agentti sijaitsee, seuraavasti korvaten arvon variableName1 muuttujan nimellä ilman Global.-etuliitettä ja käytä määritelmänä arvoa variableDefinition1. Käytä useiden muuttujien erottimena pilkkuja (,).

      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. Kutsu <script>-osassa store-kohdetta, kun upotat agenttisi, kuten seuraavassa esimerkissä, joka store kutsutaan juuri ennen kuin styleOptions kutsutaan (sinun on korvattava BOT_ID agenttisi tunnuksella):

   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. Määritä muuttujat <script>-osassa sillä sivulla, jolla agentti sijaitsee, seuraavasti korvaten arvon variableName1 muuttujan nimellä ilman bot.-etuliitettä ja käytä määritelmänä arvoa variableDefinition1. Käytä useiden muuttujien erottimena pilkkuja ,.

      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. Kutsu <script>-osassa store-kohdetta, kun upotat agenttisi, kuten seuraavassa esimerkissä, joka store kutsutaan juuri ennen kuin styleOptions kutsutaan (sinun on korvattava BOT_ID tunnuksellasi):

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