Freigeben über

Ein- und Ausgabevariablen zur Weitergabe von Informationen verwenden

Verwenden Sie Variablen als Eingabe- und Ausgabeparameter, um Informationen zwischen Agentflüssen und Copilot Studio-Agents zu übergeben.

Wichtig

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

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

Anforderungen

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

Unterstützte Parametertypen

Copilot Studio-Agents unterstützen die folgenden Arten von Eingabe- und Ausgabeparametern für Agentflüsse:

  • Number
  • String
  • Boolesch

Die folgenden Datentypen werden derzeit nicht unterstützt:

  • Object
  • Date
  • Zeitstempel
  • Liste [Zeichenfolge]
  • Liste [Zahl]
  • Liste [Boolean]
  • List [Object]
  • Liste [Datum]
  • Liste [Zeitstempel]

Ein Thema und einen Flow erstellen

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

  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. Benennen Sie die Variable für Benutzerantwort speichern unter in userResponse um.

    Screenshot eines Frageknotens, der die Antwort des Benutzers erfasst.

  7. Wählen Sie unter dem Frageknoten das Symbol " Knoten hinzufügen" und dann "Tool hinzufügen" aus.

  8. Wählen Sie auf der Registerkarte "Grundlegende Aktionen " den Befehl "Neuer Agent"-Fluss aus. Die Registerkarte "Agent Flow Designer" wird mit einer Startvorlage für einen Agentfluss geöffnet, der von einem Agent aufgerufen wird. Der Ablauf umfasst zwei Aktionen: Wenn ein Agent den Fluss aufruft und auf den Agent reagiert.

  9. Wähen Sie Entwurf speichern aus.

  10. Bearbeiten Sie auf der Registerkarte "Übersicht " des Flusses die Details für den Fluss, und ersetzen Sie den Namen durch den Echo-Parameter. Wählen Sie "Speichern" aus.

  11. Kehren Sie zur Registerkarte "Designer " zurück.

Ein Eingabeparameter dem Flow hinzufügen

  1. Wählen Sie " Wenn ein Agent den Flussflusstrigger aufruft " aus, und wählen Sie "Eingabe hinzufügen" aus.

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

    Screenshot vom Hinzufügen von Eingabeparametern für den Flow-Trigger.

Ein Ausgabeparameter dem Flow hinzufügen

  1. Wählen Sie die Antwortaktion des Agents aus, und wählen Sie "Ausgabe hinzufügen" aus.

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

    Screenshot des Ausgabeparameters für die Antwortaktion.

  3. Geben Sie als Wert einen Schrägstrich (/) in das Feld ein, wählen Sie Dynamischen Inhalt einfügen und dann die String_Input Variable aus.

  4. Wählen Sie "Entwurf speichern " und "Veröffentlichen" aus. Copilot Studio informiert Sie, wenn der Agentfluss veröffentlicht wird.

  5. Wählen Sie "Zurück zum Agent" aus, um zum Agentthema-Editor zurückzukehren. Der neue Aktionsfluss wird dem Thema hinzugefügt.

Rufen Sie den Flow aus dem Thema auf

  1. Wählen Sie den neuen Aktionsknoten aus.

  2. Legen Sie den Flow-Eingabeparameter auf die Ausgabevariable des Frageknotens fest: String_Input (Zeichenfolge) ruft seinen Wert aus der userResponse-Variablen ab.

    Screenshot des Aktionsknotens, der den Flow Echo-Parameter aufruft.

  3. Einen Nachrichtenknoten hinzfügen.

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

    Screenshot des Nachrichtenknotens, der die Benutzereingabe wiedergibt.

  5. Wählen Sie Speichern.

  6. Testen Sie Ihren Agenten.

    Screenshot einer Agent-Unterhaltung.

Zugehöriger Inhalt

  • Last updated on