Aracılığıyla paylaş

Beceri olarak klasik bir sohbet botu kullanma

  • Makale

Önemli

Power Virtual Agents yetenekleri ve özellikleri, Microsoft Copilot genelinde üretken yapay zekaya ve gelişmiş tümleştirmelere yapılan önemli yatırımların ardından artık Microsoft Copilot Studio'nun parçasıdır.

Bazı makalelerde ve ekran görüntülerinde, belgeler ve eğitim içeriği güncelleştirilirken Power Virtual Agents'a başvurulabilir.

Not

Bu makale yalnızca Microsoft Copilot Studio klasik sohbet botları için geçerli bilgileri içerir. Bu özellik yeni Microsoft Copilot Studio deneyiminde kullanılamaz.

Microsoft Copilot Studio yardımcı pilotunu bir Bot Framework botu ile beceri olarak kullandığınızda Bot Framework botu, kullanıcının söylediği herhangi bir şeyin Microsoft Copilot Studio yardımcı pilotunun tetikleyici ifadeleri ile eşleşip eşleşmediğini belirler. Eşleşme varsa Bot Framework botu konuşmayı Microsoft Copilot Studio botuna iletir. Microsoft Copilot Studio yardımcı pilotu tüm varlıkları ayıklar ve eşleşen konuyu tetikler.

Ayrıca Bot Framework Composer'dan bir değişkeni giriş olarak Microsoft Copilot Studio beceri konusuna iletebilir ve döndürülen çıktıları kullanabilirsiniz.

Önemli

Microsoft Copilot Studio botlarını beceri olarak kullanmak için deneme veya tam Microsoft Copilot Studio lisansına sahip olmanız gerekir. Bu özellik Teams Microsoft Copilot Studio lisansı ile kullanılamaz.

Microsoft Copilot Studio yardımcı pilotunuzu bir beceri olarak ayarlamak için:

  1. Microsoft Copilot Studio yardımcı pilotu için izin verilenler listesine Bot Framework botunu ekleyin.
  2. Microsoft Copilot Studio yardımcı pilotu için beceri bildirimini indirin.
  3. Botlar arasında bir bağlantı oluşturmak için Bot Framework Composer'da indirilen beceri bildirimini kullanın.
  4. Botun bir beceri olarak çalıştığını doğrulamak için Bot Framework Emulator'ı kulanın.

Önkoşullar

Bot Framework botunuzu Microsoft Copilot Studio yardımcı pilotunuz için izin verilenler listesine ekleyin

Bot Framework botunun uygulama kimliğini, beceri olarak kullanmak istediğiniz Microsoft Copilot Studio yardımcı pilotunun izin verilenler listesine ekleyin. Botlar aynı kiracıda olmalıdır.

  1. Bot Framework Composer'da, beceriyi kullanacak olan botu açın. Yapılandır'ı ve ardından Geliştirme kaynakları'nı seçin. Microsoft Uygulama Kimliği alanındaki kimliği kopyalayın.

    Bot Framework botunun uygulama kimliğinin nerede bulunacağını vurgulayan ekran görüntüsü.

  2. Microsoft Copilot Studio'ta beceri olarak kullanmak istediğiniz yardımcı pilotu açın.

  3. Gezinti menüsünde Ayarlar'a gidin ve Güvenlik'i seçin. Ardından İzin verilenler listesi öğesini seçin.

    Güvenlik sayfasında İzin Verilenler Listesi kutucuğunu vurgulayan ekran görüntüsü.

  4. İzin verilen arayanı ekle'yi seçin.

    İzin verilenler listesini yönet panelinin üst kısmında İzin verilen arayanı ekle düğmesini vurgulayan ekran görüntüsü.

  5. Bot Framework botunuzun uygulama kimliğini yapıştırın ve İleri'yi seçin.

    Bot Framework botunun uygulama kimliğinin nereye girileceğini vurgulayan ekran görüntüsü.

    Dikkat

    Bir Microsoft Copilot Studio yardımcı pilotu, diğer Microsoft Copilot Studio yardımcı pilotları için bir beceri görevi göremez. İzin verilenler listesine Power Virtual Agent botuna ait bir uygulama kimliği eklemeyi denerseniz hata alırsınız. Yalnızca bir Bot Framework botu için uygulama kimliği ekleyebilirsiniz.

    Microsoft Copilot Studio, Bot Framework botunun uygulama kimliğini doğrular ve aynı kiracıda dağıtılan bir bota ait olduğunu onaylar.

  6. (İsteğe bağlı) İzin verilenler listesine eklediğiniz bot için Görünen ad ekleyin.

    İzin verilenler listesinde botun görünen adının nereye ekleneceğini gösteren ekran görüntüsü.

  7. Kaydet'i seçin.

Bot Framework botu, görünen ad girdiyseniz görünen adıyla veya görünen ad girmediyseniz uygulama kimliğiyle gösterilir. İstediğiniz zaman silmek veya düzenlemek için botun görünen adının veya uygulama kimliğinin sağındaki simgeyi seçin.

İzin verilen bir bot için düzenleme ve silme simgelerini gösteren İzin verilenler listesini yönet panelinin ekran görüntüsü.

Not

İzin verilenler listesine eklenen Bot Framework botları bot içeriğinin bir parçası olarak dışa aktarılmaz.

Microsoft Copilot Studio yardımcı pilotunuz için yardımcı pilot beceri bildirimini indirin

Bot Framework botları, bildirimi üreten copilot ile bir bağlantı yapılandırmak için bir Microsoft Copilot Studio beceri bildirimi kullanabilir.

Tüm Microsoft Copilot Studio yardımcı pilotlarının beceri bildirimleri vardır. Bunlar, bir becerinin adını, arabirimini ve tetikleme tümceciklerini içeren JSON dosyalarıdır.

Bot Framework botu, Microsoft Copilot Studio botunu ne zaman tetikleyeceğini bilmek için bir beceri bildirimi kullanabilir (örneğin, kullanıcının kendisine söylediği bir şeye yanıt olarak).

Microsoft Copilot Studio beceri bildirimleri, Bot Framework beceri bildirim şemasının 2.2 sürümüne uygundur ve intents.lu ve manifest.json dosyalarından oluşur.

Bir Bot Framework botu, bildirim verilerine dayanarak bir Microsoft Copilot Studio yardımcı pilotunun kullanıcının isteğini yerine getirmesine karar verebilir. Kullanıcının dediği her şey yardımcı pilota geçer. Ardından, Microsoft Copilot Studio yardımcı pilotu, kullanıcının söylediklerini bir Microsoft Copilot Studio konusuna eşleştirir, yuva doldurma için gereken varlıkları ayıklar ve Microsoft Copilot Studio konusunu tetikler.

Microsoft Copilot Studio beceri bildirimleri otomatik olarak oluşturulur ve güncelleştirilir. Bir Microsoft Copilot Studio yardımcı pilotun iki beceri bildirimi vardır:

  • Test bildirimi: Bot Framework botunun Microsoft Copilot Studio yardımcı pilotunuzun test sürümüne bağlanmasını sağlar. Yayımlamadan önce becerinizdeki değişiklikleri doğrulamak için test bildirimini kullanın.

    • Test bildirimi, yeni oluşturulan tüm Microsoft Copilot Studio botları için hemen kullanılabilir.
    • Yardımcı pilotunuzu her kaydettiğinizde değişiklikleri yansıtacak şekilde otomatik olarak güncelleştirilir.

  • Yayımlanmış bildirim: Bot Framework botunun Microsoft Copilot Studio yardımcı pilotunuzun yayımlanan sürümüne bağlanmasını sağlar.

    • Yayımlanan bildirim yalnızca en az bir kez yayımlanmış Microsoft Copilot Studio yardımcı pilotları için kullanılabilir.
    • Yardımcı pilotunuzu yayımlama işlemini her yaptığınızda değişiklikleri yansıtacak şekilde otomatik olarak güncelleştirilir.

Not

Yayımlanmış bildirim, hiç yayınlanmamış Microsoft Copilot Studio yardımcı pilotları için kullanılamaz.

Botunuzun Yayınlanmış bildirim'ini oluşturmak için Microsoft Copilot Studio yardımcı pilotunuzu yayımlayın.

Her iki beceri bildirimi de İzin verilenler listesini yönet panelinde gösterilir.

Microsoft Copilot Studio yardımcı pilot bildirimlerini gösteren İzin Verilenler Listesini Yönet panelinin ekran görüntüsü.

Beceri bildirimleri, yardımcı pilotun Ayrıntılar sayfasında da gösterilir. Gezinti menüsünde Ayarlar'ı seçin ve ardından Ayrıntılar seçeneğini belirleyin. Ayrıntılar sayfası Ortam Kimliği, Kiracı Kimliği ve Bot uygulama kimliği gibi diğer meta verileri gösterir.

Microsoft Copilot Studio yardımcı pilot bildirimlerinin nereden indirileceğini vurgulayan Ayrıntılar sayfasının ekran görüntüsü.

Bildirimi seçip indirin. Bildirim Yayımlanan bildirim için <bot name>_manifest veya Test bildirimi için <bot name>_test__manifest etiketli bir .zip dosyası olarak indirilir.

İndirildikten sonra iki Microsoft Copilot Studio bildirimini gösteren ekran görüntüsü.

Not

Beceri bildirimi, bir Microsoft Copilot Studio yardımcı pilotuna eklenen sistem konularını ve Composer iletişim kutularını içermez. Yalnızca yardımcı pilot yazarları tarafından oluşturulan konular ve yazarların bota eklediği Composer amaç tetikleyicileri dahil edilir.

Composer'da bir Microsoft Copilot Studio becerisine bağlanma

Composer'daki Bot Framework botunuzda bir beceri bağlantısı oluşturmak için Microsoft Copilot Studio beceri bildirimlerini kullanabilirsiniz.

  1. Bot Framework Composer projesinde Ekle'yi ve ardından Beceriye bağlan'ı seçin.

    Bot Framework botunu bir beceriye bağlamayı gösteren Bot Framework Composer ekran görüntüsü.

  2. Microsoft Copilot Studio bildirimi .zip arşivine gidip bunu seçin ve ardından İleri'yi seçin.

    Microsoft Copilot Studio becerisi sıkıştırılmış arşivinin nerede seçileceğini gösteren Composer ekran görüntüsü.

  3. Microsoft Copilot Studio yardımcı pilotunuzda Bot Framework botunuza eklemek istediğiniz konuları veya amaçları seçin ve ardından İleri'yi seçin.

    Microsoft Copilot Studio konularının seçimini gösteren Composer ekran görüntüsü.

  4. Microsoft Copilot Studio yardımcı pilotunuz için tetikleyici ifadeleri gözden geçirip düzenleyin ve ardından İleri'yi seçin.

    Seçili konuların tetikleme tümceciklerinin nerede düzenleneceğini gösteren Composer ekran görüntüsü.

  5. Birden çok bot içeren projeler için Düzenleyici kullan seçeneğinin belirlendiğinden emin olun ve ardından Devam'ı seçin.

    Düzenleyicinin açık olduğunu gösteren Composer ekran görüntüsü.

  6. Microsoft Copilot Studio becerisinin Bot Framework botunuza doğru şekilde eklendiğini ve Composer'daki projede Microsoft Copilot Studio yardımcı pilotunuzun adıyla yeni bir tetikleyicinin görüntülendiğini doğrulayın.

    Microsoft Copilot Studio becerisi eklendikten sonra Composer'ın ekran görüntüsü.

Beceri bildiriminde konuyu bulma

Bir olayı, becerideki bir Microsoft Copilot Studio konusunu tetiklemek için kullanın. Composer'dan belirli bir konuyu çağırmak için konuya beceri bildirimindeki ilgili olayın adına göre bakın.

  1. Beceriye bağlan eylemini seçin.

  2. Beceri Diyalog Adı altında Beceri bildirimini göster'i seçin.

    Beceri bildiriminin nerede gösterileceğini vurgulayan Composer ekran görüntüsü.

  3. Bildirimdeki etkinlikleri bulun. Bu özellik, Microsoft Copilot Studio yardımcı pilotunuzda bulunan konuları temsil eden iç içe geçmiş özellikler içerir.

    Etkinlikler özelliğini vurgulayan bir beceri bildiriminin ekran görüntüsü.

  4. Çağırmak istediğiniz konuyu bulun ve ad özelliğini arayın. Microsoft Copilot Studio becerisi bu ada sahip bir olay aldığında, konu tetiklenir.

    Aşağıdaki örnekte, olay etkinlik adı dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d şeklindedir.

    Bildirimde Microsoft Copilot Studio konu adını vurgulayan ekran görüntüsü.

Microsoft Copilot Studio beceri konusu çağırma

Microsoft Copilot Studio beceri konusunu kullanıcının bir şeyler söyleyerek tetiklemesi yerine doğrudan çağırabilirsiniz. Yalnızca beceri bildiriminde listelenen Microsoft Copilot Studio konularını doğrudan çağırabilirsiniz.

  1. Composer yazma tuvalinde, Ekle'yi seçin, Dış kaynaklara eriş'i ve ardından Beceriye bağlan'ı seçin.

    Beceriye nasıl bağlanılacağını vurgulayan Composer ekran görüntüsü.

  2. Beceri Diyaloğu Adı listesinde Microsoft Copilot Studio yardımcı pilotunuzu seçin.

    Microsoft Copilot Studio yardımcı pilotunuzun nereden seçeceğinizi vurgulayan ekran görüntüsü.

  3. Çağırmak istediğiniz Microsoft Copilot Studio bot konusu için olay etkinliğinin adını bulun. Değeri, tırnak işaretlerini atlayarak kopyalayın ve sonraki adımlarda kullanmak üzere kaydedin.

  4. Kapat'ı seçin.

  5. Etkinlik bölmesinde, Kodu göster'i seçin.

    Kodu Göster'i nerede seçeceğinizi vurgulayan ekran görüntüsü.

  6. Aşağıdaki kodu yazın veya yapıştırın. TOPIC_ACTIVITY_NAME öğesini konunuzun olay etkinlik adıyla değiştirin. Ad özelliğinde hiçbir tırnak işareti olmadığından emin olun.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

    Microsoft Copilot Studio konu adına sahip Etkinlik olayı kodunun nereye ekleneceğini vurgulayan ekran görüntüsü.

Bir Microsoft Copilot Studio becerisine giriş değişkeni iletme

Bot Framework Composer, bir Microsoft Copilot Studio beceri konusuna giriş olarak bir değişken iletebilir. Giriş değişkenlerini kabul eden Microsoft Copilot Studio konularının nasıl oluşturulacağını öğrenmek için Konular arasında değişkenleri iletme bölümüne bakın.

Beceri bildiriminiz içinde listelenmiş bir giriş değişkenini alabilen Microsoft Copilot Studio konusu varsa buna bir Composer değişkeni iletebilirsiniz.

  1. Composer yazma tuvalinde, Ekle'yi seçin, Dış kaynaklara eriş'i ve ardından Beceriye bağlan'ı seçin.

    Beceriye nasıl bağlanılacağını vurgulayan Composer ekran görüntüsü.

  2. Beceri Diyaloğu Adı listesinde Microsoft Copilot Studio yardımcı pilotunuzu seçin.

    Microsoft Copilot Studio yardımcı pilotunuzun nereden seçeceğinizi vurgulayan ekran görüntüsü.

  3. Çağırmak istediğiniz Microsoft Copilot Studio yardımcı pilot konusu için olay etkinliğinin adını bulun. Değeri, tırnak işaretlerini atlayarak kopyalayın ve sonraki adımlarda kullanmak üzere kaydedin.

  4. Konunun değer özelliğini bulun. Değer özelliği $ref özelliğini içerir. Bu değeri kopyalayın ve sonraki adımda kullanmak üzere kaydedin.

    Uyarı

    Bir Microsoft Copilot Studio konusunda girişler yoksa bu konu, değer özelliğini içermez.

    Değer özelliğini vurgulayan bir beceri bildiriminin ekran görüntüsü.

  5. Tanımlar özelliğini bulun ve ardından önceki adımda bulduğunuz $ref değeriyle eşleşen bir iç içe özellik arayın. Microsoft Copilot Studio konu girişlerinin adlarını ve türlerini not edin. Bunları sonraki adımlarda kullanırsınız.

    Microsoft Copilot Studio konusunun giriş değişkenlerinin nerede bulunacağını vurgulayan beceri bildiriminin ekran görüntüsü.

  6. Kapat'ı seçin.

  7. Etkinlik bölümü altında, Kodu göster'i seçin.

    Kodu Göster'i nerede seçeceğinizi vurgulayan ekran görüntüsü.

  8. Aşağıdaki kodu yazın veya yapıştırın. Bu değerleri değiştirin:

    1. TOPIC_ACTIVITY_NAME öğesini konunuzun olay etkinlik adıyla değiştirin.
    2. PVA_INPUT_VARIABLE öğesini konunuzdaki bir giriş değişkeniyle değiştirin.
    3. COMPOSER_INPUT_VARIABLE öğesini, bir değer sağlayacak Composer değişkeniyle değiştirin.
    [Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]

    Aşağıdaki örnekte Composer değişkeni, dialog.storeLocation pva_StoreLocation Microsoft Copilot Studio yardımcı pilot konusundaki dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16giriş değişkenine bir değer sağlar.

    Microsoft Copilot Studio giriş değerine sahip Etkinlik olayı kodunun nereye ekleneceğini vurgulayan ekran görüntüsü.

Bir Microsoft Copilot Studio beceri konusundan çıkış değişkeni alma

Composer'da bir Microsoft Copilot Studio beceri konusundan çıkış almak mümkündür. Çıkışlar döndüren Microsoft Copilot Studio konularının nasıl oluşturulacağını öğrenmek için Konular arasında değişkenleri iletme bölümüne bakın.

  1. Composer yazma tuvalinde, Ekle'yi seçin, Dış kaynaklara eriş'i ve ardından Beceriye bağlan'ı seçin.

    Beceriye nasıl bağlanılacağını vurgulayan Composer ekran görüntüsü.

  2. Beceri Diyaloğu Adı listesinde Microsoft Copilot Studio yardımcı pilotunuzu seçin.

    Microsoft Copilot Studio yardımcı pilotunuzun nereden seçeceğinizi vurgulayan ekran görüntüsü.

  3. Çağırmak istediğiniz Microsoft Copilot Studio bot konunuz için olay etkinliğinin adını bulun. Değeri, tırnak işaretlerini atlayarak kopyalayın ve sonraki adımlarda kullanmak üzere kaydedin.

  4. Konunun resultValue özelliğini bulun. resultValue özelliği $ref özelliğini içerir. Bu değeri kopyalayın ve sonraki adımda kullanmak üzere kaydedin.

    Uyarı

    Bir Microsoft Copilot Studio konusunda çıkışlar yoksa bu konu, resultValue özelliğini içermez.

    Microsoft Copilot Studio konusunun resultValue özelliğini vurgulayan beceri bildiriminin ekran görüntüsü.

  5. Tanımlar özelliğini bulun ve ardından önceki adımda bulduğunuz $ref değeriyle eşleşen bir iç içe özellik arayın. Microsoft Copilot Studio konusunun çıkış değişkenlerinin adlarını ve türlerini not edin. Bunları sonraki adımlarda kullanırsınız.

    Aşağıdaki örnekte Microsoft Copilot Studio konusu, pva_State ve pva_Item şeklinde iki tür string çıkışı döndürür.

    Microsoft Copilot Studio konusunun çıkış değişkenlerinin nerede bulunacağını vurgulayan beceri bildiriminin ekran görüntüsü.

  6. Kapat'ı seçin.

  7. Etkinlik bölmesinde, Kodu göster'i seçin.

    Kodu Göster'i nerede seçeceğinizi vurgulayan ekran görüntüsü.

  8. Aşağıdaki kodu yazın veya yapıştırın. TOPIC_ACTIVITY_NAME öğesini konunuzun olay etkinlik adıyla değiştirin. Ad özelliğinde hiçbir tırnak işareti olmadığından emin olun.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

    Microsoft Copilot Studio konu adına sahip Etkinlik olayı kodunun nereye ekleneceğini vurgulayan ekran görüntüsü.

  9. Kod alanı altında, Microsoft Copilot Studio beceri konusundan çıkış değerleri almak ve bunları depolamak için Özellik alanını bir Composer değişkenine ayarlayın.

    Özellik alanının dialog.skillResult olarak nereden ayarlanacağını vurgulayan ekran görüntüsü.

  10. Composer yazma tuvalinde, Ekle'yi seçin, Özellikleri yönet'i ve ardından Özellikleri ayarla'yı seçin.

    Özellikleri ayarla'yı nerede seçeceğinizi vurgulayan ekran görüntüsü.

  11. Özellik alanını ayıklanan değeri saklayacak Composer değerine ayarlayın. Ardından Değer alanını, konunun çıkışlarını sakladığınız Composer değişkenine ayarlayın.

    Aşağıdaki örnekte dialog.skillResult.pvaState ve dialog.skillResult.pvaItem çıkış değerleri, dialog.State ve dialog.Item adlı yeni Composer değişkenleri içine ayıklanır.

    Composer'ın Özellikleri Ayarla penceresinde dialog.State ve dialog.Item değişkenlerinde kaydedilen çıkış değerlerini vurgulayan ekran görüntüsü.

Microsoft Copilot Studio yardımcı pilotunuzu bir Bot Framework botu ile beceri olarak test edin

Bot Framework botunuzun bir Microsoft Copilot Studio yardımcı pilotunu beceri olarak düzgün bir şekilde çağırdığını test etmek için Bot Framework Emülatör'ü kullanın.

Önemli

Beceri bağlantısının çalışması için Bot Framework botunuzun Microsoft Copilot Studio yardımcı pilotunun izin verilenler listesine eklenmesi gerekir.

Daha Fazla Bilgi