Mengekspor dan mengimpor kopilot menggunakan solusi

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.

Anda dapat mengekspor dan mengimpor kopilot menggunakan solusi sehingga Anda dapat memindahkan kopilot Anda di beberapa lingkungan.

Hal ini dapat berguna jika Anda menggunakan lingkungan yang berbeda untuk tujuan yang berbeda, atau Anda menggunakan metodologi penyebaran cincin. Misalnya, Anda mungkin memiliki lingkungan tertentu tempat Anda menguji dan memvalidasi kopilot secara internal, lingkungan lain tempat Anda menguji kopilot hanya untuk sebagian pengguna, dan lingkungan produksi akhir tempat Anda berbagi kopilot dengan pelanggan dan pengguna akhir.

Catatan

Anda tidak dapat mengekspor komentar tingkat topik atau tingkat node saat mengekspor kopilot.

Prasyarat

Penting

Artikel ini berisi Microsoft Copilot Studio dokumentasi pratinjau dan dapat berubah sewaktu-waktu.

Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas terbatas. Fitur-fitur ini tersedia sebelum rilis resmi sehingga Anda bisa mendapatkan akses awal dan memberikan umpan balik.

Jika Anda membuat kopilot siap produksi, lihat Microsoft Copilot Studio Ringkasan.

Pindahkan kopilot Anda di seluruh lingkungan dengan mengekspor dan mengimpornya menggunakan solusi. Mengekspor dan mengimpor kopilot Anda dapat berguna jika Anda menggunakan lingkungan yang berbeda untuk tujuan yang berbeda atau jika Anda menggunakan metodologi penyebaran cincin. Misalnya, Anda mungkin memiliki satu lingkungan tempat Anda menguji dan memvalidasi kopilot secara internal, lingkungan lain tempat Anda menguji kopilot dengan subkumpulan pengguna, dan lingkungan produksi tempat Anda berbagi kopilot dengan pelanggan.

Hal yang perlu diketahui

  • Anda tidak dapat mengekspor komentar tingkat topik atau tingkat node saat mengekspor kopilot.

  • Menghapus kopilot dari solusi tidak menghapus komponennya dari solusi. Anda harus menghapus komponen secara terpisah.

    Peringatan

    Jangan hapus komponen kopilot yang tidak terkelola, seperti topik kopilot, langsung dari Power Apps portal kecuali Anda telah menghapus kopilot dari solusi.

    Anda hanya boleh membuat perubahan pada topik dari Copilot Studio. Menghapus atau mengubah komponen kopilot dari Power Apps akan menyebabkan ekspor dan impor gagal.

  • Anda tidak dapat mengekspor solusi terkelola. Saat Anda membuat solusi, solusi tersebut tidak dikelola secara default. Jika Anda mengubahnya menjadi solusi terkelola, Anda tidak akan dapat mengekspornya. Anda harus membuat solusi baru.

  • Jika kopilot Anda memiliki sejumlah besar komponen (misalnya, lebih dari 250 topik atau lebih dari 100 entitas), ekspor menggunakan portal klasik Power Apps sebagai gantinya.

Membuat solusi untuk mengelola ekspor dan impor

Anda menggunakan solusi untuk mengekspor kopilot dari satu lingkungan dan mengimpornya ke lingkungan lain. Solusinya bertindak sebagai "pembawa" untuk kopilot. Anda dapat mengekspor dan mengimpor beberapa kopilot dalam satu solusi.

  1. Masuk Copilot Studio, buka kopilot yang ingin Anda ekspor.

  2. Buka Pengaturan, pilih Detail kopilot, lalu pilih Ekspor.

    Cuplikan layar tab detail Copilot Studio Copilot, dengan tombol Ekspor disorot.

  3. Pilih Buka Power Apps Solusi.

    Cuplikan layar permintaan ekspor kopilot.

  4. Di Power Apps, pada tab Solusi , pilih Solusi baru.

    Cuplikan layar Power Apps halaman Solusi, dengan tombol Solusi baru disorot.

  5. Masukkan informasi berikut untuk solusi baru:

    Bidang Description
    Nama tampilan Nama yang ditampilkan dalam daftar solusi. Anda dapat mengubahnya nanti.
    Nama Nama unik solusi, yang dihasilkan dari nama tampilan. Anda dapat mengeditnya sebelum menyimpan solusi, tetapi setelah menyimpan solusi, Anda tidak dapat mengubahnya.
    Penerbit Pilih penerbit default atau buat penerbit baru. Sebaiknya buat penerbit yang dapat Anda gunakan secara konsisten di seluruh lingkungan tempat Anda akan menggunakan solusi. Pelajari selengkapnya tentang penerbit solusi.
    Versi Masukkan nomor versi solusi Anda. Nomor versi disertakan dalam nama file saat Anda mengekspor solusi.
  6. Pilih Buat.

Tambahkan kopilot Anda ke solusi

  1. Solusi yang Anda buat harus terbuka Power Apps. Jika tidak, pilih dalam daftar solusi.

  2. Pilih Tambahkan yang sudah ada, lalu pilih Chatbot.

  3. Di daftar Tambahkan bot obrolan yang ada, pilih kopilot atau kopilot yang ingin Anda ekspor, lalu pilih Tambahkan.

Catatan

Untuk chatbot Klasik :

Jika Anda menggunakan keterampilan, hapus variabel lingkungan keterampilan Nilai Saat Ini dengan memilih Hapus dari solusi ini.

Cuplikan layar memperlihatkan tombol Hapus dari solusi ini.

Menghapus kopilot dari solusi tidak menghapus komponennya dari solusi. Anda harus menghapus komponen secara terpisah.

Peringatan

Jangan hapus subkomponen kopilot yang tidak dikelola (seperti topik kopilot) langsung dari Power Apps portal, kecuali Anda telah menghapus kopilot itu sendiri dari solusi.

Anda hanya boleh membuat perubahan pada topik dari Copilot Studio dalam portal.

Menghapus atau mengubah subkomponen kopilot dari dalam Power Apps akan menyebabkan ekspor dan impor gagal.

Ekspor solusi dengan kopilot Anda

Anda mengekspor dan mengimpor kopilot dengan mengekspor dan mengimpor solusi yang mengandungnya dari satu lingkungan ke lingkungan lainnya.

Penting

Jika kopilot Anda memiliki sejumlah besar komponen (misalnya, lebih dari 250 topik atau lebih dari 100 entitas), lihat Mengekspor menggunakan pengalaman klasik.

  1. Power Apps Di halaman Solusi , pilih solusi yang berisi kopilot Anda, lalu pilih Ekspor solusi.

    Cuplikan layar tombol Solusi ekspor masuk Power Apps.

  2. Di panel Sebelum Anda mengekspor , pilih Berikutnya.

  3. Masukkan atau pilih opsi berikut:

    Opsi Description
    Nomor versi Copilot Studio Secara otomatis meningkatkan versi solusi Anda. Anda dapat menerima default atau memasukkan default Anda sendiri.
    Ekspor sebagai Pilih jenis paket, baik Terkelola atau Tidak Terkelola. Pelajari selengkapnya tentang solusi terkelola dan tidak terkelola.
  4. Pilih Ekspor.

Ekspor dapat memakan waktu beberapa menit untuk diselesaikan. Tonton pesan status di bagian atas halaman Solusi . Setelah ekspor selesai, browser Anda mengunduh file .zip. Nama file dalam format SolutionName_Version_ManagementType.zip; misalnya, MyBotPublisher_1.0.0.0.1_Unmanaged.zip.

Impor solusi dengan kopilot Anda

  1. Di Power Apps, pilih lingkungan tempat Anda ingin mengimpor kopilot.

    Cuplikan layar memilih Power Apps lingkungan.

  2. Di halaman Solusi , pastikan tidak ada solusi yang dipilih, dan pilih Impor solusi.

    Cuplikan layar Power Apps halaman Solusi, dengan tombol Impor solusi disorot.

  3. Di panel Impor solusi , pilih Telusuri, pilih file .zip yang berisi solusi dengan kopilot Anda, lalu pilih Berikutnya.

  4. Pilih impor.

  5. Tunggu beberapa saat sementara impor selesai. Lihat hasilnya, lalu pilih Tutup.

    Jika impor tidak berhasil, pilih Unduh File Log untuk mengunduh file XML yang berisi detail tentang apa yang menyebabkan impor gagal. Alasan paling umum impor gagal adalah karena solusinya tidak mengandung beberapa komponen yang diperlukan.

  6. Jika kopilot Anda mengaktifkan autentikasi pengguna, Anda harus mengonfigurasinya lagi.

  7. Di panel Objek , pilih Chatbot. Kemudian pilih nama kopilot untuk membuka kopilot di Copilot Studio portal.

    Cuplikan layar daftar kopilot dan lingkungan di Copilot Studio.

    Anda juga dapat membuka Copilot Studio secara langsung dan kemudian membuka kopilot Anda di lingkungan tempat Anda mengimpornya.

Penting

  • Anda harus memublikasikan kopilot yang diimpor sebelum dapat dibagikan.
  • Mungkin perlu waktu hingga 24 jam agar ikon kopilot Anda muncul di mana saja.

Menambahkan komponen ke kopilot dalam solusi kustom

Jika Anda menambahkan komponen, seperti topik atau alur, ke kopilot Copilot Studio, Anda juga harus menambahkannya ke kopilot dalam solusi tidak terkelola.

  1. Buka solusi Anda di Power Apps portal.

  2. Pilih Chatbots, lalu pilih kopilot Anda dalam daftar.

  3. Pilih Commands(⋮), pilih Advanced , lalu pilih+Add required objects.

    Cuplikan layar menyoroti opsi Tambahkan komponen yang diperlukan di bawah menu Perintah di Power Apps.

Meningkatkan atau memperbarui solusi dengan kopilot

Pelajari cara meningkatkan atau memperbarui solusi.

Menghapus lapisan yang tidak dikelola dari kopilot terkelola

Solusi terkelola dan tidak terkelola ada pada tingkat yang berbeda di lingkungan Microsoft Dataverse . Untuk mempelajari lebih lanjut, buka Lapisan solusi.

Saat Anda mengedit komponen terkelola, seperti topik atau alur, komponen tersebut akan mendapatkan lapisan "Aktif" yang tidak dikelola. Untuk menampilkan pembaruan terbaru setelah menyebarkan solusi, Anda harus menghapus lapisan tersebut.

Gunakan opsi Lihat lapisan solusi untuk melihat semua solusi yang menjadi bagian komponennya. Anda juga dapat melihat satu solusi "Aktif" di atas semua solusi lain jika Anda telah mengubah sesuatu secara langsung.

  1. Buka solusi Anda di Power Apps portal.

  2. Pilih Chatbots, lalu pilih kopilot Anda dalam daftar.

  3. Pilih Commands(⋮), pilih Advanced , lalu pilihSee solution layers.

    Cuplikan layar menyoroti opsi Lihat lapisan solusi di bawah menu Perintah di Power Apps.

  4. Di halaman Lapisan Solusi , pilih lapisan tidak terkelola, lalu pilih Hapus lapisan tidak terkelola.