Bot Framework Becerilerini kullanarak sohbet botunu genişletme

Burada kullandığınız Power Virtual Agents sürümünü seçin:

Power Virtual Agents Bot Framework Becerilerini kullanarak sohbet botunuzu genişletmenizi sağlar. Belirli senaryolarda kuruluşunuzda hali hazırda sohbet botlarını oluşturarak dağıttıysanız (Bot Framework Pro kod araçlarını kullanarak) sohbet botlarını bir beceriye dönüştürebilir ve beceriyi bir Power Virtual Agents sohbet botu içine kaydedebilirsiniz.

Bu makale, Bot Framework becerilerine aşina olan sistem yöneticileri veya BT profesyonelleri için hazırlanmıştır. Beceri, bir Power Virtual Agents botuna kaydedildikten sonra yazarlar sorunsuz bir şekilde konuşmada beceri eylemlerini tetikleyebilir.

Ön koşullar

Akışlar ve beceriler eylemlerinin kullanımını karşılaştırma

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

Akış eylemleri Beceri eylemleri
Kişilik Bot yazarları, yeniden kullanılabilir Akışlar oluşturarak herhangi bir bot 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.
Response Bot 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 bot 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, bot yanıtı üzerine bir sayfaya gidin.

Power Virtual Agents'ta kullanmak için bir beceri yapılandırma

Öncelikle Power Virtual Agents botu oluşturun ve Profesyonel kodlama araçlarını kullanarak beceri oluşturun ve kuruluşunuza dağıtın.

Not

Power Virtual Agents yalnızca Bot Framework SDK sürüm 4.7 veya üstü kullanılarak oluşturulan becerileri destekler.

Beceriyi kaydetmeden önce botun kimliğini beceri geliştiricinize sağlayarak bota, becerideki işlemleri çağırması için yetki verin. İzin verilen beceriler listesi hakkında daha fazla bilgi edinin.

Botu izin verilen beceriler listesine ekleyin:

  1. Power Virtual Agents portalı'nda, yan gezinti bölmesinde Yönet menüsünü genişletin ve Beceriler'i seçin.

    Yönet'i ve ardından Beceriler'i seçme

  2. Beceriler sayfasının üst kısmında, İzin verilenler listesi için kimlik sağla'yı seçin.

    İzin verilenler listesi için kimlik sağla düğmesini seçme

  3. Benzersiz kimliğinizle birlikte bir pencere gösterilir. Bu kimliği kopyalayın ve beceri geliştiricinize sağlayın.

    Benzersiz kimliği gösteren pencereler

Botunuza bir beceri eklemek için beceri bildirim URL'sini girin:

  1. Power Virtual Agents portalı'nda, yan gezinti bölmesinde Yönet menüsünü genişletin ve Beceriler'i seçin.

    Yönet'i ve ardından Beceriler'i seçme

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

    Beceri Ekle düğmesini seçme

  3. Beceri bildiriminin URL'sini girin. Becerinin bildirimi, botunuzun bir beceri içindeki eylemleri tetiklemesi için ihtiyaç duyacağı bilgileri içerir.

  4. Doğrulama işlemi'ni başlatmak için İleri'yi seçin. Başarılı olduğunda beceriniz botunuza eklenir. Artık bu beceriyi konularınızda kullanabilirsiniz.

Uyumluluk değerlendirmesi

Kullanıcı gizliliğini korumak için becerilerin, oturum açmış olan kullanıcının Azure Active Directory kiracısına uygulama olarak kaydedilmesini isteriz.

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

URL'ye karşı bir dizi doğrulama denetimi yapılır. Bu denetimler, becerinizin botunuza eklenmesi, yönetilmesi 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 bir endpoint, activities/id, activities/description, activities/type (yalnızca event veya message desteklenmektedir)).
Uç noktalarınızda bir uyuşmazlık var
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)
Beceri uç noktanızın, Azure AD başvuru kaydınıza ait Publisher domain (tercih edilen) veya Home page URL alanıyla eşleşip eşleşmediğini denetleyin. Uç noktaları için giriş sayfasını ayarlama hakkında daha fazla bilgi edinin.
Bir becerinin eklenebilmesi için önce kaydedilmesi gerekir
(APPID_NOT_IN_TENANT)
Beceri'nizin uygulama kimliğinin kuruluşunuzun Azure AD kiracısında kayıtlı olup olmadığını denetleyin.
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, botunuza zaten eklendi.
(MANIFEST_ALREADY_IMPORTED)
Beceriyi silin ve tekrar kaydolmayı deneyin.
Beceri, 25 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.
Botunuzda en fazla 25 beceri olabilir.
(LIMITS_TOO_MANY_SKILLS)
Bota eklenmiş çok fazla beceri var. Var olan bir beceriyi kaldırın ve yeniden deneyin.
Bir sorun oluştuğu görülü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, botunuzun listelenmesine izin vermiyor
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)
Botunuzun izin verilen beceriler listesine eklenip eklenmediğini denetleyin. İzin listesine bir beceri ekleme hakkında daha fazla bilgi edinin.