Bot Framework Composer'a genel bakış

Not

Bu makale yalnızca klasik sohbet botları için geçerlidir. Oluşturulan yardımcı pilotları genişletmek Copilot Studioiçin Composer'ı kullanmanıza Bot Framework gerek yoktur. Bu makalede açıklanan tüm özellikler yardımcı pilotlar tarafından doğrudan kullanılabilir Copilot Studio.

Bot Framework Composer ile özel konular geliştirerek ve bunları Copilot Studio yardımcı pilotunuza ekleyerek yardımcı pilotunuzu geliştirin.

Composer, geliştiriciler ve iş kullanıcılarının yardımcı pilotlar oluşturmasını sağlamak için Copilot Studio ile tümleştirilmiştir. Composer, yardımcı pilotunuzu şunlar dahil olmak üzere, Bot Framework işlevleriyle geliştirmenizi sağlar:

  • Uyarlanabilir iletişim kutuları
  • Dil Üretimi (LG)
  • Normal ifadeler (RegEx)
  • Uyarlamalı Kartlar

Composer'ı Copilot Studio ile kullanmak, Copilot Studio'ta tanımlı değişkenler dahil olmak üzere konuşma belleği ve bağlamına erişmenizi sağlar. Bu bellek ve bağlam, kesintileri, iptalleri ve bağlam değiştirmeyi işlemek için konular oluşturmanıza olanak tanır. Ayrıca resimler ve videolar, formlar ve daha fazlası gibi etkileşimli öğeleri yardımcı pilotta görüntülemek için Uyarlanabilir Kartlar ekleyebilirsiniz.

Composer'da kullanabileceğiniz çeşitli önceden oluşturulmuş işlevle ve ifadeler ve yardımcı pilotun çalışma zamanında rasgele seçebilmesi için birden fazla tümce varyasyonu tanımlama olanağı bulunur.

Composer ile eklenen özel konular, Copilot Studio yardımcı pilot içeriğinin geri kalanıyla birlikte dağıtılır, barındırılır ve yürütülür ve daha fazla Azure hosting gerektirmez.

Önemli

Composer tümleştirmesi yalnızca Teams Microsoft Copilot Studio lisansına sahip olan kullanıcılar tarafından kullanılamaz. Bir deneme veya tam Microsoft Copilot Studio lisansınız olmalıdır.

Önkoşullar

Önemli Composer terimlerini anlama

Composer, Copilot Studio'ta kullanılan benzer kavramları açıklamak için farklı bir terimler kümesi kullanır. Anlamanız gereken bazı önemli terimler şunlardır:

  • dialog: Diyaloglar, Composer'daki temel yapı taşıdır ve tetikleyiciler için kapsayıcı görevi görür. Her diyalog ne yaptığına ve kullanıcı girdisine nasıl tepki verdiğine ilişkin talimatlar içeren botun işlevselliğinin bir bölümünü temsil eder. Diyaloglar hakkında daha fazla bilgi için Composer'da konuşma yapı taşları olarak diyaloglar konusuna bakın.

  • ana iletişim kutusu: Bir botun ana iletişim kutusu, bot gezgininde görünen ilk iletişim kutusudur ve yardımcı pilotunuzu Copilot Studio Composer'a aktardığınızda oluşturulur. Diyalog Copilot Studio yardımcı pilotunuza karşılık geldiğinden asla silinmemelidir.

  • trigger: Tetikleyiciler, bir iletişim kutusunun ana bileşenidir ve olayları yakalamanıza ve bunlara yanıt vermenize olanak tanır. Her tetikleyicinin bir koşulu ve koşulun karşılanması durumunda yürütülecek eylemler koleksiyonu vardır. Tetikleyicileri Copilot Studio'taki konuların eşdeğeri olarak düşünebilirsiniz. Tetikleyiciler hakkında daha fazla bilgi edinmek için bkz. Tetikleyiciler.

  • action: Eylemler, bir yanıt göndermenize, özelliklere değerler oluşturmanıza ve atamanıza, konuşma akışını manipüle etmenize, diyalogları yönetmenize ve diğer birçok etkinliğe olanak tanıyan bir tetikleyicinin ana bileşenleridir. Eylemleri Copilot Studio'taki düğümlerin eşdeğeri olarak düşünebilirsiniz.

Copilot Studio ile desteklenmeyen Composer özellikleri

Aşağıdaki Composer özellikleri Copilot Studio ile desteklenmez:

Desteklenmeyen Özellik Ek bilgiler
LUIS (dil anlama) Tanıyıcı Composer'daki Varsayılan Tanılayıcı, Microsoft Copilot Studio Doğal Dil Anlama (NLU) olarak ayarlanır.
Bot Framework Orchestrator Bot Framework Orchestrator Copilot Studio için Composer'da desteklenmez.
Özel tanıyıcı Copilot Studio için Composer'da özel tanıyıcı desteklenmez.
Bot becerileri Copilot Studio'a yönelik Composer içeriğinde bot becerileri çağrılamaz.
QnA Maker Bu özellik, Copilot Studio için Composer'da kullanılamaz.
OAuth Oturum açma ve kullanıcı oturumunu kapatma Bu tür eylemler Copilot Studio için Composer'da desteklenmez.
Diyalog Girişleri ve Çıkışları Copilot Studio için Composer'da diyalog girişleri ve çıkışları desteklenmez.
Composer içindeki tetik tümcecikleriyle varlık algılama Composer'da # getUserName my name is {username=userName} kullanılamaz.
Bot Framework Emulator'da test Tüm Composer içeriğinin Copilot Studio'ta yayımlanması ve test edilmesi gerekir.

Composer'da Copilot Studio için içerik oluşturma yönergeleri

Copilot Studio için içerik oluşturmak üzere Composer'ı kullanırken uyulması gereken birkaç temel yönerge vardır:

  • Copilot Studio Yardımcı pilotunuzun konuları Composer'da diyaloglar olarak görüntülenir. Bu diyalogları Composer'da düzenleyemezsiniz. Bunları seçtiğinizde düzenleme için Copilot Studio'da ilgili konular açılır.

    Composer'da Copilot Studio yardımcı pilotundan içe aktarılan konuların listesinin ekran görüntüsü.

  • Copilot Studio genel değişkenlerine virtualagent kapsamı kullanılarak Composer'dan erişilir. Bu kapsam Composer'ın özellik başvurusu menüsünde görünmez ancak doğrudan bir ifade girerek erişebilirsiniz.

  • İçeriği Composer'da yayınlamak değişiklikleri test için kullanılabilir hale getirir ancak Copilot Studio yardımcı pilotunuzu otomatik olarak yayınlamaz. Yardımcı pilot değişikliklerinizi kanallarda yayınlamak için Copilot Studio'daki Yayınla özelliğini kullanın.

  • Composer'da Copilot Studio konularını çağırmak için bir Microsoft Copilot Studio Konusu başlat eylemi kullanın.

    Composer'ın ekleme eylemi menüsünün ekran görüntüsü.

  • Ana ("kök" olarak da bilinir) diyalogunuza her türlü yeni Composer tetikleyicisi ekleyebilirsiniz.

  • Bu Composer tetikleyicilerinden iletiler gönderip sorular sorabilirsiniz.

  • Ana diyalogda Normal ifade tanıyıcısını kullanamazsınız. Ana diyalogda Normal ifade tanıyıcıyı kullanmak, Composer içeriğinizi Copilot Studio'da yayınlamanızı engeller. Ancak, diğer herhangi bir Composer diyalogunda Normal ifade tanıyıcısını kullanabilirsiniz.

  • Yeni oluşturulan diyaloglara her türlü Composer olayı ve tetikleyicisi ekleyebilirsiniz.

  • Bot Yanıtları sayfasında, Ortak bölümü boş olmalıdır. Varlıkların orada kullanılması doğrulama hatalarına neden olur ve Copilot Studio platfomuna Composer içeriğinizin yayımlanmasını önler.

    Ortak bot yanıtları bölümünün boş olduğu ekran görüntüsü.

  • Her Composer diyalogunun kendine ait bot yanıtı (.lg) ve dil anlama (.lu) kaynakları vardır. Örneğin, İngilizce (ABD) konuşan ve dialog1 adında bir diyaloğu olan bir botun bir dialog1.en-us.lg dosyası ve bir dialog1.en-us.lu dosyası vardır.

  • Composer'daki ana diyalog, Copilot Studio yardımcı pilotunuza karşılık geldiğinden asla silinmemelidir. Ana diyalogda sıfır veya daha fazla tetikleyici olabilir.

  • Composer diyaloglarında ve tetikleyicilerinde telemetri yakalayabilir ve bunları Uyarlamalı diyaloglar için Kusto sorgularıyla analiz etmek üzere Application Insights kullanabilirsiniz. Daha fazla bilgi için bkz. Application Insights ile telemetri yakalama.

Composer diyalogları, olayları, tetikleri ve Bot Framework ile gelişmiş bot içeriği oluşturma yöntemi ile ilgili ayrıntılı bilgi için aşağıdaki kaynaklara bakın:

Başvurular

Composer'da geliştirme hakkında daha fazla bilgi edinmek için şu kaynaklara bakın:

Composer'ı kullanmaya Bot Framework başlama