Menginstal Copilot Studio Kit

Copilot Studio Kit adalah toolkit sumber terbuka untuk menguji dan mengevaluasi agen Copilot Studio. Misalnya, ini memungkinkan Anda untuk menentukan kasus pengujian, mensimulasikan kueri pengguna, dan memvalidasi respons agen. Artikel ini memberikan petunjuk langkah demi langkah untuk menginstal kit dari MarketplaceatauGitHub, bersama dengan langkah-langkah pasca-penyebaran dan opsi konfigurasi.

Nota

Sebelum Anda mengunduh dan menginstal Copilot Studio Kit, pastikan bahwa semua prasyarat terpenuhi.

Instal Copilot Studio Kit dari Marketplace

Jika Anda lebih suka menginstal Copilot Studio Kit dari GitHub, lewati ke Instal Copilot Studio Kit dari GitHub.

Terapkan dari Marketplace

Untuk men-deploy Copilot Studio Kit dari Marketplace, ikuti langkah-langkah berikut:

1. Arahkan ke Copilot Studio Kit di Marketplace.
2. Pilih Dapatkan sekarang.
3. Masuk jika perlu.
4. Di tampilan Instal Copilot Studio Kit , pilih lingkungan tempat Anda ingin menyebarkan Copilot Studio Kit.
5. Tinjau persyaratan dan pernyataan. Jika Anda setuju, centang kotak dan pilih Instal.

Penginstalan Copilot Studio Kit dimulai.

Langkah-langkah pasca penyebaran (Marketplace)

Setelah penginstalan selesai, ikuti langkah-langkah pasca-penyebaran ini:

1. Masuk ke Power Apps.
2. Buka Solusi.
3. Pilih solusi default.
4. Pilih Referensi koneksi.
5. Temukan Copilot Studio Kit - Dataverse dan buka untuk pengeditan.
6. Pastikan semua bidang yang diperlukan terisi dan koneksi yang dipilih valid. Buat koneksi baru ke Dataverse sesuai kebutuhan.
7. Pilih Simpan.
8. Ikuti langkah-langkah konfigurasi lebih lanjut dan opsional.

Menginstal Copilot Studio Kit dari GitHub

Ikuti langkah-langkah ini untuk menginstal Copilot Studio Kit dari GitHub. Jika Anda lebih suka menginstal dari Marketplace, buka Menginstal Copilot Studio Kit dari Marketplace.

Unduh rilis GitHub terbaru

Unduh versi terbaru solusi terkelola untuk Power CAT Copilot Studio Kit.

Instal file zip yang dikelola CopilotStudioKit

Untuk menginstal solusi terkelola Copilot Studio Kit:

1. Masuk ke Power Apps.
2. Pilih lingkungan tempat Anda ingin menginstal Copilot Studio Kit.
3. Buka Solusi.
4. Pilih Impor Solusi.
5. Pilih Telusuri.
6. Pilih file CopilotStudioKit*_managed.zip .
7. Pilih Selanjutnya.
8. Setelah meninjau informasi solusi, pilih Berikutnya.
9. Jika diminta, buat koneksi yang diperlukan, dan pilih Impor.
10. Biarkan nilai laporan KPI Percakapan apa adanya untuk saat ini. Anda dapat memperbarui nilai-nilai ini nanti.
11. Tunggu hingga operasi impor selesai.

Meningkatkan solusi yang ada (GitHub)

Jika Anda menginstal versi Copilot Studio Kit yang lebih lama dan ingin meningkatkan ke versi terbaru, ikuti langkah-langkah berikut:

1. Masuk ke Power Apps.
2. Pilih lingkungan tempat Anda ingin meningkatkan Copilot Studio Kit.
3. Buka Solusi.
4. Pilih Impor Solusi.
5. Pilih Telusuri.
6. Pilih CopilotStudioKit*_managed.zip.
7. Pilih Selanjutnya. Power Apps mengakui bahwa peningkatan ini adalah solusi terkelola yang ada.
8. Konfirmasikan bahwa Anda ingin memutakhirkan solusi yang ada dengan memilih Berikutnya.
9. Biarkan nilai laporan KPI Percakapan apa adanya untuk saat ini. Anda dapat memperbarui nilai-nilai ini nanti.
10. Pilih Import.

Nota

Saat memutakhirkan Copilot Studio Kit, Anda mungkin mengalami kesalahan berikut: "Solusi "Power CAT Copilot Studio Kit" gagal diimpor: ImportAsHolding gagal dengan pengecualian: Tidak dapat menghapus atribut: cat_copilottestrunid dari Entitas: cat_CopilotTestRun karena atribut bukan bidang kustom."

Masalah ini diketahui dan sedang diselidiki. Sebagai solusinya, tahapkan peningkatan sebelum menerapkannya. Pelajari selengkapnya di Meningkatkan atau memperbarui solusi.

Langkah-langkah konfigurasi lebih lanjut dan opsional

Langkah-langkah konfigurasi ini berlaku apakah Anda menginstal Copilot Studio Kit dari Marketplace atau GitHub.

Petunjuk / Saran

Copilot Studio Kit menyertakan Wizard Penyiapan untuk mengonfigurasi referensi koneksi, variabel lingkungan, dan alur cloud. Pelajari selengkapnya tentang menggunakan Wizard Pengaturan.

Mengonfigurasi sinkronisasi SharePoint

Langkah-langkah berikut bersifat opsional dan diperlukan hanya jika Anda berencana menggunakan fitur sinkronisasi SharePoint . Anda dapat mengatur nilai-nilai ini kapan saja sebelum menggunakan fitur .

Arahkan koneksi ke SharePoint ke situs SharePoint sumber. Arahkan URL Dataverse ke instans Dataverse untuk agen kustom target tempat konten disinkronkan.

Anda dapat mengikuti langkah-langkah ini atau menggunakan Wizard Penyiapan untuk mengonfigurasi referensi koneksi SharePoint.

Untuk menggunakan fitur sinkronisasi SharePoint:

1. Instal Copilot Studio Kit, yang dijelaskan sebelumnya dalam artikel ini.
2. Masuk ke Power Apps.
3. Buka Solusi.
4. Pilih solusi default.
5. Pilih Referensi koneksi.
6. Temukan Referensi koneksi Copilot Studio Kit - SharePoint dan buka untuk pengeditan.
7. Pastikan semua bidang yang diperlukan diisi dan koneksi yang dipilih valid. Buat koneksi baru ke SharePoint sesuai kebutuhan.
8. Pilih Simpan.

Informasi selengkapnya: Pelajari tentang mengonfigurasi agen di Copilot Studio Kit, termasuk cara mengonfigurasi agen baru untuk sinkronisasi file.

Mengonfigurasi Inventaris Agen

Langkah-langkah berikut bersifat opsional dan diperlukan hanya jika Anda berencana untuk menggunakan fitur Inventori Agen . Anda dapat mengatur nilai-nilai ini kapan saja sebelum menggunakan fitur .

Referensi koneksi dalam solusi mengontrol visibilitas agen. Meskipun Anda dapat menggunakan akun lain, gunakan izin ini untuk mendapatkan visibilitas penuh.

• Copilot Studio Kit - Power Platform for Admins mengambil daftar lingkungan dalam penyewa. Memerlukan izin tingkat admin Power Platform.
• Copilot Studio Kit - Dataverse mengumpulkan informasi agen dari lingkungan. Memerlukan izin tingkat admin sistem ke semua lingkungan.

Anda dapat mengikuti langkah-langkah ini atau menggunakan Wizard Penyiapan untuk mengonfigurasi referensi koneksi Inventaris Agen.

Untuk menggunakan fitur Inventori Agen:

1. Instal Copilot Studio Kit, yang dijelaskan sebelumnya dalam artikel ini.
2. Masuk ke Power Apps.
3. Buka Solusi.
4. Pilih solusi default.
5. Pilih Referensi koneksi.
6. Temukan referensi koneksi Copilot Studio Kit - Power Platform for Admins dan buka untuk pengeditan.
7. Pastikan semua bidang yang diperlukan terisi dan koneksi yang dipilih valid.
8. Pilih Simpan.
9. Temukan referensi koneksi Copilot Studio Kit - Dataverse dan buka untuk pengeditan.
10. Pastikan semua bidang yang diperlukan terisi dan koneksi yang dipilih valid.
11. Pilih Simpan.

Mengaktifkan metrik penggunaan

Untuk mengaktifkan Metrik Penggunaan opsional di Inventori Agen, selesaikan langkah-langkah berikut:

1. Pastikan bahwa konektor HTTP Dengan Microsoft Entra ID (pra-otorisasi) diizinkan di lingkungan Anda.
2. Impor file AgentInventoryUsage*_managed.zip dari repositori GitHub Power CAT Copilot Studio Kit.
3. Selama proses impor, buat koneksi menggunakan URL host lisensi: https://licensing.powerplatform.microsoft.com/

Aktifkan alur

Nota

Jika Anda berencana menggunakan sinkronisasi SharePoint, Konfigurasikan sinkronisasi SharePoint sebelum mengaktifkan alur terkait (nama dimulai dengan Sinkronisasi Sharepoint).

Untuk mengaktifkan alur cloud yang disertakan dalam Copilot Studio Kit, ikuti langkah-langkah ini atau gunakan Wizard Pengaturan.

1. Instal Copilot Studio Kit, yang dijelaskan sebelumnya dalam artikel ini.
2. Masuk ke Power Automate.
3. Pastikan lingkungan Copilot Studio Kit telah dipilih.
4. Pilih Solusi.
5. Pilih Copilot Studio Kit.
6. Pilih Alur cloud.
7. Pastikan semua alur diaktifkan (Status = Aktif).
8. Aktifkan alur apa pun yang tidak diaktifkan, dalam urutan berikut:
   1. Alur yang diakhiri dengan Grandchild.
   2. Alur yang diakhiri dengan turunan.
   3. Sisa alur sesuai kebutuhan, dalam urutan apa pun.

Menyiapkan Pusat Kepatuhan

Untuk menyiapkan Hub Kepatuhan, ikuti langkah-langkah dalam Menyiapkan dan mengonfigurasi Hub Kepatuhan Copilot Studio Kit. Hub Kepatuhan memerlukan Inventaris Agen.

Mengonfigurasi dasbor KPI Percakapan yang disematkan

Langkah-langkah ini diperlukan hanya jika Anda berencana menggunakan dasbor KPI Percakapan yang disematkan.

Selama langkah-langkah, catat nilai berikut:

• Nama ruang kerja
• GUID Ruang kerja
• Nama laporan
• Laporan GUID

Menerbitkan laporan

Untuk memublikasikan laporan KPI Percakapan:

1. Instal Copilot Studio Kit, yang dijelaskan sebelumnya dalam artikel ini.

2. Unduh Conversation.KPIs.zip dari repositori GitHub Power CAT Copilot Studio Kit.

3. Ekstrak isi dari file .zip.

4. Buka file Conversation KPIs.pbit di aplikasi Power BI Desktop.

5. Masukkan URL Dataverse sebagai URL Lingkungan dalam dialog yang muncul dan pilih Muat (misalnya, org3c23948.crm.dynamics.com, tanpa awalan https:// ).

   Jika dialog tidak muncul, masukkan URL Lingkungan di Beranda>Transformasi data>Edit parameter.

6. Refresh data dan masuk sesuai kebutuhan.

7. Simpan dan terbitkan ke ruang kerja.

8. Catat nama Laporan dan Nama ruang kerja.

9. Masuk ke Power BI.

10. Buka laporan yang Anda terbitkan dan catat GUID Ruang Kerja dan GUID Laporan di URL.

    Jika Anda menerbitkan ke "Ruang Kerja Saya," GUID Ruang Kerja adalah 00000000-0000-0000-0000-000000000000.

11. Pilih tiga titik (...) lalu Lihat model semantik.

12. BukaFile>Pengaturan.

13. Periksa apakah Kredensial sumber data tidak memiliki masalah. Masuk untuk memperbaiki masalah apa pun.

14. Buka Refresh dan atur jadwal refresh.

Memperbarui variabel lingkungan laporan

Untuk menyiapkan dasbor KPI Percakapan yang disematkan, perbarui variabel lingkungan terkait dengan pengidentifikasi yang benar. Anda dapat mengikuti langkah-langkah ini atau menggunakan Wizard Pengaturan.

1. Masuk ke Power Apps dan pilih lingkungan tempat Anda menginstal Copilot Studio Kit.
2. Pilih Solusi>Solusi Default.
3. Pilih Variabel lingkungan.
4. Temukan dan pilih Laporan KPI Percakapan.
5. Ganti tempat penampung di Nilai Default dengan nilai Nama ruang kerja, GUID Ruang Kerja, Nama Laporan, dan GUID Laporan yang Anda catat selama proses penerbitan.
6. Pilih Simpan.

Informasi selengkapnya: Pelajari tentang mengonfigurasi agen di Copilot Studio Kit, termasuk cara mengonfigurasi agen baru untuk KPI Percakapan.

Mengakses aplikasi Copilot Studio Kit

Untuk mengakses aplikasi Copilot Studio Kit:

1. Masuk ke Power Apps dan pilih lingkungan tempat Anda menginstal Copilot Studio Kit.
2. Buka Aplikasi.
3. Temukan dan pilih Power CAT Copilot Studio Kit.
4. Pilih Putar.
5. (Opsional) buat marka buku aplikasi.

Langkah selanjutnya

Mengonfigurasi pengguna dan tim