Freigeben über

Einen Agentflow als Werkzeug erstellen

Erfahren Sie, wie Sie einen Cloud-Flow in Copilot Studio verwenden, indem Sie einem Agent die Möglichkeit geben, auf Anfrage eine Wettervorhersage zu erstellen. In diesem ersten Beispiel erstellen Sie einen Flow, der eine Wettervorhersage abruft. Im nächsten Beispiel richten Sie ein Thema ein, um den Flow als Aktion aufzurufen, damit der Agent mit der Vorhersage antworten kann, wenn ein Kunde nach dem Wetter fragt.

Ein Agenten-Flow benötigt Folgendes, um als Werkzeug mit Agenten arbeiten zu können:

  • Den Auslöser Wenn ein Agent den Flow aufruft und eine Aktion An den Agenten antworten.
  • Sie müssen so konfiguriert sein, dass Sie in Echtzeit antworten und nicht asynchron. Der Schalter Asynchrone Antwort muss unter Netzwerk in den Einstellungen für die Aktion Auf den Agenten antworte auf Aus gesetzt werden.
  • Antworten auf den Agenten innerhalb des Aktionslimits von 100 Sekunden. Optimieren Sie die Flowlogik, die Abfragen und die zurückgegebene Datenmenge, sodass eine typische Ausführung unter dieser 100-Sekunden-Grenze liegt. Aktionen im Flow, die länger ausgeführt werden müssen, können nach der Aktion Copilot antworten platziert werden, um die Ausführung bis zum Limit der Flowausführung von 30 Tagen fortzusetzen. Anleitungen zum Beschleunigen Ihrer Flows finden Sie unter Ausführung des Agentflows mit dem Expressmodus beschleunigen.

Wenn Sie einen Agent-Flow in Copilot Studio als neues Tool erstellen, das einem Agent hinzugefügt wird, werden die erforderlichen Ablauftrigger- und Antwortaktionen für Sie hinzugefügt. Sie können einen vorhandenen vorhandenen Flow für die Nutzung mit Agenten verwenden, indem Sie ihn so aktualisieren, dass der diese Trigger und Aktionen zu verwenden.

Voraussetzungen

Einen Flow erstellen, der mit einem Agent verwendet werden kann

In diesem Beispiel erstellen Sie einen Flow, der die aktuelle Wettervorhersage von MSN Weather abruft. Sie fügen den Flow als Tool zu einem vorhandenen Agentthema hinzu.

Fügen Sie einem Thema einen leeren neuen Agent-Flow hinzu und speichern Sie ihn

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

  2. Öffnen Sie das Thema, von dem aus Sie einen Flow aufrufen möchten.

  3. Wählen Sie das Symbol Knoten hinzufügen unter einem beliebigen Knoten aus, und wählen Sie dann Tool hinzufügen.

  4. Wählen Sie auf der Registerkarte Grundlegende Werkzeuge die Option Neuer Agentflow aus.

    Die Seite Agent-Flows wird geöffnet, wobei eine Startflussvorlage im Agent-Flows-Designer zur Bearbeitung geöffnet ist. Der Flow enthält den erforderlichen Trigger Wenn ein Agent den Flow aufruft und die Aktion Auf den Agent antworten.

  5. 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.

  6. 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.

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

Hinzufügen von Aktionen und Konfigurieren des Flows

Nachdem Sie eine Basisvorlage für den Flow erstellt und diesen zu Ihrem Agent-Thema hinzugefügt haben, können Sie nun zurückkehren, um Ihrem Flow Aktionen hinzuzufügen. In diesem Beispiel fügen Sie eine Aktion hinzu, welche die aktuelle Wettervorhersage von MSN Wetter abruft.

  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 Seite Übersicht unter Details den Namen des Flows in etwas Aussagekräftiges, z. B. „Wettervorhersage abrufen“.

  3. Bitte gehen Sie zum Designer, wählen Sie den Flow-Trigger Wenn ein Agent den Flow aufruft aus und fügen Sie die folgenden Eingabeparameter hinzu:

    • Ort (Text)
    • ZIP-Code (Nummer)

  4. Wählen Sie das Symbol Hinzufügen unter dem Flow-Trigger und dann Wenn ein Agent den Flow aufruft aus.

  5. Wählen Sie Eine Aktion hinzufügen und suchen Sie nach MSN-Wetter und wählen Sie die Vorhersage für heute abrufen Aktion aus.

  6. Geben Sie im Bereich Vorhersage für den heutigen Tag abrufen im Feld Standort einen Schrägstrich (/) ein, wählen Sie Dynamischen Inhalt hinzufügen und dann den Eingabeparameter Stadt aus.

  7. Gehen Sie genauso vor, um den Eingabeparameter für die Postleitzahl hinzuzufügen.

  8. Fügen Sie in der Aktion Dem Agenten antworten die folgenden Ausgabeparameter und -variablen hinzu:

    Ausgabeparameter Typ Variable
    day_summary Text Tageszusammenfassung
    location Text Speicherort
    chance_of_rain Nummer Regenwahrscheinlichkeit tagsüber

    Screenshot dynamischer Variablen als Ausgabeparameter für die Antwortaktion.

  9. Wählen Sie Veröffentlichen aus. Eine Benachrichtigung wird angezeigt, wenn der Flow erfolgreich erstellt wurde.

Um fortzufahren, folgen Sie den Anweisungen unter Aufrufen eines Agentflows von einem Agent.

Verwalten, welche Verbindungen der Flow verwendet

In einem unterstützten authentifizierten Agenten können Cloud-Flows für die Verwendung der Benutzeranmeldeinformationen konfiguriert werden, wenn sie im Rahmen einer generativen Orchestrierung ausgeführt und von einem Thema aus aufgerufen werden. Für die Verwendung des Flows in einem unterstützten Kanal ist keine spezielle Konfiguration in Ihrem Agenten erforderlich. Kunden können ihre Verbindungen verwalten, während sie den Agenten verwenden.

Cloud-Flows in Umgebungen, die kundenseitig verwaltete Schlüssel (CMK) verwenden, können noch nicht mit Kundenanmeldeinformationen im Rahmen von generativen Orchestrierungsplänen oder aus Themen ausgeführt werden. Stellen Sie sicher, dass die „Nur ausführen“-Einstellungen für Cloud-Flows in CMK-Umgebungen auf bestimmte Verbindungen eingestellt sind und nicht auf Vom Nur-ausführen-Benutzenden bereitgestellt.

Zugehöriger Inhalt

  • Last updated on