Arbeiten mit Variablen in Ihrem Copilot Studio-Agent

Mit Microsoft Copilot Studio können Sie Variablen verwenden, um wichtige Informationen zu speichern, die vom Kunden zur späteren Verwendung eingegeben werden. Sie können beispielsweise den Namen eines Kunden in einer Variablen namens varName speichern. Diese Variable kann in Unterhaltungsknoten eingefügt werden, um eine persönlichere Erfahrung für den Kunden zu schaffen, z. B. das Einfügen in den Knoten Nachricht, damit der Agent den Kunden im weiteren Verlauf der Konversation mit seinem Namen ansprechen kann.

Mithilfe von Variablen können Kunden dynamisch auf verschiedenen Konversationspfaden weitergeleitet werden. Sie können auch als Eingabeparameter in Workflows eingespeist werden. Beispielsweise kann die Stadt, in der der Kunde lebt, in einer Variablen gespeichert werden. Wenn ein Workflow ausgeführt wird, kann die Variable als Eingabeparameter übergeben werden, um sicherzustellen, dass der Wetterdienst die richtige Prognose erhält.

Viele Variablentypen sind mit sofort einsatzbereiten und im benutzerdefinierten Entitäten verknüpft, die im Agent definiert sind. Für Ihre Referenz stehen eine vollständige Liste der Variablentypen zur Verfügung.

Variablen erstellen

Variablen werden automatisch erstellt, wenn Sie einen Fragenknoten zu einem Thema hinzufügen, und können im Abschnitt Benutzerantwort speichern als bearbeitet werden. Wenn ein Fragenknoten eingefügt wird, wird er standardmäßig mit Multiple-Choice-Optionen erstellt. Sie können jedoch jede vorgefertigte oder benutzerdefinierte Entität verwenden, indem Sie sie unter Identifizieren auswählen.

Eine Variable umbenennen

Wenn eine Variable automatisch erstellt wird, wird ihr ein Standardname oder etwas wie Var1, Var2 gegeben, was nicht beschreibend ist. Falls gewünscht, können Sie eine Variable umbenennen, indem Sie sie auswählen und dann einen neuen Namen im Bereich Variableneigenschaften eingeben. Dadurch wird die spätere Identifizierung bei Bedarf erleichtert.

Variablen zwischen Themen übergeben

Eine häufige Aktion in einem Microsoft Copilot Studio Agent besteht darin, von einem Thema zu einem anderen umzuleiten, z. B. das Senden einer Person an die Store Hours Thema, nachdem sie begrüßt wurden. Sie können Werte an Variablen im Zielthema übergeben, wenn Sie zu einem anderen Thema umleiten. Sie können auch Werte an Variablen im ursprünglichen Thema zurückgeben.

Das Übergeben von Variablen zwischen Themen ist besonders hilfreich, wenn Sie bereits Informationen haben, die das Thema benötigt. Benutzende werden es zu schätzen wissen, wenn sie die Fragen nicht erneut beantworten müssen. Wenn Sie zum Beispiel den Namen des Benutzers bereits im Thema Begrüßung erfasst haben und wissen, dass der Name des Benutzers in dem Thema Ladenzeiten verwendet wird, zu dem Sie umleiten, können Sie den Benutzernamen einfach an das Thema Ladenzeiten übernehmen, wenn Sie zum Thema umleiten.

Werte aus anderen Themen empfangen

Wenn Sie eine Variable in einem Thema festlegen (z. B. durch Einfügen eines Frageknotens), wird die Antwort des Benutzers auf die Fragen in die dieser Frage zugeordnete Variable eingefügt. Da Sie bereits über den Wert verfügen, müssen Sie die Frage nicht erneut stellen. Sie können in diesen Fällen die Variable als Werte aus anderen Themen empfangen festlegen.

Das heißt, dass ein Thema, das zu diesem umleitet, eine Variable an diesen Wert übergeben und die Frage überspringen kann. Die Erfahrung für den Benutzer, der mit dem Agent kommuniziert, wird nahtlos.

Sie müssen beim Konfigurieren Ihres Umleitungsknotens festlegen, welche Variable Sie im Zielthema ausfüllen möchten. Nachdem Sie angegeben haben, welche Variable Sie im Zielthema festlegen möchten, geben Sie an, welcher Wert im aktuellen Thema genutzt wird. Zum Beispiel leiten wir in der Abbildung unten zu einem Thema mit dem Namen Standort weiter Die Variable UserCity im Thema Standort wird auf eine Textvariable mit dem Namen Standort aus dem Weiterleitungsthema festgelegt.

Weitere Informationen und schrittweise Anleitungen, um Werte aus anderen Themen zu empfangen, finden Sie unter Werte aus anderen Themen empfangen.

Werte an ursprüngliche Themen zurückgeben

Die Variable kann an das ursprüngliche Thema zurückgegeben werden, das darauf umgeleitet hat, wenn ein Thema eine Frage stellt oder auf andere Weise eine Variable von einer Aktion erhält.

In diesem Fall wird die Variable auch zu einem Teil des ursprünglichen Themas und kann wie jede andere Variable verwendet werden. Dies unterstützt Sie dabei, das Thema so zu konstruieren, dass Informationen, die der Agent erhält, themenübergreifend verfügbar sind, wodurch der Bedarf an globalen Variablen reduziert wird.

Weitere Informationen und schrittweise Anleitungen finden Sie unter Werte an ursprüngliche Themen zurückgeben.

Weitere Informationen zum Arbeiten mit Variablen finden Sie unter "Arbeiten mit Variablen".

Globale Variablen

Standardmäßig kann der Wert einer Variablen nur in dem Thema verwendet werden, in dem die Variable erstellt wurde. Wenn Sie zum Beispiel eine Variable UserCity in einem Thema „Wetter prüfen“ erstellen, können Sie sie nur in Elemente wie Nachrichtenknoten innerhalb des Themas „Wetter prüfen“ einfügen. Diese werden als Variablen auf Themenebene bezeichnet. Es können jedoch Szenarien auftreten, in denen Sie denselben Wert für mehrere Themen verwenden möchten. Agents können sich an den variablen Kontext erinnern, wenn eine Unterhaltung mehrere Themen umfasst.

Zum Beispiel könnte in einem Willkommen-Thema nach dem Namen und der E-Mail-Adresse des Kunden gefragt werden. Wenn die Unterhaltung zu einem anderen Thema wechselt, z. B. Terminbuchung, möchten Sie vielleicht, dass sich der Agent an den Namen und die E-Mail-Adresse des Kunden erinnert.

In Microsoft Copilot Studio werden diese Variablen als GlobalVariablen bezeichnet. Auf sie kann von jedem anderen Thema im Agent zugegriffen werden.

Standardmäßig gelten globale Variablen nur während der aktuellen Sitzung. Sie können angeben, welche Variablen als globale Variablen behandelt werden sollen, um sie von Variablen auf Themenebene zu unterscheiden.

Definieren einer globalen Variablen

Um eine Variable als global zu definieren, wählen Sie die Variable direkt aus einem Knoten oder im Menü Variablen in der oberen Menüleiste aus. In der Regel navigieren Sie zum Knoten Frage zuerst auf die Variable verweist, mit der Sie arbeiten möchten.

Wählen Sie im Bereich Variableneigenschaften unter Verwendung die Option Global (jedes Thema kann zugreifen) aus.

Beispielsweise wird die Variable UserName jetzt als Global.UserName angezeigt. Stellen Sie beim Konvertieren einer Themenvariablen in eine globale Variable sicher, dass der Variablenname für alle Themen eindeutig ist. Wenn ein Namenskonflikt auftritt, müssen Sie die Variable umbenennen, bevor Sie Ihre Änderung speichern.

Verwenden von globalen Variablen

Nachdem eine globale Variable erstellt wurde, steht sie allen Themen zur Verfügung. Wählen Sie beim Arbeiten mit einem Nachrichten- oder Frageknoten die Schaltfläche "{x} " aus, und navigieren Sie zur Registerkarte " Benutzerdefiniert ". Dadurch wird eine Liste aller variablen angezeigt, die im aktuellen Thema verfügbar sind. Variablen werden in alphabetischer Reihenfolge sortiert und nach ihrem Typ Verwendung gruppiert, d. h. Global und Thema.

Wenn Sie einen Bedingungsknoten, einen Workflowknoten oder einen Toolknoten verwenden, können Sie auch globale Variablen sehen, die dort verfügbar sind.

Globale Variablen verwalten

Wenn Sie eine globale Variable zur Verwendung in mehreren Themen erstellen, ist es wichtig zu verstehen, wo sie angewendet wird. Sie können leicht feststellen, wo die Variable ursprünglich definiert wurde, indem Sie Referenz überprüfen, und andere Themen identifizieren, die sie verwenden, indem Sie Alle Referenzen anzeigen auswählen. Diese Funktion ist besonders hilfreich bei der Entwicklung eines neuen Agents oder bei der Verwaltung mehrerer Variablen innerhalb komplexer Themenverzweigungen.

Der Abschnitt Referenzen umfasst zwei Hauptoptionen:

• Referenz: Zeigt an, wo die Variable aktuell definiert ist.

• Alle Referenzen anzeigen: Listet alle Themen und Knoten auf, in denen die Variable verwendet wird, sodass Sie direkt zu jedem referenzierten Thema und Knoten wechseln können.

  

Den Wert einer globalen Variablen aus externen Quellen festlegen

Sie können eine globale Variable auf eine Art und Weise festlegen, dass sie mit einer externen Quelle initialisiert wird. So kann der Agent die Unterhaltung mit einem gewissen Kontext beginnen.

Beispiel: Ein Kunde ruft einen Chat auf Ihrer Website auf. Sie kennen bereits den Namen des Kunden, wenn dieser auf Ihrer Website angemeldet ist. Indem diese Informationen vor Beginn der Unterhaltung an den Agent weitergegeben werden, kann dieser eine intelligentere Unterhaltung mit dem Kunden führen, ohne erneut nach seinem Namen fragen zu müssen.

Sie können festlegen, dass eine Variable ihre Werte aus einer externen Quelle beziehen kann. Öffnen Sie den Bereich Variableigenschaften, und wählen Sie im Abschnitt Verwendung das Feld Externe Quellen können Wert festlegen aus.

Weitere Informationen zum Arbeiten mit globalen Variablen finden Sie unter Arbeiten mit globalen Variablen.

Als Nächstes befassen wir uns mit Systemthemen.