Freigeben über

Ü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 schreibgeschützt. 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
Zeichenfolge Eine Folge von Zeichen zur Darstellung von Text
Boolesch Ein logischer Wert, der nur true oder false sein kann
Zahl Eine beliebige reelle Zahl
Tabelle 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 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 betrachtet.

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
Multiple-Choice-Optionen Auswahl
Die gesamte Antwort des Benutzers Zeichenfolge
Alter Zahl
Boolesch Boolesch
Stadt Zeichenfolge
Farbe Zeichenfolge
Kontinent Zeichenfolge
Land oder Region Zeichenfolge
Datum und Uhrzeit DateTime
E‑Mail Zeichenfolge
Veranstaltung Zeichenfolge
Ganzzahl Ganzzahl
Sprache Zeichenfolge
Geldbetrag Zahl
Zahl Zahl
Ordinalzahl Zahl
Organisation Zeichenfolge
Prozent Zahl
Name der Person Zeichenfolge
Telefon Zeichenfolge
Point of Interest Zeichenfolge
Geschwindigkeit Zahl
Bundesstaat Zeichenfolge
Straße Zeichenfolge
Temperatur Zahl
URL Zeichenfolge
Schriftstärke Zahl
Postleitzahl Zeichenfolge
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 Geheimnis-Variablen zur Laufzeit abgerufen.

Umgebungsvariablentypen in Copilot Studio sind Power Apps-Datentypen wie folgt zugeordnet:

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

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 Art Definition
Activity.Attachments 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 Unterhaltung als Zeichenfolge.
Activity.From.Id Zeichenfolge Die kanalspezifische eindeutige ID des Absenders.
Activity.From.Name Zeichenfolge Der kanalspezifische benutzerfreundliche Name des Absenders.
Activity.Name Zeichenfolge Der Name des Ereignisses.
Activity.Recipient.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, an die der Agent angefügt ist.
Activity.Text Zeichenfolge Die letzte vom Benutzer gesendete Nachricht.
Activity.Type Option Typ der Aktivität.
Activity.TypeId Zeichenfolge Typ der Aktivität als Zeichenfolge.
Activity.Value beliebig Wert mit offenem Ende.
Bot.EnvironmentId Zeichenfolge Die Umgebungs-ID des Agents.
Bot.Id Zeichenfolge Die ID der Momentaufnahme.
Bot.Name Zeichenfolge Der Name Ihres Agents.
Bot.SchemaName Zeichenfolge Der Schemaname des Agents.
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 der aktuellen Unterhaltung.
Conversation.InTestMode Boolesch Boolesches Kennzeichen, das angibt, ob die Unterhaltung im Test-Canvas stattfindet.
Conversation.LocalTimeZone Zeichenfolge 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 Zeichenfolge Der Fehlercode des aktuellen Fehlers.
Die Fehlermeldung, die für den aktuellen Fehler definiert wurde.
Error.Message Zeichenfolge Die Fehlermeldung, die für den aktuellen Fehler definiert wurde.
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.
InactivityTimer.Continue 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.Text 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.
SignInReason 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.
User.Language Option Mit dieser Variable wird das Gebietsschema der Benutzersprache pro 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 Art Definition
User.DisplayName 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.
User.LastName 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 Art Definition
User.AccessToken Zeichenfolge Der Zugriffstoken für den Benutzenden, der sich bei dem Agenten authentifiziert.
User.DisplayName 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 Art Definition
User.AccessToken Zeichenfolge Der Zugriffstoken für den Benutzenden, der sich bei dem Agenten authentifiziert.
User.DisplayName 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.
User.LastName Zeichenfolge Der Familienname des Benutzers, der gerade mit der Agent spricht.
User.PrincipalName Zeichenfolge Der Prinzipalname des Benutzers, der gerade mit der 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 Art Definition
Activity.InputDTMFKeys Zeichenfolge Der unformatierte MFV-Schlüsselwert aus der Telefonie.
Activity.SpeechRecognition.Confidence 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 Testen, Sprache oder MFV sein.
Conversation.OnlyAllowDTMF Boolesch Boolesche Kennzeichen, das angibt, ob die ISA zur Laufzeit auf den Nur-MFV-Modus eingestellt werden soll.
Conversation.SipUuiHeaderValue Zeichenfolge Die UUI-Headerzeichenfolge, die verwendet wird, um beim Beginn des Anrufs den Kontext an die ISA zu übergeben.
  • Last updated on