Proaktive Microsoft Teams Nachrichten senden

Sie können proaktive Nachrichten für Agents und klassische Chatbots konfigurieren, die Sie in Copilot Studio erstellen und anpassen. Nachdem Sie einen Agenten veröffentlicht haben und ihn Benutzern in Microsoft Teams zur Verfügung gestellt haben, kann er proaktive Nachrichten senden, um Benutzer ("Empfänger") in Teams zu benachrichtigen. Proaktive Nachrichten verwenden Power Automate-Flows, um ihre Inhalte zu übermitteln, und sie sind in vielen Szenarien nützlich, einschließlich:

• Dem Empfänger mitteilen, dass seine frühere Anfrage erfüllt ist. Zum Beispiel wird der Auszeitantrag des Nutzers genehmigt.
• Bereitstellung von Erinnerungen oder Nachrichten-Updates. Zum Beispiel sendet der Agent eine Erinnerung, eine Online-Schulung zu absolvieren.

Anforderungen

• Agenten veröffentlichen und einsetzen
• Agenten für Microsoft Teams verbinden und konfigurieren
• Get started with Power Automate
• Übersicht über Cloud-Flows

Bekannte Einschränkungen

• Wenn der Agent die Verbindung trennt und wieder mit Teams verbindet, erhalten die Nutzer keine proaktiven Nachrichten, bis sie den Agenten neu installiert haben.
• Alle aktiven Nachrichten von Copilot Studio unterliegen Power Automate Grenzwerten und Drosselungsgrenzwerten des Microsoft Teams-Connectors.
• Proaktive Nachrichten erscheinen nicht in Gesprächstranskripten oder Analysesitzungsdaten.
• Proaktive Meldungen müssen sich in derselben Umgebung wie der Power Automate Flow befinden.
• Proaktive Nachrichten können nur in einen persönlichen Chat mit dem Agenten gehen.

Proaktive Nachricht senden

1. Öffnen Sie in Power Automate den Fluss, den Sie zum Senden einer proaktiven Nachricht verwenden möchten.

2. Fügen Sie die Aktion des Microsoft Teams Connectors Nachricht in einem Chat oder Kanal posten hinzu.

3. Wählen Sie für Post as den Microsoft Copilot Studio Agent aus.

4. Für Beitrag wählen Sie Chat mit Agent.

5. Wählen Sie für Agent den Agenten aus, von dem die Nachricht gesendet werden soll.

6. Geben Sie für Empfänger den Namen oder die E-Mail-Adresse des Empfängers ein. Sie können auch dynamische Inhalte verwenden, wenn die Empfängerinformationen aus einem früheren Schritt im Flow stammen.

7. Geben Sie für Nachricht die Nachricht ein, die Sie senden möchten.

   

Wenn der Flow läuft, erhält der Empfänger die proaktive Nachricht vom Agenten in Teams.

Senden Sie eine proaktive Adaptive Card

In diesem Abschnitt wird erläutert, wie proaktive Adaptive Cards mithilfe von Power Automate Flows gesendet werden. Auf einer proaktiven adaptiven Karte können Nutzer Informationen aus einem inaktiven Gespräch mit einem Agenten erhalten.

Adaptive Cards sind ein offenes Kartenaustauschformat, mit dem Entwickler UI-Inhalte auf gemeinsame und konsistente Weise austauschen können. Sie können Adaptive Cards manuell in JSON erstellen, oder wenn Sie eine Drag-and-Drop-Schnittstelle bevorzugen, können Sie den Adaptive Cards Designer verwenden.

In diesem Beispiel senden Sie eine Bestellübersichtskarte, die der Nutzer überprüfen kann.

1. Fügen Sie in Power Automate die Microsoft Teams Connector-Aktion "Post adaptive Karte in einem Chat oder Kanal" hinzu an dem Schritt, bei dem Sie eine Karte in Ihrem Ablauf senden möchten.

2. Wählen Sie für Post as den Microsoft Copilot Studio Agent aus.

3. Für Beitrag wählen Sie Chat mit Agent.

4. Wählen Sie für Agent den Agenten aus, von dem die Nachricht gesendet werden soll.

5. Geben Sie für Empfänger den Namen oder die E-Mail-Adresse des Empfängers ein. Sie können auch dynamische Inhalte verwenden, wenn die Empfängerinformationen aus einem früheren Schritt im Flow stammen.

6. Geben Sie für Adaptive Karte die folgende JSON-Vorlage ein:

   {
       "type": "AdaptiveCard",
       "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
       "version": "1.5",
       "body": [
           {
               "type": "TextBlock",
               "text": "Order summary",
               "wrap": true,
               "style": "heading"
           },
           {
               "type": "FactSet",
               "facts": [
                   {
                       "title": "Name",
                       "value": "John Doe"
                   },
                   {
                       "title": "Phone number",
                       "value": "(000) 000-0000"
                   }
               ]
           },
           {
               "type": "Container",
               "items": [
                   {
                       "type": "FactSet",
                       "facts": [
                           {
                               "title": "1x",
                               "value": "Steak"
                           },
                           {
                               "title": "2x",
                               "value": "Side Rice"
                           },
                           {
                               "title": "1x",
                               "value": "Soft Drink"
                           }
                       ],
                       "spacing": "Small"
                   }
               ],
               "spacing": "Small"
           }
       ]
   }
   

   

Wenn der Flow läuft, erhält der Empfänger die Adaptive Card vom Agenten in Teams.

Senden Sie eine proaktive adaptive Karte und warten Sie auf die Antwort des Nutzers

Adaptive Cards unterstützen das Sammeln von Benutzereingaben. In diesen Szenarien solltest du auf die Antwort des Nutzers warten, bevor der Fluss weitergeht.

In diesem Beispiel senden Sie eine Bestellbestätigungskarte, mit der der Nutzer Änderungen vornehmen kann, bevor die Bestellung abgegeben wird.

1. In Power Automate fügen Sie die Microsoft Teams-Connector-Aktion adaptive Karte posten und auf eine Antwort warten bei dem Schritt hinzu, in dem Sie die Karte in Ihrem Flow senden möchten.

2. Wählen Sie für Post as den Microsoft Copilot Studio Agent aus.

3. Für Beitrag wählen Sie Chat mit Agent.

4. Für Nachricht geben Sie die folgende Vorlage JSON ein. Die Eigenschaften des Elements actions bestimmen die Optionen, die der Benutzer sieht.

   {
       "type": "AdaptiveCard",
       "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
       "version": "1.0",
       "body": [
           {
               "type": "TextBlock",
               "text": "Order confirmation",
               "wrap": true,
               "style": "heading"
           },
           {
               "type": "FactSet",
               "facts": [
                   {
                       "title": "Name",
                       "value": "John Doe"
                   },
                   {
                       "title": "Phone number",
                       "value": "(000) 000-0000"
                   }
               ]
           },
           {
               "type": "Container",
               "items": [
                   {
                       "type": "FactSet",
                       "facts": [
                           {
                               "title": "1x",
                               "value": "Steak"
                           },
                           {
                               "title": "2x",
                               "value": "Side Rice"
                           },
                           {
                               "title": "1x",
                               "value": "Soft Drink"
                           }
                       ],
                       "spacing": "Small"
                   }
               ],
               "spacing": "Small"
           }
       ],
       "actions": [
           {
               "type": "Action.Submit",
               "title": "Submit Order"
           },
           {
               "type": "Action.Submit",
               "title": "Edit Order"
           }
       ]
   }
   

5. Für die Update-Nachricht geben Sie die Nachricht ein, die der Empfänger nach der Antwort sieht.

6. Geben Sie für Empfänger den Namen oder die E-Mail-Adresse des Empfängers ein. Sie können auch dynamische Inhalte verwenden, wenn die Empfängerinformationen aus einem früheren Schritt im Flow stammen.

7. Für Agent wählen Sie den Agenten aus, von dem Sie die Karte senden möchten.

   

Wenn der Flow läuft, erhält der Empfänger die adaptive Karte vom Agenten in Teams, auf die er dann antworten kann.

Um die Antwort des Empfängers zu verwenden, wählen Sie submitActionId aus dem Flyout-Menü für dynamische Inhalte aus. Der Wert dieser Variable ist der title der vom Benutzer gewählten Aktion.

Senden Sie proaktive Nachrichten an mehrere Empfänger

In einigen Szenarien möchten Sie möglicherweise dieselbe proaktive Nachricht oder Karte gleichzeitig an mehrere Empfänger senden.

Dieser Abschnitt enthält Beispiele für das Senden von Nachrichten an mehrere Empfänger.

An Teamkollegen senden

In diesem Beispiel sendet der Agent eine Erinnerung an die Teammitglieder, ihr Online-Training abzuschließen.

1. Fügen Sie den Microsoft Teams-Connector hinzu und wählen Sie die Aktion Team abrufen in Ihrem Power-Automate-Flow aus.

2. Wählen Sie für Team das Team mit den Mitgliedern aus, an die Sie die Nachricht senden möchten.

3. Fügen Sie den Connector Office 365 Groups hinzu, und wählen Sie die Aktion Gruppenmitglieder auflisten aus.

4. Wählen Sie für Gruppen-ID die Option Benutzerdefinierter Wert aus.

5. Wählen Sie Team-ID aus dem dynamischen Inhalt der Aktion Holen Sie sich ein Team.

6. Fügen Sie den Connector Microsoft Teams hinzu, und wählen Sie die Aktion Nachricht in einem Chat oder Kanal senden aus.

7. Wählen Sie für Post as den Microsoft Copilot Studio Agent aus.

8. Für Beitrag wählen Sie Chat mit Agent.

9. Wählen Sie für Agent den Agenten aus, von dem die Nachricht gesendet werden soll.

10. Wählen Sie für Empfänger den dynamischen Inhalt Benutzerprinzipalname aus der Aktion Gruppenmitglieder auflisten aus.

    

11. Geben Sie für Nachricht die Nachricht ein, die Sie senden möchten.

Wenn der Flow läuft, erhält jeder Nutzer im Team die proaktive Nachricht in einem privaten Chat mit dem Agenten.

An Sicherheitsgruppe senden

In diesem Beispiel sendet der Agent eine Erinnerung an eine Sicherheitsgruppe, um die Online-Schulung abzuschließen.

1. Fügen Sie den Connector Microsoft Entra ID hinzu, und wählen Sie die Aktion Gruppenmitglieder abrufen in Ihrem Power Automate-Fluss aus.

2. Geben Sie für Gruppen-ID die GUID der Sicherheitsgruppe ein.

3. Fügen Sie den Connector Microsoft Teams hinzu, und wählen Sie die Aktion Nachricht in einem Chat oder Kanal senden aus.

4. Wählen Sie für Post as den Microsoft Copilot Studio Agent aus.

5. Für Beitrag wählen Sie Chat mit Agent.

6. Wählen Sie für Agent den Agenten aus, von dem die Nachricht gesendet werden soll.

7. Wählen Sie für Empfänger den dynamischen Inhalt Benutzerprinzipalname für Gruppenmitglieder aus der Aktion Gruppenmitglieder abrufen aus.

8. Geben Sie für Nachricht die Nachricht ein, die Sie senden möchten.

   

Wenn der Flow läuft, erhält jeder Benutzer in der Sicherheitsgruppe die proaktive Nachricht in einem privaten Chat mit dem Agenten.

Senden Sie proaktive Nachrichten an mehrere Empfänger parallel

Normalerweise sendet ein Agent eine proaktive Nachricht an mehrere Empfänger, eine Nachricht nach der anderen. In manchen Situationen ist es jedoch besser, die Nachricht gleichzeitig an mehrere Empfänger zu senden.

1. Im Kommando "Auf jede Aktion anwenden " wählen Sie die drei Punkte (...) und wählen Sie dann Einstellungen.

   

2. Aktivieren Sie Parallelitätskontrolle und stellen Sie den Grad der Parallelität ein.

   

Konfigurieren Sie erweiterte Optionen für proaktive Nachrichten

mit Copilot Studio können Sie detailliertes Verhalten ihres Agents unter Show advanced options im Microsoft Teams Connector steuern.

Gesendete Nachricht als Benachrichtigung kennzeichnen

Als Benachrichtigung kennzeichnen steuert, ob der Text „Benachrichtigung über“ vor dem Namen des Agenten steht. Das Kennzeichnen der Antwort des Agenten ermöglicht es dem Empfänger, die Antwort des Agenten auf seine Anfrage zu identifizieren.

Wenn sich der Empfänger gerade in einem aktiven Chat mit dem Agenten befindet

Ein Agent könnte eine proaktive Nachricht senden, während der Empfänger in einem aktiven Gespräch mit dem Agenten ist. Vielleicht möchtest du das Senden der proaktiven Nachricht bis zum Ende des Gesprächs verschieben, um den Gesprächsfluss nicht zu stören.

Die Option "Wenn der Chat mit dem Agenten aktiv ist " steuert das Verhalten:

• Senden: Der Agent sendet die proaktive Nachricht wie gewohnt.

• Nicht senden und trotzdem erfolgreich: Der Agent sendet die proaktive Nachricht nicht, wenn der Empfänger in einem aktiven Gespräch ist. Statuscode 300 wird zurückgegeben.

• Nicht senden und scheitern: Der Agent sendet die proaktive Nachricht nicht, wenn der Empfänger in einem aktiven Gespräch ist. Der Flow-Durchlauf wird als fehlerhaft markiert.

Wenn der Empfänger den Agenten nicht installiert hat

Der Agent kann nur Nachrichten an Empfänger zustellen, die den Agenten in Teams installiert haben. Manche Empfänger möchten den Agenten vielleicht nicht installieren oder deinstallieren den Agenten.

Für Nachrichten mit geringerer Bedeutung können Sie festlegen, dass die Flowausführung als erfolgreich gekennzeichnet wird, auch wenn der Empfänger den Agenten nicht installiert hat.

Die Option Wenn der Agent nicht installiert ist , steuert das Verhalten:

• Fehlschlag: Der Flow-Run wird als Fehlschlag markiert, wenn der Empfänger den Agenten in Teams nicht installiert hat.

• Erfolg mit Statuscode: Der Flow-Lauf wird als erfolgreich markiert, obwohl der Empfänger die Nachricht nicht empfangen kann, weil er den Agenten nicht installiert hat. Statuscode 100 wird zurückgegeben.

Statuscode-Definition

Verwenden Sie den zurückgegebenen Statuscode, um verschiedene Folgeverhaltensweisen in Ihrem Flow zu definieren. Zum Beispiel kannst du angeben, dass der Fluss über einen bestimmten Zeitraum erneut versuchen soll oder einen Datensatz über den Fehler protokollieren.