Eine Liste der Ergebnisse zurückgeben

Artikel
03/05/2025

Es ist üblich, einen Agenten zu bitten, in einem externen System nach Daten zu suchen und eine Liste mit Ergebnissen zurückzugeben. Zu diesem Zweck kann ein Agent einen Power Automate Flow aufrufen, um:

Eine externe Lösung zu authentifizieren und sich damit zu verbinden.
Führen Sie eine Abfrage auf der Benutzereingabe aus.
Die Ergebnisse zu formatieren.
Die Ergebnisse dem Agenten zurückgeben.

In diesem Beispiel wird der Konnektor für Dataverse die Power Automate Suche nach Konten verwendet. Der Konnektor gibt eine Liste von Ergebnissen zurück, die den Kontonamen, die Stadt und die Kontonummer zu Ihrem Agent enthält.

Anforderungen

Verstehen, wie ein Flow über den Copilot Studio-Erstellungsbereich erstellt wird
Ein- und Ausgabevariablen zur Weitergabe von Informationen verwenden
Die Dataverse-Suche in Ihrer Umgebung konfigurieren

Kontenschemata in Dataverse einrichten

Die Kontotabelle ist eine Standardtabelle, die standardmäßig in Power Platform Umgebungen verfügbar ist. Es enthält jedoch keine Kontodaten. Bevor Ihr Agent nach Konten suchen kann, müssen Sie die Tabelle Konto befüllen.

Wenn Sie bereits eine Kontotabelle mit Daten haben, überspringen Sie diesen Schritt und fahren Sie mit fort Erstellen Sie ein Thema fort. Denken Sie jedoch daran, Suchbegriffe zu verwenden, die für Ihre Daten relevant sind, wenn Sie Ihren Agent in späteren Schritten testen.

Wechseln Sie zum Power Apps-Portal.
Wählen Sie im linken Navigationsbereich Tabellen aus.
Wählen Sie die Tabelle Konto und dann die Tabelleneigenschaften auf der Seite und wählen sie Bearbeiten.
Fügen Sie die folgenden Zeilen zu der Tabelle hinzu:

Adresse 1: Stadt Firmenname Kontonummer

Düsseldorf Contoso Inc AC0125

San Francisco Contoso-Residenzen AC0255

Olympia Contoso-Essenslieferung AC0035

Adresse 1: Stadt	Firmenname	Kontonummer
Düsseldorf	Contoso Inc	AC0125
San Francisco	Contoso-Residenzen	AC0255
Olympia	Contoso-Essenslieferung	AC0035

Thema erstellen

Gehen Sie in Copilot Studio zur Themen-Seite für Ihren Agent.
Ein neues Thema Kontosuche erstellen.
Fügen Sie folgende Triggerphrasen hinzu:
- Ich suche nach einem Kunden
- Ich suche ein Konto
- Kontosuche
- Kunde suchen
Fügen Sie einen Nachrichtenknoten hinzu, und geben Sie die Meldung Klingt, als ob Sie nach einem Konto suchen ein. Das kann ich für dich nachschlagen.
Fügen Sie einen Knoten Frage hinzu und geben Sie die Nachricht ein Wie heißt der gesuchte Kunde? ein.
Für Identifizieren wählen Sie Organisation aus.

Die gesamte Antwort des Benutzers würde ebenfalls funktionieren. Wenn Sie jedoch die Entität Organisation auswählen, nutzen Sie die Sprachverständnisfunktionen des Agenten, um den Namen der Organisation aus der Antwort zu extrahieren.
Benennen Sie die Variable für Benutzerantwort speichern unter in Organisation um.

Workflow erstellen

Wählen Sie das Symbol Knoten hinzufügen unter einem beliebigen Knoten aus und wählen Sie Aktion hinzufügen aus.
Wählen Sie auf der Registerkarte Grundlegende Aktionen die Option Neuer Power Automate Flow aus.
Wählen Sie in Power Automate den Namen des Flows aus, und ersetzen Sie ihn durch Konto suchen.
Wählen Sie den Trigger-Flow Flow über Copilot ausführen aus und fügen Sie einen Texteingabeparameter mit dem Namen Organisation hinzu.
Wählen Sie das Symbol Hinzufügen unter dem Trigger Flow aus Copilot Flow ausführen aus.
Suchen Sie unter Aktion hinzufügen nach Microsoft Dataverse und wählen Sie die Aktion Zeilen suchen aus.

Diese Aktion verwendet Fuzzyübereinstimmung, um relevante Konten in Ihrer Dataverse Kontentabelle zu finden.
Geben Sie im Feld Suchbegriff einen Schrägstrich (/) ein, wählen Sie Dynamischen Inhalt einfügen und dann den Eingabeparameter Organisation aus.
Wählen Sie für Erweiterte Parameter die Option Alle anzeigen aus und legen Sie die folgenden Werte fest:
- Tabellenfilterelement: account
- Nach Artikel sortieren – 1: search.score desc
- Nach Artikel sortieren – 2: name asc

Ergebnisse formatieren

Die Aktion Zeilen suchen gibt die Variable Liste der Zeilen zurück, die JSON-Daten enthält. Bevor Sie die Daten verwenden können, müssen Sie sie mit der Aktion JSON parsen analysieren beginnen.

Wählen Sie das Hinzufügen Symbol unter der Aktion Zeilen durchsuchen aus.
Wählen Sie Aktion hinzufügen und suchen nach Datenvorgang und wählen JSON parsen aus.
Geben Sie im Kästchen Inhalt einen Schrägstrich (/) ein, wählen SieDynamischen Inhalt einfügen und dann Zeilenliste aus.

Kopieren Sie das folgende JSON-Schema und fügen Sie es dann im Feld Schema ein:

{
    "type": "array",
    "items": {
        "type": "object",
        "properties": {
            "@@search.score": {
                "type": "number"
            },
            "name": {
                "type": "string"
            },
            "address1_city": {
                "type": "string"
            },
            "accountnumber": {
                "type": "string"
            }
        },
        "required": [
            "name"
        ]
    }
}

Screenshot der Aktion „Parse JSON“ Eigenschaften mit einem JSON-Schema.

Wählen Sie das Hinzufügen Symbol unter der Aktion JSON parsen aus.
Wählen Sie Aktion hinzufügen und suchen nach Variable und wählen Variable initialisieren aus.
Geben Sie im Feld Name ListOfAccounts ein.
Wählen Sie als TypZeichenfolge aus.
Wählen Sie das Hinzufügen Symbol unter der Aktion Variable initialisieren aus.
Wählen Sie Aktion hinzufügen und suchen nach Control und wählen Auf jede Aktion anwenden aus.
Geben Sie im Feld Ausgabe von vorherigen Schritten auswählen einen Schrägstrich (/) ein, wählen Sie Dynamischen Inhalt einfügen aus, und wählen Sie dann die Körper-Variable unter JSON parsen aus.
Wählen Sie das Hinzufügen-Symbo in der Aktion Auf alle anwenden aus.
Wählen Sie Aktion hinzufügen und suchen nach Variable und wählen die Aktion Auf Stringvariable anwenden aus.
Wählen Sie als NameListOfAccounts.

Kopieren Sie den folgenden Text und fügen Sie ihn in das Kästchen Wert ein:

- @{items('Apply_to_each')['accountnumber']}: @{items('Apply_to_each')['name']} - @{items('Apply_to_each')['address1_city']}

Fügen Sie nach Ausschnitt einen Zeilenumbruch hinzu, damit jedes Ergebnis in einer eigenen Zeile erscheint.
In der Aktion Auf Copilot antworten fügen Sie eine Textausgabe hinzu.
Geben Sie als Name FoundAccounts ein.
Geben Sie als Wert einen Schrägstrich (/) in das Feld ein, wählen Sie Dynamischen Inhalt einfügen und dann die ListOfAccounts Variable aus.
Speichern und veröffentlichen Sie Ihren Flow.

Rufen Sie aus Copilot Studio den Flow auf

Wählen Sie in Copilot Studio das Symbol Knoten hinzufügen unter dem Knoten Frage aus, wählen Sie Aktion hinzufügen aus, und wählen Sie dann den zuvor erstellten Flow Konto durchsuchen aus.
Legen Sie den Flow-Eingabeparameter auf die Ausgabevariable des Frageknotens fest: Organisation (Zeichenfolge) ruft seinen Wert aus der Organisations-Variable ab.
Fügen Sie einen Knoten Nachricht hinzu und geben Sie die Nachricht ein Okay, das habe ich gefunden.
Fügen Sie einen zweiten Knoten Nachricht hinzu. Wählen Sie das Symbol Variable einfügen und dann FoundAccounts aus.
Wählen Sie Speichern.
Testen Sie Ihren Agenten.

Teilen über