Variablen verwenden

Wichtig

Power Virtual Agents-Fähigkeiten und -Funktionen sind jetzt Teil von Microsoft Copilot Studio nach erheblichen Investitionen in generative KI und verbesserte Integrationen in Microsoft Copilot.

Einige Artikel und Screenshots beziehen sich möglicherweise auf Power Virtual Agents während wir Dokumentation und Schulungsinhalte aktualisieren.

Mithilfe von Variablen können Sie Antworten von Kunden speichern und später in der Unterhaltung wiederverwenden.

Sie können auch Variablen verwenden, um logische Ausdrücke zu erstellen, die den Kunden dynamisch durch verschiedene Unterhaltungen leiten. Speichern Sie beispielsweise den Namen eines Kunden in einer Variablen namens UserName, und der Copilot kann den Kunden während der gesamten Unterhaltung mit Namen ansprechen.

Variablen können auch aus anderen Themen und Power Automate-Flows übergeben und zurückgegeben werden.

Web-App

Variablen können auf drei Ebenen oder in drei Bereichen vorhanden sein:

• 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 mithilfe Ihres Copilots erstellt. Sie bieten mehr kontextbezogene Informationen über die Unterhaltung oder den Benutzer. Sie sind in allen Themen verfügbar.

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.

Type	Beschreibung
String	Eine Folge von Zeichen zur Darstellung von Text
Boolesch	Ein logischer Wert, der nur true oder false sein kann
Number	Eine beliebige reelle Zahl
Table	Eine Liste mit Werten, aber alle Werte müssen vom gleichen Typ sein
Datensatz	Eine Sammlung von Name-Wert-Paaren, bei denen Werte jeden Typs haben können
DateTime	Ein Datum, eine Uhrzeit, ein Wochentag oder ein Monat relativ zu einem Zeitpunkt
Auswahl	Eine Liste von Zeichenfolgenwerten, denen Synonyme zugeordnet sind
Leer	Ein Platzhalter für „kein Wert“ oder „unbekannter Wert“. Weitere Informationen finden Sie unter Leerstellen in Power Fx

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, ihn einem Zeichenfolgen-Wert von "apples" zuzuordnen, führt zu einem Fehler.

Wenn Sie einen Copiloten testen, wird möglicherweise vorübergehend eine Variable als Typ Unbekannt angezeigt. Einer Unbekannt Variable wurde noch kein Wert zugewiesen.

Die Reihenfolge der Variablen wird von oben nach unten im Erstellungsbereich festgelegt. Das heißt, Knoten am oberen Rand des Erstellungsbereichs werden vor Knoten am unteren Rand berücksichtigt. Wenn Sie Verzweigungen mit Bedingungsknoten erstellen, werden die Verzweigungen von links nach rechts geordnet. Das heißt, dass Knoten in der äußerst linken Verzweigung zuerst vor Knoten in der äußerst rechten Verzweigung betrachtet werden.

Entitäten

Microsoft 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 ist der Typ der Variablenbasis aufgeführt, der mit vordefinierten Entitäten verknüpft ist.

Entity	Variablen-Basistyp
Multiple-Choice-Optionen	Auswahl
Die gesamte Antwort des Benutzers	String
Alter	Number
Boolesch	Boolesch
City	String
Color	String
Kontinent	String
Land oder Region	String
Datum und Uhrzeit	DateTime
E‑Mail	String
Event	String
Ganzzahl	Ganzzahl
Language	String
Money	Number
Number	Number
Ordinal	Number
Organization	String
Prozentsatz	Number
Name der Person	String
Telefon	String
Point of Interest	String
Geschwindigkeit	Number
Bundesstaat	String
Straße	String
Temperatur	Number
URL	String
Schriftstärke	Number
Postleitzahl	String
Benutzerdefinierte Entität	Auswahl

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

Frageknoten 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 Variableneigenschaften zu öffnen.

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

Variable setzen

In der Regel verwenden Sie einen Frageknoten, 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 (+) aus, um einen Knoten hinzuzufügen, und wählen Sie dann Einen Variablenwert festlegen aus.

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 Typ 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 Bereich Variablen aus. Sie können den Variableneigenschaften auch öffnen, indem Sie eine Variable in einem beliebigen Knoten auswählen.

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. Wenn Sie beispielsweise die Systemvariable User.DisplayName in eine Formel aufnehmen möchten, müssen Sie als System.User.DisplayName darauf verweisen.

Name des Dataflows	Type	Ausgeblendet	Definition
Activity.Channel	Option	sichtbar	Die Kanal-ID der aktuellen Unterhaltung
Activity.ChannelData	Beliebig	hidden	Ein Objekt, das kanalspezifische Inhalte enthält
Activity.ChannelId	string	hidden	Die Kanal-ID des aktuellen Gesprächs als Zeichenfolge
Activity.From.Id	string	hidden	Die kanalspezifische eindeutige ID des Absenders
Activity.From.Name	string	hidden	Der kanalspezifische benutzerfreundliche Name des Absenders
Activity.Name	string	sichtbar	Der Name des Ereignisses
Activity.Text	string	sichtbar	Die letzte vom Benutzer gesendete Nachricht
Activity.Type	Option	sichtbar	Typ der Aktivität
Activity.TypeId	string	hidden	Typ der Aktivität als Zeichenfolge
Activity.Value	Beliebig	hidden	Offener Wert
Bot.Name	string	sichtbar	Der Name Ihres Copiloten
Channel.DisplayName	string	hidden	Der Anzeigename des Kanals
Conversation.Id	string	sichtbar	Die eindeutige ID der aktuellen Unterhaltung
LastActivity.Id	string	sichtbar	Die ID der zuvor gesendeten Aktivität
LastMessage.Id	string	sichtbar	Die ID der vorherigen vom Benutzer gesendeten Nachricht
LastMessage.Text	string	sichtbar	Die vorherige vom Benutzer gesendete Nachricht
Recognizer.TriggerMessage.Id	string	sichtbar	Die ID der Benutzernachricht, die das aktuelle Thema ausgelöst hat.
Recognizer.TriggerMessage.Text	string	sichtbar	Die Benutzernachricht, die das aktuelle Thema ausgelöst hat
User.DisplayName	string	sichtbar	Der Anzeigename des angemeldeten Benutzers.

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 hinzu, und wählen Sie das Zielthema aus.

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.

Klassisch

Entität und Variablentyp

Microsoft 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.

Entität	Variablen-Basistyp
Multiple-Choice-Optionen	String
Die gesamte Antwort des Benutzers	String
Alter	Number
Boolesch	Boolesch
City	String
Color	String
Kontinent	String
Land oder Region	String
Datum und Uhrzeit	String
Duration	String
E‑Mail	String
Veranstaltung	String
Language	String
Money	String
Number	String
Ordinal	String
Organization	String
Prozent	Number
Name der Person	String
Telefon	String
Point of Interest	String
Geschwindigkeit	Number
Bundesstaat	String
Straße	String
Temperatur	Number
URL	String
Schriftstärke	Number
Postleitzahl	String
Benutzerdefinierte Entität	String

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 Bots 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 Microsoft 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.

Notiz

Variablen vom Typ Custom Entity, Date and Time, Duration und Multiple-choice können nicht zwischen Themen weitergegeben werden.

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.

Verwandte Themen

• Variablen themenübergreifend wiederverwenden
• Das Copilot-Erscheinungsbild anpassen