Proaktif Microsoft Teams iletileri gönderme

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Copilot Studio'da oluşturup özelleştirdiğiniz aracılar ve klasik sohbet botları için proaktif iletiler yapılandırabilirsiniz. Bir aracıyı yayınladıktan ve Microsoft Teams'de kullanıcıların kullanımına sunduktan sonra, bu araç Teams'de kullanıcıları ("alıcılar") bilgilendirmek için proaktif iletiler gönderebilir. Proaktif iletiler, içeriklerini teslim etmek için Power Automate akışlarını kullanır ve aşağıdakiler gibi birçok senaryoda kullanışlıdır:

• Alıcıya önceki talebinin tamamlandığını bildirmek. Örneğin, kullanıcının izin talebi onaylandı.
• Hatırlatıcılar veya haber güncellemeleri sunma. Örneğin, temsilci çevrimiçi eğitimi tamamlamanız için bir hatırlatma gönderir.

Important

Bir aracı, alıcı şu durumlarda iletileri teslim edemez:

• Ajanı Teams'e yüklemez.
• Ajanı kaldır.
• Ajanı engelliyor.
• Temsilciyle konuşma izni yok. Bu durumda, acenteni paylaşmanız gerekir.

Prerequisites

• Ajanları yayınla ve dağıt
• Microsoft Teams için aracıları bağlayın ve yapılandırın
• Power Automate'i kullanmaya başlama
• Bulut akışlarına genel bakış

Bilinen sınırlamalar

• Ajan bağlantıyı kesip Teams'e yeniden bağlanırsa, kullanıcılar ajanı yeniden yüklemeden proaktif mesajlar alamazlar.
• Copilot Studio'dan gelen tüm proaktif mesajlar, Power Automate sınırları ve Microsoft Teams bağlayıcısının kısıtlama sınırlarına tabidir.
• Proaktif mesajlar konuşma transkriptlerinde veya analiz oturum verilerinde görünmez.
• Proaktif iletiler Power Automate akışıyla aynı ortamda olmalıdır.
• Proaktif mesajlar yalnızca temsilciyle yapılan kişisel sohbete gidebilir.

Proaktif ileti gönderme

1. Power Automate'da, proaktif ileti göndermek için kullanmak istediğiniz akışı açın.

2. Microsoft Teams bağlayıcı eylemini ekleyin İletiyi sohbete veya kanala gönderin.

3. Post as için Microsoft Copilot Studio agent öğesini seçin.

4. Gönder için, Temsilciyle Sohbet seçeneğini seçin.

5. Agent için, mesajın gönderilmesini istediğiniz ajanı seçin.

6. Alıcı için alıcının adını veya e-posta adresini girin. Alıcı bilgileri akışta önceki bir adımdan geliyorsa dinamik içerik de kullanabilirsiniz.

7. İleti için göndermek istediğiniz iletiyi girin.

   

Akış çalıştığında, alıcı Teams'teki ajan tarafından gönderilen proaktif mesajı alır.

Proaktif Uyarlamalı Kart gönderme

Bu bölümde, Power Automate akışlarını kullanarak proaktif olarak Adaptive Card gönderme işlemi açıklanmaktadır. Proaktif bir Adaptif Kartta, kullanıcılar bir ajanla aktif olmayan bir konuşmadan bilgi alabilirler.

Uyarlamalı Kartlar, geliştiricilerin kullanıcı arabirimi içeriğini ortak ve tutarlı bir şekilde değiştirmelerine olanak tanıyan açık bir kart değişimi biçimidir. JSON'da el ile Uyarlamalı Kartlar yazabilir veya sürükleyip bırakma arabirimini tercih ediyorsanız Uyarlamalı Kartlar Designer kullanabilirsiniz.

Note

Power Automate, templating özelliğini kullanan Uyarlamalı Kartlar'ı desteklemez.

Bu örnekte, kullanıcının incelemesi için bir sipariş özeti kartı gönderirsiniz.

1. Power Automate'te, akışınızda kart göndermek istediğiniz adıma Microsoft Teams bağlayıcı eylemi Bir sohbete veya kanala uyarlamalı kart gönder ekleyin.

2. Post as için Microsoft Copilot Studio agent öğesini seçin.

3. Gönder için, Temsilciyle Sohbet seçeneğini seçin.

4. Agent için, mesajın gönderilmesini istediğiniz ajanı seçin.

5. Alıcı için alıcının adını veya e-posta adresini girin. Alıcı bilgileri akışta önceki bir adımdan geliyorsa dinamik içerik de kullanabilirsiniz.

6. Uyarlamalı Kart için aşağıdaki JSON şablonunu girin:

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

   

Akış çalıştığında, alıcı Teams'teki ajandan Adaptif Kart alır.

Proaktif bir Adaptif Kart gönderin ve kullanıcı yanıtını bekleyin

Uyarlamalı Kartlar, kullanıcı girdisi toplamayı destekler. Bu durumlarda, akış devam etmeden önce kullanıcının yanıtını beklemelisiniz.

Note

Power Automate, templating özelliğini kullanan Uyarlamalı Kartlar'ı desteklemez.

Bu örnekte, sipariş gönderilmeden önce kullanıcının değişiklik yapmasına izin veren bir sipariş onay kartı gönderirsiniz.

1. Power Automate içinde Microsoft Teams bağlayıcı eylemi olan Uyarlamalı kartı gönder ve yanıt bekle eylemini, kartı göndermek istediğiniz adımda akışınıza ekleyin.

2. Post as için Microsoft Copilot Studio agent öğesini seçin.

3. Gönder için, Temsilciyle Sohbet seçeneğini seçin.

4. Mesaj için aşağıdaki JSON şablonunu girin. Öğedeki özellikler, actions kullanıcının gördüğü seçenekleri belirler.

   {
       "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. Mesajı güncellemek için, alıcının yanıtını verdikten sonra gördüğü mesajı girin.

6. Alıcı için alıcının adını veya e-posta adresini girin. Alıcı bilgileri akışta önceki bir adımdan geliyorsa dinamik içerik de kullanabilirsiniz.

7. Agent için, kartın gönderilmesini istediğiniz temsilciyi seçin.

   

Akış çalıştığında, alıcı Teams'teki ajandan uyarlanabilir kartı alır ve bu karta yanıt verebilir.

Alıcıdan gelen yanıtı kullanmak için dinamik içerik açılır menüsünden submitActionId öğesini seçin. Bu değişkenin title değeri, kullanıcının seçtiği eylemin değeridir.

Proaktif iletileri birden çok alıcıya gönderme

Bazı senaryolarda, aynı proaktif iletiyi birden çok alıcıya göndermek isteyebilirsiniz.

Bu bölüm, birden çok alıcıya ileti gönderme örnekleri içermektedir.

Important

Her alıcı, bu makalede belirtilen ön koşulları karşılamalıdır.

Örneğin, bir eylemde aynı iletiyi en fazla 10 alıcıya gönderebilirsiniz. 10 alıcıdan üçünde ajan kurulu değilse, bu üç alıcı mesajı almıyor.

Takım arkadaşlarına gönderme

Bu örnekte, temsilci bir takım üyelerine çevrimiçi eğitimlerini tamamlamaları için bir hatırlatma gönderir.

1. Microsoft Teams bağlayıcısını ekleyin ve Power Automate akışınızda Ekip edinin eylemini seçin.

2. Takım için iletiyi göndermek istediğiniz üyelerin bulunduğu takımı seçin.

3. Office 365 Groups bağlayıcısını ekleyin ve Liste grubu üyeleri eylemini seçin.

4. Grup Kimliği için Özel değer'i seçin.

5. Takım al eyleminin dinamik içeriğinden Takım Kimliği'ni seçin.

6. Microsoft Teams bağlayıcısını ekleyin ve İletiyi sohbette veya kanalda paylaş eylemini seçin.

7. Post as için Microsoft Copilot Studio agent öğesini seçin.

8. Gönder için, Temsilciyle Sohbet seçeneğini seçin.

9. Agent için, mesajın gönderilmesini istediğiniz ajanı seçin.

10. Alıcı için Grup üyelerini listele eyleminden Kullanıcı Asıl Adı dinamik içeriğini seçin.

    

11. İleti için göndermek istediğiniz iletiyi girin.

Akış çalıştığında, ekipteki her kullanıcı ajanla özel bir sohbette proaktif mesajı alır.

Güvenlik grubuna gönderme

Bu örnekte, temsilci bir güvenlik grubuna çevrimiçi eğitimlerini tamamlamaları için bir hatırlatma gönderir.

1. Microsoft Entra ID bağlayıcısını ekleyin ve Power Automate akışınızda Grup üyelerini al eylemini seçin.

2. Grup Kimliği için güvenlik grubunun GUID değerini girin.

3. Microsoft Teams bağlayıcısını ekleyin ve İletiyi sohbette veya kanalda paylaş eylemini seçin.

4. Post as için Microsoft Copilot Studio agent öğesini seçin.

5. Gönder için, Temsilciyle Sohbet seçeneğini seçin.

6. Agent için, mesajın gönderilmesini istediğiniz ajanı seçin.

7. Alıcı için Grup üyelerini al eyleminden Grup Üyeleri Kullanıcı Asıl Adı dinamik içeriğini seçin.

8. İleti için göndermek istediğiniz iletiyi girin.

   

Akış çalıştığında, güvenlik grubundaki her kullanıcı ajanla özel bir sohbette proaktif mesajı alır.

Proaktif iletiyi birden çok alıcıya eşzamanlı olarak gönderme

Genellikle, bir ajan proaktif bir mesajı birden fazla alıcıya gönderdiğinde, ardına bir mesaj gönderir. Ancak bazı durumlarda, mesajı aynı anda birden fazla alıcıya göndermek daha iyi olabilir.

Warning

Copilot Studio'dan gelen tüm proaktif iletiler, Power Automate üzerindeki limitlere ve Microsoft Teams bağlayıcısının kısıtlama limitlerine tabidir.

Eğer büyük bir alıcı grubuna mesaj gönderiyorsanız, throttling limitine ulaştığınızda hata görürsünüz. Paralellik düzeyini veya gruptaki alıcı sayısını azaltabilirsiniz.

1. Her eyleme Uygula bölümünde üç noktayı (...) seçin ve ardından Ayarlar'ı seçin.

   

2. Eşzamanlılık denetimi'ni açın ve paralellik derecesini ayarlayın.

   

Proaktif iletiler için gelişmiş seçenekleri yapılandırma

Copilot Studio, Microsoft Teams bağlayıcısında Gelişmiş seçenekleri göster altında aracınızdaki ayrıntılı davranışı denetlemenize olanak tanır.

Gönderilen iletiyi bildirim olarak etiketleme

Bildirim olarak etiketle, iletide temsilcinin adından önce "Bildirim yoluyla" metninin gösterilip gösterilmeyeceğini belirler. Temsilcinin yanıtının etiketlenmesi, alıcının kendi sorgusuna verilen temsilci yanıtını belirlemesini sağlar.

Alıcı şu anda temsilciyle aktif bir sohbet içindeyse

Bir ajan, alıcı ajanla aktif bir konuşma halinde olduğunda proaktif bir mesaj gönderiyor olabilir. Konuşma akışını bozmamak için proaktif mesajı göndermeyi konuşmanın sonuna kadar ertelemek isteyebilirsiniz.

Eğer danışmanla sohbet aktifse seçeneği davranışı kontrol eder:

• Gönder: Ajan, proaktif mesajı normal şekilde gönderir.

• Gönderme ve başarılı ol: Alıcı aktif bir konuşmadayken ajan, proaktif mesajı göndermez. Durum kodu 300 geri döndürüldü.

• Gönderip başarısız olmayın: Alıcı aktif bir konuşmadayken ajan, proaktif mesajı göndermez. Akış çalışması hata olarak işaretlendi.

Alıcı aracıyı yüklemediğinde

Ajan, yalnızca Teams'e ajanı kuran alıcılara mesaj iletebilir. Bazı alıcılar ajanı yüklemek istemeyebilir veya ajanı kaldırabilir.

Daha düşük öneme sahip iletiler için alıcının aracıyı yüklemediği durumlarda bile akış çalıştırmasını başarılı olarak işaretlenecek şekilde ayarlayabilirsiniz.

Ajan kurulu değilse seçeneği şu davranışı kontrol eder:

• Başarısızlık: Alıcı ajanı Teams'e yüklemediğinde akış çalıştırması hata olarak işaretlenir.

• Durum kodu ile başarı: Alıcı ajanı yüklemediği için mesajı alamasa da, akış çalıştırması başarılı olarak işaretlenir. Durum kodu 100 döndürüldü.

Durum kodu tanımı

Akışınızda farklı takip davranışlarını tanımlamak için geri dönen durum kodunu kullanın. Örneğin, akışın belirli bir süre içinde tekrar denemesi veya hata hakkında bir kayıt kaydı kaydetmesi gerektiğini belirtebilirsiniz.

Durum kodu	Başarılı (Boolean)	Description
200	True	İleti başarıyla teslim edildi.
100	False	Mesaj teslim edilemez çünkü alıcının üzerinde yazılım aracı yüklü değil.
300	False	Mesaj iletilemez çünkü alıcı temsilciyle aktif bir konuşmada.