Aracılığıyla paylaş

Bir Bot Framework botunda beceri olarak klasik bir sohbet botu kullanma

Not

Bu makale yalnızca klasik sohbet robotları için geçerlidir. Bu özellik yeni Copilot Studio deneyiminde mevcut değildir.

Klasik bir chatbot'u bir Bot Framework botuyla beceri olarak kullandığınızda, Bot Framework botu kullanıcının söylediği herhangi bir şeyin klasik sohbet botunun tetikleyici ifadeleriyle eşleşip eşleşmediğini belirler. Eşleşme varsa Bot Framework botu konuşmayı klasik sohbet botuna iletir. Klasik sohbet botu herhangi bir varlığı ayıklar ve eşleşen konuyu tetikler.

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

Önemli

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

Klasik sohbet botunuzu bir beceri olarak ayarlamak için:

  1. Klasik sohbet botu için izin verilenler listesine Bot Framework botunu ekleyin.

  2. Klasik sohbet botu 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

Klasik sohbet botunuz için Bot Framework botunuzu izin verilenler listesine ekleyin

Beceri olarak kullanmak istediğiniz klasik sohbet botu için Bot Framework botunun uygulama kimliğini 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.

  2. Copilot Studio'ta beceri olarak kullanmak istediğiniz klasik sohbet botunu açın.

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

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

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

    Dikkat

    Klasik bir sohbet botu, diğer klasik sohbet botları 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.

    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.

  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.

Not

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

Klasik sohbet botunuz için klasik chatbot beceri bildirimini indirin

Bot Framework botları, bildirimi oluşturan klasik sohbet botuyla bir bağlantı yapılandırmak için bir Copilot Studio beceri bildirimi kullanabilir.

Tüm klasik sohbet botlarının beceri bildirimleri vardır. Beceri bildirimi, becerinin adını, arayüzünü ve tetikleyici ifadelerini içeren bir JSON dosyasıdır.

Bot Framework botu, klasik sohbet 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).

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.

Bot Framework botu, manifest verilerine dayanarak kullanıcının isteğini klasik bir sohbet botunun işlemesi gerektiğine karar verebilir. Kullanıcının söylediği her şeyi klasik sohbet botuna iletir. Daha sonra klasik sohbet botu, kullanıcının söylediklerini Copilot Studio konusuyla eşleştirir, yuvanın doldurulması için gereken varlıkları çıkarır ve Copilot Studio konusunu tetikler.

Copilot Studio beceri bildirimleri otomatik olarak oluşturulur ve güncelleştirilir. Klasik sohbet botu, iki beceri bildirimine sahiptir:

  • Test bildirimi: Bot Framework botunun klasik sohbet botunuzun test sürümüne bağlanmasına izin verir. Yayımlamadan önce becerinizdeki değişiklikleri doğrulamak için test bildirimini kullanın.

    • Test bildirimi, yeni oluşturulan tüm klasik sohbet botları için hemen kullanılabilir.
    • Test bildirimi, klasik sohbet botunuzu her kaydetmenizde değişiklikleri yansıtacak şekilde otomatik olarak güncelleştirilir.

  • Yayımlanan bildirim: Bot Framework botunun klasik sohbet botunuzun yayımlanan sürümüne bağlanmasına izin verir.

    • Yayımlanan bildirim yalnızca en az bir kez yayımlanmış klasik sohbet botları için kullanılabilir.
    • Yayımlanan bildirim, aracınızı her yayımlamanızda değişiklikleri yansıtacak şekilde otomatik olarak güncelleştirilir.

Not

Yayımlanan bildirim, yayımlanmamış klasik sohbet botları için kullanılamaz.

Klasik sohbet botunuzun Yayımlanan bildirimini oluşturmak için klasik sohbet botunuzu yayımlayın.

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

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.

Bildirimi seçip indirin. Yayınlanan manifesto için _<bot adı>manifest etiketli bir .zip dosyası olarak veya Test manifestosu için <bot adı>test__manifest etiketli bir dosya olarak indirilir.

Not

Beceri bildirimine bir klasik sohbet botuna eklenen sistem konuları ve Composer diyalogları dahil değildir. 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 Copilot Studio becerisine bağlanma

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

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

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

  3. Bot Framework botunuzda klasik sohbet botunuza eklemek istediğiniz konuları veya amaçları seçin ve ardından İleri'yi seçin.

  4. Klasik sohbet botunuzun tetikleme tümceciklerini gözden geçirip düzenleyin ve ardından İleri'yi seçin.

  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.

  6. Copilot Studio becerisinin Bot Framework botunuza doğru bir şekilde eklendiğini ve Composer'da projede klasik sohbet botunuzun adıyla yeni bir tetikleyicinin görüntülendiğini doğrulayın.

Beceri bildiriminde konuyu bulma

Bir olayı, becerideki bir 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.

  3. Bildirimdeki etkinlikleri bulun. Bu özellik, klasik sohbet botunuzda kullanılabilir olan konuları temsil eden iç içe özellikleri içerir.

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

    Bu örnekte, olay etkinlik adı dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d şeklindedir.

Copilot Studio beceri konusu çağırma

Copilot Studio beceri konusunu kullanıcının bir şeyler söyleyerek tetiklemesi yerine doğrudan çağırabilirsiniz. Yalnızca beceri bildiriminde listelenen 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.

  2. Beceri Diyalog Adı listesinde, klasik sohbet botunuzu seçin.

  3. Çağırmak istediğiniz klasik sohbet botu 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.

  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
]

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

Bot Framework Composer, bir Copilot Studio beceri konusuna giriş olarak bir değişken iletebilir. Giriş değişkenlerini kabul eden Copilot Studio konularının nasıl oluşturulacağını öğrenmek için Değişkenlerle çalışma bölümüne bakın.

Beceri bildiriminiz içinde listelenmiş bir giriş değişkenini alabilen 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.

  2. Beceri Diyalog Adı listesinde, klasik sohbet botunuzu seçin.

  3. Çağırmak istediğiniz klasik sohbet botu 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 Copilot Studio konusunda girişler yoksa bu konu, değer özelliğini içermez.

  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. Copilot Studio konu girişlerinin adlarını ve türlerini not edin. Bunları sonraki adımlarda kullanırsınız.

  6. Kapat'ı seçin.

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

  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)}
]

    Bu örnekte dialog.storeLocation adlı Composer değişkeni, dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16 adlı klasik sohbet botu konusundaki pva_StoreLocation giriş değişkenine bir değer sağlar.

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

Composer'da bir Copilot Studio beceri konusundan çıkış almak mümkündür. Çıkışlar döndüren Copilot Studio konularının nasıl oluşturulacağını öğrenmek için Değişkenlerle çalışma 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.

  2. Beceri Diyalog Adı listesinde, klasik sohbet botunuzu seçin.

  3. Çağırmak istediğiniz klasik sohbet botu 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 Copilot Studio konusunda çıkışlar yoksa bu konu, resultValue özelliğini içermez.

  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. Copilot Studio konusunun çıkış değişkenlerinin adlarını ve türlerini not edin. Bunları sonraki adımlarda kullanırsınız.

    Bu örnekte Copilot Studio konusu, pva_State ve pva_Item şeklinde iki tür string çıkışı döndürür.

  6. Kapat'ı seçin.

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

  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
]

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

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

  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.

    Bu ö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.

Klasik sohbet botunuzu bir Bot Framework botu ile bir beceri olarak sınama

Bot Framework botunuzun bir klasik sohbet botunu beceri olarak doğru şekilde çağırdığını sınamak için Bot Framework Emulator kullanın.

Önemli

Beceri bağlantısının çalışması için Bot Framework botunuzun klasik sohbet botunun izin verilenler listesine eklenmesi gerekir.

Çok kiracılı Bot Framework bir botu tek kiracılı bir bota güncelleştirme

Aşağıdaki çizim, Bot Framework SDK'sı üzerine kurulu Bot Framework botunun, bir beceri olarak kullanmak üzere klasik bir sohbet botunu çağırdığı senaryoyu göstermektedir.

Bir Bot Framework Bot ile klasik bir sohbet botu arasındaki etkileşimleri gösteren çizim.

Bot Framework bot ve klasik sohbet botu, Azure Bot örnekleri tarafından başvurulan bir Microsoft Entra ID uygulaması kaydına sahiptir. Bu Microsoft Entra ID uygulaması kayıtları çok kiracılı olarak oluşturuldu. Bot Framework botu, Bot Framework kiracısından bir belirteç ister ve bu belirteci Azure Bot Hizmeti'ni kullanarak Copilot Studio'e kimlik doğrulaması yapmak için kullanır. Copilot Studio, aynı mekanizmayı Bot Framework botuyla iletişim kurmak için kullanır.

Copilot Studio sohbet botunun uygulama kaydı artık tek kiracılı olarak oluşturulduğundan bu iletişim artık çalışmaz. Microsoft Entra ID, aynı kiracıda olmayan tek kiracılı uygulama kayıtları için belirteç oluşturmayı reddediyor.

Ayrıca, Copilot Studio gelen belirteci doğrular ve klasik sohbet botu uygulama kaydının oluşturulduğu kiracı kimliği gibi beklemediği kiracılardan gelen istekleri reddeder.

Bu sorunu çözmek için iki olası düzeltme vardır.

Bot Framework botla aynı kiracıda bulunan klasik sohbet botları

Copilot Studio sohbet botunun Bot Framework botuyla aynı kiracıda zaten konuşlandırılmış olduğu ve yalnızca bu bot tarafından kullanıldığı senaryolarda, botu tek kiracı yapılandırmasına güncelleyin, ardından Bot Framework botunuzu yeniden konuşlandırın. Tek kiracı için Bot Framework botunun nasıl yapılandırılacağı hakkında daha fazla bilgi için Bot sağlama ve yayınlama bölümüne bakın.

Copilot Studio sohbet botu tek kiracılı olarak güncelleştirilemez

Copilot Studio sohbet botunun Bot Framework botuyla aynı kiracıda zaten konuşlandırıldığı ancak botun tek kiracı olarak güncellenemediği senaryolarda, Bot Framework botundaki kodu güncelleyerek Copilot Studio sohbet botuyla iletişim kurmak için belirteç oluşturmanız gerekir. Belirtecin, Copilot Studio sohbet botunun oluşturulduğu kiracı için de oluşturulması gerekiyor. Ayrıca, yanıtın kabul edilmesi gerekir; bu da muhtemelen Mevcut bir beceriyi çoklu kiracıdan tek kiracıya dönüştürme adımlarını izlemenizi gerektirir.

Daha Fazla Bilgi