Copilot Studio'da kullanmak için bir Bot Framework becerisini yapılandırma

Ö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.

Copilot Studio, Bot Framework becerilerini kullanarak yardımcı pilotunuzu genişletmenize olanak sağlar. Belirli senaryolarda kuruluşunuzda hali hazırda sohbet botlarını oluşturarak dağıttıysanız (Bot Framework SDK ve Pro kod araçlarını kullanarak) sohbet botlarını bir beceriye dönüştürebilir ve beceriyi bir Copilot Studio yardımcı pilotu içine kaydedebilirsiniz.

Not

Microsoft Teams içinde Copilot Studio uygulamasına bir beceri eklemek için tek başına bir Microsoft Copilot Studio aboneliğiniz olmalıdır.

Bu makale, Bot Framework becerilerine aşina olan sistem yöneticileri veya BT profesyonelleri için hazırlanmıştır. Bir beceri Copilot Studio yardımcı pilot ile kaydedildikten sonra, yazarlar konuşma sırasında beceri eylemlerini kesintisiz şekilde tetikleyebilir.

Önkoşullar

• Copilot Studio''ta kullanılan beceriler için kısıtlamaları ve doğrulamayı inceleme

Önemli

Copilot Studio yardımcı pilotları yalnızca Bot Framework SDK sürüm 4.12.0+ kullanarak becerileri destekler.

Klasik sohbet botları yalnızca Bot Framework SDK sürüm 4.7+ kullanılarak oluşturulan becerileri destekler.

Bot Framework Composer kullanıyorsanız Composer 2.x kullanmanız önerilir. Varolan bir Composer 1.x yardımcı pilot kullanmak isterseniz, beceri olarak kullanmadan önce öncelikle Composer 2.x'e taşıyın.

Bir beceriyi yapılandırmak için, beceriniz için Microsoft Entra ID ile ilişkili uygulama kaydı, Birden çok kiracılı yapılandırmaya ayarlanmalıdır.

Eylemleri ve beceri eylemlerini akışla sağlar

Aşağıdaki tablo, konuşma için becerilerin ne zaman kullanılacağını belirlemeye yardımcı olur.

	Akış eylemleri	Beceri eylemleri
Kişilik	Yardımcı pilot yazarları herhangi bir yardımcı pilot konuşmasına eklemek için yeniden kullanılabilir Akışlar oluşturabilir	Geliştiriciler, kendi ortamlarında özel beceriler oluşturabilir, dağıtabilir ve barındırabilir
Konuşma	Basit, tek dönüşlü işlemler için Akışlar'ı kullanın. Örneğin, bir sipariş verin veya sipariş durumunu alın.	Karmaşık, çoklu dönüş işlemleri için becerileri kullanın. Örneğin, bir toplantı zamanlayın veya uçuş rezervasyonu yapın.
Yanıtla	Bir yardımcı pilot yanıtı yaymak için Akışlar'dan yararlanın. Örneğin, kişiselleştirilmiş bir ileti veya satır içi görüntüler gösterin.	Desteklenen herhangi bir yardımcı pilot yanıtını yaymak için beceriler kullanın. Örneğin, uyarlanabilir bir kart gösterin veya rastgele yanıtlar gönderin.
Eylemler	Sunucu tarafındaki tek dönüşlü eylemleri tetiklemek için Akışlar'ı kullanın. Örneğin, bir HTTP API'sini çağırın veya özel bir bağlayıcıyı tetikleyin.	Sunucu tarafı ve istemci tarafı olaylarını ve eylemlerini tetiklemek için becerileri kullanın. Örneğin, yardımcı pilot yanıtının üzerinde bir sayfaya gidin.

Beceri yapılandırma

Öncelikle Copilot Studio kullanarak bir yardımcı pilot oluşturun ve kuruluşunuza pro kod araçlar kullanarak bir beceri oluşturun ve yayın.

Beceriyi kaydetmeden önce, yardımcı pilotun beceriyle ilgili eylemleri gerçekleştirmesi için yetki vermesi için beceri geliştiricinize kimliğini sağlayın. Beceri izin listesi hakkında daha fazla bilgi edinin. Beceri ekle penceresinden yardımcı pilotunuzun kimliğini alabilirsiniz.

Yardımcı pilotunuza bir beceri eklemek için:

1. Gezinti bölmesinde Ayarlar'ı genişletin ve Beceriler'i seçin.

2. Beceriler sayfasının üst kısmındaki Beceri ekle'yi seçin.

3. Yardımcı pilot kimliğinizi kopyalayın ve bunu beceri geliştiricinize sağlayın.

   

4. Beceri bildiriminin URL'sini girin. Becerinin bildirimi, yardımcı pilotunuzun bir beceri içinde eylemleri tetikleyebilmek için ihtiyaç duyacağı bilgileri içerir.

5. Doğrulama işlemi'ni başlatmak için İleri'yi seçin. Doğrulama başarılı olduktan sonra, beceriniz yardımcı pilotunuza eklenir. Artık bu beceriyi konularınızda kullanabilirsiniz.

Uyumluluk değerlendirmesi

Kullanıcı gizliliğini korumak için, oturum açmış kullanıcının Microsoft Entra ID kiracısında becerilerin uygulama olarak kaydedilmesi gerekir.

Beceri kaydı sırasında oluşan hataları giderme

URL'ye karşı bir dizi doğrulama denetimi yapılır. Bu kontroller, yardımcı pilotunuza eklenmekte olan beceriye uyumluluğu, yönetişim ve kullanılabilirliği sağlar. Beceri kaydı öncesinde bu hataları düzeltmeniz gerekir.

Hata iletisi	Sorun Giderme/Risk Azaltma
Beceri bildirimini alırken sorunlarla karşılaştık. (MANIFEST_FETCH_FAILED)	Bildirim URL'nizi bir web tarayıcısında açmayı deneyin. URL, sayfayı 10 saniye içinde işlerse becerinizi tekrar kaydedin.
Bildirim uyumlu değil. (MANIFEST_MALFORMED)	(a) Bildirimin geçerli bir JSON dosyası olup olmadığını denetleyin. (b) Bildirimin gerekli özellikleri içerip içermediğini denetleyin Örneğin, (name, msaAppId, tek endpoint, activities/id, activities/description, activities/type (yalnızca event veya message desteklenir)).
Uç noktalarınızda bir uyuşmazlık var (MANIFEST_ENDPOINT_ORIGIN_MISMATCH)	Beceri uç noktanızın Microsoft Entra ID uygulama kaydının Publisher domain (tercih edilen) veya Home page URL alanıyla eşleşip eşleşmediğini kontrol edin. Uç noktaları için giriş sayfasını ayarlama hakkında daha fazla bilgi edinin.
Bir becerinin eklenmesi için önce kaydedilmesi gerekir (APPID_NOT_IN_TENANT)	Becerinizin uygulama kimliğinin kuruluşunuzun Microsoft Entra ID kiracısında kayıtlı olup olmadığını kontrol edin.
Bağlantı geçerli değil; Bağlantı https:// ile başlamalıdır (URL_MALFORMED,URL_NOT_HTTPS)	Bağlantıyı güvenli bir URL olarak yeniden girin.
Bildirim çok büyük; (MANIFEST_TOO_LARGE)	Bildirimin boyutunu kontrol edin. 500 KB'den küçük veya 500 KB olmalıdır.
Bu beceri zaten yardımcı pilotunuza eklendi. (MANIFEST_ALREADY_IMPORTED)	Beceriyi silin ve tekrar kaydolmayı deneyin.
Beceri, 100 eylemle sınırlıdır. (LIMITS_TOO_MANY_ACTIONS)	Beceri bildiriminde tanımlanmış çok fazla beceri eylemi var. Eylemleri kaldırın ve yeniden deneyin.
Eylemler 25 giriş ile sınırlıdır. (LIMITS_TOO_MANY_INPUTS)	Çok fazla beceri eylemi giriş parametresi var. Parametreleri kaldırın ve yeniden deneyin.
Eylemler 25 çıkış ile sınırlıdır. (LIMITS_TOO_MANY_OUTPUTS)	Çok fazla beceri eylemi çıkış parametresi var. Parametreleri kaldırın ve yeniden deneyin.
Yardımcı pilotunuzda en fazla 100 beceri olabilir. (LIMITS_TOO_MANY_SKILLS)	Yardımcı pilota eklenen çok fazla beceri var. Var olan bir beceriyi kaldırın ve yeniden deneyin.
Bir sorun var gibi görünüyor. (AADERROR_OTHER)	Beceriniz doğrulanırken geçici bir hata oluştu. Yeniden deneyin.
Beceriniz denetlenirken bir sorun oluştu. (ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED)	Beceri uç noktanızın çevrimiçi olup olmadığını ve iletilere yanıt verip vermediğini denetleyin.
Bu beceri, yardımcı pilotunuzu izin verilenler listesine eklemedi. (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Yardımcı pilotunuzun yetenek izin verilenler listesine eklenip eklenmediğini kontrol edin.