Eine Aktion zum Abrufen von Dataverse for Teams-Daten aufrufen

Abgeschlossen

Durch die Verwendung des Knotens Eine Aktion aufrufen können Copiloten mit Power Automate-Flows interagieren. Verwenden Sie diese, um automatisierte Prozesse auszulösen oder eine Verbindung mit Dataverse for Teams-Daten, Microsoft Listen oder anderen Datenquellen herzustellen.

Beispielsweise könnte der Copilot Ereigniskontakte die Mitglieder des Vertriebsprojektteams aus einer Dataverse for Teams-Tabelle bereitstellen. Anstatt den Copiloten zu bearbeiten, wenn Änderungen an diesem Team vorgenommen werden, können Sie einfach die Tabelle aktualisieren.

Schritt 1 – Eine Dataverse for Teams-Tabelle erstellen

Gehen Sie wie folgt vor, um eine Dataverse for Teams-Tabelle zu erstellen:

  1. Erstellen Sie eine neue Dataverse for Teams-Tabelle im selben Team wie der Copilot. Denken Sie daran, dass Sie sie mit Power Apps für Teams erstellen müssen. Klicken Sie in Power Apps für Teams auf die Registerkarte Erstellen, und wählen Sie dann Ihr Team aus.

  2. Wählen Sie Alle anzeigen unter Für [Name Ihres Teams] erstellte Elemente aus, um die Liste der Teamlösungen anzuzeigen. Die Teamlösungsliste umfasst alle Apps, Copiloten, Cloud-Flows, Tabellen usw., die in Dataverse for Teams für das ausgewählte Team integriert wurden. Wenn Sie dasselbe Team ausgewählt haben, in dem Sie Ihren Veranstaltungskontakte-Copiloten erstellt haben, wird es in der Lösungsliste angezeigt.

  3. Wählen Sie im Menüband für die Teamlösung oben Neu>Tabelle aus.

    Screenshot der Registerkarte „Erstellen“ mit neuem Menü und ausgewählter Tabelle

    Nennen Sie Ihre neue Tabelle Vertriebsprojektteam, und klicken Sie auf Speichern. Folgende Spalten und Datentypen sind zu verwenden:

    Spalte Datentyp
    Name Text
    E‑Mail-Adresse E-Mail

    Sie müssen Ihrer Tabelle die Spalte E-Mail-Adresse hinzufügen, bevor Sie mit dem nächsten Schritt fortfahren.

  4. Fügen Sie für jeden der vier Kontakte neue Zeilen hinzu.

    Name E‑Mail-Adresse
    Joseph Price JosephP@contoso.com
    Nathan Rigby NathanR@contoso.com
    Amber Rodriguez AmberR@contoso.com
    Monica Thomson MonicaT@contoso.com
  5. Wenn Sie fertig sind, wechseln Sie zu Microsoft Copilot Studio für Teams zurück.

Schritt 2 – Ein Copilot-Thema mit einem Aktionsschritt erstellen

Führen Sie die folgenden Schritte aus, um eine Aktion hinzuzufügen:

  1. Wählen Sie in Microsoft Copilot Studio für Teams die Registerkarte Copiloten im Menüband aus und suchen/wählen Sie dann Ihren Event Contacts-Copiloten aus, um ihn zu öffnen.

  2. Wechseln Sie zur Liste mit Themen.

  3. Erstellen Sie ein neues Thema, indem Sie im Menüband „Themen“ Neues Thema>Ohne Vorlage auswählen. Wählen Sie im Menüband Details aus, um das Thema zu benennen. Geben Sie in das Feld Name „Vertriebsprojektteam“ ein.

  4. Wählen Sie Trigger-Phrasen aus, und geben Sie jeweils Folgendes ein. Drücken Sie nach jeder Eingabe +:

    sales project team

    sales project info

    sales team info

    sales project members

    sales project info

  5. Geben Sie im Erstellungsbereich im Knoten Nachricht Folgendes ein:

    Let me look up the Sales Project Team!

    Screenshot des Setups mit dem Namen und den Triggerausdrücken

  6. Wählen Sie aus dem oberen Menüband die Schaltfläche Speichern aus, um Ihr Thema zu speichern. Alle Änderungen, die Sie zu diesem Zeitpunkt noch nicht gespeichert haben, können verloren gehen, wenn Sie zu Power Automate wechseln, um den Flow zu erstellen.

  7. Fügen Sie nach dem Knoten Nachricht einen neuen Knoten hinzu, und wählen Sie dann Aktion aufrufen > Flow erstellen aus. Möglicherweise zeigt Copilot Studio Ihnen ein Optionsfeld an, das Sie daran erinnert, Ihr Thema vor dem Verlassen zu speichern. Klicken Sie auf Verlassen, falls Sie dies bereit gespeichert haben. Diese Aktion öffnet das Power Automate Studio in Copilot Studio.

    Es stehen einige gängige Vorlagen zur Verfügung, aus denen Sie sofort auswählen können. Mit jeder Vorlage können Sie Informationen an den Flow übergeben, wenn dieser ausgelöst wird. Sobald der Flow abgeschlossen ist, können Informationen an den Copiloten zurückgegeben werden. Sie können Weitere Vorlagen anzeigen auswählen, um weitere Vorlagenoptionen anzuzeigen. Einige Bemerkenswerte sind:

    Power Virtual Agents-Flowvorlage – Diese Vorlage enthält nur die Schritte zum Empfangen und Senden von Informationen an den Copiloten.

    Eine Nachricht an einen Teams-Kanal senden – Lösen Sie eine Teams-Nachricht aus dem Copiloten aus.

    Adaptive Karte an einen Teams-Kanal senden – Eine adaptive Karte auslösen, um Informationen in einem Teams-Kanal bereitzustellen.

  8. Wählen Sie die Vorlage mit der Bezeichnung Power Virtual Agents-Flow-Vorlage aus. Wenn Sie dies tun, ist Ihr Trigger Power Virtual Agents, und Sie haben darunter einen Schritt mit der Bezeichnung Werte zurückgeben an Power Virtual Agents.

  9. Benennen Sie den Flow in Get Sales Team Members um.

  10. Erstellen Sie eine Variable, um die Informationen zu speichern, die Sie an den Copiloten zurückgeben möchten. Bewegen Sie den Cursor zwischen Ihrem Trigger und dem Rückgabewertschritt auf den Pfeil, und wählen Sie das Symbol Neuen Schritt einfügen aus, das anzeigt wird, wenn Sie mit der Maus darüber fahren, und klicken Sie dann auf die Option Aktion hinzufügen.

  11. Geben Sie im Suchfeld „variable“ ein, und wählen Sie dann unter Aktionen die Option Variable initialisieren aus.

  12. Geben Sie „varContactInfo“ als Namen ein, und wählen Sie Zeichenfolge als Typ aus. Lassen Sie den Wert leer.

  13. Jetzt brauchen wir einen Schritt, um von Dataverse auf die Daten in Teams zuzugreifen. Unter Ihrem neuen Variable initialisieren-Schritt, wählen Sie das Symbol Neuen Schritt einfügen und Aktion hinzufügen aus. Suchen Sie nach dem Konnektor Microsoft Dataverse, und wählen Sie dann als Trigger Zeilen auflisten aus.

  14. Wählen Sie als TabellennameSales Project Team aus der Dropdownliste aus. (Sie können „sales“ in das Eingabefeld eingeben, um die Liste schnell zu filtern.)

    Die Aktion Listenzeilen zieht alle Tabellenzeilen in ein Array. Ein Array ist eine Tabelle. Sie müssen jede Zeile der Tabelle prüfen und jede Datenzeile zu Ihrer Variable varContactInfo hinzufügen, um unserer Zeichenfolgenvariable Daten hinzuzufügen. So geben wir diese Daten an Power Virtual Agents zurück.

  15. Wählen Sie das Symbol Neuen Schritt einfügen nach den Listenzeilen aus. Wählen Sie Aktion hinzufügen aus.

  16. Geben Sie im Suchfeld Steuerelement ein, und wählen Sie dann unter Aktionen die Option Für alle übernehmen aus.

  17. Wählen Sie dies aus dem Feld Ausgabe von vorherigen Schritten auswählen aus, um dynamischen Inhalt hinzuzufügen. Wählen Sie dann Wert unter der Aktion Dataverse-Listenzeilen aus.

  18. Wählen Sie innerhalb der Aktion Für alle übernehmen die Option Aktion hinzufügen aus, um fortzufahren.

  19. Geben Sie im Suchfeld Auswählen und Vorgangvariable ein, und wählen Sie unter Aktionen die Option An Zeichenfolgenvariable anfügen aus.

  20. Wählen Sie im Schritt An Array-Variable anfügenvarContactInfo als Namen aus.

  21. Für den Wert erstellen wir eine Liste mit Aufzählungszeichen (als Zeichenfolgedaten) mit dem Namen und der E-Mail-Adresse jeder Person. Power Automate verwendet die Markdown-Syntax beim Formatieren von Text. Um eine Liste mit Aufzählungszeichen in Markdown anzuzeigen, müssen Sie das Sternchen * am Anfang der Zeile verwenden. (Weitere Informationen über Markdown finden Sie im Abschnitt „Zusammenfassung“ am Ende dieses Moduls.)

    Im Textfeld Wert:

    1. Geben Sie ein Sternchen * ein, fügen Sie dann ein LEERZEICHEN hinzu.

    2. Wählen Sie unter Listenzeilen des dynamischen Inhalts Name aus, und fügen Sie dann ein LEERZEICHEN hinzu.

    3. Wählen Sie unter den Listenzeilen des dynamischen Inhalts E-Mail-Adresse aus.

    4. Drücken Sie die Eingabetaste, um eine neue Zeile zu beginnen.

    Dieser Schritt ist abgeschlossen.

  22. Wählen Sie den Schritt Wert(e) an Microsoft Copilot Studio zurückgeben unten im Flow aus, und klicken Sie dann auf + Eine Ausgabe hinzufügen.

  23. Wählen Sie Text als Ausgabetyp aus.

  24. Geben Sie im Textfeld Titel eingebenContactData ein.

  25. Wählen Sie für das Feld Wert eingeben, um zu antworten das Eingabefeld aus, und klicken Sie dann unter dem Abschnitt Variablen auf varContactInfo.

    Ihr Flow sollte nun dem nächsten Bild ähneln:

    Screenshot des Flows „Get Sales Team Members“

  26. Wählen Sie Speichern aus dem Power Automate-Menüband aus, um die Bearbeitung des Flows abzuschließen. Power Automate führt den Flow-Checker automatisch aus, um nach Problemen zu suchen. Möglicherweise wird eine Warnung zu „... OData-Filterabfragen ...“ angezeigt, die ignoriert werden kann. Sie können OData-Filter verwenden, um die Daten zu begrenzen, die Ihr Schritt Zeilen auflisten zurückruft. Da unsere Datenquelle jedoch nur wenige Zeilen umfasst, ist ein Filter nicht erforderlich. Wählen Sie Schließen aus, um Power Automate zu schließen und zum Copilot-Editor zurückzukehren.

  27. Sehen Sie sich in Ihrem Copilot-Chatbot-Editor Ihren Schritt Aktion an. Sie sollten den Flow sehen, den Sie gerade erstellt haben: Get Sales Team Members als Aktion und die von Ihnen erstellte Zeichenfolgenvariable „ContactData“ als Ausgabe aufgelistet.

  28. Fügen Sie einen Schritt Nachricht anzeigen nach dem Knoten „Aktion“ hinzu.

  29. Klicken Sie in das Textfeld, um das Menü aufzurufen. Wählen Sie ContactData unter „Variable {X} einfügen“ aus.

  30. Wählen Sie im Menüband zur Themenbearbeitung die Option Speichern aus, und warten Sie, bis das Thema gespeichert ist. Wenn der Bereich Testbot nicht sichtbar ist, wählen Sie die Menüoption Testbot aus.

  31. Stellen Sie oben im Bereich Chatbot testen sicher, dass die Option Zwischen Themen nachverfolgen aktiviert ist.

  32. Geben Sie einen der Triggerausdrücke ein, um Ihren Sales Project Team-Chatbot zu testen. Ihr Test-Chatbot enthält eine Auflistung der vier Namen und E-Mail-Adressen Ihres Sales Project Team.

    Screenshot des Themas „Sales Project Team“

Herzlichen Glückwunsch! Sie haben jetzt eine Möglichkeit für Ihren Copilot-Chatbot erstellt, über einen integrierten Power Automate-Flow auf Informationen aus Datentabellen zuzugreifen.