Eingabe- und Ausgabevariablen hinzufügen

Wichtig

Power Virtual Agents-Fähigkeiten und -Funktionen sind jetzt Teil von Microsoft Copilot Studio nach erheblichen Investitionen in generative KI und verbesserte Integrationen in Microsoft Copilot.

Einige Artikel und Screenshots beziehen sich möglicherweise auf Power Virtual Agents während wir Dokumentation und Schulungsinhalte aktualisieren.

Verwenden Sie Variablen als Eingabe- und Ausgabeparameter, um Informationen zwischen Power Automate-Flows und Microsoft Copilot Studio-Copiloten weiterzugeben.

Wichtig

Ein Copilot kann nur bis zu 1 MB Daten von einem Flow in einer einzigen Aktion empfangen. Es gibt jedoch keine Begrenzung hinsichtlich der Datenmenge, die ein Copilot senden kann, oder der Anzahl der Variablen, die ein Copilot weitergeben kann.

In diesem Beispiel erstellen Sie einen Flow mit einem Eingabeparameter und geben ihn als Ausgabeparameter an einen Copiloten zurück.

Anforderungen

  • Verstehen, wie ein Flow über den Copilot Studio-Erstellungsbereich erstellt wird

Unterstützte Parametertypen

Copiloten können die folgenden Arten von Ein- und Ausgaben mit Power Automate-Flows verwenden:

  • Number
  • String
  • Boolesch

Folgende Typen werden nicht unterstützt:

  • Object
  • Date
  • Zeitstempel
  • List [String]
  • List [Number]
  • List [Boolean]
  • List [Object]
  • List [Date]
  • List [Timestamp]

Thema und Flow erstellen

  1. Gehen Sie zur Themenseite für Ihren Copiloten.

  2. Erstellen Sie ein neues Thema mit dem Namen Echo-Nachricht.

  3. Fügen Sie die Triggerausdrücke Echo hinzu.

  4. Fügen Sie einen Knoten Frage hinzu und geben Sie die Nachricht Sag mir etwas und ich sage es dir zurück ein

  5. Zum Identifizieren wählen Sie Gesamte Antwort des Benutzers aus.

  6. Für Antwort speichern unter wählen Sie das Stiftsymbol aus und benennen Sie die Variable um in userResponse.

    Bildschirmfoto der Hinzufügung eines Frageknotens.

  7. Wählen Sie im Erstellungsbereich Knoten hinzufügen (+) aus. Wählen Sie Handlungsaufforderung und wählen Sie dann Einen Flow erstellen.

  8. In dem Power Automate Portal, benennen Sie den Flow Echo Parameter.

Eingabeparameter für den Flow hinzufügen

  1. In dem Flowauslöser Microsoft Copilot Studio wählen Sie Eine Eingabe hinzufügen.

    Screenshot eines Auslösers für einen Microsoft Copilot Studio Flow, mit hervorgehobenem „Add an input“.

  2. Wählen Sie Text und geben Sie den Namen String_Eingabe ein.

    Screenshot des Azure -Flow-Triggers.

Ausgabeparameter für den Flow hinzufügen

  1. In der Antwortaktion Rückgabewerte an Microsoft Copilot Studio wählen Sie Eine Ausgabe hinzufügen aus.

    Screenshot der Flow-Antwortaktion mit hervorgehobener Ausgabe hinzufügen.

  2. Wählen Sie Text und geben Sie den Namen String_Output ein.

    Screenshot der Antworausgabeaktion.

  3. Für den Wert String_Output wählen Sie die Variable String_Input.

    Screenshot eines Eingabeparameters, der als Wert eines Ausgabeparameters ausgewählt wurde.

  4. Wählen Sie Speichern.

Variablen im Copilot-Thema auswählen

  1. Im Microsoft Copilot Studio Erstellungsbereich wählen Sie Knoten hinzufügen (+) und wählen Sie dann Rufen Sie eine Aktion auf.

  2. Wählen Sie den zuvor erstellten Flow Echo Parameter aus.

  3. Für String_Input(Text) erhält Wert von wählen Sie userResponse.

  4. Einen Nachrichtenknoten hinzfügen. Wählen Sie Variable einfügen und dann String_Output aus.

    Screenshot vom Aktionsknoten für den Echo Parameterflow

  5. Testen Sie Ihr Thema im Bereich Copilot testen.

    Screenshot einer Copilot-Unterhaltung.

Verwenden Sie optional Literalwerte für Eingabeparameter

Wenn Sie alternativ lieber einen Literalwert für einen Aktionseingabeparameter eingeben möchten, anstatt eine Variable als Aktionseingabe zu verwenden, können Sie den Wert direkt in das Feld Wert abrufen von eingeben.

Screenshot eines als Eingabeparameter übergebenen Literalwerts.

Variablen verwenden