Bagikan melalui

Gunakan chatbot klasik sebagai keterampilan di abot Bot Framework

  • Artikel

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.

Catatan

Artikel ini mencakup informasi yang hanya berlaku untuk Microsoft Copilot Studio chatbot klasik. Fitur ini tidak tersedia di pengalaman baru Microsoft Copilot Studio .

Saat Anda menggunakan akopilot Microsoft Copilot Studio sebagai keterampilan dengan abot Bot Framework , Bot Framework bot menentukan apakah ada yang dikatakan pengguna cocok dengan Microsoft Copilot Studio frasa pemicu kopilot. Jika ada kecocokan, Bot Framework bot meneruskan percakapan ke Microsoft Copilot Studio bot. Microsoft Copilot Studio kopilot mengekstrak entitas apa pun dan memicu topik yang cocok.

Anda juga dapat meneruskan variabel ke a Microsoft Copilot Studio keterampilan topik sebagai input dari Bot Framework Composer dan menggunakan output yang dikembalikannya.

Penting

Anda harus memiliki lisensi uji coba atau penuh Microsoft Copilot Studio untuk menggunakan Microsoft Copilot Studio bot sebagai keterampilan. Kemampuan ini tidak tersedia dengan lisensi Microsoft Copilot Studio Teams.

Untuk mengatur kopilot Anda Microsoft Copilot Studio sebagai keterampilan:

  1. Tambahkan Bot Framework bot ke daftar yang diizinkan untuk Microsoft Copilot Studio kopilot.
  2. Unduh manifes keterampilan untuk Microsoft Copilot Studio kopilot.
  3. Gunakan manifes keterampilan yang diunduh di Bot Framework Composer untuk membuat koneksi antar bot.
  4. Gunakan Bot Framework Emulator untuk mengonfirmasi bot berfungsi sebagai keterampilan.

Prasyarat

Tambahkan bot Anda Bot Framework ke daftar yang diizinkan untuk kopilot Anda Microsoft Copilot Studio

Tambahkan Bot Framework ID aplikasi bot ke daftar yang diizinkan untuk Microsoft Copilot Studio kopilot yang ingin Anda gunakan sebagai keterampilan. Bot harus berada di penyewa yang sama.

  1. Di Bot Framework Composer, buka bot yang akan menggunakan keterampilan tersebut. Pilih Konfigurasikan, lalu pilih Sumber daya pengembangan. Salin ID di ID Aplikasi Microsoft.

    Tangkapan layar yang menyoroti tempat menemukan Bot Framework ID aplikasi bot.

  2. Di dalam Microsoft Copilot Studio, buka kopilot yang ingin Anda gunakan sebagai keterampilan.

  3. Di menu navigasi, buka Pengaturan dan pilih Keamanan. Lalu pilih Daftar yang diizinkan.

    Cuplikan layar yang menyoroti ubin Daftar yang diizinkan di halaman Keamanan.

  4. Pilih Tambahkan penelepon yang diizinkan.

    Screenshot yang menyoroti tombol Tambahkan penelepon yang diizinkan di bagian atas panel Kelola daftar yang diizinkan.

  5. Tempelkan ID Bot Framework aplikasi bot Anda dan pilih Berikutnya.

    Cuplikan layar menyoroti tempat memasukkan Bot Framework ID aplikasi bot.

    Perhatian

    Akopilot Microsoft Copilot Studio tidak dapat bertindak sebagai keterampilan untuk copilot lain Microsoft Copilot Studio . Jika Anda mencoba menambahkan ID aplikasi yang termasuk dalam Power agen virtual bot ke daftar yang diizinkan, Anda akan mendapatkan error. Anda hanya dapat menambahkan ID aplikasi untuk abot Bot Framework .

    Microsoft Copilot Studio memvalidasi Bot Framework ID aplikasi bot dan mengonfirmasi bahwa ID aplikasi milik bot di penyewa yang sama.

  6. (Opsional) Tambahkan nama tampilan untuk bot yang telah Anda tambahkan ke daftar yang diizinkan.

    Cuplikan layar yang menunjukkan tempat menambahkan nama tampilan untuk bot di daftar yang diizinkan.

  7. Pilih Simpan.

Bot Framework Bot ditampilkan dengan Nama tampilan jika Anda memasukkannya, atau dengan ID aplikasinya jika Anda tidak memasukkan nama tampilan. Untuk menghapus atau mengeditnya kapan saja, pilih ikon di sebelah kanan Nama tampilan atau ID aplikasi bot.

Cuplikan layar panel Kelola daftar yang diizinkan yang menampilkan ikon edit dan hapus untuk bot yang diizinkan.

Catatan

Bot Framework Bot yang ditambahkan ke daftar yang diizinkan tidak diekspor sebagai bagian dari konten bot.

Download manifes kopilot keterampilan untuk Anda Microsoft Copilot Studio kopilot

Bot Framework Bot dapat menggunakan Microsoft Copilot Studio manifes keterampilan untuk mengonfigurasi koneksi ke kopilot yang menghasilkan manifes.

Semua Microsoft Copilot Studio kopilot memiliki manifes keterampilan. Ini adalah file JSON yang menyertakan nama, antarmuka, dan frasa pemicu keterampilan.

Abot Bot Framework dapat menggunakan manifes keterampilan untuk mengetahui kapan harus memicu Microsoft Copilot Studio bot (misalnya, sebagai respons terhadap sesuatu yang dikatakan pengguna kepadanya).

Microsoft Copilot Studio Manifes keterampilan mengikuti versi 2.2 dari Bot Framework skema manifes keterampilan dan terdiri dari file intents.lu dan manifest.json .

Abot Bot Framework dapat memutuskan akopilot Microsoft Copilot Studio harus menangani permintaan pengguna, berdasarkan data manifes. Itu meneruskan ke kopilot semua yang dikatakan pengguna. Kemudian, Microsoft Copilot Studio kopilot mencocokkan apa yang dikatakan pengguna ke Microsoft Copilot Studio topik, mengekstrak entitas apa pun yang diperlukan untuk mengisi slot, dan memicu Microsoft Copilot Studio topik.

Microsoft Copilot Studio Manifes keterampilan dibuat dan diperbarui secara otomatis. Akopilot Microsoft Copilot Studio memiliki dua manifes keterampilan:

  • Manifes pengujian: Memungkinkan Bot Framework bot untuk terhubung ke versi pengujian kopilot Anda Microsoft Copilot Studio . Gunakan manifes pengujian untuk memvalidasi perubahan pada keterampilan Anda sebelum Anda menerbitkannya.

    • Manifes pengujian segera tersedia untuk setiap bot yang baru dibuat Microsoft Copilot Studio .
    • Ini diperbarui secara otomatis untuk mencerminkan perubahan setiap kali Anda menyimpan kopilot Anda.

  • Manifes yang diterbitkan: Mengizinkan Bot Framework bot terhubung ke versi kopilot Anda Microsoft Copilot Studio yang diterbitkan.

    • Manifes yang dipublikasikan hanya tersedia untuk Microsoft Copilot Studio kopilot yang telah dipublikasikan setidaknya sekali.
    • Ini diperbarui secara otomatis untuk mencerminkan perubahan setiap kali Anda memublikasikan kopilot Anda.

Catatan

Manifes yang dipublikasikan tidak tersedia untuk Microsoft Copilot Studio kopilot yang belum pernah dipublikasikan.

Untuk membuat manifes Dipublikasikan botAnda, publikasikan kopilot Microsoft Copilot Studio Anda.

Kedua manifes keterampilan ditampilkan di panel Kelola daftar yang diizinkan.

Screenshot panel Kelola daftar yang diizinkan yang menampilkan Microsoft Copilot Studio manifes kopilot.

Manifes keterampilan juga ditampilkan di halaman Detail kopilot. Di menu navigasi, pilih Pengaturan, lalu pilih Detail . Halaman Detail menampilkan metadata lain, termasuk ID Lingkungan, ID Penyewa, dan ID aplikasi bot.

Tangkapan layar halaman Detail yang menyoroti tempat mengunduh Microsoft Copilot Studio manifes kopilot.

Untuk mendownload manifes, pilih. Ini diunduh sebagai file .zip berlabel < bot nama>_manifest untuk manifes Diterbitkan , atau bot nama <_test__manifest>untuk manifes Uji.

Cuplikan layar yang menunjukkan dua Microsoft Copilot Studio manifes setelah diunduh.

Catatan

Manifes keterampilan tidak menyertakan topik sistem dan dialog Komposer yang ditambahkan ke Microsoft Copilot Studio kopilot. Hanya topik yang dibuat oleh penulis kopilot dan pemicu intent Composer yang ditambahkan penulis ke bot yang disertakan.

Terhubung ke Microsoft Copilot Studio keterampilan di Composer

Gunakan Microsoft Copilot Studio manifestasi keterampilan untuk membuat koneksi keterampilan di bot Anda Bot Framework di Composer.

  1. Dalam Bot Framework proyek Composer, pilih Tambahkan, lalu pilih Sambungkan ke keterampilan.

    Tangkapan layar Composer Bot Framework yang menunjukkan cara menghubungkan abot Bot Framework ke keterampilan.

  2. Telusuri dan pilih Microsoft Copilot Studio manifes .zip arsip, lalu pilih Berikutnya.

    Tangkapan layar Composer menunjukkan tempat memilih Microsoft Copilot Studio arsip zip keterampilan.

  3. Pilih topik, atau niat, di kopilot Anda Microsoft Copilot Studio yang ingin Anda tambahkan ke bot Anda Bot Framework , lalu pilih Berikutnya.

    Tangkapan layar Composer yang menunjukkan pemilihan Microsoft Copilot Studio topik.

  4. Tinjau dan edit frasa pemicu untuk kopilot Anda Microsoft Copilot Studio , lalu pilih Berikutnya.

    Tangkapan layar Composer yang menunjukkan tempat untuk mengedit frasa pemicu untuk topik yang dipilih.

  5. Pastikan Gunakan Orchestrator untuk proyek multi-bot dipilih, lalu pilih Lanjutkan.

    Tangkapan layar Composer yang menunjukkan Orchestrator diaktifkan.

  6. Pastikan Microsoft Copilot Studio keterampilan ditambahkan ke bot Anda Bot Framework dengan benar, dan pemicu baru dengan nama kopilot Anda Microsoft Copilot Studio muncul di proyek di Composer.

    Tangkapan layar Komposer setelah Microsoft Copilot Studio keterampilan ditambahkan.

Temukan topik di manifes keterampilan

Gunakan acara untuk memicu Microsoft Copilot Studio topik dalam keterampilan. Untuk memanggil topik tertentu dari Composer, lihat topik dengan nama peristiwa terkait dalam manifes keterampilan.

  1. Pilih tindakan Hubungkan ke keterampilan .

  2. Di bawah Nama Dialog keterampilan, pilih Tampilkan manifes keterampilan.

    Tangkapan layar Composer yang menyoroti tempat menampilkan manifes keterampilan.

  3. Temukan aktivitas dalam manifes. Properti ini berisi properti berlapis yang mewakili topik yang tersedia di kopilot Anda Microsoft Copilot Studio .

    Cuplikan layar manifes keterampilan yang menyoroti properti aktivitas.

  4. Temukan topik yang ingin Anda hubungi dan cari properti namanya . Ketika Microsoft Copilot Studio keterampilan menerima acara dengan nama ini, itu memicu topik.

    Dalam contoh berikut, nama aktivitas peristiwa adalah dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

    Cuplikan layar yang menyoroti Microsoft Copilot Studio nama topik dalam manifes.

Hubungi a Microsoft Copilot Studio keterampilan topik

Alih-alih mengandalkan apa yang dikatakan pengguna untuk memicu a Microsoft Copilot Studio keterampilan topik, Anda dapat memanggilnya secara langsung. Anda hanya dapat langsung memanggil Microsoft Copilot Studio topik yang tercantum dalam manifes keterampilan.

  1. Di kanvas penulisan Composer, pilih Tambahkan, lalu pilih Akses sumber daya eksternal, lalu pilih Sambungkan ke keterampilan.

    Tangkapan layar Composer yang menyoroti cara terhubung ke keterampilan.

  2. Di daftar Nama Dialog keterampilan, pilih kopilot Anda Microsoft Copilot Studio .

    Tangkapan layar menyoroti tempat memilih kopilot Anda Microsoft Copilot Studio .

  3. Temukan nama aktivitas acara untuk Microsoft Copilot Studio bot topik yang ingin Anda panggil. Salin nilai, hilangkan tanda kutip, dan simpan untuk digunakan di langkah berikutnya.

  4. Pilih tutup.

  5. Di bagian Aktivitas , pilih Tampilkan kode.

    Screenshot menyoroti tempat memilih Show Code.

  6. Ketik atau tempel kode berikut. Ganti dengan TOPIC_ACTIVITY_NAME nama aktivitas acara topik Anda. Pastikan tidak ada tanda kutip di properti name .

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

    Cuplikan layar menyoroti tempat menambahkan kode peristiwa Aktivitas dengan Microsoft Copilot Studio nama topik.

Teruskan variabel input ke a Microsoft Copilot Studio keterampilan topik

Bot Framework Komposer dapat meneruskan variabel ke a Microsoft Copilot Studio keterampilan topik sebagai input. Untuk mempelajari cara membuat Microsoft Copilot Studio topik yang menerima variabel input, lihat Meneruskan variabel antar topik.

Jika Microsoft Copilot Studio topik yang dapat menerima variabel input tercantum dalam manifes keterampilan Anda, Anda dapat meneruskan variabel Komposer ke dalamnya.

  1. Di kanvas penulisan Composer, pilih Tambahkan, lalu pilih Akses sumber daya eksternal, lalu pilih Sambungkan ke keterampilan.

    Tangkapan layar Composer yang menyoroti cara terhubung ke keterampilan.

  2. Di daftar Nama Dialog keterampilan, pilih kopilot Anda Microsoft Copilot Studio .

    Tangkapan layar menyoroti tempat memilih kopilot Anda Microsoft Copilot Studio .

  3. Temukan nama aktivitas acara untuk Microsoft Copilot Studio kopilot topik yang ingin Anda panggil. Salin nilai, hilangkan tanda kutip, dan simpan untuk digunakan di langkah berikutnya.

  4. Temukan properti nilai topik . Properti nilai berisi properti $ref . Salin nilai tersebut dan simpan untuk digunakan pada langkah berikutnya.

    Peringatan

    Jika Microsoft Copilot Studio topik tidak memiliki input, itu tidak akan memiliki properti value .

    Tangkapan layar manifes keterampilan yang menyoroti properti value.

  5. Temukan properti definisi, lalu cari properti berlapis yang cocok dengan $ref nilai yang Anda temukan di langkah sebelumnya. Perhatikan nama dan jenis Microsoft Copilot Studio input topik. Anda akan menggunakannya di langkah berikutnya.

    Cuplikan layar manifes keterampilan yang menyoroti tempat menemukan variabel input untuk Microsoft Copilot Studio topik.

  6. Pilih tutup.

  7. Di bagian Aktivitas , pilih Tampilkan kode.

    Screenshot menyoroti tempat memilih Show Code.

  8. Ketik atau tempel kode berikut. Ganti nilai-nilai ini:

    1. Ganti dengan TOPIC_ACTIVITY_NAME nama aktivitas acara topik Anda.
    2. Ganti dengan PVA_INPUT_VARIABLE variabel input dari topik Anda.
    3. Ganti dengan COMPOSER_INPUT_VARIABLE variabel Composer yang akan memberikan nilai.
    [Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]

    Dalam contoh berikut, variabel dialog.storeLocation Composer memberikan nilai ke variabel pva_StoreLocation input di kopilot topik Microsoft Copilot Studio dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

    Cuplikan layar menyoroti tempat menambahkan kode peristiwa Aktivitas dengan Microsoft Copilot Studio nilai input.

Terima variabel keluaran dari Microsoft Copilot Studio keterampilan topik

Dimungkinkan untuk menerima output dari a Microsoft Copilot Studio keterampilan topik di Composer. Untuk mempelajari cara membuat Microsoft Copilot Studio topik yang menampilkan output, lihat Meneruskan variabel antar topik.

  1. Di kanvas penulisan Composer, pilih Tambahkan, lalu pilih Akses sumber daya eksternal, lalu pilih Sambungkan ke keterampilan.

    Tangkapan layar Composer yang menyoroti cara terhubung ke keterampilan.

  2. Di daftar Nama Dialog keterampilan, pilih kopilot Anda Microsoft Copilot Studio .

    Tangkapan layar menyoroti tempat memilih kopilot Anda Microsoft Copilot Studio .

  3. Temukan nama aktivitas acara untuk Microsoft Copilot Studio bot topik Anda ingin menelepon. Salin nilai, hilangkan tanda kutip, dan simpan untuk digunakan di langkah berikutnya.

  4. Temukan properti resultValue topik. Properti resultValue berisi properti $ref . Salin nilai tersebut dan simpan untuk digunakan pada langkah berikutnya.

    Peringatan

    Jika Microsoft Copilot Studio topik tidak memiliki output, itu tidak akan memiliki properti resultValue .

    Cuplikan layar manifes keterampilan yang menyoroti properti resultValue untuk Microsoft Copilot Studio topik.

  5. Temukan properti definisi, lalu cari properti berlapis yang cocok dengan $ref nilai yang Anda temukan di langkah sebelumnya. Perhatikan nama dan jenis Microsoft Copilot Studio variabel keluaran topik. Anda akan menggunakannya di langkah berikutnya.

    Dalam contoh berikut, the Microsoft Copilot Studio topik mengembalikan dua output jenis String,pva_State dan pva_Item.

    Cuplikan layar manifes keterampilan yang menyoroti tempat menemukan variabel keluaran untuk suatu Microsoft Copilot Studio topik.

  6. Pilih tutup.

  7. Di bagian Aktivitas , pilih Tampilkan kode.

    Screenshot menyoroti tempat memilih Show Code.

  8. Ketik atau tempel kode berikut. Ganti dengan TOPIC_ACTIVITY_NAME nama aktivitas acara topik Anda. Pastikan tidak ada tanda kutip di properti name .

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

    Cuplikan layar menyoroti tempat menambahkan kode peristiwa Aktivitas dengan Microsoft Copilot Studio nama topik.

  9. Di bawah area kode, atur Properti ke variabel Komposer untuk menerima dan menyimpan nilai output dari Microsoft Copilot Studio keterampilan topik.

    Cuplikan layar menyoroti tempat mengatur bidang Properti ke dialog.skillResult.

  10. Di kanvas penulisan Composer, pilih Tambahkan, lalu pilih Kelola properti, lalu pilih Atur properti.

    Cuplikan layar menyoroti tempat memilih Atur properti.

  11. Atur Properti ke nilai Komposer yang harus menyimpan nilai yang diekstraksi. Kemudian atur Nilai ke variabel Komposer tempat Anda menyimpan output topik.

    Dalam contoh berikut, nilai output dari dialog.skillResult.pvaState dan dialog.skillResult.pvaItem diekstraksi ke dalam dialog variabel Komposer baru. Status dan dialog. Barang.

    Tangkapan layar menyoroti nilai keluaran yang disimpan ke dalam dialog. Status dan dialog. Item di jendela properti Set Komposer.

Uji kopilot Anda Microsoft Copilot Studio sebagai keterampilan dengan abot Bot Framework

Gunakan Bot Framework Emulator untuk menguji apakah bot Anda Bot Framework memanggil Microsoft Copilot Studio kopilot dengan benar sebagai keterampilan.

Penting

Bot Anda Bot Framework harus ditambahkan ke Microsoft Copilot Studio daftar yang diizinkan kopilot agar koneksi keterampilan berfungsi.

Pelajari Lebih Lanjut