Übersicht über Variablen

Variablen existieren auf vier Ebenen oder Bereichen:

  • Themenvariablen, die Sie nur in den Themen verwenden können, in denen Sie sie erstellen. Dieser Bereich ist der Standardbereich für Variablen, die Sie erstellen.
  • Globale Variablen, die Sie in allen Themen verwenden können. Sie können den Bereich einer Thema-Variable ändern, um sie zu einer globalen Variablen zu machen.
  • Systemvariablen, die Copilot Studio automatisch für einen Agent erstellt. Sie bieten mehr kontextbezogene Informationen über die Unterhaltung oder den Benutzer. Sie sind in allen Themen verfügbar.
  • Umgebungsvariablen, die Sie in Power Platform erstellen. Sie sind in Copilot Studio als Nur-Lesen markiert. Sie speichern die Parameterschlüssel und -werte, die dann als Eingabe für verschiedene andere Anwendungsobjekte dienen können, einschließlich 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, festcodierte Parameterwerte in den Komponenten zu belassen, die sie verwenden.

Variablentypen

Jede Variable hat einen Basistyp. Der Typ bestimmt, welche Werte die Variable annehmen kann und welche Operatoren Sie verwenden können, wenn Sie damit einen logischen Ausdruck bilden.

Typ BESCHREIBUNG
String Eine Folge von Zeichen zur Darstellung von Text
Boolesch Ein logischer Wert, der nur true oder false sein kann
Nummer Eine beliebige reelle Zahl
Tabelle Eine Liste mit Werten, aber alle Werte müssen vom gleichen Typ sein
Aufzeichnung Eine Sammlung von Name-Wert-Paaren, bei denen Werte beliebigen Typs sein 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 Leer in der Power Fx-Dokumentation.

Sie legen den Typ einer Variablen fest, wenn Sie ihr zum ersten Mal einen Wert zuweisen. Danach ist der Typ festgelegt, und Sie können keine Werte anderen Typs zuweisen. Wenn Sie beispielsweise den Anfangswert 1 einer Variablen zuweisen, legen Sie dessen Typ auf Zahl fest. Wenn Sie dann versuchen, einen Zeichenfolge-Wert wie "apples" zuzuweisen, wird eine Fehlermeldung angezeigt.

Wenn Sie einen Agent testen, wird möglicherweise vorübergehend eine Variable mit dem Typ Unbekannt angezeigt. Eine unbekannte Variable hat noch keinen Wert.

Die Reihenfolge der Variablen wird von oben nach unten im Erstellungsbereich festgelegt. Die Knoten am oberen Rand des Erstellungsbereichs werden vor den Knoten am unteren Rand berücksichtigt.

Wenn Sie Verzweigungen mit Bedingungsknoten erstellen, werden die Verzweigungen von links nach rechts geordnet. Knoten in der Verzweigung ganz links werden vor Knoten in der Verzweigung ganz rechts betrachtet.

Entitäten

Copilot Studio verwendet Entitäten, um bestimmte Arten 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 Basistyp der Variablen aufgeführt, die vordefinierten Entitäten zugeordnet sind.

Entität Variablen-Basistyp
Mehrfachauswahloptionen Auswahl
Die gesamte Antwort des Benutzers String
Alter Nummer
Boolesch Boolesch
Stadt String
Farbe String
Kontinent String
Land oder Region String
Datum und Uhrzeit DateTime
E-Mail String
Veranstaltung String
Ganzzahl Ganzzahl
Sprache String
Geld Nummer
Nummer Nummer
Ordinalzahl Nummer
Organisation String
Prozent Nummer
Name der Person String
Telefon String
Interessanter Ort String
Geschwindigkeit Nummer
Bundesstaat String
Straßenadresse String
Temperatur Nummer
URL String
Gewicht Nummer
Postleitzahl String
Benutzerdefinierte Entität Auswahl

Umgebungsvariablen

Umgebungsvariablen 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 Umgebungsvariablen in Copilot Studio schreibgeschützt sind. Agent-Erstellende können Umgebungsvariablen in Copilot Studio nicht ändern. Administrierende können jedoch den Wert von Umgebungsvariablen in Power Apps ändern. In Copilot Studio können Sie den Bereich Variablen verwenden, um Informationen zu einer Umgebungsvariablen anzuzeigen. Der Bereich Variableneigenschaften verfügt außerdem über einen Link zu Power Apps, der Erstellungsumgebung für Umgebungsvariablen.

Die veröffentlichte Version eines Agents, der Umgebungsvariablen verwendet, weist die Werte auf, die für diese Variablen festgelegt werden, wenn Sie den Agent veröffentlichen. Jedes Mal, wenn eine Fachkraft für die Administration Umgebungsvariablen aktualisiert, müssen Sie alle Agenten, die diese Variablen verwenden, erneut veröffentlichen, damit die Änderungen zur Laufzeit wirksam werden. Es gibt jedoch eine Ausnahme: Sie müssen Ihre Agenten nicht erneut veröffentlichen, wenn sich der Wert einer Umgebungsvariablen vom Typ Geheimnis ändert. Im Gegensatz zu anderen Umgebungsvariablen werden geheime Variablen bei der Laufzeit abgerufen.

Umgebungsvariablentypen in Copilot Studio entsprechen den Datentypen in Power Apps wie folgt:

Schreiben Sie in Copilot Studio Eingeben in Power Apps
Dezimalzahl Nummer
JSON Ermitteln Sie den Typ anhand des Wertes. Wenn nicht JSON => Nicht spezifiziert (Validierungsfehler)
Text String
Ja/Nein Boolesch
Datenquelle String
Geheimnis String

Anmerkung

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

Systemvariablen

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

Screenshot von Systemvariablen in einem Agententhema.

Anmerkung

Weitere Informationen zu sprachaktivierten Agentenvariablen finden Sie unter Sprachvariablen verwenden.

Copilot Studio zeigt nicht alle Systemvariablen an. Um auf ausgeblendete Systemvariablen zuzugreifen, verwenden Sie eine Power Fx-Formel.

Um Systemvariablen in einer Power Fx-Formel zu verwenden, fügen Sie vor dem Variablennamen System. hinzu. Um beispielsweise die Systemvariable User.DisplayName in eine Formel einzubinden, verweisen Sie als System.User.DisplayName darauf.

Name Typ Definition
Aktivität.Anlagen Tabelle Die Dateianhänge, die der Benutzer bereitstellt.
Activity.Channel Option Die Kanal-ID der aktuellen Unterhaltung.
Activity.ChannelData beliebig Ein Objekt, das kanalspezifische Inhalte enthält.
Activity.ChannelId Zeichenfolge Die Kanal-ID der aktuellen Konversation als Zeichenfolge.
Activity.From.Id Zeichenfolge Die kanalspezifische eindeutige ID des Absenders.
Aktivität.Von.Name Zeichenfolge Der kanalspezifische benutzerfreundliche Name des Absenders.
Aktivität.Name Zeichenfolge Der Name des Ereignisses.
Aktivität.Empfänger.Id Zeichenfolge Die Typ-Eigenschaft der eingehenden Aktivität.
Activity.Recipient.Name Zeichenfolge Stellt den Anzeigenamen für den Agenten innerhalb des Kanals dar. Im Kontext des Telefoniekanals ist der Wert dieser Variablen die Telefonnummer, mit der der Agent verbunden ist.
Aktivität.Text Zeichenfolge Die letzte vom Benutzer gesendete Nachricht.
Activity.Type Option Typ der Aktivität.
Activity.TypeId Zeichenfolge Typ der Aktivität als Zeichenfolge.
Aktivität.Wert beliebig Wert mit offenem Ende.
Bot.EnvironmentId Zeichenfolge Die Umgebungs-ID des Agents.
Bot.Id Zeichenfolge Die ID des Agenten.
Bot.Name Zeichenfolge Der Name Ihres Agents.
Bot.SchemaName Zeichenfolge Der Schemaname des Agenten.
Bot.TenantId Zeichenfolge Die Mandanten-ID des Agents.
ClientPluginActions Option Sammlung dynamischer Client-Plug-In-Aktionen, die bei der generativen Orchestrierung zu berücksichtigen sind.
Conversation.Id Zeichenfolge Die eindeutige ID des aktuellen Gesprächs.
Konversation.ImTestmodus Boolesch Boolesches Kennzeichen, das angibt, ob die Unterhaltung im Test-Canvas stattfindet.
Unterhaltung.LokaleZeitzone Zeichenfolge Name der vom Benutzenden zu verwendenden Zeitzone im IANA-Zeitzonendatenbankformat.
Conversation.LocalTimeZoneOffset DateTime Der Zeitunterschied zur UTC für die aktuelle lokale Zeitzone.
Fehlercode Zeichenfolge Der Fehlercode des aktuellen Fehlers.
Die Fehlermeldung für den aktuellen Fehler.
Fehlermeldung Zeichenfolge Die Fehlermeldung für den aktuellen Fehler.
Hinweis: Diese Variable wird nur unterstützt, wenn der Trigger On Error lautet.
FallbackCount Zahl Diese Variable zählt, wie oft ein Thema nicht der Benutzereingabe zugeordnet werden konnte.
Hinweis: Diese Variable wird nur unterstützt, wenn der Trigger On Unknown Intent lautet.
InaktivitätsTimer.Fortsetzen Boolesch Boolesches Kennzeichen, das angibt, ob der Timer fortgesetzt werden muss.
Hinweis: Diese Variable wird nur unterstützt, wenn der Trigger Inactivity lautet.
InactivityTimer.Count Zahl Gibt an, wie oft der OnInactivity-Timer aufgrund von Benutzerinaktivität nach der konfigurierten Zeit ausgelöst wurde.
Hinweis: Diese Variable wird nur unterstützt, wenn der Trigger Inactivity lautet.
LastMessage.Id Zeichenfolge Die ID der vorherigen vom Benutzer gesendeten Nachricht.
LastMessage.Text Zeichenfolge 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 der Trigger On Select Intent lautet.
Recognizer.IntentOptions Option Stellt die Absichtsoptionen dar, wenn die Erkennung mehrdeutige Ergebnisse zurückgibt.
Hinweis: Diese Variable wird nur unterstützt, wenn der Trigger On Select Intent lautet.
Recognizer.SelectedIntent Option Stellt die vom Erkennungsmodul ausgewählte Absicht dar.
Hinweis: Diese Variable wird nur unterstützt, wenn der Trigger On Select Intent lautet.
Recognizer.TriggeringMessage.ID Zeichenfolge Die ID der Benutzernachricht, die das aktuelle Thema ausgelöst hat.
Recognizer.TriggeringMessage.Nachrichtentext Zeichenfolge Die Benutzernachricht, die das aktuelle Thema ausgelöst hat.
Recognizer.MultipleTopicsMatchedReason Zeichenfolge Wird verwendet, um zu ermitteln, warum mehrere Themen übereinstimmen.
Hinweis: Diese Variable wird nur unterstützt, wenn der Trigger On Select Intent lautet.
Anmeldegrund Option Wird verwendet, um zu bestimmen, welche Anmeldeoption beim Auslösen des Themas erforderlich ist.
Hinweis: Diese Variable wird nur unterstützt, wenn der Trigger On Sign In lautet.
Benutzersprache Option Mit dieser Variable wird das Gebietsschema der Benutzersprache für jede Unterhaltung festgelegt.

Variablen für integrierte Authentifizierung (Standard)

Die folgenden Variablen sind für Agenten verfügbar, die für die Authentifizierung bei Microsoft konfiguriert sind. Diese Konfiguration verwendet die Microsoft Entra ID-Authentifizierung und ist die Standardeinstellung für neue Agents.

Weitere Informationen finden Sie unter Authentifizierungsvariablen.

Name Typ Definition
Benutzer.Anzeigename Zeichenfolge Der Anzeigename des Benutzenden, der aktuell mit dem Agenten spricht.
Benutzer-E-Mail Zeichenfolge Die E-Mail-Adresse des Benutzers, der gerade mit dem Agent kommuniziert.
User.FirstName Zeichenfolge Der Vorname des Benutzenden, der aktuell mit dem Agenten spricht.
User.Id Zeichenfolge Die einzigartige ID des Benutzenden, der aktuell mit dem Agenten spricht.
User.IsLoggedIn Boolesch Boolesches Kennzeichen, das angibt, ob der Benutzer, der gerade mit dem Agent spricht, authentifiziert ist oder nicht.
Benutzer.Nachname Zeichenfolge Der Familienname des Benutzers, der gerade mit der Agent spricht.
User.PrincipalName Zeichenfolge Der Benutzerprinzipalname des Benutzers, der derzeit mit der Agent kommuniziert.

Variablen für die manuelle Authentifizierung mit generischem OAuth 2

Die folgenden Variablen sind für Agents verfügbar, die für die Verwendung des generischen Dienstanbieters OAuth 2 konfiguriert sind.

Name Typ Definition
User.AccessToken Zeichenfolge Der Zugriffstoken für den Benutzenden, der sich bei dem Agenten authentifiziert.
Benutzer.Anzeigename Zeichenfolge Der Anzeigename des Benutzenden, der aktuell mit dem Agenten spricht.
User.Id Zeichenfolge Die einzigartige ID des Benutzenden, der aktuell mit dem Agenten spricht.
User.IsLoggedIn Boolesch Boolesches Kennzeichen, das angibt, ob der Benutzer, der gerade mit dem Agent spricht, authentifiziert ist oder nicht.

Variablen für die manuelle Authentifizierung mit Microsoft Entra ID

Die folgenden Variablen sind für Agents verfügbar, die für die Verwendung der Microsoft Entra ID- Dienstanbieter (zuvor Azure Active Directory) konfiguriert sind.

Name Typ Definition
User.AccessToken Zeichenfolge Der Zugriffstoken für den Benutzenden, der sich bei dem Agenten authentifiziert.
Benutzer.Anzeigename Zeichenfolge Der Anzeigename des Benutzenden, der aktuell mit dem Agenten spricht.
Benutzer-E-Mail Zeichenfolge Die E-Mail-Adresse des Benutzers, der gerade mit dem Agent kommuniziert.
User.FirstName Zeichenfolge Der Vorname des Benutzenden, der aktuell mit dem Agenten spricht.
User.Id Zeichenfolge Die einzigartige ID des Benutzenden, der aktuell mit dem Agenten spricht.
User.IsLoggedIn Boolesch Boolesches Kennzeichen, das angibt, ob der Benutzer, der gerade mit dem Agent spricht, authentifiziert ist oder nicht.
Benutzer.Nachname Zeichenfolge Der Familienname des Benutzers, der gerade mit der Agent spricht.
User.PrincipalName Zeichenfolge Der Hauptbenutzername des Benutzers, der gerade mit dem Agent spricht.

Variablen für sprachaktivierte Agenten

Die folgenden Variablen sind nur für sprachgesteuerte Agenten verfügbar.

Anmerkung

Weitere Informationen zu sprachaktivierten Agentenvariablen finden Sie unter Sprachvariablen verwenden.

Name Typ Definition
Activity.EingabeDTMFTasten Zeichenfolge Der rohe DTMF-Schlüsselwert aus der Telefonie.
Aktivität.Spracherkennung.Vertrauensniveau Zahl Die Konfidenzbewertung für das gesamte Ergebnis der Azure Site Recovery-Hypothese: 0 bis 1.
Activity.SpeechRecognition.MinimallyFormattedText Zeichenfolge Etwas formatierter Text des Ergebnisses der Hypothese von Azure Site Recovery Zum Beispiel: „Fünfhundert Dollar“. Die Wörter werden ausgeschrieben, aber grundlegende Großschreibung und Zeichensetzung werden berücksichtigt.
Activity.UserInputType Option Die Art der letzten Eingabe des Agent-Benutzers. Der Wert kann entweder Test, Sprache oder DTMF sein.
Unterhaltung.NurDTMFERlauben Boolesch Boolesches Kennzeichen, das angibt, ob das IVR zur Laufzeit auf den DTMF-Nur-Modus eingestellt werden soll.
Conversation.SipUuiHeaderValue Zeichenfolge Die UUI-Headerzeichenfolge, die verwendet wird, um zu Beginn des Anrufs den Kontext an das IVR zu übermitteln.
  • Last updated on