Ein- und Ausgabevariablen zur Weitergabe von Informationen verwenden

Verwenden Sie Variablen als Eingabe- und Ausgabeparameter, um Informationen zwischen Agent-Flows und Copilot Studio-Agents zu übertragen.

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

Voraussetzungen

• Verstehen, wie ein Flow aus der Copilot Studio Canvas erstellt wird

Unterstützte Parametertypen

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

• Zahl
• Zeichenfolge
• Boolesch

Die folgenden Datentypen werden nicht unterstützt:

• Objekt
• Datum
• Zeitstempel
• Liste [Zeichenfolge]
• Liste [Nummer]
• Liste [Boolesch]
• Liste [Objekt]
• Liste [Datum]
• Liste [Zeitstempel]

Ein Thema und einen Flow erstellen

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

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.

   

7. Wählen Sie das Symbol Knoten hinzufügen unter dem Frage-Knoten aus, und wählen Sie Tool hinzufügen aus.

8. Wählen Sie auf der Registerkarte Grundlegende Aktionen die Option Neuer Agentflow aus. Die Registerkarte Agent-Flow-Designer wird mit einer Startvorlage für einen Agent-Flow geöffnet, der von einem Agenten aufgerufen wird. Der Flow umfasst zwei Aktionen: Wenn ein Agent den Flow aufruft und An den Agenten antworten.

9. Wählen Sie Veröffentlichen aus, um den Flow zu speichern, bevor Sie Änderungen vornehmen. Eine Benachrichtigung wird angezeigt, wenn der Flow erfolgreich erstellt wurde.

10. Wählen Sie Zurück zum Agent aus, um zu Ihrem Thema zurückzukehren. Ihrem Thema für den Flow wird ein neuer Aktionsknoten hinzugefügt.

11. Wählen Sie Speichern aus, um das Hinzufügen des Flows als Tool zu Ihrem Agent abzuschließen.

Flow-Details bearbeiten

1. Wählen Sie im Knoten Aktion mit dem Flow den Link Flow-Details anzeigen, um zum Agent-Flow zurückzukehren.

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

3. Rückkehr zur Registerkarte Designer.

Ein Eingabeparameter dem Flow hinzufügen

1. Wählen Sie den Wenn ein Agent den Flow aufruft Flow-Trigger und dann Eingabe hinzufügen aus.

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

   

Ein Ausgabeparameter dem Flow hinzufügen

1. Wählen Sie die Antwort-Aktion Agent antworten und dann Ausgabe hinzufügen aus.

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

   

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 dann Veröffentlichen. Copilot Studio informiert Sie, wenn der Agent-Flow veröffentlicht wird.

5. Wählen Sie Zurück zum Agenten aus, um zum Agententhemen-Editor zurückzukehren. Der neue Aktionsflow wird dem Thema hinzugefügt.

Aufrufen des Flows aus dem Thema

1. Wählen Sie den neuen Aktionsknoten.

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

   

3. Einen Nachrichtenknoten hinzufügen.

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

   

5. Wählen Sie Speichern aus.

6. Testen Sie Ihren Agenten.

   

Zugehöriger Inhalt

• Variablenübersicht