Konfigurasikan Bot Framework keterampilan untuk digunakan di Copilot Studio

Penting

Power Virtual Agents kemampuan dan fitur sekarang menjadi bagian dari Microsoft Copilot Studio mengikuti investasi signifikan dalam AI generatif dan integrasi yang ditingkatkan Microsoft Copilot.

Beberapa artikel dan tangkapan layar mungkin merujuk saat Power Virtual Agents kami memperbarui dokumentasi dan konten pelatihan.

Copilot Studio memungkinkan Anda memperluas kopilot Anda dengan menggunakan Bot Framework keterampilan. Jika Anda telah membangun dan menyebarkan bot di organisasi Anda (menggunakan Bot Framework SDK dan alat pro-code) untuk skenario tertentu, Anda dapat mengonversi bot tersebut menjadi keterampilan dan mendaftarkan keterampilan tersebut di Copilot Studio kopilot.

Catatan

Untuk menambahkan keterampilan dari dalam Copilot Studio aplikasi Microsoft Teams, Anda harus memiliki Microsoft Copilot Studio langganan mandiri.

Artikel ini ditujukan untuk administrator sistem atau profesional TI yang terbiasa dengan Bot Framework keterampilan. Setelah keterampilan didaftarkan ke Copilot Studio kopilot, penulis dapat dengan mulus memicu tindakan keterampilan dalam percakapan.

Prasyarat

• Tinjau batasan dan validasi untuk keterampilan yang digunakan dalam Copilot Studio

Penting

Copilot Studio copilot hanya mendukung keterampilan dibuat menggunakan Bot Framework SDK versi 4.12.0+.

Chatbot klasik hanya mendukung keterampilan yang dibuat menggunakan Bot Framework SDK versi 4.7+.

Jika Anda menggunakan Bot Framework Composer , sangat disarankan agar Anda menggunakan Composer 2.x. Jika Anda ingin menggunakan kopilot Composer 1.x yang sudah ada, migrasikan terlebih dahulu ke Composer 2.x sebelum menggunakannya sebagai keterampilan.

Untuk mengonfigurasi keterampilan, pendaftaran aplikasi terkait di Microsoft Entra ID untuk keterampilan Anda harus diatur ke Konfigurasi Multi-penyewa.

Tindakan alur dan tindakan keterampilan

Tabel berikut akan membantu menentukan kapan harus menggunakan keterampilan untuk percakapan.

	Tindakan alur	Tindakan keterampilan
Persona	Penulis copilot dapat membuat Alur yang dapat digunakan kembali untuk disematkan ke dalam percakapan kopilot apa pun	Pengembang dapat membuat, menyebarkan, dan menghosting keterampilan kustom di lingkungannya sendiri
Percakapan	Gunakan alur untuk operasi satu giliran yang sederhana. Misalnya, melakukan pemesanan, atau mendapatkan status pesanan.	Gunakan keterampilan untuk operasi multi-giliran yang kompleks. Misalnya, jadwalkan Rapat atau pesan penerbangan.
Respons	Gunakan Alur untuk memancarkan kopilot respons. Misalnya, Tampilkan pesan terpersonalisasi atau gambar sebaris.	Gunakan keterampilan untuk memancarkan kopilot respons yang didukung. Misalnya, tunjukkan kartu adaptif atau kirim respons acak.
Tindakan	Gunakan alur untuk memicu tindakan satu giliran sisi server. Misalnya, hubungi API HTTP atau memicu konektor kustom.	Gunakan keterampilan untuk memicu aktivitas dan tindakan sisi server dan klien. Misalnya, navigasikan ke halaman setelah kopilot respons.

Konfigurasi Keterampilan

Pertama, gunakan Copilot Studio untuk membuat kopilot dan buat dan terapkan keterampilan menggunakan alat pro-code ke dalam organisasi Anda.

Sebelum mendaftarkan keterampilan, berikan ID kopilot kepada pengembang keterampilan Anda untuk mengizinkan kopilot untuk memanggil tindakan dalam keterampilan. Pelajari lebih lanjut daftar yang diizinkan keterampilan. Anda bisa mendapatkan ID kopilot dari jendela Tambahkan keterampilan .

Untuk menambahkan keterampilan ke kopilot Anda:

1. Di panel navigasi, perluas Pengaturan dan pilih keterampilan.

2. Di bagian atas halaman keterampilan , pilih Tambahkan keterampilan.

3. Salin ID kopilot Anda dan berikan kepada pengembang keterampilan Anda.

   

4. Masukkan URL ke manifest keterampilan. Manifes keterampilan berisi informasi yang diperlukan kopilot Anda untuk memicu tindakan dalam keterampilan.

5. Pilih Berikutnya untuk memulai proses validasi. Setelah validasi berhasil, keterampilan Anda ditambahkan ke kopilot Anda. Anda sekarang dapat menggunakan keterampilan ini dalam topik Anda.

Pertimbangan kepatuhan

Untuk melindungi privasi pengguna, kami mewajibkan keterampilan untuk didaftarkan sebagai aplikasi di penyewa ID pengguna Microsoft Entra yang masuk.

Memecahkan masalah kesalahan selama pendaftaran keterampilan

Rangkaian pemeriksaan validasi dibuat terhadap URL. Pemeriksaan ini memastikan kepatuhan, tata kelola, dan kegunaan keterampilan yang ditambahkan ke kopilot Anda. Anda akan perlu memperbaiki kesalahan ini sebelum mendaftarkan keterampilan.

Pesan kesalahan	Memecahkan masalah/mitigasi
Kami mengalami masalah dalam mendapatkan manifes keterampilan. (MANIFEST_FETCH_FAILED)	Coba buka URL manifest Anda di browser web. Jika URL merender halaman dalam 10 detik, daftarkan ulang keterampilan Anda.
Manifest tidak kompatibel. (MANIFEST_MALFORMED)	(a) Periksa apakah manifes adalah file JSON yang valid. (b) Periksa apakah manifes berisi properti yang diperlukan Misalnya, (,name, msaAppId tunggal endpoint,, activities/id, activities/description( activities/type hanya event atau didukung message )).
Ada ketidakcocokan di endpoint (MANIFEST_ENDPOINT_ORIGIN_MISMATCH) Anda	Periksa apakah keterampilan titik akhir Anda cocok dengan pendaftaran Microsoft Entra aplikasi ID (pilihan) atau Publisher domain bidang Anda Home page URL . Pelajari selengkapnya tentang mengatur halaman beranda untuk titik akhir.
Untuk menambahkan keterampilan, terlebih dahulu harus didaftarkan (APPID_NOT_IN_TENANT)	Periksa apakah ID aplikasi keterampilan Anda terdaftar di penyewa ID organisasi Microsoft Entra Anda.
Tautkan tidak valid; tautkan harus dimulai dengan https:// (URL_MALFORMED, URL_NOT_HTTPS)	Masukkan ulang tautan sebagai URL aman.
Manifesnya terlalu besar; (MANIFEST_TOO_LARGE)	Periksa ukuran manifest. Ia harus kurang dari atau sama dengan 500KB.
Keterampilan ini telah ditambahkan ke kopilot Anda. (MANIFEST_ALREADY_IMPORTED)	Hapus keterampilan dan coba mendaftar lagi.
keterampilan dibatasi hingga 100 tindakan. (LIMITS_TOO_MANY_ACTIONS)	Ada terlalu banyak tindakan keterampilan yang didefinisikan dalam manifes keterampilan. Hapus tindakan dan coba lagi.
Tindakan dibatasi hingga 25 input. (LIMITS_TOO_MANY_INPUTS)	Ada terlalu banyak parameter input tindakan keterampilan. Hapus parameter dan coba lagi.
Tindakan dibatasi hingga 25 output. (LIMITS_TOO_MANY_OUTPUTS)	Ada terlalu banyak parameter output tindakan keterampilan. Hapus parameter dan coba lagi.
Kopilot Anda dapat memiliki maksimal 100 keterampilan. (LIMITS_TOO_MANY_SKILLS)	Ada terlalu banyak keterampilan yang ditambahkan ke dalam kopilot. Hapus keterampilan yang ada dan coba lagi.
Sepertinya ada yang tidak beres. (AADERROR_OTHER)	Terjadi kesalahan sementara saat memvalidasi keterampilan Anda. Coba lagi.
Terjadi kesalahan saat memeriksa keterampilan Anda. (ENDPOINT_HEALTHCHECK_FAILED,) HEALTH_PING_FAILED	Periksa apakah keterampilan titik akhir Anda sedang online dan merespons pesan.
Keterampilan ini belum mengizinkan kopilot Anda (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Periksa apakah kopilot Anda telah ditambahkan ke daftar yang diizinkan keterampilan.