Mit globalen Variablen arbeiten

1. Erstellen Sie eine Variable oder verwenden Sie das Bedienfeld Variablen, um eine vorhandene Variable zu öffnen.

2. Wählen Sie im Bereich Variableneigenschaftenglobal (jedes Thema kann zugreifen) aus.

   Der Variablenname erhält das Präfix Global., um es von den Variablen auf Themenebene zu unterscheiden. Zum Beispiel wird die Variable UserName jetzt als Global.UserName angezeigt.

3. Speichern Sie das Thema.

1. Wählen Sie die gewünschte Variable aus.

2. Im Bereich Variableneigenschaften unter Verwendung wählen Sie Bot (jedes Thema kann darauf zugreifen).

3. Der Variablenname erhält eine Präfixzeichenfolge bot., um es von den Variablen auf Themenebene zu unterscheiden. Zum Beispiel wird die Variable UserEmail jetzt als bot.UserEmail angezeigt.

Wenn Sie eine Nachricht in einem Nachrichten-Knoten oder Frage-Knoten verfassen, wählen sie das {x} Symbol, um die im Thema verfügbaren Variablen anzuzeigen. Globale Variablen werden auf der Registerkarte Benutzerdefiniert neben den Themenvariablen angezeigt. Variablen werden in alphabetischer Reihenfolge aufgeführt.

Wenn Sie eine Nachricht in einem Nachrichten-Knoten oder Frage-Knoten verfassen, wählen sie das {x} Symbol, um die im Thema verfügbaren Variablen anzuzeigen. Die Variablen werden in alphabetischer Reihenfolge aufgelistet, und alle globalen Variablen erscheinen zusammen, da sie alle mit bot. beginnen.

Wenn Sie einen Bedingungsknoten, einen Knoten Flowaktion oder einen Fertigkeitsknoten verwenden, werden dort auch verfügbare globale Variablen angezeigt.

1. Wählen Sie die gewünschte globale Variable auf der Bearbeitungsfläche oder im Bereich Variable aus.

2. Wählen Sie im Bereich Variableneigenschaften im Abschnitt Referenz die Option Alle Verweise anzeigen aus.

3. Wechseln Sie zur Registerkarte Andere und wählen Sie ein beliebiges Thema aus, in dem die Variable verwendet wird, um direkt zu diesem Thema und Knotenpunkt zu wechseln.

Wählen Sie die gewünschte Variable im Erstellungsbereich aus. Der Bereich Variableneigenschaften wird angezeigt.

• Um direkt zum Knoten zu gehen, in dem die globale Variable erstellt wurde, wählen Sie Zur Quelle gehen.

• Um zu einem Thema zu wechseln, in dem diese Variable verwendet wird, wählen Sie das das gewünschte Thema im Abschnitt Verwendet von aus.

Standardmäßig bleibt der Wert einer globalen Variablen bestehen, bis die Sitzung endet. Der Knoten Variablenwerte löschen setzt die Werte globaler Variablen zurück und wird im Systemthema Unterhaltung zurücksetzen verwendet. Wenn eine Umleitung dieses Thema auslöst (oder wenn der Benutzer einen Ausdruck wie „Start over“ eingibt), werden alle globalen Variablen zurückgesetzt.

Auf globale Variablen kann von jedem Thema aus zugegriffen werden, und der zugewiesene Wert bleibt während einer Sitzung erhalten.

Der Wert wird nur gelöscht, wenn der Benutzende des Agenten zum Systemthema Neu starten weitergeleitet wird oder er dieses Thema direkt auslöst (z. B. durch Eingabe von Neu starten). In diesem Fall werden alle globalen Variablen zurückgesetzt und haben keinen Wert.

Initialisierung der globalen Variablen

Wenn eine globale Variable ausgelöst wird, bevor sie initialisiert (oder „ausgefüllt“) wurde, löst der Agent automatisch den Teil des Themas aus, in dem die globale Variable zuerst definiert wird, auch wenn sie sich in einem anderen Thema befindet, bevor sie zum Originalthema zurückkehrt. Mit diesem Verhalten kann der Agent alle Variablen ausfüllen, ohne die Unterhaltung zu unterbrechen.

Beispielsweise startet der Kunde die Unterhaltung über das Terminbuchungsthema, in dem eine globale Variable bot.UserName genutzt wird. Die Variable bot.UserName wird zuerst im Willkommen-Thema definiert.

Wenn die Unterhaltung zu dem Punkt im Terminbuchungsthema kommt, in dem auf bot.UserName verwiesen wird, schwenkt der Agent nahtlos zu dem Fragenknoten, an dem bot.UserName zuerst definiert wird.

Nachdem der Kunde die Frage beantwortet hat, kehrt der Agent zum Terminbuchungsthema zurück.

Verhalten von globalenVariablen bei der Implementierung von Aktionen über Power Automate Flows oder Fertigkeiten

Manchmal können Sie einen Flow oder eine Fertigkeit verwenden, um eine Variable zu initialisieren oder auszufüllen.

Wenn ein Benutzer jedoch mit dem Agent interagiert, wird die Variable möglicherweise zu einem früheren Zeitpunkt in der Unterhaltung ausgefüllt, oder Sie haben möglicherweise die Variablen bereits extern festgelegt.

In dieser Situation wird der Flow oder die Fertigkeit weiterhin ausgeführt und die Variable ausgefüllt, wobei alles überschrieben wird, was zuvor in der Variablen gespeichert worden ist.

Um sicherzustellen, dass der Agent eine Unterhaltung mit einem bestimmten Kontext startet, können Sie eine globale Variable verwenden und dessen Wert aus einer externen Quelle festlegen. Angenommen, auf Ihrer Website müssen sich die Benutzer anmelden. Wenn Sie den Namen eines Benutzers in einer globalen Variablen speichern und an Ihren Agent übergeben, kann der Agent Kunden nach Namen begrüßen, bevor er mit der Eingabe der ersten Frage beginnt. Ein weiteres Beispielszenario besteht darin, den Kontext von Dynamics 365 Customer Service an einen Agent zu übergeben, damit es mit dem Wissen über das, was der Kunde erreichen möchte, beginnen kann.

Um unerwünschte Wartezeiten zu verhindern, können Sie angeben, wie lange Ihr Agent auf einen Wert warten kann. Sie können auch einen Standardwert festlegen, der verwendet werden soll, wenn die externe Quelle nicht rechtzeitig reagiert.

1. Erstellen Sie ein dediziertes Thema für die Konfiguration für alle Variablen, die aus externen Quellen festgelegt werden sollen. Sie können dieses Thema beispielsweise „Kontextvariablen festlegen“ nennen. Dieses Thema dient keinen anderen Zwecken, daher müssen keine Triggerausdrücke festgelegt werden.

2. Fügen Sie Ihrem dedizierten Thema einen -Variablenwert festlegen Knoten hinzu.

3. Wählen Sie optional unter Variable festlegen die Option Neue Variable erstellen aus, um eine Variable zu erstellen.

4. Wählen Sie den Standardnamen der neuen Variablen aus. Der Bereich Variableneigenschaften wird angezeigt.

5. Ersetzen Sie den Standardnamen durch einen Namen, der exakt dem Namen der Variablen entspricht, die vom externen System übergeben wird.

6. Unter Nutzung wählen Sie Global (ein beliebiges Thema kann zugreifen) und externe Quellen können Wert festlegen aus.

7. Wählen Sie unter "Verweis" die drei Punkte (⋮) in der oberen rechten Ecke aus, und wählen Sie "Wert aus diesem Knoten abrufen" aus, wenn er leer ist.

8. (Optional) Legen Sie eine Timeout-Verzögerung in Millisekunden fest. Dieser Wert legt fest, wie lange Ihr Agent warten kann, bis die Variable von einer externen Quelle festgelegt wurde, bevor eine Zeitüberschreitung eintritt und mit dem Standardwert fortgefahren wird, den Sie im Knoten Variablenwert festlegen festgelegt haben. Diese Einstellung ist in Szenarien relevant, in denen die Variable von einem langen oder asynchronen Prozess abhängt, aber Ihr Agent muss eine maximale Latenz berücksichtigen, um eine gute Benutzererfahrung sicherzustellen.

   Für Variablen, die von Omnichannel for Customer Service stammen, empfehlen wir einen Wert von 10 Sekunden (10.000 ms) als maximale Wartezeit.

9. Geben Sie im Knoten Variablenwert festlegen den Standardwert ein, der verwendet werden soll, wenn das Timeout erreicht ist. Zur Laufzeit erwartet Ihr Agent Werte mit demselben Datentyp. Wenn dieser Standardwert eine leere Zeichenfolge sein soll, verwenden Sie Text("") als Formel.

   

10. Fügen Sie für alle anderen Werte, die Sie aus einem externen System erwarten, weitere Knoten Variablenwert festlegen zu Ihrem dedizierten Thema hinzu, und konfigurieren Sie die erforderlichen globalen Variablen auf dieselbe Weise.

Daher ist Ihr Agent zum Testen bereit. Wenn der Agent aufgerufen wird, kann Ihr Agent sofort mit dem Senden von Nachrichten beginnen, die nicht von den übergebenen Variablen abhängig sind, anstatt auf unbestimmte Zeit zu warten, bis alle Variablen ausgefüllt werden. Wenn Ihr Agent versucht, auf eine Variable zuzugreifen, die extern festgelegt wird, wird sie angehalten, bis der Wert eingeht oder das Timeout auftritt. Erfahren Sie mehr über die Optimierung von Agenten, um die Latenz zu minimieren.

Sie können eine globale Variable festlegen, die mit einer externen Quelle initialisiert werden soll. Mit dieser Aktion kann der Agent die Unterhaltung mit einem gewissen Kontext beginnen.

Ein Kunde ruft beispielsweise einen Agent-Chat von Ihrer Website auf, und die Website kennt bereits den Namen des Kunden. Sie teilen dem Agenten vor Beginn der Unterhaltung den Namen des Benutzenden mit, und der Agent kann eine intelligentere Unterhaltung mit dem Kunden führen, ohne erneut nach seinem Namen fragen zu müssen.

1. Wählen Sie die gewünschte globale Variable aus.

2. Aktivieren Sie im Bereich Variableneigenschaften im Externe Quellen können Werte festlegen.

Wenn Sie Ihren Agenten in eine einfache Webseite einbetten, können Sie Variablen und ihre Definitionen an die URL des Agenten anhängen. Oder, wenn Sie etwas mehr Kontrolle wünschen, können Sie einen <script>-Codeblock zum programmatischen Aufrufen und Verwenden von Variablen verwenden.

Der Variablenname in der Abfragezeichenfolge der URL muss mit dem Namen der globalen Variablen übereinstimmen, ohne das Global.-Präfix. Eine globale Variable Global.UserName würde in der Abfrage beispielsweise als UserName bezeichnet.

In den folgenden Beispielen wird eine einfache Deklaration für die Variablen verwendet. In einem Produktionsszenario könnten Sie als Abfrageparameter oder Variablendefinition eine andere Variable übergeben, die bereits den Namen des Benutzers speichert (zum Beispiel, wenn Sie den Benutzernamen aus einem Anmeldeskript haben).

Hängen Sie die Variablen und ihre Definitionen an die URL des Agenten als Parameter für Abfragezeichenfolgen im Format botURL?variableName1=variableDefinition1&variableName2=variableDefinition2 an.

Zum Beispiel:

• Sie haben eine globale Variable namens Global.UserName.
• Die URL des Agenten lautet https://web.powerva.microsoft.com/webchat/bots/12345.
• Hängen Sie die Abfragezeichenfolge UserName= als https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana an, um den Benutzernamen beim Starten einer Agentenunterhaltung auf einer Website weiterzugeben.

Beim Parameternamen wird die Groß-/Kleinschreibung nicht berücksichtigt. username=Ana würde auch in diesem Beispiel funktionieren.

Sie können die Variablen und ihre Definitionen anhängen, indem Sie einfach Ihren Agent in eine einfache Webseite einbetten, oder Sie können einen <script>-Codeblock zum programmgesteuerten Aufrufen und Verwenden von Variablen verwenden.

In den hier beschriebenen Beispielen wird eine einfache Deklaration für die Variablen abgegeben. In einem Produktionsszenario könnten Sie als Abfrageparameter oder Variablendefinition eine andere Variable übergeben, die bereits den Namen des Benutzers speichert (zum Beispiel, wenn Sie den Benutzernamen aus einem Anmeldeskript haben).

1. Hängen Sie die Variablen und ihre Definitionen an die URL des Agenten als Parameter für Abfragezeichenfolgen an (im Format von botURL?variableName1=variableDefinition1&variableName2=variableDefinition2), zum Beispiel:

   • Sie haben eine globale Variable namens bot.UserEmail.
   • Die URL des Agenten lautet https://web.powerva.microsoft.com/webchat/bots/12345.
   • Um den Benutzernamen beim Starten einer Agentenunterhaltung auf einer Website weiterzugeben, können Sie die UserEmail=-Abfragezeichenfolge als https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com anhängen.

2. Beim Parameternamen wird die Groß-/Kleinschreibung nicht berücksichtigt. Das bedeutet, dass useremail=Ana@contoso.com auch in diesem Beispiel funktionieren würde.

1. In dem <script>-Abschnitt auf der Seite, auf der Sie Ihren Agenten haben, definieren Sie die Variablen wie folgt und ersetzen Sie variableName1 für den Variablennamen ohne Global.-Präfix und variableDefinition1 für die Definition. Trennen Sie mehrere Variablen durch Kommas (,).

      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. Rufen Sie in Ihrem <script>-Abschnitt store auf, wenn Sie Ihren Agent einbetten, wie im folgenden Beispiel, wo store genau oberhalb aufgerufen wird, wo styleOptions aufgerufen wird (Sie müssen die BOT_ID mit Ihrer Agent-ID ersetzen):

   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 dem <script>-Abschnitt auf der Seite, auf der Sie Ihren Agenten haben, definieren Sie die Variablen wie folgt und ersetzen Sie variableName1 für den Variablennamen ohne bot.-Präfix und variableDefinition1 für die Definition. Trennen Sie mehrere Variablen durch Kommas ,.

      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. Rufen Sie in Ihrem <script>-Abschnitt store auf, wenn Sie Ihren Agent einbetten, wie im folgenden Beispiel, wo store genau oberhalb aufgerufen wird, wo styleOptions aufgerufen wird (Sie müssen die BOT_ID mit Ihrer Agent-ID ersetzen):

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