Freigeben über

Einen Agentenflow aufrufen

Erfahren Sie, wie Sie einen Agentenfluss in Copilot Studio verwenden, indem Sie einem Agenten die Möglichkeit geben, eine Wettervorhersage auf Anfrage zu erstellen.

Anforderungen

Dieses Beispiel hängt von einem vorherigen Beispiel ab, in dem Sie einen Agentenablauf erstellt haben, der eine Wettervorhersage abruft.

Falls Sie den Wettervorhersageflow nocht nicht erstellt haben, macheb Sie dies nun.

Einen Agentflow von einem Agent aufrufen

Hier zeigen wir, wie Sie einem Agenten den Wettervorhersageflow als Tool hinzufügen. Mit dieser Methode kann der Agenten-Orchestrator den Ablauf aufrufen, wenn er eine Wettervorhersage bereitstellen muss.

  1. Wählen Sie im linken Navigationsbereich in Copilot Studio Agents aus, und wählen Sie den Agent aus, dem Sie den Fluss hinzufügen möchten.

  2. Wechseln Sie zur Seite "Extras ", und wählen Sie "Tool hinzufügen" aus.

  3. Wählen Sie "Flow" aus, um die Liste der verfügbaren veröffentlichten Flüsse anzuzeigen.

  4. Wählen Sie den zuvor erstellten Wettervorhersagefluss aus.

  5. Wählen Sie "Hinzufügen" und "Konfigurieren" aus.

    Der Flow wird Ihrem Agenten hinzugefügt und in der Liste der Tools für den Agenten angezeigt. Der Konfigurationsbereich für das Tool, das vom Agent verwendet wird, wird geöffnet. Sie können diesen Bereich verwenden, um das Tool für den Agent zu konfigurieren.

  6. Geben Sie unter Name und Beschreibung einen Anzeigenamen für das Tool und eine klare Beschreibung ein, die dem Agent Orchestrator hilft, zu verstehen, wann der Ablauf verwendet werden soll. Beispiel: "Abrufen der wettervorhersage von heute bei einem angegebenen Ortsnamen oder Postleitzahl"

  7. Wählen Sie unter "Eingaben" aus, wie der Agent den Variablenwert ausfüllen soll.

  8. Wählen Sie unter Abschluss aus, was der Agent tun soll, nachdem er das Tool verwendet hat.

  9. Wenn Sie mit der Konfiguration fertig sind, wählen Sie "Speichern" aus.

Rufen Sie einen Agent-Flow aus einem Thema auf

Hier zeigen wir, wie Sie einen Aktionsknoten in einem Thema verwenden, um den Fluss aufzurufen, wenn ein Kunde nach dem Wetter fragt.

  1. Gehen Sie in Copilot Studio zur Themen-Seite für Ihren Agent.

  2. Erstellen Sie ein neues Thema und benennen Sie es Wetter abrufen.

  3. Fügen Sie folgende Triggerphrasen hinzu:

    • Wird es regnen
    • Heutige Vorhersage
    • Wetter abrufen
    • Wie ist das Wetter

    Screenshot der Triggerausdrücke für das Thema Wetter abrufen.

  4. Wählen Sie das Knoten hinzufügen Symbol unter dem Trigger-Knoten und wählen Sie Nachricht senden.

  5. Geben Sie im Nachricht-Knoten den Text Ich kann Ihnen dabei helfen. im Textfeld ein.

  6. Wählen Sie das Symbol Knoten hinzufügen unter dem Nachrichten-Knoten aus, um Eine Frage stellen dem Knoten Frage für die erste Information für Ihren Flow Stadt, hinzuzufügen.

  7. Für den Frage-Knoten:

    1. Geben Sie die Frage Was ist Ihre Stadt? in das Textfeld ein.
    2. Unter Identifizieren wählen Sie Gesamte Antwort des Benutzers aus.
    3. Notieren Sie sich den Namen der Variablen, Var1, die dieser Antwort zugeordnet ist. Sie können den Namen unverändert lassen oder durch einen aussagekräftigeren Namen wie Stadt ersetzen (siehe Umbenennen einer Variablen, falls erforderlich).

  8. Gehen Sie auf die gleiche Weise vor, um einen weiteren Frageknoten für die andere Information für Ihren Flow , die Postleitzahl, hinzuzufügen:

    1. Geben Sie die Frage Wie lautet Ihre Postleitzahl? in das Textfeld ein.
    2. Wählen Sie unter Identifizieren die Option Nummer aus.
    3. Notieren Sie sich den Namen der Variablen, Var2, die dieser Antwort zugeordnet ist. Sie können den Namen unverändert lassen oder durch einen aussagekräftigeren Namen (z. B. ZIPcode) ersetzen.

  9. Wählen Sie das Symbol "Knoten hinzufügen" unter dem Frageknoten für die Postleitzahl aus, wählen Sie "Tool hinzufügen" und dann den zuvor erstellten Fluss "Wettervorhersage abrufen" aus.

  10. Ordnen Sie die Flow-Eingaben den Ausgabevariablen der Frageknoten zu. Stadt (Zeichenfolge) ruft ihren Wert von Var1 ab (oder City wenn Sie sie umbenannt haben) und Postleitzahl (Zahl) ruft ihren Wert von Var2 ab (oder ZIPcode wenn Sie sie umbenannt haben).

    Screenshot des Aktionsknotens, der die Eingabe- und Ausgabeparameter des Flows Wettervorhersage abrufen anzeigt

  11. Fügen Sie unter dem Knoten Aktion einen Knoten Nachricht hinzu und geben Sie eine Nachricht ein,die die Ausgabeinormation vom Flow verwendet. Zum Beispiel:

    Heutige Vorhersage für location: day_summary
    Niederschlagswahrscheinlichkeit beträgt chance_of_rain%
    Dabei handelt es sich um locationday_summarychance_of_rain, Ausgabeparameter aus Ihrem Flow.

    Screenshot des Nachrichtenknotens mit einer Nachricht, die Ausgabeparameter aus dem Flow verwendet.

  12. Wählen Sie Speichern.

Einen in einem Thema verwendeten Agentenflow verwalten

Sobald Sie einen Aktionsknoten haben, der einen Flow aufruft, können Sie die folgenden Optionen aus dem Menü des Knotens verwenden, um den Flow zu verwalten:

  • Löschen löscht den Knoten endgültig und der Flow wird aus dem Thema entfernt.

  • Aktualisieren lädt den Flow neu, um alle Änderungen zu übernehmen, die Sie in Power Automate vorgenommen haben, und validiert sie im Thema. Sie müssen alle Probleme mit dem Flow beheben, bevor Sie das Thema speichern können.

Wenn Sie einen anderen Flow auswählen oder erstellen möchten, verwenden Sie das Symbol Flow ändern Symbol , das angezeigt wird, wenn Sie über den Flow in Ihrem Aktions-Knoten fahren.

Testen Sie Ihren Flow und das Thema

Es ist eine gute Idee, den Flow und das Thema, das ihn aufruft, zu testen.

Geben Sie im Bereich Testen Sie Ihren Agent eine der Triggerphrasen des Themas ein, um eine Unterhaltung mit dem Agenten zu beginnen. Geben Sie Ihren Ort und Ihre Postleitzahl ein, wenn der Agent danach fragt. Stellen Sie sicher, dass der Agent die heutige Wettervorhersage für Ihre Stadt zurückgibt und dass die Nachricht wie erwartet aussieht.

Screenshot eines Testchats mit Informationen aus dem Tool

Problembehandlung für Ihren Agent

Testen Sie Ihren Agent immer, wenn Sie Änderungen an Ihren Themen und Flows vornehmen, um sicherzustellen, dass alles wie erwartet funktioniert. Wenn ein Agent während einer Unterhaltung auf ein Problem stößt, antwortet er mit einer Fehlermeldung.

Die meisten Flow bezogenen Probleme im Flow-Prüfern finden Sie auf der Registerkarte Flow-Designer. Verwenden Sie die Themenprüfung, um Probleme mit dem Erstellungsbereich zu identifizieren.