Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Sie können Variablen verwenden, um die Antworten von Kunden zu speichern und ihre Inhalte später in der Unterhaltung wiederzuverwenden.
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 customerName und der Agent kann den Kunden mit Namen ansprechen, während das Gespräch fortgesetzt wird.
Variablen können auch aus anderen Themen und Power Automate-Flows übergeben und zurückgegeben werden.
Eine Variable erstellen
Jeder Knoten, der eine Ausgabe zurückgibt, z. B. ein Frageknoten , erstellt automatisch eine Ausgabevariable des entsprechenden Typs.
Trinkgeld
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 die drei Punkte (...) des Knotens und wählen Sie im Menü Umbenen . 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. Wenn Sie eine andere vordefinierte oder benutzerdefinierte Entität verwenden möchten, wählen Sie das Feld " Identifizieren " und dann den gewünschten Informationstyp aus.
Eine Variable umbenennen
Variablen wird beim Erstellen automatisch ein Name zugewiesen. Eine bewährte Methode besteht darin, Ihren Variablen aussagekräftige Namen zu geben, um ihren Zweck für jeden klar zu machen, der Ihren Agenten verwalten muss.
Wählen Sie die Variable aus. Der Bereich Variableneigenschaften wird angezeigt.
Geben Sie unter "Variablenname" den gewünschten Namen für die 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 einer Variablen selbst festlegen möchten. Verwenden Sie in diesen Fällen den Knoten Variablenwert festlegen.
Wählen Sie unter dem Knoten das Symbol "Knoten
hinzufügen" aus, nach dem Sie einen Variablenwertknoten festlegen möchten.Wählen Sie Variablenverwaltung>Eine Variable festlegen aus. Im Zeichenbereich wird ein Knoten zum Festlegen von Variablenwerten angezeigt.
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.
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.
- Eine Power Fx Formell verwenden. Power Fx-Formeln sind nützlich für komplexere Typen, bei denen keine Literalwerte verwendet werden können, z. B. Tabellen- und Datensatztypen.
Verwenden von Variablen in Aktionsknoten
Wenn Sie eine Variable in einem Aktionsknoten verwenden, wenn der Basistyp einem parametertyp entspricht, der für einen Fluss oder für eine Bot Framework-Fähigkeit angegeben ist, können Sie sie zu diesem Parameter feeden. Die Ausgabe von Aktionsknoten generiert neue Variablen.
Weitere Kontextinformationen finden Sie in den Beispielszenarien in " Aufrufen eines Agent-Flusses aus einem Thema " und "Verwenden von Eingabe- und Ausgabevariablen zum Übergeben von Informationen".
Verwenden von Literalwerten für Variableneingaben
In Knoten, in denen Sie einen Wert für Eingabeparameter festlegen können, können Sie immer einen Literalwert eingeben, anstatt eine andere Variable als Wert auszuwählen.
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.
In einigen Szenarien (z. B. Szenarien mit komplexen Typen) müssen Sie möglicherweise eine Power Fx Formel verwenden, um einen bestimmten Typ festzulegen.
Umgebungsvariablen für Azure Key Vault-Geheimnisse verwenden
Eine Umgebungsvariable kann auf ein Geheimnis im Key Vault verweisen. Geheime Umgebungsvariablen sind ein Sonderfall von Umgebungsvariablen mit besonderen Gesichtspunkten.
Um eine geheime Umgebungsvariable im Power Apps-Portal zu erstellen, müssen Sie den Key Vault konfigurieren.
Um das Lesen dieses Key Vault für Copilot Studio zu autorisieren, müssen Sie die folgenden Aktionen ausführen:
Weisen Sie der Anwendung Microsoft Copilot Studio Service die Rolle Key Vault Secrets User-Rolle zu.
Um alle Agents aus der Umgebung für den Zugriff auf das Geheimnis zu autorisieren, erstellen Sie ein Tag
AllowedEnvironmentsam Geheimnis und fügen Sie die zulässigen Umgebungs-IDs durch Kommas getrennt hinzu.Um nur bestimmten Agenten aus der Umgebung die Nutzung dieses Key Vaults zu erlauben, erstellen Sie ein
AllowedAgents-Tag und geben Sie die Agenten-Kennung im Format{envId}/{schemaName}ein. Trennen Sie die Werte bei mehreren Werte durch Kommas.Wenn Sie die maximale Anzahl an Zeichen erreicht haben, aber dennoch weitere Agenten hinzufügen müssen, fügen Sie ein weiteres Tag mit einem beschreibenden, aber eindeutigen Namen hinzu (zum Beispiel:
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 geheimen Schlüssels im Agent können Sie den Wert dieses geheimen Schlüssels verfügbar machen. Jeder, der den Agent in der Umgebung bearbeiten kann, kann einen Nachrichtenknoten hinzufügen und den Wert der variablen der geheimen Umgebung in einer Nachricht zurückgeben.
Variablenbereich
Im Bereich Variablen können Sie alle Variablen anzeigen, die für ein Thema verfügbar sind, unabhängig davon, in welchen Knoten sie definiert sind 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 ihre Eigenschaften im Bereich Variableneigenschaften zu bearbeiten.
Um den Bereich "Variablen " zu öffnen, wählen Sie "Variablen " in der Menüleiste des Themas aus.
Bereich „Variableneigenschaften“
Im Bereich "Variable Eigenschaften " können Sie eine Variable umbenennen, sehen, wo ihr Agent sie verwendet, oder sie in eine globale Variable konvertieren. Sie können eine globale Variable jedoch nicht wieder in eine Themen-Variable konvertieren. Sie können auch auswählen, ob eine Themenvariable Werte von anderen Themen empfangen oder ihren Wert an andere Themen übergeben kann.
Um den Bereich Variableneigenschaften für eine Variable zu öffnen, wählen Sie die gewünschte Variable im Bereich Variablen aus. Sie können auch den Bereich " Variableneigenschaften " von jedem Knoten aus öffnen, der Variablen verwendet, indem Sie die gewünschte Variable auswählen.
Variablen zwischen Themen übergeben
Wenn Sie ein Thema zu einem anderen umleiten, können Sie die Werte von Variablen vom ursprünglichen Thema an das Zielthema übergeben und auch Werte vom Zielthema an das ursprüngliche Thema zurückgeben. 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 Benutzer wissen sicherlich, dass sie nicht mehr als einmal dieselben Fragen beantworten müssen.
Werte aus anderen Themen empfangen
Wenn ein Thema eine Variable definiert (z. B. in einem Frageknoten), bittet der Agent den Benutzenden, den Wert der Variablen einzugeben. Wenn der Agent den Wert bereits in einem früheren Thema erfasst hat, gibt es keinen Grund, die Frage noch einmal zu stellen. In solchen Fällen können Sie die Variable als 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 Kundengespräch. Beide Themen fragen nach dem Namen des Kunden. Wenn das Thema Begrüßung jedoch zuerst ausgeführt wird, überspringt das Thema Mit dem Kunden sprechen diese Frage. Stattdessen wird der aus dem Thema Begrüßung übergebene Wert der Variable verwendet.
Der Flow des Themas Mit dem Kunden sprechen lautet wie folgt:
Wie im Testbereich gezeigt, wenn dieses Thema zuerst ausgelöst wird, fragt es den Benutzer: Wie soll ich Sie nennen? Der Wert wird in einer Zeichenfolgenvariablen mit dem Namen customerName gespeichert. Die Variable „customerName“ ist auch so festgelegt, dass sie ihren Wert aus anderen Themen abruft. Das Thema endet mit der Nachricht: Ich hoffe, Sie haben einen wundervollen Tag, customerName!
Der Flow des Themas Begrüßung lautet wie folgt:
Wie im Testbereich gezeigt, wenn dieses Thema zuerst ausgelöst wird, fragt es den Benutzer: Wie ist Ihr Name? Der Wert wird in einer Zeichenfolgenvariablen mit dem Namen customerName gespeichert. Das Thema sendet die Nachricht: Freut mich, Sie kennenzulernen, customerName! Anschließend wird zum Thema Mit Kunden sprechen weitergeleitet, in dem die Nachricht gesendet wird: Ich hoffe, Sie haben einen schönen Tag, customerName! Beachten Sie jedoch, dass im Thema Mit Kunden sprechen die erneute Frage nach dem Namen des Benutzers übersprungen wurde. Stattdessen wird der Wert der customerName-Variable aus dem Thema Begrüßung verwendet.
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. In unserem Beispielszenario wird das vordefinierte Thema Begrüßung als Quellthema und ein neues Thema Mit Kunden sprechen als Zielthema verwendet. Die gleichen Schritte gelten jedoch für jedes Thema, das nach Möglichkeit einen Wert aus einem früheren Thema verwenden soll.
Zielthema einrichten
Das Zielthema ist das Thema, zu dem umgeleitet wird, das Werte von anderen Themen empfängt. In unserem Beispiel ist es Mit dem Kunden sprechen.
Erstellen Sie ein neues Thema, und nennen Sie es „Mit Kunden sprechen“.
Fügen Sie Triggerausdrück wie Rede mit mir, Sprich mit mir, Chatte mit mir hinzu.
Fügen Sie einen Frageknoten hinzu, und geben Sie Wie soll ich Sie nennen? für die Nachricht ein.
Wählen Sie unter Identifizieren die vordefinierte Entität Personenname.
Der Name der festzulegenden Variablen auswählen. Der Bereich Variableneigenschaften wird geöffnet.
Ersetzen Sie den Standardnamen durch customerName und wählen Sie dann Werte von anderen Themen empfangen.
Einen Nachrichtenknoten hinzufügen.
Geben Sie in das Nachrichtenfeld Ich hoffe, Sie haben einen wunderbaren Tag ein.
Wählen Sie das Symbol Variable einfügen ({x}) und dann customerName aus.
Wählen Sie das Leerzeichen hinter der Variablen aus, und geben Sie „!“ ein.
Speichern Sie das Thema.
Datenquelle einrichten
Das Quellthema ist das Thema, das die Umleitung durchführt, das den Wert bereitstellt und an das Zielthema übergibt. In unserem Beispiel lautet es Begrüßung.
Wechseln Sie zum Thema Begrüßung und löschen Sie die Standardknoten mit Ausnahme des Trigger-Knotens.
Fügen Sie einen Frageknoten hinzu, und geben Sie Wie lautet Ihr Name? für die Nachricht ein.
Wählen Sie unter Identifizieren die vordefinierte Entität Personenname.
Ersetzen Sie den Standardnamen durch „customerNameFromGreeting“.
Einen Nachrichtenknoten hinzufügen.
Geben Sie im Nachrichtenfeld Freut mich, Sie kennenzulernen, ein.
Wählen Sie das Symbol Variable einfügen ({x}) und dann customerNameFromGreeting aus.
Wählen Sie das Leerzeichen hinter der Variablen aus, und geben Sie „!“ ein.
Fügen Sie einen Umleitungsknoten hinzu, und wählen Sie das Zielthema Mit Kunden sprechen aus.
Wählen Sie Eingabe hinzufügen und dann die Variable aus dem Zielthema aus, an das Sie einen Wert übergeben möchten.
Wählen Sie das > Symbol aus, und wählen Sie dann die Variable aus, deren Wert Sie übergeben möchten, in diesem Beispiel customerNameFromGreeting.
Der Umleitungsknoten sieht möglicherweise wie folgt aus:
Speichern Sie das Thema.
Werte an ursprüngliche Themen zurückgeben
In einem Agentensystem wird ein Thema dazu verwendet, spezifische Informationen zu sammeln. Mehrere andere Themen können sie aufrufen und erwarten, dass sie die Informationen als Variable zurückgibt. Die Variable wird Teil des ursprünglichen Themas und kann wie jede andere Variable verwendet werden. Informationen, die der Agent 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 Kunden sprechen und geben dann die Antwort im 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, das den Wert bereitstellt, der an das ursprüngliche Thema zurückgegeben werden soll. In diesem Beispiel ist das Quellthema Mit dem Kunden sprechen.
Wechseln Sie zum Quellthema.
Fügen Sie einen Frageknoten hinzu, und geben Sie Wo wohnen Sie? für die Nachricht ein.
Wählen Sie unter Identifizieren die vordefinierte Entität Stadt.
Wählen Sie die Variable aus, um den Bereich Variableneigenschaften zu öffnen. Nennen Sie es customerCity und wählen Sie dann Rückgabe von Werten an ursprüngliche Themenaus.
Einen Nachrichtenknoten hinzufügen.
Wählen Sie das Symbol Variable einfügen ({x}) und dann customerCity aus.
Geben Sie nach der Variablen im Nachrichtenfeld muss zu dieser Jahreszeit schön sein! ein.
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 Werte vom aktuellen Thema empfängt. In unserem Beispiel lautet das Zielthema Begrüßung.
Wechseln Sie zum Zielthema.
Die Variable, die Sie im Quellthema ausgewählt haben, sollte auf dem Knoten Umleiten als Ausgabevariable angezeigt werden.
Speichern Sie das Thema.
Analysieren von Werten
Mit dem Knoten Wert parsen können Sie einen Wert eines Typs in den Wert eines anderen Typs konvertieren. Ein gängiger Anwendungsfall für den Parse-Wertknoten ist das Konvertieren von unformatiertem JSON.A use case for the Parse value node is to convert raw JSON. Beispielsweise ruft ein Agent einen Fluss auf, der wiederum eine API aufruft. Die App gibt dann ein Ergebnis zurück. Jetzt benötigen Sie eine Möglichkeit, dieses Ergebnis zu analysieren und eine oder mehrere Grundtypvariablen zurückzugeben. Mit dem Knoten " Parse-Wert " können Sie das gesamte API-Ergebnis als Zeichenfolge senden, z. B. folgendes:
{
"Name": "Parker",
"Position": "Product manager",
"Company": "Contoso",
"FormerPositions": [{
"Position": "Customer service representative"
}
]
}
Der Parse-Wert-Knoten kann die aktuelle Zeichenfolgenvariable in eine Variable vom Typ Record umwandeln, für die der Power Fx-Editor IntelliSense-Codevervollständigung und Vorschläge bietet.
Neben dem Parsen von JSON-Zeichenfolgen ist eine wichtige Verwendung des Parse-Wert-Knotens das Parsen von nicht typisierten Objekten zur Laufzeit. Der häufigste Anwendungsfall ist, wenn Sie ein Ereignis empfangen und den Ereigniswert analysieren müssen. Oder Sie möchten die System.Activity.ChannelData Eigenschaft analysieren, die zur Laufzeit nach Kanal variiert.
Wenn Sie Informationen aus einem Ereignis analysieren müssen, das von Teams stammt, finden Sie in der Teams-Entwicklerdokumentation ein Beispiel dafür, wie das erwartete Ereignis aussehen könnte. Anschließend können Sie den Anweisungen in diesem Abschnitt folgen, indem Sie das Beispielereignis als Beispieldaten verwenden.
So fügen Sie einem Thema einen Parse-Wertknoten hinzu:
Wählen Sie das Symbol "Knoten
hinzufügen" unter dem Knoten aus, nach dem Sie einen Wert analysieren möchten, zeigen Sie auf die Variable-Verwaltung, und wählen Sie "Analysewert" aus.Fügen Sie einen Knoten Wert parsen hinzu, und wählen Sie die Variable aus, die Sie parsen möchten.
Wählen Sie den Datentyp aus. Wählen Sie in diesem Fall Aus Beispieldaten.
Wählen Sie " Schema aus Beispiel-JSON abrufen" aus, geben Sie das gewünschte JSON-Beispiel in den editor ein, der geöffnet wird, und wählen Sie "Bestätigen" aus.
Wählen Sie schließlich die Variable aus, um den analysierten Wert zu halten. Normalerweise erstellen Sie eine neue Variable.
Die Ausgabevariable hat nun den erwarteten Typ: Record.
