Bagikan melalui

Menerapkan keterampilan untuk digunakan di Power Virtual Agents

  • Artikel

BERLAKU UNTUK: SDK v4

Keterampilan adalah bot yang dapat digunakan oleh bot lain. Dengan cara ini Anda dapat membuat satu bot yang menghadap pengguna dan memperluasnya dengan satu atau beberapa keterampilan. Anda dapat mempelajari lebih lanjut tentang keterampilan secara umum dalam Gambaran Umum Keterampilan, dan cara membuatnya dalam Menerapkan keterampilan. Atau, templat Asisten Virtual berisi serangkaian keterampilan bawaan yang dapat Anda sesuaikan dan sebarkan alih-alih membuatnya dari awal.

Jika Anda mengharapkan keterampilan Anda akan dikonsumsi dari bot Power Virtual Agents , ada beberapa batasan tambahan yang ditempatkan pada keterampilan Anda yang perlu Anda perhitungkan.

Pembatasan manifes

Power Virtual Agents menempatkan pembatasan pada apa yang dapat Anda nyatakan dalam manifes keterampilan Anda.

  • Anda hanya dapat menyatakan 100 atau lebih sedikit tindakan.
  • Setiap tindakan dibatasi hingga 25 atau lebih sedikit input atau output.
  • Anda tidak dapat menggunakan jenis array untuk input atau output.

Pembatasan penyewa yang sama

Untuk memastikan kepatuhan dan tata kelola keterampilan kustom yang memadai yang didaftarkan untuk digunakan dalam Power Virtual Agents, bot keterampilan Anda harus menjadi aplikasi terdaftar di ID Microsoft Entra. Setelah menambahkan keterampilan, kami memvalidasi apakah ID aplikasi keterampilan adalah penyewa pengguna yang masuk dan titik akhir keterampilan cocok dengan aplikasi Home Page URLterdaftar.

Sebelum Anda dapat mendaftarkan bot Sebagai keterampilan dalam Power Virtual Agents, Anda harus memastikan bahwa untuk bot, halaman beranda di portal Azure diatur ke URL manifes keterampilan bot.

Validasi dilakukan selama mendaftarkan Keterampilan

Ketika pengguna akhir mencoba terhubung ke keterampilan Anda dari bot Power Virtual Agents mereka, mereka harus terlebih dahulu mengimpor keterampilan ke Power Virtual Agents. Keterampilan Anda akan melalui serangkaian pemeriksaan validasi. Kegagalan salah satu pemeriksaan ini dapat mengakibatkan pesan kesalahan seperti yang dijelaskan dalam tabel ini.

Langkah validasi Kode kesalahan Pesan kesalahan Deskripsi atau mitigasi
URL Manifes valid URL_MALFORMED, URL_NOT_HTTPS Tautan tidak valid; Tautan harus dimulai dengan https:// Masukkan kembali tautan sebagai URL aman.
Manifes dapat diambil MANIFEST_FETCH_FAILED Kami mengalami masalah saat mendapatkan manifes keterampilan. Verifikasi URL manifes Anda adalah tautan ke manifes Anda; coba buka URL manifes Anda di browser web. Jika URL merender halaman dalam waktu 10 detik, daftarkan ulang keterampilan Anda.
Manifes dapat dibaca MANIFEST_TOO_LARGE Manifes terlalu besar. Manifes Anda harus 500 KB atau kurang.
Manifes dapat dibaca MANIFEST_MALFORMED Manifes tidak kompatibel. Periksa apakah manifes adalah file JSON yang valid. Periksa apakah manifes berisi properti yang diperlukan, seperti name, msaAppId, dan sebagainya. Lihat Pembatasan manifes untuk informasi selengkapnya.
Keterampilan belum terdaftar MANIFEST_ALREADY_IMPORTED Keterampilan ini telah ditambahkan ke bot Anda. Hapus keterampilan dan daftarkan lagi.
Titik akhir manifes dan domain beranda cocok MANIFEST_ENDPOINT_ORIGIN_MISMATCH Ada ketidakcocokan di titik akhir keterampilan Anda. Domain URL beranda aplikasi Microsoft Entra ID dan domain URL manifes harus cocok. Lihat Pembatasan penyewa yang sama
Keterampilan dihosting di penyewa pengguna yang masuk APPID_NOT_IN_TENANT Untuk menambahkan keterampilan, pertama-tama harus didaftarkan. Administrator global harus mendaftarkan keterampilan ke organisasi pengguna yang masuk.
Tindakan dibatasi LIMITS_TOO_MANY_ACTIONS Keterampilan ini dibatasi hingga 100 tindakan. Ada terlalu banyak tindakan keterampilan yang ditentukan dalam manifes keterampilan. Hapus tindakan dan coba lagi.
Parameter input tindakan terbatas LIMITS_TOO_MANY_INPUTS Tindakan dibatasi hingga 25 input. Ada terlalu banyak parameter input tindakan keterampilan. Hapus parameter dan coba lagi.
Parameter output tindakan terbatas LIMITS_TOO_MANY_OUTPUTS Tindakan dibatasi hingga 25 output. Ada terlalu banyak parameter output tindakan keterampilan. Hapus parameter dan coba lagi.
Jumlah keterampilan terbatas LIMITS_TOO_MANY_SKILLS Bot Anda dapat memiliki maksimal 25 keterampilan. Ada terlalu banyak keterampilan yang ditambahkan ke dalam bot. Hapus keterampilan yang ada, lalu coba lagi.
Token keamanan valid AADERROR_OTHER Sepertinya ada yang tidak bermasalah. Mungkin ada kesalahan sementara untuk memperoleh token keamanan untuk memicu keterampilan. Coba lagi mengimpor keterampilan.
Keterampilan sehat ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Terjadi kesalahan saat memeriksa keterampilan Anda. Power Virtual Agents menerima respons yang tidak diketahui saat mengirim EndOfConversation aktivitas ke keterampilan Anda. Pastikan keterampilan Anda berjalan dan merespons dengan benar.
Keterampilan diotorisasi ENDPOINT_HEALTHCHECK_UNAUTHORIZED Keterampilan ini belum mengizinkan untuk mencantumkan bot Anda. Periksa apakah bot Anda telah ditambahkan ke daftar izin keterampilan. Untuk informasi selengkapnya, lihat Power Virtual Agents cara Mengonfigurasi Keterampilan.