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 Variablename ruft das Präfix Global. ab, um es von Variablen auf Themenebene zu unterscheiden. Die Variable UserName wird z. B. .Global.UserName

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 Variablename ruft das Präfix bot. ab, um es von den Variablen auf Themenebene zu unterscheiden. Die Variable UserEmail wird z. B. .bot.UserEmail

Wenn Sie eine Nachricht in einem Nachrichtenknoten oder einem Frageknoten verfassen, wählen Sie das Symbol "{x} " aus, um die Variablen anzuzeigen, auf die das Thema zugreifen kann. Sie können auch globale Variablen in Toolknoten verwenden, die Aufforderungen oder Workflows aufrufen. Globale Variablen werden auf der Registerkarte "Benutzerdefiniert " zusammen mit beliebigen Themenvariablen angezeigt. Variablen werden in alphabetischer Reihenfolge aufgeführt.

Wenn Sie eine Nachricht in einem Nachrichtenknoten oder einem Frageknoten verfassen, wählen Sie das Symbol "{x} " aus, um die Variablen anzuzeigen, auf die das Thema zugreifen kann. 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 im Dokumenterstellungsbereich oder im Bereich "Variablen " 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 auf der Erstellungsarbeitsfläche aus. Der Bereich Variableneigenschaften wird angezeigt.

• Um direkt zum Knoten zu wechseln, auf dem Sie die globale Variable erstellt haben, wählen Sie "Gehe zur Quelle" aus.

• 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 wird ein globaler Variablenwert bis zum Ende der Sitzung beibehalten. Der Knoten "Variablenwerte löschen" setzt die Werte globaler Variablen zurück. Das Systemthema Konversation zurücksetzen verwendet diesen Knoten. Wenn eine Umleitung dieses Thema auslöst (oder wenn der Benutzer einen Ausdruck wie „Start over“ eingibt), werden alle globalen Variablen zurückgesetzt.

Sie können von jedem Thema aus auf globale Variablen zugreifen, und deren Wert wird während einer Sitzung beibehalten.

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.

Globales Variablenverhalten bei der Implementierung von Aktionen über Power Automate Flows oder Skills

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, verwenden Sie eine globale Variable, und legen Sie dessen Wert aus einer externen Quelle fest. Angenommen, Ihre Website erfordert, dass sich Benutzer anmelden müssen. 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 ist es, den Kontext von Dynamics 365 Customer Service an einen Agenten zu übergeben, damit er die Unterhaltung beginnen kann und weiß, was der Kunde erreichen will.

Um unerwünschte Wartezeiten zu verhindern, geben Sie an, 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 aus dem 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 Timeoutverzö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.

   Verwenden Sie für Variablen, die von Omnichannel für den Kundendienst stammen, 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.

Wenn Sie Ihren Agent auf diese Weise konfigurieren, kann er getestet werden. 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 unter Agenten optimieren, 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. Verwenden Sie z. B. für eine globale Variable Global.UserName nur UserName in der Abfrage.

In den folgenden Beispielen wird eine grundlegende Deklaration für die Variablen verwendet. In einem Produktionsszenario können Sie eine andere Variable übergeben, die bereits den Namen des Benutzers speichert (z. B. wenn Sie über den Benutzernamen aus einem Anmeldeskript verfügen) als Abfrageparameter oder Variablendefinition.

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.

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.

Bei dem Parameternamen wird die Groß-/Kleinschreibung nicht beachtet: username=Ana Funktioniert auch in diesem Beispiel.

Sie können Variablen und deren Definitionen hinzufügen, wenn Sie Ihren Agent einfach in eine einfache Webseite einbetten. Sie können auch einen <script> Codeblock verwenden, um Variablen programmgesteuert aufzurufen und zu verwenden.

In den folgenden Beispielen wird eine grundlegende Deklaration für die Variablen verwendet. In einem Produktionsszenario können Sie eine andere Variable übergeben, die bereits den Namen des Benutzers speichert (z. B. wenn Sie über den Benutzernamen aus einem Anmeldeskript verfügen) als Abfrageparameter oder Variablendefinition.

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 Start einer Unterhaltung mit einem Agenten auf einer Website zu übergeben, fügen Sie den UserEmail= Query-String wie folgt an: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. Bei dem Parameternamen wird die Groß-/Kleinschreibung nicht beachtet: useremail=Ana@contoso.com Funktioniert auch in diesem Beispiel.

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