Mit Variablen arbeiten

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 Agent kann den Kunden im weiteren Gespräch 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 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 Agent 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.

Type	Beschreibung
Zeichenfolge	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 mit zugehörigen Synonymen
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, es einem String Wert von "apples" zuzuweisen, führt zu einem Fehler.

Wenn Sie ein Agent testen, wird eine Variable möglicherweise vorübergehend als Typ unbekannt angezeigt. 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.

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

Tipp

Benennen Sie Knoten um, um sie leichter identifizieren zu können. Wählen Sie das Namensfeld des Knotens aus, um den Namen direkt zu aktualisieren, oder wählen Sie das Symbol Mehr (…) des Knotens und im Menü Umbenennen aus. Sie können Knoten im Code-Editor auch umbenennen.

Es ist nicht möglich, Trigger-Knoten und Zu Schritt gehen-Knoten umzubenennen.

Knotennamen können bis zu 500 Zeichen lang sein.

Die zu verwendenden Entität auswählen

Frageknoten werden standardmäßig mit Multiple-Choice-Optionen erstellt. Um eine andere vorgefertigte oder benutzerdefinierte Entität zu verwenden, Auswählen das Feld Identifizieren und wählen Sie den Informationstyp aus, auf den Agent warten soll.

Eine Variable umbenennen

Variablen wird beim Erstellen automatisch ein Name zugewiesen. Es empfiehlt sich, Ihren Variablen aussagekräftige Namen zu geben, damit ihr Zweck für alle anderen klar ist, die Ihr Agent pflegen müssen.

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.

Anmerkung

Wenn beim Festlegen einer Zeichenfolgenvariablen eine Nichtübereinstimmung zwischen Variable festlegen und Bis-Wert auftritt, werden eine Fehlermeldung und die Schaltfläche Typnichtübereinstimmung beheben angezeigt. Auswählen die Schaltfläche, um Copilot Studio automatisch eine Power Fx Formel generieren zu lassen, die die Nichtübereinstimmung behebt.

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. Autoren von Agent können die Variable Umgebung 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:

Typ in Copilot Studio	Typ in PowerApps
Dezimalzahl	Number
JSON	Ermitteln Sie den Typ anhand des Wertes. Wenn nicht Json => nicht angegeben (Validierungsfehler)
Text	string
Ja/Nein	Boolesch
Data source	string
Secret	String

Anmerkung

Umgebungsvariablenfehler sind im Testen-Chat und beim Veröffentlichen sichtbar. Diese Fehler werden jedoch in der Liste Thema nicht angezeigt, da es sich nicht um Themenvariablen handelt.

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 Agenten von Umgebung den Zugriff auf das Geheimnis zu gestatten, erstellen Sie ein Tag AllowedEnvironments für das Geheimnis und fügen Sie die zulässigen Umgebung-IDs durch Kommas getrennt hinzu.

3. Um nur bestimmten Agenten aus Umgebung die Verwendung dieses Schlüsseltresors zu gestatten, erstellen Sie ein Tag AllowedAgents und geben Sie die Kennung Agent im Format {envId}/{schemaName} ein. Trennen Sie die Werte bei mehreren Werte durch Kommas.

Wenn Sie die maximale Anzahl an Zeichen erreichen, aber dennoch weitere Agenten hinzufügen müssen, fügen Sie ein weiteres Tag mit einem beschreibenden, aber eindeutigen Namen hinzu (z. B.: AllowedAgents2).

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

Warnung

Durch Hinzufügen des Geheimnisses zu Agent können Sie den Wert dieses Geheimnisses allen Benutzern zugänglich machen, die Agent in Umgebung bearbeiten können, da solche Benutzer Agent bearbeiten könnten, um den Wert im SendMessage Knoten zurückzugeben.

Systemvariablen

Jedes Agent verfügt über integrierte Systemvariablen, die zusätzliche Informationen zu einer Konversation liefern.

Anmerkung

Weitere Informationen zu sprachgesteuerten Agent-Variablen finden Sie unter Sprachvariablen verwenden.

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.

Name des Dataflows	typ	Definition
Activity.Attachments	Tabelle	Die vom Benutzenden bereitgestellten Dateianhänge
Activity.Channel	Option	Die Kanal-ID der aktuellen Unterhaltung
Activity.ChannelData	Beliebig	Ein Objekt, das kanalspezifische Inhalte enthält
Activity.ChannelId	string	Die Kanal-ID des aktuellen Gesprächs als Zeichenfolge
Activity.From.Id	string	Die kanalspezifische eindeutige ID des Absenders
Activity.From.Name	string	Der kanalspezifische benutzerfreundliche Name des Absenders
Activity.Name	string	Der Name des Ereignisses
Activity.Recipient.Id	string	Die Typ-Eigenschaft der eingehenden Aktivität.
Activity.Recipient.Name	string	Stellt das Anzeigename für das Agent innerhalb des Kanals dar. Im Kontext des Telefoniekanals ist der Wert dieser Variablen die Telefonnummer, an die Agent angehängt ist.
Activity.Text	string	Die letzte vom Benutzer gesendete Nachricht
Activity.Type	Option	Typ der Aktivität
Activity.TypeId	string	Typ der Aktivität als Zeichenfolge
Activity.Value	Beliebig	Offener Wert
Bot.EnvironmentId	string	Die Umgebung-ID des Agent
Bot.Id	string	Die ID des Agent
Bot.Name	string	Der Name Ihres Agent
Bot.SchemaName	string	Der Schemaname von Agent
Bot.TenantId	string	Die Mandanten-ID von Agent
ClientPluginActions	Option	Sammlung dynamischer Client-Plugin-Aktionen, die für die generative Orchestrierung berücksichtigt werden sollten
Conversation.Id	string	Die eindeutige ID der aktuellen Unterhaltung
Conversation.InTestMode	boolesch	Boolesches Kennzeichen, das angibt, ob die Unterhaltung im Test-Canvas stattfindet
Conversation.LocalTimeZone	string	Name der vom Benutzenden zu verwendenden Zeitzone im IANA-Zeitzonendatenbankformat
Conversation.LocalTimeZoneOffset	DateTime	Der Zeitunterschied zur UTC für die aktuelle lokale Zeitzone
Error.Code	string	Der Fehlercode des aktuellen Fehlers. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger On Error ist.
Error.Message	string	Die Fehlernachricht des aktuellen Fehlers. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger On Error ist.
FallbackCount	Zahl	Diese Variable zählt, wie oft ein Thema nicht der Benutzereingabe zugeordnet werden konnte. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger On Unknown Intent ist.
InactivityTimer.Continue	boolesch	Boolesches Kennzeichen, das angibt, ob der Timer fortgesetzt werden muss. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger Inactivity ist.
InactivityTimer.Count	Zahl	Häufigkeit, mit welcher der OnInactivity-Timer aufgrund von Benutzerinaktivität nach der konfigurierten Zeit ausgelöst wurde. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger Inactivity ist.
LastMessage.Id	string	Die ID der vorherigen vom Benutzer gesendeten Nachricht
LastMessage.Text	string	Die vorherige vom Benutzer gesendete Nachricht
Recognizer.ExtractedEntities	Option	Stellt die extrahierten Entitäten aus der auslösenden Nachricht dar. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger On Select Intent ist.
Recognizer.IntentOptions	Option	Stellt die Absichtsoptionen dar, wenn das Erkennungsmodul mehrdeutige Ergebnisse zurückgibt. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger On Select Intent ist.
Recognizer.SelectedIntent	Option	Stellt die vom Erkennungsmodul ausgewählte Absicht dar. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger On Select Intent ist.
Recognizer.TriggeringMessage.Id	string	Die ID der Benutzernachricht, die das aktuelle Thema ausgelöst hat.
Recognizer.TriggeringMessage.Text	string	Die Benutzernachricht, die das aktuelle Thema ausgelöst hat
Recognizer.MultipleTopicsMatchedReason	string	Wird verwendet, um zu ermitteln, warum mehrere Themen übereinstimmten. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger On Select Intent ist.
User.Language	Option	Mit dieser Variable wird das Gebietsschema der Benutzersprache pro Unterhaltung festgelegt.
SignInReason	Option	Wird verwendet, um zu bestimmen, welche Anmeldeoption beim Auslösen des Themas erforderlich ist. Hinweis: Diese Variable wird nur unterstützt, wenn Trigger On Sign In ist.

Variablen für integrierte Authentifizierung (Standard)

Die folgenden Variablen sind verfügbar, wenn Sie Ihr Agent für die Authentifizierung mit 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 Agenten.

Weitere Informationen finden Sie unter Authentifizierungsvariablen.

Name des Dataflows	typ	Definition
User.DisplayName	string	Die Anzeigename des Benutzers, der aktuell mit Agent spricht.
User.Email	string	Die E-Mail-Adresse des Benutzers, der aktuell mit Agent spricht.
User.FirstName	string	Der Vorname des Benutzers, der aktuell mit Agent spricht.
User.Id	string	Die eindeutige ID des Benutzers, der aktuell mit Agent spricht.
User.IsLoggedIn	boolesch	boolesch-Flag, das angibt, ob der Benutzer, der aktuell mit Agent spricht, authentifiziert ist oder nicht.
User.LastName	string	Das Nachname des Benutzers, der aktuell mit Agent spricht.
User.PrincipalName	string	Der Benutzerprinzipalname des Benutzers, der aktuell mit Agent spricht.

Variablen für die manuelle Authentifizierung mit Generic OAuth 2

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

Name des Dataflows	typ	Definition
User.AccessToken	string	Die Zugriffstoken für den Benutzer, der sich mit Agent authentifiziert.
User.DisplayName	string	Die Anzeigename des Benutzers, der aktuell mit Agent spricht.
User.Id	string	Die eindeutige ID des Benutzers, der aktuell mit Agent spricht.
User.IsLoggedIn	boolesch	boolesch-Flag, das angibt, ob der Benutzer, der aktuell mit Agent spricht, authentifiziert ist oder nicht.

Variablen für die manuelle Authentifizierung mit Microsoft Entra ID

Die folgenden Variablen sind verfügbar, wenn Sie Ihr Agent so konfiguriert haben, dass die Dienstanbieter Microsoft Entra ID (früher Azure Active Directory) verwendet werden.

Name des Dataflows	typ	Definition
User.AccessToken	string	Die Zugriffstoken für den Benutzer, der sich mit Agent authentifiziert.
User.DisplayName	string	Die Anzeigename des Benutzers, der aktuell mit Agent spricht.
User.Email	string	Die E-Mail-Adresse des Benutzers, der aktuell mit Agent spricht.
User.FirstName	string	Der Vorname des Benutzers, der aktuell mit Agent spricht.
User.Id	string	Die eindeutige ID des Benutzers, der aktuell mit Agent spricht.
User.IsLoggedIn	boolesch	boolesch-Flag, das angibt, ob der Benutzer, der aktuell mit Agent spricht, authentifiziert ist oder nicht.
User.LastName	string	Das Nachname des Benutzers, der aktuell mit Agent spricht.
User.PrincipalName	string	Der Benutzerprinzipalname des Benutzers, der aktuell mit Agent spricht.

Variablen für sprachgesteuerte Agenten

Die folgenden Variablen sind nur in sprachgesteuerten Agenten verfügbar.

Anmerkung

Weitere Informationen zu sprachgesteuerten Agent-Variablen finden Sie unter Sprachvariablen verwenden.

Name des Dataflows	typ	Definition
Activity.InputDTMFKeys	string	Der rohe MFV-Tastenwert, der von der Telefonie empfangen wurde.
Activity.SpeechRecognition.Confidence	Zahl	Die Konfidenzbewertung für das Gesamtergebnis der ASR-Hypothese, 0 bis 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Leicht formatierter Text des ASR-Hypothesenergebnisses. Zum Beispiel: Fünfhundert Dollar. Wörter werden ausgeschrieben, aber die grundlegende Groß- und Kleinschreibung sowie Zeichensetzung werden berücksichtigt.
Activity.UserInputType	Option	Der Eingabetyp der letzten Eingabe des Endbenutzenden. Der Wert kann entweder testen, Sprache und MFV sein.
Conversation.OnlyAllowDTMF	boolesch	Boolesche Kennzeichen, das angibt, ob die ISA zur Laufzeit auf den Nur-MFV-Modus eingestellt werden soll.
Conversation.SipUuiHeaderValue	string	Die UUI-Headerzeichenfolge, die verwendet wird, um beim Beginn des Anrufs den Kontext an die ISA zu übergeben.

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 (beispielsweise in einem Fragenknoten), stellt Agent dem Benutzer die Frage, den Wert der Variablen einzugeben. Wenn Agent den Wert bereits in einem früheren Thema erhalten hat, besteht kein Grund, die Frage erneut 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 Agent 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 „Test Agent“ gezeigt, wird der Benutzer, wenn dieser Thema zuerst ausgelöst wird, gefragt: „Wie soll ich Sie nennen?“ Der Wert wird in einer Zeichenfolgenvariablen namens gespeichert userName. 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 „Test Agent“ gezeigt, wird der Benutzer, wenn dieser Thema zuerst ausgelöst wird, gefragt: „Wie heißen Sie?“ Der Wert wird in einer Zeichenfolgenvariablen namens gespeichert UserName. 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. Die von Agent erhaltenen Informationen sind somit 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

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	Zeichenfolge
Die gesamte Antwort des Benutzers	Zeichenfolge
Alter	Number
Boolesch	Boolesch
City	Zeichenfolge
Color	Zeichenfolge
Kontinent	Zeichenfolge
Land oder Region	Zeichenfolge
Datum und Uhrzeit	Zeichenfolge
Duration	Zeichenfolge
E‑Mail	Zeichenfolge
Veranstaltung	Zeichenfolge
Language	Zeichenfolge
Money	Zeichenfolge
Number	Zeichenfolge
Ordinal	Zeichenfolge
Organization	Zeichenfolge
Prozent	Number
Name der Person	Zeichenfolge
Telefon	Zeichenfolge
Point of Interest	Zeichenfolge
Geschwindigkeit	Number
Bundesstaat	Zeichenfolge
Straße	Zeichenfolge
Temperatur	Number
URL	Zeichenfolge
Schriftstärke	Number
Postleitzahl	Zeichenfolge
Benutzerdefinierte Entität	Zeichenfolge

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.

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.

Zugehöriger Inhalt

• Variablen verwenden, um Inhalte themenübergreifend zu übertragen
• Passen Sie das Erscheinungsbild eines Agent an