Bagikan melalui

Menerapkan keterampilan untuk digunakan di Copilot Studio

  • 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 bahwa keterampilan Anda akan dikonsumsi dari salinan Copilot Studio , ada beberapa batasan lain yang ditempatkan pada keterampilan Anda yang harus Anda perhitungkan.

Pembatasan manifes

Copilot Studio menempatkan pembatasan pada apa yang dapat Anda deklarasikan dalam manifes keterampilan Anda.

  • Anda hanya dapat mendeklarasikan 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 Copilot Studio, bot keterampilan Anda harus menjadi aplikasi terdaftar di ID Microsoft Entra. Setelah menambahkan keterampilan, kami memvalidasi apakah ID aplikasi keterampilan berada di penyewa pengguna yang masuk dan titik akhir keterampilan cocok dengan aplikasi Home Page URLterdaftar.

Sebelum dapat mendaftarkan bot sebagai keterampilan dalam Copilot Studio, Anda harus memastikan bahwa untuk bot, halaman beranda di portal Azure diatur ke URL manifes keterampilan bot.

Validasi dilakukan selama mendaftarkan Keterampilan

Saat pengguna akhir mencoba terhubung ke keterampilan Anda dari salinan mereka, mereka harus terlebih dahulu mengimpor keterampilan ke Copilot Studio. Keterampilan Anda 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. Copilot Studio 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 ada di daftar izin keterampilan. Untuk informasi selengkapnya, lihat Copilot Studio cara Mengonfigurasi Keterampilan.