Power Virtual Agents'da kullanmak için beceri uygulama

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Beceri, başka bir bot tarafından kullanılabilecek bir botdur. Bu şekilde, kullanıcıya yönelik tek bir bot oluşturabilir ve bunu bir veya daha fazla beceriyle genişletebilirsiniz. Becerilere Genel Bakış bölümünde genel olarak beceriler hakkında daha fazla bilgi edinebilir ve bunları beceri uygulama bölümünden nasıl oluşturabileceğinizi öğrenebilirsiniz. Alternatif olarak, Sanal Yardımcı şablonları sıfırdan oluşturmak yerine özelleştirebileceğiniz ve dağıtabileceğiniz önceden oluşturulmuş bir dizi beceri içerir.

Becerinizin bir Power Virtual Agents botundan tüketileceğini düşünüyorsanız, becerinize hesaba eklemeniz gereken bazı ek kısıtlamalar vardır.

Bildirim kısıtlamaları

Power Virtual Agents, beceri bildiriminizde bildirebilecekleriniz üzerinde kısıtlamalar getirir.

  • Yalnızca 100 veya daha az eylem bildirebilirsiniz.
  • Her eylem 25 veya daha az giriş veya çıkışla sınırlıdır.
  • Girişler veya çıkışlar için dizi türünü kullanamazsınız.

Aynı kiracı kısıtlaması

Power Virtual Agents içinde kullanılmak üzere kaydedilen özel becerilerin uyumluluğunu ve yeterli idaresini sağlamak için beceri botunuzun Microsoft Entra Id'de kayıtlı bir uygulama olması gerekir. Beceri ekledikten sonra, becerinin uygulama kimliğinin oturum açmış kullanıcının kiracısında olup olmadığını ve beceri uç noktasının kayıtlı uygulamanın ile eşleşip eşleşmediğini doğrularız Home Page URL.

Botunuzu Power Virtual Agents'a beceri olarak kaydedebilmeniz için önce botun Azure portalındaki giriş sayfasının botun beceri bildirimi URL'sine ayarlandığından emin olmanız gerekir.

Beceri kaydederken gerçekleştirilen doğrulama

Bir son kullanıcı Power Virtual Agents botundan becerinize bağlanmayı denediğinde, önce beceriyi Power Virtual Agents'a aktarması gerekir. Beceriniz bir dizi doğrulama denetiminden geçer. Bu denetimlerden birinin başarısızlığı, bu tabloda açıklandığı gibi bir hata iletisine neden olabilir.

Doğrulama adımı Hata kodu Hata iletisi Açıklama veya risk azaltma
Bildirim URL'si geçerli URL_MALFORMED, URL_NOT_HTTPS Bağlantı geçerli değil; Bağlantı https:// ile başlamalıdır Bağlantıyı güvenli bir URL olarak yeniden girin.
Bildirim alınabilir MANIFEST_FETCH_FAILED Beceri bildirimini alma konusunda sorunlarla karşılaştık. Bildirim URL'nizin bildiriminizin bir bağlantısı olduğunu doğrulayın; bildirim URL'nizi bir web tarayıcısında açmayı deneyin. URL, sayfayı 10 saniye içinde işlerse becerinizi tekrar kaydedin.
Bildirim okunabilir MANIFEST_TOO_LARGE Bildirim çok büyük. Bildiriminiz 500 KB veya daha az olmalıdır.
Bildirim okunabilir MANIFEST_MALFORMED Bildirim uyumlu değil. Bildirimin geçerli bir JSON dosyası olup olmadığını denetleyin. Bildirimin , msaAppIdgibi gerekli özellikleri nameiçerip içermediğini denetleyin. Daha fazla bilgi için bkz . Bildirim kısıtlamaları .
Beceri henüz kayıtlı değil MANIFEST_ALREADY_IMPORTED Bu beceri, botunuza zaten eklendi. Beceriyi silin ve yeniden kaydedin.
Bildirim uç noktası ve giriş sayfası etki alanları eşleş MANIFEST_ENDPOINT_ORIGIN_MISMATCH Beceri uç noktalarınızda bir uyuşmazlık var. Microsoft Entra ID uygulamanızın giriş sayfası URL etki alanı ve bildirim URL'si etki alanı eşleşmelidir. Bkz. Aynı kiracı kısıtlaması
Beceri oturum açmış kullanıcının kiracısında barındırılıyor APPID_NOT_IN_TENANT Beceri eklemek için önce kayıtlı olması gerekir. Genel yöneticinin bu beceriyi oturum açmış kullanıcının kuruluşuna kaydetmesi gerekir.
Eylemler sınırlıdır LIMITS_TOO_MANY_ACTIONS Beceri, 100 eylemle sınırlıdır. Beceri bildiriminde tanımlanmış çok fazla beceri eylemi var. Eylemleri kaldırın ve yeniden deneyin.
Eylem giriş parametreleri sınırlıdır LIMITS_TOO_MANY_INPUTS Eylemler 25 giriş ile sınırlıdır. Çok fazla beceri eylemi giriş parametresi var. Parametreleri kaldırın ve yeniden deneyin.
Eylem çıkış parametreleri sınırlıdır LIMITS_TOO_MANY_OUTPUTS Eylemler 25 çıkış ile sınırlıdır. Çok fazla beceri eylemi çıkış parametresi var. Parametreyi kaldırın ve yeniden deneyin.
Beceri sayısı sınırlıdır LIMITS_TOO_MANY_SKILLS Botunuz en fazla 25 beceriye sahip olabilir. Bota eklenmiş çok fazla beceri var. Var olan bir beceriyi kaldırın ve yeniden deneyin.
Güvenlik belirteci geçerli AADERROR_OTHER Bir sorun olmuş gibi görünüyor. Beceriyi tetikleyen bir güvenlik belirteci almak için geçici bir hata olabilir. Beceriyi içeri aktarmayı yeniden deneyin.
Beceri sağlıklıdır ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Beceriniz denetlenirken bir sorun oluştu. Power Virtual Agents, becerinize etkinlik gönderirken bilinmeyen bir EndOfConversation yanıt aldı. Becerinizin çalıştığından ve doğru yanıt verdiğine emin olun.
Beceri yetkilendirilmiştir ENDPOINT_HEALTHCHECK_UNAUTHORIZED Bu beceri, botunuzun izin verenler listesinde yer almamıştır. Botunuzun becerinin izin verme listesine eklenip eklenmediğini denetleyin. Daha fazla bilgi için bkz. Power Virtual Agents how to Configure a Skill.