Variablen in Copilot Studio: Themen, globale und Systemvariablen

Variablen in Copilot Studio speichern Angaben, die ein Agent im Gespräch erfährt oder berechnet: den Namen des Nutzers, eine Bestellnummer, das Ergebnis eines Werkzeugs. Ohne Variablen könnte ein Agent nichts weitergeben und nichts wiederverwenden. Wer die Arten kennt, baut übersichtlichere und robustere Agenten.

Die vier Arten

• Themenvariablen entstehen, wenn ein Knoten etwas abfragt oder berechnet. Sie gelten nur im jeweiligen Thema, können aber an andere Themen übergeben oder von ihnen empfangen werden.
• Globale Variablen gelten im gesamten Gespräch, etwa eine einmal abgefragte Kundennummer, die mehrere Themen brauchen.
• Systemvariablen stellt Copilot Studio bereit, etwa Angaben zum angemeldeten Nutzer oder zur letzten Nachricht.
• Umgebungsvariablen halten Werte, die sich zwischen Entwicklung, Test und Produktion unterscheiden, etwa Adressen von Schnittstellen.

Angaben abfragen mit Entitäten

Ein Frage-Knoten speichert die Antwort in einer Variable. Mit Entitäten legen Sie fest, welche Art von Angabe erwartet wird: Zahl, Datum, E-Mail-Adresse, eine Auswahl aus einer Liste oder ein eigenes Muster. So erkennt der Agent auch „nächsten Dienstag“ als Datum und fragt nach, wenn eine Eingabe nicht passt.

Rechnen und prüfen mit Power Fx

Für Berechnungen und Bedingungen nutzt Copilot Studio die Formelsprache Power Fx, die auch in Power Apps vorkommt. Beispiele: Texte zusammensetzen, Datumswerte vergleichen oder prüfen, ob eine Variable leer ist. Halten Sie Formeln kurz und benennen Sie Variablen sprechend, etwa Bestellnummer statt Var1.

Variablen und generative Orchestrierung

Bei generativer Orchestrierung kann der Agent Eingaben für Themen und Werkzeuge selbst aus dem Gespräch füllen. Dafür braucht jede Eingabevariable eine klare Beschreibung: Was bedeutet sie, in welchem Format wird sie erwartet? In den Anweisungen des Agenten lassen sich Variablen außerdem mit „/“ direkt referenzieren. Wie Anweisungen insgesamt aufgebaut werden, zeigt der Generator für Copilot-Studio-Anweisungen; gute Beschreibungen erstellt der Generator für Agent-Beschreibungen.

Typische Fehler

1. Alles global: Zu viele globale Variablen machen Agenten unübersichtlich und führen zu alten Werten in neuen Abläufen.
2. Keine Prüfung auf leere Werte: Ein Werkzeug wird mit fehlender Angabe aufgerufen und schlägt fehl.
3. Feste Werte im Thema: Adressen oder Kennungen gehören in Umgebungsvariablen, sonst bricht der Agent beim Umzug in die Produktion.
4. Sensible Daten in Variablen: Passwörter oder Gesundheitsdaten haben im Gespräch nichts zu suchen.

Wie Themen und Variablen zusammenspielen, beschreibt Themen in Copilot Studio. Den Umzug zwischen Umgebungen erklärt die Anleitung Agent als Lösung exportieren.

Werte aus Werkzeugen nutzen

Ruft ein Thema ein Werkzeug auf, etwa einen Agent Flow zur Bestellabfrage, landen dessen Ausgaben ebenfalls in Variablen. Prüfen Sie diese, bevor Sie sie weiterverwenden: Liefert der Flow keinen Treffer, sollte der Agent das freundlich sagen, statt eine leere Antwort zu zeigen. Bei komplexen Ausgaben wie Listen helfen Power-Fx-Formeln, einzelne Werte herauszuziehen.