Freigeben über


Eine Liste der Ergebnisse zurückgeben

Es ist üblich, einen Copiloten aufzufordern, in einem externen System nach Daten zu suchen und eine Ergebnisliste zurückzugeben. Dazu kann Microsoft Copilot Studio einen Power Automate Flow aufrufen, um:

  • Eine externe Lösung zu authentifizieren und sich damit zu verbinden
  • Eine Abfrage basierend auf den Eingaben des Benutzenden auszuführen
  • Die Ergebnisse zu formatieren
  • Ergebnisse an den Copiloten zurückzugeben

In diesem Beispiel verwenden Sie den Dataverse Connecter in Power Automate, um nach Konten zu suchen. Anschließend erhalten Sie eine Ergebnisliste, die den Kontonamen, die Stadt und die Kontonummer für Microsoft Copilot Studio enthält.

Anforderungen

Kontenschemata in Dataverse einrichten

Das Kontoschema ist eine Standardtabelle, die automatisch in Power Platform Umgebungen enthalten ist. Es enthält jedoch keine Kontodaten. Bevor Ihr Copilot nach Konten suchen kann, müssen Sie die Kontotabelle ausfüllen.

Wenn Sie bereits eine Kontotabelle mit Daten haben, überspringen Sie diesen Schritt und fahren Sie mit fort Erstellen Sie ein Thema fort. Wenn Sie Ihren Copiloten in späteren Schritten testen, müssen Sie jedoch andere Suchbegriffe verwenden.

  1. Wechseln Sie zum Power Apps-Portal.

  2. Wählen Sie im Seitenbereich unter Dataverse und wählen Tabellen aus.

  3. Wählen Sie die Tabelle Konto und dann die Tabelleneigenschaften auf der Seite und wählen sie Bearbeiten.

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

Thema erstellen

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

  2. Ein neues Thema Kontosuche erstellen.

  3. Fügen Sie folgende Triggerphrasen hinzu:

    • Ich suche nach einem Kunden
    • Ich suche ein Konto
    • Kontosuche
    • Kunde suchen
  4. Fügen Sie einen Knoten Nachricht hinzu und geben Sie die Nachricht ein Klingt, als suchen Sie ein Konto. Ich kann das für Sie nachschlagen..

  5. Fügen Sie einen Knoten Frage hinzu und geben Sie die Nachricht ein Wie heißt der gesuchte Kunde?.

  6. Für Identifizieren wählen Sie Organisation aus.

    Gesamte Antwort des Benutzers wird auch funktionieren. Allerdings nutzt die Auswahl der Entität Organisation die Language-Understanding-Fähigkeitn des Copiloten, um den Namen der Organisation aus der Antwort zu extrahieren.

    Screenshot eines neuen Thema mit einem Nachrichten- und Frageknoten.

  7. Für Antwort speichern unter benennen Sie die Variable um in Organisation.

Workflow erstellen

  1. Wählen Sie im Erstellungsbereich Knoten hinzufügen (+) aus. Wählen Sie Handlungsaufforderung und wählen Sie dann Einen Flow erstellen.

  2. In dem Power Automate Portal, benennen Sie den Flow Konto suchen.

  3. Fügen Sie einen Text mit dem Namen Organisation hinzu.

    Screenshot des Flow-Triggers mit einer hinzugefügten Texteingabe.

  4. Wählen Sie Neuer Schritt hinzufügen (+) und dann Aktion hinzufügen.

  5. Suchen Sie nach dem Microsoft Dataverse Connector und wählen Sie dann die Aktion Zeilen suchen.

    Diese Aktion verwendet Fuzzyübereinstimmung, um relevante Konten in Ihrer Dataverse Kontentabelle zu finden.

    Screenshot der Aktion Dataverse Konnektor Zeilen suchen.

  6. Als Suchbegriff wählen Sie die Variable Organisation.

  7. Wählen Sie Erweiterte Optionen anzeigen und stellen Sie die folgenden Elemente wie angegeben ein:

    • Tabellenfilterelement: account
    • Nach Artikel sortieren – 1: @search.score desc
    • Nach Artikel sortieren – 2: name asc

    Screenshot von Suchzeilenaktionen mit konfigurierten erweiterten Optionen.

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

  1. Wählen Sie Neuer Schritt hinzufügen (+) und dann Aktion hinzufügen.

  2. Wählen Sie den Konnektor Datenvorgang, und wählen Sie dann die Aktion JSON analysieren aus.

  3. In dem Kästchen Inhalt wählen Sie unter Zeilen suchen die Variable Liste der Zeilen aus.

  4. 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 des JSON-Schemas, das in den JSON-Parser-Knoten eingegeben wurde.

  5. Wählen Sie Neuer Schritt hinzufügen (+) und dann Aktion hinzufügen. Wählen Sie den Konnektor Variable, und wählen Sie dann die Aktion Variable initialisieren aus.

  6. Geben Sie als Name ListOfAccounts ein. Wählen Sie als Typ Zeichenfolge aus.

    Screenshot der Aktion „Variable initialisieren“.

  7. Wählen Sie Neuer Schritt hinzufügen (+) und dann Aktion hinzufügen. Wählen Sie den Konnektor Steuerelement und wählen Sie dann die Aktion Für alle anwenden.

  8. Wählen Sie das Kontrollkästchen Einen Ausgabewert vom früheren Schritt, um das Menü Dynamischer Inhalt zu öffnen. Suchen Sie nach Körper und wählen dann unter JSON analysieren die Variable Körper aus.

  9. Wählen Sie Neuer Schritt hinzufügen (+) und dann Aktion hinzufügen. Wählen Sie den Konnektor Variable, und wählen Sie dann die Aktion auf Zeichenfolge anwenden aus.

  10. Wählen Sie als Name ListOfAccounts. 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']}
    
  11. Fügen Sie nach Ausschnitt einen Zeilenumbruch hinzu, damit jedes Ergebnis in einer eigenen Zeile erscheint.

    Screenshot für jede Aktion anwenden.

  12. In der Aktion Rückgabewerte an Microsoft Copilot Studio fügen Sie eine Ausgabe Text hinzu. Geben Sie als Name FoundAccounts ein. Wählen Sie im Feld Wert die Option ListOfAccounts aus.

    Screenshot der Aktion Werte zurückgeben auf Microsoft Copilot Studio.

  13. Wählen Sie Save (Speichern).

Rufen Sie aus Microsoft Copilot Studio den Flow auf

  1. Im Microsoft Copilot Studio Erstellungsbereich wählen Sie Knoten hinzufügen (+) und wählen Sie dann Rufen Sie eine Aktion auf.

  2. Wählen Sie den zuvor erstellten Flow Konto suchen aus.

  3. Wählen Sie für Organisation bekommt Wert von die Variable Organisation aus.

  4. Fügen Sie einen Knoten Nachricht hinzu und geben Sie die Nachricht ein Okay, das habe ich gefunden.

  5. Fügen Sie einen zweiten Knoten Nachricht hinzu. Wählen Sie Variable einfügen und dann FoundAccounts aus.

    Screenshot einer Unterhaltung mit einem Copiloten, der mit einer Liste gefundener Konten geantwortet hat.

  6. Wählen Sie Speichern.

  7. Testen Sie Ihren Copiloten im Bereich Copilot testen.

    Screenshot der Copilot-Unterhaltung im Bereich „Copilot testen“.