Mengonfigurasi Bot Framework keterampilan untuk digunakan di Copilot Studio

Artikel
02/18/2025

Copilot Studio memungkinkan Anda memperluas agen 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 agen.

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 dengan agen Copilot Studio , penulis dapat memicu tindakan keterampilan dalam percakapan dengan mulus.

Prasyarat

Tinjau pembatasan dan validasi untuk keterampilan yang digunakan dalam Copilot Studio

Penting

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

Chatbot klasik hanya mendukung keterampilan yang dibangun 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 agen Composer 1.x yang sudah ada, migrasikan terlebih dahulu ke Composer 2.x sebelum menggunakannya sebagai keterampilan.

Untuk mengonfigurasi keterampilan, pendaftaran aplikasi terkait dalam Microsoft Entra ID untuk keterampilan Anda harus diatur ke konfigurasi multipenyewa.

Tindakan alur dan tindakan keterampilan

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

	Tindakan alur	Tindakan keterampilan
Persona	Penulis agen dapat membuat Alur yang dapat digunakan kembali untuk disematkan ke dalam percakapan agen apa pun.	Pengembang dapat membuat, menerapkan, dan menghosting keterampilan kustom di lingkungan mereka 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.
Jawaban	Gunakan Alur untuk memancarkan respons agen. Misalnya, Tampilkan pesan terpersonalisasi atau gambar sebaris.	Gunakan keterampilan untuk memancarkan respons agen 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 agen.

Konfigurasi Keterampilan

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

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

Untuk menambahkan keterampilan ke agen Anda:

Di panel navigasi, perluas Pengaturan dan pilih Keterampilan.
Di bagian atas halaman Keterampilan , pilih Tambahkan keterampilan.
Salin ID agen Anda dan berikan kepada pengembang keterampilan Anda.
Masukkan URL ke manifest keterampilan. Manifes keterampilan berisi informasi yang diperlukan agen Anda untuk memicu tindakan dalam keterampilan.
Pilih Berikutnya untuk memulai proses validasi. Setelah validasi berhasil, keterampilan Anda ditambahkan ke agen Anda. Anda sekarang dapat menggunakan keterampilan ini dalam topik Anda.

Pertimbangan kepatuhan

Untuk melindungi privasi pengguna, kami memerlukan 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 agen Anda. Anda akan perlu memperbaiki kesalahan ini sebelum mendaftarkan keterampilan.

Pesan kesalahan	Memecahkan masalah/mitigasi
Kami mengalami masalah untuk 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 titik akhir keterampilan Anda cocok dengan pendaftaran Microsoft Entra aplikasi ID (lebih disukai) atau `Publisher domain` bidang Anda `Home page URL` . Pelajari selengkapnya tentang mengatur halaman beranda untuk titik akhir.
Untuk menambahkan keterampilan, pertama-tama harus didaftarkan (`APPID_NOT_IN_TENANT`)	Periksa apakah ID aplikasi keterampilan Anda terdaftar di penyewa ID organisasi Microsoft Entra Anda.
Tautan tidak valid; Tautan 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 agen 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.
Agen Anda dapat memiliki maksimal 100 keterampilan. (`LIMITS_TOO_MANY_SKILLS`)	Ada terlalu banyak keterampilan yang ditambahkan ke dalam agen. 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. Periksa juga apakah pendaftaran aplikasi keterampilan penyewa tunggal telah disebarkan ke penyewa yang sama.
Keterampilan ini belum mengizinkan agen Anda (`ENDPOINT_HEALTHCHECK_UNAUTHORIZED`)	Periksa apakah agen Anda telah ditambahkan ke daftar yang diizinkan keterampilan.

Bagikan melalui