Konfigurasikan Bot Framework keterampilan untuk digunakan di Copilot Studio

Copilot Studio memungkinkan Anda memperluas kopilot Anda dengan menggunakan Bot Framework keterampilan. Jika Anda telah membuat 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 Copilot Studio .

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 copilot 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 copilot 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 Respons kopilot. Misalnya, Tampilkan pesan terpersonalisasi atau gambar sebaris.	Gunakan keterampilan untuk memancarkan Respons kopilot 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 Respons kopilot.

Konfigurasi Keterampilan

Pertama, gunakan Copilot Studio untuk membuat copilot dan membuat serta menyebarkan keterampilan menggunakan alat pro-code ke dalam organisasi Anda.

Sebelum mendaftarkan keterampilan, berikan ID kopilot kepada pengembang keterampilan Anda untuk mengotorisasi 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 pilihketerampilan .

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 ()ENDPOINT_HEALTHCHECK_UNAUTHORIZED Anda	Periksa apakah kopilot Anda telah ditambahkan ke daftar yang diizinkan keterampilan.