Werken met globale variabelen

1. Maak een variabele of gebruik het paneel Variabelen om een bestaande variabele te openen.

2. Selecteer in het paneel Variabele-eigenschappen de optie Algemeen (elk onderwerp heeft toegang). De naam van de variabele haalt het voorvoegsel Global. op om dit te onderscheiden van variabelen op onderwerpniveau. De variabele UserName wordt Global.UserNamebijvoorbeeld .

3. Sla het onderwerp op.

1. Selecteer de gewenste variabele.

2. Selecteer in het paneel Variabele-eigenschappen onder Gebruik de optie Bot (elk onderwerp heeft toegang).

3. De naam van de variabele haalt het voorvoegsel bot. op om dit te onderscheiden van de variabelen op onderwerpniveau. De variabele UserEmail wordt bot.UserEmailbijvoorbeeld .

Wanneer u een bericht opstelt in een berichtknooppunt of een vraagknooppunt , selecteert u het pictogram {x} om de variabelen weer te geven waartoe het onderwerp toegang heeft. U kunt ook globale variabelen gebruiken in toolknooppunten die prompts of werkstromen aanroepen. Globale variabelen worden weergegeven op het tabblad Aangepast , samen met eventuele onderwerpvariabelen. Variabelen worden in alfabetische volgorde weergegeven.

Wanneer u een bericht opstelt in een berichtknooppunt of een vraagknooppunt , selecteert u het pictogram {x} om de variabelen weer te geven waartoe het onderwerp toegang heeft. Variabelen worden in alfabetische volgorde weergegeven en alle algemene variabelen worden samen weergegeven omdat ze allemaal beginnen met bot..

Wanneer u een voorwaardeknooppunt, een stroomactieknooppunt of een vaardigheidsknooppunt gebruikt, ziet u daar ook algemene variabelen.

1. Selecteer de gewenste globale variabele op het ontwerpcanvas of in het deelvenster Variabelen .

2. Selecteer in het paneel Variabele-eigenschappen in de sectie Verwijzing de optie Alle verwijzingen weergeven.

3. Ga naar het tabblad Overig en selecteer een onderwerp waarin de variabele wordt gebruikt om direct naar dat onderwerp en knooppunt te gaan.

Selecteer de gewenste variabele op het ontwerpcanvas. Het deelvenster Variabele-eigenschappen verschijnt.

• Als u rechtstreeks naar het knooppunt wilt gaan waar u de globale variabele hebt gemaakt, selecteert u Ga naar bron.

• Om naar een onderwerp te gaan dat deze variabele gebruikt, selecteert u het gewenste onderwerp in de sectie Gebruikt door.

Standaard blijft een globale variabele waarde behouden totdat de sessie wordt beëindigd. Met het knooppunt Variabele waarden wissen worden de waarden van globale variabelen opnieuw ingesteld. In het onderwerp Gesprekssysteem opnieuw instellen wordt dit knooppunt gebruikt. Wanneer een omleiding dat onderwerp activeert (of wanneer de gebruiker een zin invoert zoals "Opnieuw beginnen"), worden alle algemene variabelen opnieuw ingesteld.

U hebt toegang tot globale variabelen vanuit elk onderwerp en de bijbehorende waarde blijft gedurende een sessie behouden.

De waarde wordt alleen gewist wanneer de agentgebruiker wordt omgeleid naar het systeemonderwerp Opnieuw beginnen of wanneer de gebruiker dit onderwerp rechtstreeks activeert (bijvoorbeeld door Opnieuw beginnen te typen). In dit geval worden alle algemene variabelen gereset en hebben ze geen waarden.

Initialisatie van een algemene variabel

Als een algemene variabele wordt geactiveerd voordat deze is geïnitialiseerd (of "gevuld"), activeert de agent automatisch het deel van het onderwerp waar de algemene variabele voor het eerst is gedefinieerd, zelfs wanneer dit zich in een ander onderwerp bevindt. Vervolgens keert hij terug naar het originele onderwerp. Door dit gedrag kan de agent alle variabelen vullen zonder het gesprek te onderbreken.

De klant start bijvoorbeeld het gesprek in het onderwerp "Afspraakboeking", waarin een algemene variabele bot.UserName wordt gebruikt. De variabele bot.UserName is echter eerst gedefinieerd in het onderwerp "Welkom".

Wanneer het gesprek op het punt komt in het onderwerp "Afspraakboeking" waar naar bot.UserName wordt verwezen, zal de agent naadloos overgaan naar het vraagknooppunt waar bot.UserName eerst is gedefinieerd.

Nadat de klant de vraag heeft beantwoord, hervat de agent het onderwerp "Afspraakboeking".

Gedrag van algemene variabele bij het implementeren van acties via Power Automate-stromen of vaardigheden

Soms gebruikt u een stroom of vaardigheid om een variabele te initialiseren of te vullen.

Wanneer een gebruiker echter met de agent communiceert, kan de variabele op een eerder punt in het gesprek worden ingevuld, of hebt u misschien de variabelen al extern ingesteld.

In deze situatie wordt de stroom of vaardigheid nog steeds uitgevoerd en wordt de variabele ingevuld, waarbij wordt overschreven wat eerder in de variabele was opgeslagen.

Als u ervoor wilt zorgen dat de agent een gesprek start met een bepaalde context, gebruikt u een globale variabele en stelt u de waarde ervan in vanuit een externe bron. Stel dat uw site vereist dat gebruikers zich aanmelden. Als u de naam van een gebruiker opslaat in een algemene variabele en deze doorgeeft aan uw agent, kan deze de klanten met hun naam aanspreken voordat ze hun eerste vraag beginnen te typen. Een ander voorbeeldscenario is het doorgeven van context van Dynamics 365 Customer Service aan een agent, zodat het gesprek kan beginnen met kennis van wat de klant wil bereiken.

Als u ongewenste latentie wilt voorkomen, geeft u op hoe lang uw agent kan wachten op een waarde. U kunt ook een standaardwaarde instellen die moet worden gebruikt wanneer de externe bron niet op tijd reageert.

1. Maak een toegewezen onderwerp om de configuratie vast te houden voor alle variabelen die vanuit externe bronnen moeten worden ingesteld. U zou dit onderwerp bijvoorbeeld 'Contextvariabelen instellen' kunnen noemen. Dit onderwerp dient geen andere doeleinden, dus er hoeven geen triggerzinnen te worden ingesteld.

2. Voeg een Variabelewaarde instellen-knooppunt toe aan uw speciale onderwerp.

3. Open onder Variabele instellen de variabelekiezer en selecteer Een nieuwe variabele maken.

4. Selecteer de standaardnaam van de nieuwe variabele. Het deelvenster Variabele-eigenschappen verschijnt.

5. Vervang de standaardnaam door een naam die exact overeenkomt met de naam van de variabele die wordt doorgegeven vanuit het externe systeem.

6. Selecteer onder GebruikAlgemeen (alle onderwerpen hebben toegang) en Externe bronnen kunnen waarden instellen.

7. Selecteer onder Referentie de drie puntjes (⋮) in de rechterbovenhoek en selecteer Waarde ophalen van dit knooppunt indien leeg.

8. (Optioneel) Stel een time-outvertraging in milliseconden in. Met deze waarde bepaalt u hoe lang uw agent kan wachten tot de variabele door een externe bron is ingesteld voordat er een time-out optreedt en de standaardwaarde die u in het knooppunt Variabelewaarde instellen hebt ingesteld, wordt gebruikt. Deze instelling is relevant in scenario's waarin de variabele afhankelijk is van een langdurig of asynchroon proces, maar uw agent moet een maximale latentie respecteren om een goede gebruikerservaring te garanderen.

   Voor variabelen die afkomstig zijn van Omnichannel for Customer Service, gebruikt u een waarde van 10 seconden (10.000 ms) als maximale wachttijd.

9. Voer in het knooppunt Variabelewaarde instellen de standaardwaarde in die moet worden gebruikt als de time-out is bereikt. Tijdens runtime verwacht uw agent waarden met hetzelfde gegevenstype. Als u wilt dat deze standaardwaarde een lege tekenreeks is, gebruikt u Text("") als formule.

   

10. Voor alle andere waarden waarvan u verwacht dat ze afkomstig zijn van een extern systeem, voegt u meer Variabelewaarde instellen-knooppunten toe aan uw speciale onderwerp en configureert u de vereiste globale variabelen op dezelfde manier.

Wanneer u uw agent op deze manier configureert, kunt u deze testen. Wanneer de agent wordt aangeroepen, hoeft u niet eindeloos te wachten tot alle variabelen zijn ingevuld. In plaats daarvan kunt u direct berichten verzenden, die niet afhankelijk zijn van de doorgegeven variabelen. Wanneer uw agent probeert toegang te krijgen tot een variabele die extern wordt ingesteld, wordt deze onderbroken totdat de waarde binnenkomt of de time-out optreedt. Meer informatie vindt u in Agents optimaliseren om de latentie te minimaliseren.

U kunt een algemene variabele instellen die moet worden geïnitialiseerd vanuit een externe bron. Met deze actie kan de agent het gesprek beginnen met een bepaalde context.

Een klant opent bijvoorbeeld een chatgesprek met een agent vanaf uw website en de site kent de naam van de klant al. U laat de agent de gebruikersnaam weten voordat u het gesprek start en de agent kan een intelligenter gesprek met de klant voeren zonder opnieuw naar de naam te hoeven vragen.

1. Selecteer de gewenste globale variabele.

2. Schakel in het paneel Variabele-eigenschappenExterne bronnen kunnen waarden instellen in.

Als u uw agent insluit in een eenvoudige webpagina kunt u variabelen en hun definities toevoegen aan de URL van de agent. Of, als u wat meer controle wilt, kunt u een codeblok <script> gebruiken om variabelen programmatisch aan te roepen en te gebruiken.

De variabelenaam in de queryreeks van de URL moet overeenkomen met de naam van de algemene variabele zonder het voorvoegsel Global.. Voor een globale variabele Global.UserName wordt bijvoorbeeld alleen UserName in de query gebruikt.

In de volgende voorbeelden wordt een basisdeclaratie voor de variabelen gebruikt. In een productiescenario kunt u een andere variabele doorgeven waarin de naam van de gebruiker al is opgeslagen (bijvoorbeeld als u de gebruikersnaam uit een aanmeldingsscript hebt) als queryparameter of variabeledefinitie.

Voeg de variabelen en hun definities toe aan de URL van de agent als parameters voor de querytekenreeks in de notatie botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Voorbeeld:

• U hebt een algemene variabele met de naam Global.UserName.
• De URL van uw agent is https://web.powerva.microsoft.com/webchat/bots/12345.
• Om de naam van de gebruiker door te geven bij het starten van een agentgesprek op uw website, voegt u de querytekenreeks UserName= toe als: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

De parameternaam is niet hoofdlettergevoelig: username=Ana werkt ook in dit voorbeeld.

U kunt variabelen en de bijbehorende definities toevoegen als u uw agent gewoon insluit op een eenvoudige webpagina. U kunt ook een <script> codeblok gebruiken om variabelen programmatisch aan te roepen en te gebruiken.

In de volgende voorbeelden wordt een basisdeclaratie voor de variabelen gebruikt. In een productiescenario kunt u een andere variabele doorgeven waarin de naam van de gebruiker al is opgeslagen (bijvoorbeeld als u de gebruikersnaam uit een aanmeldingsscript hebt) als queryparameter of variabeledefinitie.

1. Voeg de variabelen en hun definities toe aan de URL van de agent als parameters voor de queryreeks (in de notatie botURL?variableName1=variableDefinition1&variableName2=variableDefinition2), bijvoorbeeld:

   • U hebt een algemene variabele met de naam bot.UserEmail.
   • De URL van uw agent is https://web.powerva.microsoft.com/webchat/bots/12345.
   • Als u de gebruikersnaam wilt doorgeven bij het starten van een agentgesprek op een website, voegt u de UserEmail= querytekenreeks als volgt toe: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com

2. De parameternaam is niet hoofdlettergevoelig: useremail=Ana@contoso.com werkt ook in dit voorbeeld.

1. In de sectie <script> op de pagina waar u uw agent hebt, definieert u de variabelen als volgt en vervangt u variableName1 door de variabelenaam zonder de prefix Global. en variableDefinition1 door de definitie. Scheid meerdere variabelen met komma's (,).

      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. Roep in de sectie <script> de store aan wanneer u uw agent insluit, zoals in het volgende voorbeeld waar store wordt aangeroepen net voor waar styleOptions wordt aangeroepen (u moet de BOT_ID vervangen door de id van uw agent):

   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. In de sectie <script> op de pagina waar u uw agent hebt, definieert u de variabelen als volgt en vervangt u variableName1 door de variabelenaam zonder de prefix bot. en variableDefinition1 door de definitie. Scheid meerdere variabelen met komma's ,.

      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. Roep binnen de sectie <script> de store aan wanneer u uw agent insluit, zoals in het volgende voorbeeld waar store wordt aangeroepen net voor waar styleOptions wordt aangeroepen (u moet de BOT_ID vervangen door uw 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));