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

Makale
02/19/2025

Copilot Studio, Bot Framework Becerilerini kullanarak aracınızı genişletmenizi sağlar. Belirli senaryolarda kuruluşunuzda hali hazırda botları oluşturup dağıttıysanız (Bot Framework SDK ve pro kod araçlarını kullanarak) botları bir beceriye dönüştürebilir ve beceriyi bir Copilot Studio aracısına 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. Beceri, bir Copilot Studio aracısına kaydedildikten sonra yazarlar sorunsuz bir şekilde konuşmada beceri eylemlerini tetikleyebilir.

Önkoşullar

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

Önemli

Copilot Studio aracıları, yalnızca Bot Framework SDK sürüm 4.12.0+ kullanılarak oluşturulan becerileri destekler.

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

Bot Framework Composer kullanıyorsanız Composer 2.x kullanmanız önerilir. Varolan bir Composer 1.x aracısını kullanmak istiyorsanız, beceri olarak kullanmadan önce Composer 2.x'e geçirin.

Bir beceriyi yapılandırmak için, beceriniz için Microsoft Entra ID'deki ilişkili uygulama kaydı çok kiracılı yapılandırma olarak 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	Aracı yazarları, yeniden kullanılabilir Akışlar oluşturarak herhangi bir aracı konuşmasına yerleştirebilir.	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	Aracı yanıtı göndermek için Akışlar'ı kullanın. Örneğin, kişiselleştirilmiş bir ileti veya satır içi görüntüler gösterin.	Desteklenen herhangi bir aracı yanıtını göndermek için becerileri 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, aracı yanıtı üzerine bir sayfaya gidin.

Beceri yapılandırma

Öncelikle aracı oluşturmak için Copilot Studio kullanın ve kuruluşunuzda profesyonel kodlama araçlarını kullanarak beceri oluşturun ve kuruluşunuza dağıtın.

Beceriyi kaydetmeden önce aracının kimliğini beceri geliştiricinize sağlayarak aracıya, becerideki işlemleri çağırması için yetki verin. Beceri izin listesi hakkında daha fazla bilgi edinin. Aracınızın kimliğini Beceri ekle penceresinden alabilirsiniz.

Aracınıza beceri eklemek için:

Gezinti bölmesinde Ayarlar'ı genişletin ve Beceriler'i seçin.
Beceriler sayfasının üst kısmındaki Beceri ekle'yi seçin.
Aracınızın kimliğini kopyalayın ve beceri geliştiricinize sağlayın.
Beceri bildiriminin URL'sini girin. Becerinin bildirimi, aracınızın bir beceri içindeki eylemleri tetiklemesi için ihtiyaç duyacağı bilgileri içerir.
Doğrulama işlemi'ni başlatmak için İleri'yi seçin. Doğrulama başarılı olduğunda, beceriniz temsilcinize 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 denetimler, aracınıza eklenen becerinin uyumluluğunu, yönetimini ve kullanılabilirliğini 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, aracınıza zaten 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.
Aracınızda en fazla 100 beceri olabilir. (`LIMITS_TOO_MANY_SKILLS`)	Aracıya eklenmiş ç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. Ayrıca, tek kiracı becerisinin uygulama kaydının aynı kiracıya dağıtılıp dağıtılmadığını da denetleyin.
Bu beceri, aracınızın listelenmesine izin vermiyor (`ENDPOINT_HEALTHCHECK_UNAUTHORIZED`)	Aracınızın izin verilen beceriler listesine eklenip eklenmediğini denetleyin.

Aracılığıyla paylaş