Mit Variablen arbeiten

Variablen können auf vier Ebenen bzw. in vier Bereichen existieren:

• Thema Variablen können nur in den Themen verwendet werden, in denen sie erstellt wurden. Dieser Bereich ist der Standardbereich für Variablen, die Sie erstellen.
• Globale Variablen können in allen Themen verwendet werden. Sie können den Bereich einer Thema-Variable ändern, um sie zu einer globalen Variablen zu machen.
• Systemvariablen werden automatisch mit Ihrem Copiloten erstellt. Sie bieten mehr kontextbezogene Informationen über die Unterhaltung oder den Benutzer. Sie sind in allen Themen verfügbar.
• Umgebung-Variablen werden in Power Platform erstellt und sind in Copilot Studio schreibgeschützt. Sie speichern die Parameterschlüssel und -werte, die dann als Eingabe für verschiedene andere Anwendungsobjekte dienen darunter für Copilot Studio. Durch Trennen der Parameter von den verwendenden Objekten können Sie die Werte in derselben Umgebung oder bei der Migration von Lösungen in andere Umgebungen ändern. Die Alternative besteht darin, fest codierte Parameterwerte in den Komponenten zu belassen, die sie verwenden.

Variablentypen

Eine Variable ist einem Basistyp zugeordnet. Der Typ bestimmt, welche Werte die Variable enthalten kann und welche Operatoren Sie verwenden können, wenn Sie einen logischen Ausdruck mit ihr erstellen.

Der Typ einer Variablen wird ihr beim ersten Zuweisen eines Werts festgelegt. Danach wird der Typ für diese Variable festgelegt und ihr können keine Werte eines anderen Typs zugewiesen werden. So wird beispielsweise einer Variablen mit dem Anfangswert 1 der Typ Zahl zugewiesen. Der Versuch, es einem String Wert von "apples" zuzuweisen, führt zu einem Fehler.

Wenn Sie einen Copiloten testen, kann eine Variable vorübergehend als Typ unbekannt angezeigt werden. Einer Unbekannt Variable wurde noch kein Wert zugewiesen.

Die Reihenfolge der Variablen wird von oben nach unten im Erstellungsbereich festgelegt. Knoten oben auf der Erstellungsfläche werden vor Knoten unten berücksichtigt.

Wenn Sie Verzweigungen mit Bedingungsknoten erstellen, werden die Verzweigungen von links nach rechts geordnet. Knoten im äußersten linken Zweig werden vor Knoten im äußersten rechten Zweig berücksichtigt.

Entitäten

Copilot Studio verwendet Entitäten, um eine bestimmte Art von Informationen aus den Antworten eines Benutzers zu identifizieren. Die identifizierten Informationen werden in einer Variablen des Typs gespeichert, der den Informationen entspricht. In der folgenden Tabelle sind die variablen Basistypen aufgeführt, die mit vorgefertigten Entitäten verknüpft sind.

Eine Variable erstellen

Jeder Knoten, der Sie auffordert, eine Variable als Ausgabe auszuwählen, z. B. ein Frage-Knoten, erstellt automatisch eine Ausgabevariable des entsprechenden Typs.

Die zu verwendenden Entität auswählen

Frage Knoten werden standardmäßig mit Multiple-Choice-Optionen erstellt. Wählen Sie für die Verwendung einer anderen vorgefertigten oder benutzerdefinierten Entität das Identifizieren-Feld aus, und wählen Sie den Informationstyp aus, auf den der Copilot achten soll.

Eine Variable umbenennen

Variablen wird beim Erstellen automatisch ein Name zugewiesen. Eine bewährte Methode ist, den Variablen aussagekräftige Namen zu geben, damit denjenigen, die Ihren Copiloten verwalten müssen, der Zweck der Variablen klar ist.

1. Wählen Sie die Variable aus, um sie im Bereich für Variableneigenschaften zu öffnen.

2. Geben Sie unter Variablenname einen neuen Namen für Ihre Variable ein.

Variable setzen

Normalerweise verwenden Sie einen Frage -Knoten, um Benutzereingaben in einer Variablen zu speichern. Es kann jedoch Situationen geben, in denen Sie den Wert selbst festlegen möchten. Verwenden Sie in diesen Fällen den Knoten Variablenwert festlegen.

1. Wählen Sie Knoten hinzufügen (+), um einen Knoten hinzuzufügen, und wählen Sie dann Variablenverwaltung>Variablenwert festlegen.

2. Wählen Sie das Feld unter Variable festlegen und dann Eine neue Variable erstellen aus.

   

   Es wird eine neue Variable erstellt. Sie ist vom Typ unbekannt, bis Sie ihr einen Wert zuweisen.

   

3. Für Bis Wert weisen Sie einen Wert zu, indem Sie eine der folgenden Optionen verwenden:

   • Geben Sie einen Literalwert ein.
   • Wählen Sie eine vorhandene Variable desselben Typs aus. Mit dieser Aktion wird Ihre Variable auf denselben Wert festgelegt wie die von Ihnen gewählte Variable.
   • Verwenden Sie Power Fx-Formel. Power Fx-Formeln sind nützlich für komplexere Typen, bei denen keine Literalwerte verwendet werden können, z. B. Tabellen- und Datensatztypen.

Literal-Werte verwenden

Anstatt einen Variablenwert auszuwählen, können Sie in einen Literalwert in eine beliebige Variable eingeben.

Der Knoten versucht, Literalwerte als Zeichenfolge, Zahl oder Booleschen Wert zu interpretieren. 123 wird beispielsweise als Zahl interpretiert. Wenn dieser Wert stattdessen als Zeichenfolgenwert interpretiert werden soll, können Sie ihn in doppelte Anführungszeichen setzen: "123".

Verwenden Sie für einige Szenarien oder wenn Sie komplexere Typen verwenden, eine Power Fx-Formel, um einen bestimmten Typ festzulegen.

Variablenbereich

Im Bereich Variablen können Sie alle Variablen anzeigen, die im Thema verfügbar sind, unabhängig davon, in welchen Knoten sie definiert oder verwendet werden. Für jede Variable können Sie auswählen, ob sie ihren Wert von anderen Themen erhalten und/oder ihren Wert an andere Themen zurückgeben können soll. Sie können auch eine Variable auswählen, um deren Eigenschaften im Bereich Variableneigenschaften zu bearbeiten.

Wählen Sie in der Menüleiste des Themas die Option Variablen aus, um den Bereich Variablen zu öffnen.

Bereich Variableneigenschaften

Im Bereich Variableneigenschaften können Sie eine Variable umbenennen, sehen, wo eine Variable verwendet wird, oder eine Variable in eine globale Variable umwandeln. Sie können sie jedoch nicht von einer globalen Variable zurück in eine Themenvariable konvertieren. Sie können auch auswählen, ob sie Werte von anderen Themen empfangen oder an andere Themen weitergeben kann.

Um den Bereich Variableneigenschaften zu öffnen, wählen Sie eine Variable im Variablenbereich. Sie können den Variableneigenschaften auch öffnen, indem Sie eine Variable in einem beliebigen Knoten auswählen.

Umgebungsvariablen

Umgebung-Variablen sind ein Power Platform Konzept. Umgebungsvariablen ermöglichen das grundlegende Szenario der Lebenszyklusverwaltung von Anwendungen (Application Lifecycle Management, ALM) zum Verschieben einer Anwendung zwischen Power Platform-Umgebungen. In diesem Szenario bleibt die Anwendung bis auf einige wichtige externe Referenzen, die sich zwischen der Quellumgebung und der Zielumgebung unterscheiden, absolut unverändert.

Verwenden Sie Umgebungsvariablen auf die gleiche Weise wie Themen-, globale und Systemvariablen. Ein bemerkenswerter Unterschied besteht darin, dass Sie Umgebungvariablen nur im schreibgeschützten Modus verwenden können. Copilot-Autoren können die Umgebungsvariable in Copilot Studio nicht ändern. Administrierende können jedoch den Wert der Umgebungsvariablen im PowerApps-Portal ändern.

Umgebungsvariablentypen in Copilot Studio werden den folgenden PowerApps-Datentypen zugeordnet:

Sie können keine Umgebungsvariablen in Copilot Studio erstellen und bearbeiten. Sie müssen das PowerApps-Portal zum Ändern oder Festlegen von Umgebungsvariablen verwenden. Sie können aus Copilot Studio den Bereich Variablen verwenden, um Informationen zu einer Umgebungsvariablen anzuzeigen. Der Bereich Variablen verfügt auch über ein Verknüpfung zur nativen Dokumenterstellungserfahrung.

Umgebungsvariablen für Azure Key Vault-Geheimnisse verwenden

Eine Umgebungsvariable kann auf ein Geheimnis im Key Vault verweisen. Dies ist ein Sonderfall von Umgebungsvariablen mit einzigartigen Überlegungen.

Um eine geheime Umgebungsvariable im PowerApps-Portal zu erstellen, müssen Sie den Key Vault konfigurieren.

Neben der oben genannten Konfiguration müssen Sie die folgenden Aktionen ausführen, um Copilot Studio zu erlauben, diesen Key Vault zu lesen:

1. Weisen Sie der Microsoft Virtual Agents Service-Anwendung die Key Vault Secrets User-Rolle zu.

2. Um allen Copiloten von der Umgebung aus den Zugriff auf das Geheimnis zu erlauben, erstellen Sie ein AllowedEnvironments-Tag auf das Geheimnis und fügen Sie die zulässigen Umgebung-IDs durch Kommas getrennt hinzu.

3. Um nur bestimmten Copiloten aus der Umgebung die Nutzung dieses Key Vaults zu erlauben, erstellen Sie ein AllowedCopilots-Tag und geben Sie die Copilot-Kennung im Format {envId}/{schemaName} ein. Trennen Sie die Werte bei mehreren Werte durch Kommas.

Wenn Sie die maximale Anzahl an Zeichen erreicht haben, aber dennoch weitere Copiloten hinzufügen müssen, fügen Sie ein weiteres Tag mit einem beschreibenden, aber eindeutigen Namen hinzu (zum Beispiel: AllowedCopilots2).

Der geheime Wert wird zur Dialoglaufzeit fünf Minuten lang zwischengespeichert. Nicht erfolgreiche Lesevorgänge werden 30 Sekunden lang zwischengespeichert.

Systemvariablen

Jeder Copilot verfügt über integrierte Systemvariablen, die zusätzliche Informationen zu einer Unterhaltung liefern.

Nicht alle Systemvariablen werden in der Liste angezeigt. Auf diese versteckten Systemvariablen müssen Sie mit einer Power Fx Formel zugreifen.

Zum Verwenden von Systemvariablen in einer Power Fx-Formel müssen Sie System. vor dem Variablennamen hinzufügen. Um beispielsweise die Systemvariable User.DisplayName in eine Formel einzubinden, verweisen Sie als System.User.DisplayName darauf.

Variablen für integrierte Authentifizierung (Standard)

Die folgenden Variablen sind verfügbar, wenn Sie Ihren Copiloten zur Authentifizierung bei Microsoft konfiguriert haben. Dabei wird die Entra-ID-Authentifizierung verwendet und nur Teams- und PowerApps-Kanäle sind zulässig. Dies ist die Standardeinstellung für neue Copiloten.

Weitere Informationen finden Sie unter Authentifizierungsvariablen.

Variablen für die manuelle Authentifizierung mit Generic OAuth 2

Die folgenden Variablen sind verfügbar, wenn Sie Ihren Copiloten für die Verwendung des Dienstanbieters Generic OAuth 2 konfiguriert haben.

Variablen für die manuelle Authentifizierung mit Microsoft Entra ID

Die folgenden Variablen sind verfügbar, wenn Sie Ihren Copiloten zur Verwendung der Microsoft Entra ID-Dienstanbieter (früher Azure Active Directory) konfiguriert haben.

Variablen für sprachgesteuerte Copiloten

Die folgenden Variablen sind nur bei Copiloten mit Sprachsteuerung verfügbar.

Variablen zwischen Themen übergeben

Wenn Sie ein Thema an ein anderes umleiten, können Sie die Variablenwerte vom ursprünglichen Thema an das Zielthema übergeben. Das Übergeben von Variablen zwischen Themen ist besonders hilfreich, wenn ein vorheriges Thema bereits Informationen gesammelt hat, die ein späteres Thema benötigt. Ihre Nutzer werden es zu schätzen wissen, dass sie die gleichen Fragen nicht noch einmal beantworten müssen.

Werte aus anderen Themen empfangen

Wenn ein Thema eine Variable definiert (z. B. in einem Frageknoten), bittet der Copilot den Benutzer, den Wert der Variablen einzugeben. Wenn der Copilot den Wert bereits in einem früheren Thema erfasst hat, gibt es keinen Grund, die Frage noch einmal zu stellen. Für diese Fälle können Sie die Variable auf Werte aus anderen Themen empfangen festlegen. Wenn ein anderes Thema an dieses Thema umgeleitet wird, kann es den Wert einer Variablen (oder eines Literalwerts) an diese Variable übergeben und die Frage überspringen. Die Erfahrung für den Benutzer, der mit dem Copilot kommuniziert, ist nahtlos.

In diesem Beispiel verwenden wir zwei Themen „Begrüßung“ und „Mit dem Kunden sprechen“. Beide Themen fragen nach dem Namen des Kunden. Wenn das Thame „Begrüßung“ jedoch zuerst ausgeführt wird, überspringt das Thema „Mit dem Kunden sprechen“ diese Frage. Stattdessen verwendet es den Wert der Variablen, die vom Thema „Begrüßung“ übergeben wird.

Der Flow des Themas „Mit dem Kunden sprechen“ lautet wie folgt:

Wie im Bereich „Copilot testen“ gezeigt, wird der Benutzer bei erstmaliger Auslösung dieses Themas gefragt: „Wie soll ich Sie nennen?“ Der Wert wird in einer Zeichenfolgenvariable namens userName gespeichert. Die userName-Variable ist auch so festgelegt, dass sie ihren Wert von anderen Themen erhält. Das Thema endet mit der Nachricht: „Ich hoffe, Sie haben einen schönen Tag, {userName}!“.

Der Flow des Themas „Begrüßung“ lautet wie folgt:

Wie im Bereich „Copilot testen“ gezeigt, wird der Benutzer bei erstmaliger Auslösung dieses Themas gefragt: „Wie heißen Sie?“ Der Wert wird in einer Zeichenfolgenvariable namens UserName gespeichert. Der Thema sendet die Nachricht: „Pleased to meet you, {UserName}!“. Anschließend erfolgt die Weiterleitung an das Thema „Mit dem Kunden sprechen“, das die Nachricht „Ich hoffe, Sie haben einen wunderschönen Tag, {userName}!“ sendet. Beachten Sie jedoch, dass das Thema „Mit dem Kunden sprechen“ übersprungen und der erneut nach dem Namen des Benutzers wird. Stattdessen wurde der Wert der UserName-Variablen verwendet, die vom Thema „Begrüßung“ übergeben wurde.

Zum Schluss finden Sie hier noch einmal die zweite Unterhaltung, diesmal aus der Perspektive des Themas „Mit dem Kunden sprechen“:

Lassen Sie uns die Schritte zum Einrichten eines Themas zum Empfangen von Werten aus anderen Themen durchgehen. Wir verwenden unser aktuelles Beispiel, aber dieselben Schritte funktionieren immer dann, wenn ein Thema einen Wert von einem früheren Thema abrufen muss.

Zielthema einrichten

Das Zielthema ist das Thema, an das weitergeleitet wird, also das Thema, das die Werte aus anderen Themen erhält. In unserem Beispiel ist es „Mit dem Kunden sprechen“.

1. Erstellen Sie Ihr Zielthema, oder wechseln Sie zu diesem.

2. Fügen Sie einen Frageknoten hinzu, und geben Sie What should I call you? als Nachricht ein.

3. Wählen Sie unter Identifizieren die vordefinierte Entität Personenname.

4. Wählen Sie die Variable aus, um den Bereich Variableneigenschaften zu öffnen. Benennen Sie sie userName, und wählen Sie dann Werte aus anderen Themen empfangen aus.

   

5. Fügen Sie einen Nachrichtenknoten hinzu.

6. Geben Sie im Nachrichtenfeld I hope you're having a wonderful day, ein.

7. Wählen Sie das Symbol Variable einfügen ({x}) und dann userName aus.

8. Wählen Sie das Leerzeichen nach der Variablen aus, und geben Sie ! ein.

9. Speichern Sie das Thema.

Datenquelle einrichten

Das Quellthema ist das Thema, das die Weiterleitung durchführt, also den Wert bereitstellt, der an das Zielthema übergeben wird. In unserem Beispiel lautet es „Begrüßung“.

1. Wechseln Sie zum Quellthema.

2. Fügen Sie einen Umleitungsknoten und Auswählen das Ziel Thema hinzu.

3. Wählen Sie + Eingabe hinzufügen und dann die Variable aus dem Zielthema aus, an das Sie einen Wert übergeben möchten.

   

4. Wählen Sie das Symbol > und dann die Variable aus, deren Wert Sie übergeben möchten.

   

   Der Umleitungsknoten sieht möglicherweise wie folgt aus:

   

5. Speichern Sie das Thema.

Werte an ursprüngliche Themen zurückgeben

Wenn eine Umleitung an ein Thema erfolgt und es eine Variable durch eine Frage oder auf andere Weise erhält, kann die Variable an das ursprüngliche Thema zurückgegeben werden. Die Variable wird Teil des ursprünglichen Themas und kann wie jede andere Variable verwendet werden. Informationen, die der Copilot erhält, sind also themenübergreifend verfügbar, wodurch der Bedarf an globalen Variablen reduziert wird.

Lassen Sie uns mit dem Beispiel aus dem vorherigen Abschnitt fortfahren. Wir stellen eine neue Frage im Thema „Mit dem Kunden sprechen“ und geben die Antwort an das Thema „Begrüßung“ zurück.

Das Quellthema für eine zurückgegebene Variable einrichten

Wenn Sie eine Variable an ein Thema zurückgeben, ist das Quellthema das Thema, an das die Umleitung erfolgt, als das Thema, das den Wert bereitstellt, der an das ursprüngliche Thema übergeben wird. In diesem Beispiel lautet es „Mit dem Kunden sprechen“.

1. Wechseln Sie zum Quellthema.

2. Fügen Sie einen Frageknoten hinzu, und geben Sie What city do you live in? als Nachricht ein.

3. Wählen Sie unter Identifizieren die vordefinierte Entität Stadt.

4. Wählen Sie die Variable aus, um den Bereich Variableneigenschaften zu öffnen. Geben Sie ihr den Namen userCity, und wählen Sie dann Werte an ursprüngliche Themen zurückgeben aus.

   

5. Speichern Sie das Thema.

Das Zielthema für eine zurückgegebene Variable einrichten

Wenn Sie eine Variable an ein Thema zurückgeben, ist das Zielthema das Thema, das die Umleitung vornimmt, also das Thema, das Werte aus anderen Themen erhält. In unserem Beispiel lautet es „Begrüßung“.

1. Wechseln Sie zum Zielthema.

2. Die Variable, die Sie im Quellthema ausgewählt haben, sollte im Umleitungsknoten als Ausgabevariable angezeigt werden.

   

3. Speichern Sie das Thema.

Entität und Variablentyp

Copilot Studio verwendet Entitäten, um eine bestimmte Art von Informationen aus den Antworten eines Benutzers zu identifizieren. Beim Speichern wird den identifizierten Informationen ein Variablentyp zugeordnet. Der Variablentyp ist analog zur Entität.

Jeder Entitäts- oder Variablentyp wird einem Basistyp zugeordnet, wie in der folgenden Tabelle aufgeführt. Der Basistyp bestimmt die Operatoren, die Sie verwenden können, wenn Sie einen logischen Ausdruck mit der entsprechenden Variablen erstellen. Es bestimmt auch, ob Sie eine Variable in einen Flow oder einen Bot Framework Skill als Eingabeparameter einspeisen können.

Zum Beispiel wird ein boolescher Basistyp einem „gleich“-Operator zugeordnet, wobei die möglichen Werte „Wahr“ oder „Falsch“ sein können. Ein Anzahl-Basistyp gibt Ihnen numerische Operatoren wie „gleich“, „größer als“ oder „größer als oder gleich“ und so weiter.

Eine Variable erstellen

Fügen Sie im Bot-Erstellungsbereich einen Frageknoten hinzu. Im Knoten wird automatisch eine Variable angelegt.

1. Gehen Sie zur Themenseite Ihres Bot und öffnen Sie das Thema, dem Sie eine Variable hinzufügen möchten.

2. Wählen Sie Knoten hinzufügen (+) und anschließend Eine Frage stellen aus.

   

   Es wird automatisch eine Variable erstellt, die die Antwort des Benutzers enthält.

   

Die zu verwendenden Entität auswählen

Standardmäßig wird ein Frageknoten mit Multiple-Choice-Optionen erstellt. Um eine andere vordefinierte oder benutzerdefinierte Entität zu verwenden, wählen Sie aus, was anhand des Knotens identifiziert werden soll.

Eine Variable umbenennen

Automatisch erstellte Variablen haben einen Standardnamen. Um eine Variable umzubenennen, wählen Sie den Variablennamen aus, geben Sie einen neuen Namen ein und wählen Sie Fertig aus.

Variablen in Aktionsknoten verwenden

Wenn Sie eine Variable in einem Aktionsknoten verwenden und der Basistyp mit einem Parametertyp übereinstimmt, der für einen Flow oder einen Bot Framework Skill angegeben ist, können Sie sie an diesen Parameter weitergeben. Die Ausgabe von Aktionsknoten generiert neue Variablen.

Literalwerte in Aktionsknoten verwenden

Sie können einen Literalwert in das Variableneingabefeld in einem Aktionsknoten eingeben, anstatt eine Variable aus dem Menü auszuwählen.

Knoten „Wert analysieren“

Mit dem Knoten „Wert analysieren“ können Sie einen Wert eines Typs in den Wert eines anderen Typs konvertieren. Wenn Sie einen Knoten zu einem Thema hinzufügen, wählen Sie „Knoten hinzufügen (+)“, dann „Variablenverwaltung“ und „Wert analysieren“.

Wichtige Szenarien, in denen der Knoten „Wert analysieren“ verwendet wird, konzentrieren sich auf die Konvertierung von rohem JSON oder untypisierten Variablen (deren Wert oder Struktur erst zur Laufzeit bekannt ist, z. B. ChannelData) in konkrete Typen.

Der Prozess startet, wenn ein Flow aufgerufen wird, der wiederum eine API aufruft. Die App gibt dann ein Ergebnis zurück. In der Regel müssen Sie diese Antwort analysieren und eine oder mehrere primitive Variablen auf Copilot Studio zurücksetzen. Mit dem Knoten „Wert analysieren“ können Sie das gesamte API-Ergebnis als Zeichenfolge senden:

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

Die Zeichenfolge-Variable, die Sie jetzt haben, kann unter Verwendung dieses neuen Knotens in eine Aufnahme-Variable mit vollständiger Intellisense-Unterstützung in Power Fx umgewandelt werden. Ein Beispiel mit Beispieldaten soll diesen Prozess veranschaulichen.

Beispiel für die Verwendung des Knotens „Wert analysieren“

1. Fügen Sie einen Knoten „Wert analysieren“ hinzu, und wählen Sie die Variable aus, die Sie analysieren möchten.

   

2. Wählen Sie den Datentyp aus. Wählen Sie in diesem Fall „Aus Beispieldaten“.

   

3. Jetzt können Sie JSON bereitstellen, indem Sie auf „Schema aus JSON-Beispiel abrufen“ klicken. Wenn Sie darauf klicken, wird ein Editor geöffnet, in den Sie das Beispiel einfügen können.

   

4. Geben Sie abschließend an, in welche Variable Sie den analysierten Wert einfügen möchten. Normalerweise würden Sie hierfür eine neue Variable erstellen.

   

   Beachten Sie, dass die Ausgabevariable jetzt den richtigen Typ hat: Datensatz.

   

Sie können jetzt Ihre neue Variable verwenden. Hier im Power Fx-Editor können Sie sehen, dass Sie das volle Intellisense für die verschiedenen Eigenschaften erhalten.

Neben dem Analysieren von JSON-Zeichenfolgen der Knoten „Wert analysieren“ vor allem verwendet, um UntypedObjects-Elemente zur Laufzeit zu analysieren. Am häufigsten ist dies der Fall, wenn Sie ein Ereignis erhalten und den Ereigniswert analysieren müssen. Oder Sie möchten möglicherweise die System.Activity.ChannelData-Eigenschaft analysieren, die zur Laufzeit je nach Kanal variiert.

Wenn das Ereignis im folgenden Beispiel von Teams käme, müssten Sie in der Teams-Entwicklerdokumentation ein Beispiel dafür finden, wie das eingehende Ereignis aussehen würde, und anschließend die in diesem Abschnitt beschriebenen Beispieldaten verwenden.

Variablen zwischen Themen übergeben

Wenn Sie zu anderen Themen umleiten, können Sie Werte an Variablen im Ziel Thema übergeben oder Variablen daraus zurückholen. Das Übergeben von Variablen zwischen Themen ist besonders nützlich, wenn Sie bereits Informationen haben, die das Thema benötigt. Ihre Benutzer werden es zu schätzen wissen, die Frage nicht erneut beantworten zu müssen. Dies ist auch hilfreich, wenn Sie Ihre Themen umgestalten und in wiederverwendbare Komponenten aufteilen und Variablen über die Themen hinweg übergeben möchten.

Werte aus anderen Themen empfangen

Wenn ein Thema eine Variable definiert (z. B. durch einen Frageknoten), bittet der Bot den Benutzer, den Wert der Variablen einzugeben. Wenn der Bot den Wert bereits erfasst hat, gibt es keinen Grund, die Frage noch einmal zu stellen. Für diese Fälle können Sie die Variable als Werte aus anderen Themen empfangen definieren. Wenn ein anderes Thema auf dieses Thema umleitet, kann es eine Variable (oder Literalwerte) in diese Variable weitergeben und die Frage überspringen. Die Erfahrung für den Benutzer, der mit dem Bot spricht, ist nahtlos.

Um Werte aus anderen Themen zu erhalten, legen Sie die Eigenschaft der Variablen fest:

1. Im Knoten Frage wählen Sie die Variable aus, die Sie Werte aus anderen Themen erhalten möchten.

2. Wählen Sie im Bereich Variableneigenschaften unter Thema (begrenzter Umfang) die Option Werte aus anderen Themen erhalten.

   

3. Speichern Sie das Thema.

4. Gehen Sie zu einem Thema, zu dem Sie umleiten möchten. Folgen Sie den Schritten in Zu anderem Thema umleiten, um zum richtigen Thema umzuleiten.

5. Wählen Sie + Eingabe für Zielthema hinzufügen.

   

6. Wählen Sie eine Variable im umgeleiteten Thema aus, an das Sie die Variable übergeben möchten.

   

7. Wählen Sie unter Wert eingeben oder auswählen die Variable im aktuellen Thema aus, die Sie an das umgeleitete Thema übergeben möchten.

   

   Die Variable wird im umgeleiteten Knoten angezeigt.

   

Werte an ursprüngliche Themen zurückgeben

Wenn ein Thema eine Frage stellt oder eine Variable auf andere Weise von einer Aktion erhält, kann diese Variable an das ursprüngliche Thema zurückgegeben werden, das zu ihr weitergeleitet wurde.

In diesem Fall wird die Variable auch Teil des ursprünglichen Thema und kann wie jede andere Variable verwendet werden. Dies hilft Ihnen, das Thema so zu konstruieren, dass Informationen, die der Bot erhält, themenübergreifend verfügbar sind, wodurch der Bedarf an globalen Variablen reduziert wird.

Um eine Variable an das ursprüngliche Thema zurückzugeben, legen Sie die Eigenschaft der Variablen fest:

1. Im Knoten Frage wählen Sie die Variable aus, die Sie Werte aus anderen Themen erhalten möchten.

2. Wählen Sie im Bereich Variableneigenschaften unter Thema (begrenzter Umfang) die Option Werte zu ursprünglichen Themen zurückgeben.

   

3. Speichern Sie das Thema.

4. Gehen Sie zu einem Thema, zu dem Sie umleiten möchten. Folgen Sie den Schritten in Zu anderem Thema umleiten, um zum richtigen Thema umzuleiten.

   Die Variable, die an Thema zurückgegeben wird, wird im umgeleiteten Thema angezeigt. Verwenden Sie die zurückgegebene Variable in Ihrem Thema.

   

Variablenbereich verwenden

Verwenden Sie den Bereich Variablen, um den Empfangs- oder Rückgabestatus mehrerer Variablen gleichzeitig auszuwählen.

1. Wählen Sie in der Menüleiste des Themas Variablen.

   

2. Wählen Sie für jede Variable im Thema aus, ob die Werte in Thema zwischen Themen weitergeben, erhalten oder beides werden sollen.

   

Verwenden von Literalwerten für Variableneingaben

Sie können sowohl Literalwerte als auch Variablen an ein Thema übergeben. Um einen Literalwert zu übergeben, geben Sie den Wert ein, den Sie als Eingabe verwenden möchten, anstatt eine Variable auszuwählen.