Inviare messaggi proattivi su Microsoft Teams

È possibile configurare messaggi proattivi per agenti e chatbot classici creati e personalizzati in Copilot Studio. Dopo aver pubblichi un agente e rendi l'agente disponibile per gli utenti in Microsoft Teams, può inviare messaggi proattivi per notificare agli utenti ("destinatari") in Teams. I messaggi proattivi usano flussi Power Automate per distribuire il contenuto e sono utili in molti scenari, tra cui:

• Far sapere al destinatario che la richiesta precedente è completata. Ad esempio, la richiesta di congedo dell'utente viene approvata.
• Fornire promemoria o aggiornamenti di notizie. Ad esempio, l'agente invia un promemoria per completare la formazione online.

Prerequisiti

• Pubblica e distribuisci agenti
• Connettere e configurare gli agenti per Microsoft Teams
• Introduzione a Power Automate
• Panoramica dei flussi cloud

Limitazioni note

• Se l'agente si disconnette e si riconnette a Teams, gli utenti non ricevono messaggi proattivi finché non reinstallano l'agente.
• Tutti i messaggi proattivi di Copilot Studio sono soggetti a limiti Power Automate e limiti di throttling del connettore Microsoft Teams.
• I messaggi proattivi non compaiono nelle trascrizioni delle conversazioni o nei dati delle sessioni di analisi.
• I messaggi proattivi devono trovarsi nello stesso ambiente del flusso di Power Automate.
• I messaggi proattivi possono essere inviati solo in una chat personale con l'agente.

Inviare un messaggio proattivo

1. In Power Automate aprire il flusso da usare per inviare un messaggio proattivo.

2. Aggiungi l'azione del Microsoft Teams connector Pubblica messaggio in una chat o in un canale.

3. Per Post as selezionare Microsoft Copilot Studio agent.

4. Per Invia in, seleziona Chat con agente.

5. Per l'agente, seleziona l'agente da cui vuoi che venga inviato il messaggio.

6. Per Destinatario, immetti il nome o l'indirizzo e-mail del destinatario. Puoi anche utilizzare il contenuto dinamico se le informazioni sul destinatario provengono da un passaggio precedente del flusso.

7. Per Messaggio, immetti il messaggio che vuoi inviare.

   Azione di postare messaggi in Power Automate.

Quando il flusso si avvia, il destinatario riceve il messaggio proattivo dall'agente in Teams.

Invia una Adaptive Card proattiva

Questa sezione illustra come inviare Adaptive Cards proattive usando flussi di Power Automate. Con una Carta Adattiva proattiva, gli utenti possono ricevere informazioni da una conversazione inattiva con un agente.

Adaptive Cards sono un formato di scambio di schede aperto che consente agli sviluppatori di scambiare contenuto dell'interfaccia utente in modo comune e coerente. È possibile creare Adaptive Cards manualmente in JSON o, se si preferisce un'interfaccia drag-and-drop, è possibile usare Adaptive Cards Designer.

In questo esempio, invii una scheda riepilogo dell'ordine che l'utente può esaminare.

1. In Power Automate, aggiungi l'azione del connettore Microsoft Teams Posta una scheda adattativa in una chat o in un canale nel passaggio del flusso in cui desideri inviare la scheda.

2. Per Post as selezionare Microsoft Copilot Studio agent.

3. Per Invia in, seleziona Chat con agente.

4. Per l'agente, seleziona l'agente da cui vuoi che venga inviato il messaggio.

5. Per Destinatario, immetti il nome o l'indirizzo e-mail del destinatario. Puoi anche utilizzare il contenuto dinamico se le informazioni sul destinatario provengono da un passaggio precedente del flusso.

6. Per Scheda adattiva, immetti il seguente modello JSON:

   {
       "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"
           }
       ]
   }
   

   

Quando il flusso si avvia, il destinatario riceve la Scheda Adattiva dall'agente in Teams.

Invia una Scheda Adattiva proattiva e attendi la risposta dell'utente

Adaptive Cards supportano la raccolta dell'input dell'utente. In questi scenari, è meglio aspettare la risposta dell'utente prima che il flusso continui.

In questo esempio, invii una scheda di conferma dell'ordine che permette all'utente di apportare modifiche prima che l'ordine venga inviato.

1. In Power Automate, aggiungere l'azione del connettore Microsoft Teams Posta una scheda adattiva e attendi una risposta nel passaggio in cui si vuole inviare la scheda nel flusso.

2. Per Post as selezionare Microsoft Copilot Studio agent.

3. Per Invia in, seleziona Chat con agente.

4. Per Messaggio, inserisci il seguente modello JSON. Le proprietà contenute nell'elemento actions determinano le opzioni che l'utente vede.

   {
       "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. Per il messaggio Aggiornamento, inserisci il messaggio che il destinatario vede dopo aver fornito la risposta.

6. Per Destinatario, immetti il nome o l'indirizzo e-mail del destinatario. Puoi anche utilizzare il contenuto dinamico se le informazioni sul destinatario provengono da un passaggio precedente del flusso.

7. Per l'Agente, seleziona l'agente da cui vuoi che venga inviata la carta.

   

Quando il flusso viene eseguito, il destinatario riceve la scheda adattiva dall'agente in Teams a cui può poi rispondere.

Per utilizzare la risposta del destinatario, seleziona submitActionId dal menu a comparsa del contenuto dinamico. Il valore di questa variabile è l'azione title selezionata dall'utente.

Inviare messaggi proattivi a più destinatari

In alcuni scenari, potresti voler inviare lo stesso messaggio proattivo a più destinatari.

Questa sezione contiene esempi per l'invio di messaggi a più destinatari.

Inviare a membri del team

In questo esempio, l'agente invia un promemoria ai membri del team per completare la formazione online.

1. Aggiungere il connettore Microsoft Teams e selezionare l'azione Get a team nel flusso di Power Automate.

2. Per Team, scegli il team con i membri a cui vuoi inviare il messaggio.

3. Aggiungere il connettore Office 365 Groups e selezionare l'azione List group members.

4. Seleziona Valore personalizzato nel campo ID gruppo.

5. Seleziona ID Team dal contenuto dinamico dell'azione Recupera un team.

6. Aggiungere il connettore Microsoft Teams e selezionare l'azione Pubblica messaggio in una chat o in un canale.

7. Per Post as selezionare Microsoft Copilot Studio agent.

8. Per Invia in, seleziona Chat con agente.

9. Per l'agente, seleziona l'agente da cui vuoi che venga inviato il messaggio.

10. Per Destinatario seleziona il contenuto dinamico Nome dell'entità utente dall'azione Elenca membri del gruppo.

    

11. Per Messaggio, immetti il messaggio che vuoi inviare.

Quando il flusso si avvia, ogni utente del team riceve il messaggio proattivo in una chat privata con l'agente.

Inviare a un gruppo di sicurezza

In questo esempio, l'agente invia un promemoria a un gruppo di sicurezza per completare la formazione online.

1. Aggiungere il connettore Microsoft Entra ID e selezionare l'azione Get group members nel flusso di Power Automate.

2. Per ID gruppo, immetti il GUID del gruppo di sicurezza.

3. Aggiungere il connettore Microsoft Teams e selezionare l'azione Pubblica messaggio in una chat o in un canale.

4. Per Post as selezionare Microsoft Copilot Studio agent.

5. Per Invia in, seleziona Chat con agente.

6. Per l'agente, seleziona l'agente da cui vuoi che venga inviato il messaggio.

7. Per Destinatario, seleziona il contenuto dinamico Nome principale utente membri del gruppo dall'azione Recupera membri del gruppo.

8. Per Messaggio, immetti il messaggio che vuoi inviare.

   

Quando il flusso si avvia, ogni utente del gruppo di sicurezza riceve il messaggio proattivo in una chat privata con l'agente.

Inviare un messaggio proattivo a più destinatari in parallelo

Normalmente, quando un agente invia un messaggio proattivo a più destinatari, invia uno dopo l'altro. Tuttavia, in alcune situazioni, potrebbe essere meglio inviare il messaggio a più destinatari contemporaneamente.

1. Nella sezione Applica a ogni azione, seleziona i tre punti (...) e poi seleziona Impostazioni.

   

2. Attiva Controllo della concorrenza e imposta il grado di parallelismo.

   

Configurare le opzioni avanzate per i messaggi proattivi

Copilot Studio consente di controllare il comportamento dettagliato dell'agente in Visualizza opzioni avanzate nel connettore Microsoft Teams.

Etichettare il messaggio inviato come notifica

Etichetta come notifica controlla se il messaggio avrà il testo "Notifica tramite" davanti al nome dell'agente. L'etichettatura della risposta dell'agente consente al destinatario di identificare la risposta dell'agente alla richiesta.

Quando il destinatario è attualmente in una chat attiva con l'agente

Un agente potrebbe inviare un messaggio proattivo quando il destinatario è in una conversazione attiva con lui. Potresti voler rimandare l'invio del messaggio proattivo alla fine della conversazione per evitare di interrompere il flusso della conversazione.

L'opzione Se la chat con l'agente è attiva controlla il comportamento:

• Invia: l'agente invia il messaggio proattivo come al solito.

• Non inviare per riuscire: l'agente non invia il messaggio proattivo quando il destinatario sta partecipando a una conversazione attiva. Il codice di stato 300 viene restituito.

• Non inviare in caso di errore: l'agente non invia il messaggio proattivo quando il destinatario è in una conversazione attiva. L'esecuzione del flusso viene contrassegnata come un errore.

Quando il destinatario non ha installato l'agente

L'agente può consegnare messaggi solo ai destinatari che l'hanno installato in Teams. Alcuni destinatari potrebbero non voler installare l'agente o disinstallarlo.

Per i messaggi di importanza inferiore, è possibile impostare che l'esecuzione del flusso sia contrassegnata come riuscita anche quando il destinatario non ha installato l'agente.

L'opzione Se l'agente non è installato controlla il comportamento:

• Errore: l'esecuzione del processo viene contrassegnata come errore quando il destinatario non ha installato l'agente in Teams.

• Riuscito con codice di stato: l'esecuzione del flusso viene contrassegnata come riuscita anche quando il destinatario non ha installato l'agente, quindi non può ricevere il messaggio. Il codice di stato 100 viene restituito.

Definizione del codice di stato

Usa il codice di stato restituito per definire diversi comportamenti di follow-up nel tuo flusso. Ad esempio, puoi specificare che il flusso dovrebbe riprovare nel corso di un certo periodo di tempo o registrare un record sull'errore.