Instal Copilot Agent Kit

Copilot Agen Kit adalah toolkit sumber terbuka untuk menguji dan mengevaluasi agen Copilot Studio. Misalnya, ini membantu Anda menentukan kasus pengujian, mensimulasikan kueri pengguna, dan memvalidasi respons agen. Artikel ini memberikan petunjuk langkah demi langkah untuk menginstal kit dari Marketplace atau GitHub, beserta langkah-langkah pasca-penyebaran dan opsi konfigurasi.

Note

Sebelum mengunduh dan menginstal Kit Agen Copilot, pastikan Anda memenuhi semua prasyarat.

Instalasi Kit Agen Copilot dari Marketplace

Jika Anda lebih suka menginstal Kit Agen Copilot dari GitHub, lanjutkan ke Instalasi Kit Agen Copilot dari GitHub.

Terapkan dari Marketplace

Untuk menyebarkan Kit Agen Copilot dari Marketplace, ikuti langkah-langkah berikut:

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

Instalasi Kit Agen Copilot 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 Agent Kit - Dataverse dan buka untuk diedit.
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.

Instalasi Kit Agen Copilot dari GitHub

Ikuti langkah-langkah berikut untuk menginstal Kit Agen Copilot dari GitHub. Jika Anda lebih suka menginstal dari Marketplace, kunjungi Instal Copilot Agent Kit dari Marketplace.

Unduh rilis GitHub terbaru

Unduh versi terbaru dari solusi terkelola untuk Power CAT Copilot Agent Kit.

Menginstal file zip terkelola Kit Agen Copilot

Untuk menginstal solusi terkelola Copilot Agent Kit:

1. Masuk ke Power Apps.
2. Pilih lingkungan tempat Anda ingin menginstal Kit Agen Copilot.
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)

Untuk meningkatkan ke versi terbaru dari Kit Agen Copilot, ikuti langkah-langkah berikut:

1. Masuk ke Power Apps.
2. Pilih lingkungan tempat Anda ingin memperbarui Kit Agen Copilot.
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.

Note

Saat meningkatkan Copilot Agent Kit, Anda mungkin mengalami kesalahan berikut: Solusi "Power CAT Copilot Agent Kit" gagal diimpor: ImportAsHolding gagal dengan pengecualian: Tidak dapat menghapus atribut: cat_copilottestrunid dari Entity: cat_CopilotTestRun karena atribut tersebut 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 baik Anda menginstal Kit Agen Copilot dari Marketplace maupun GitHub.

Tip

Kit Agen Copilot mencakup sebuah Wizard Penyiapan untuk mengonfigurasi referensi koneksi, variabel lingkungan, dan alur cloud. Pelajari selengkapnya di menggunakan Wizard Penyiapan.

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 Setup untuk mengonfigurasi SharePoint connection reference.

Untuk menggunakan fitur sinkronisasi SharePoint:

1. Instal Copilot Agent Kit, yang telah dijelaskan sebelumnya di artikel ini.
2. Masuk ke Power Apps.
3. Buka Solusi.
4. Pilih solusi default.
5. Pilih Referensi koneksi.
6. Temukan referensi koneksi Copilot Agent Kit - SharePoint dan buka untuk diedit.
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 Kit Agen Copilot, 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.

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

Anda dapat mengikuti langkah-langkah ini atau menggunakan Setup Wizard untuk mengonfigurasi referensi koneksi Agent Inventory.

Setelah referensi koneksi diatur, Anda mengonfigurasi cakupan lingkungan, tipe agen, grup lingkungan, opsi inventaris, dan jadwal sinkronisasi dari dalam Inventaris Agen. Pelajari selengkapnya di Mengonfigurasi Inventori Agen.

Untuk menggunakan fitur Inventori Agen:

1. Instal Copilot Agent Kit, yang telah 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 Agent Kit - Power Platform for Admins dan buka untuk diedit.
7. Pastikan semua bidang yang diperlukan terisi dan koneksi yang dipilih valid.
8. Pilih Simpan.
9. Temukan referensi koneksi Copilot Agent Kit - Dataverse dan buka untuk diedit.
10. Pastikan semua bidang yang diperlukan terisi dan koneksi yang dipilih valid.
11. Pilih Simpan.

Aktifkan alur

Note

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 Kit Agen Copilot, ikuti langkah-langkah ini atau gunakan Wizard Penyiapan.

1. Instal Copilot Agent Kit, yang telah dijelaskan sebelumnya di artikel ini.
2. Login ke Power Automate.
3. Pastikan lingkungan yang menggunakan Copilot Agent Kit telah dipilih.
4. Pilih Solusi.
5. Pilih Kit Agen Copilot.
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 Kit Agen Copilot. Hub Kepatuhan memerlukan Inventaris Agen.

Mengonfigurasi dasbor KPI Percakapan yang disematkan

Ikuti langkah-langkah ini 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 Agent Kit, yang telah dijelaskan sebelumnya di artikel ini.

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

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 Kit Agen Copilot.
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.

Pelajari tentang mengonfigurasi agen di Kit Agen Copilot, termasuk cara mengonfigurasi agen baru untuk KPI Percakapan.

Akses aplikasi Copilot Agent Kit

Untuk mengakses aplikasi Kit Agen Copilot:

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

Bagikan aplikasi Copilot Agent Kit

Setelah memverifikasi bahwa aplikasi berhasil diluncurkan, pemilik (atau administrator sistem yang menginstal Kit) perlu membagikan aplikasi Kit Agen Copilot dengan tim.

1. Masuk ke Power Apps.
2. Pilih Aplikasi.
3. Cari "Copilot Agent Kit" dan temukan yang bertipe Code (bukan aplikasi berdasarkan model).
4. Pilih tiga titik (...), lalu pilih Bagikan di samping nama aplikasi.
5. Cari dan tambahkan pengguna atau grup keamanan yang memerlukan akses.
6. Pilih Bagikan untuk mengonfirmasi.

Pelajari selengkapnya di Berbagi aplikasi kanvas dengan organisasi Anda.

Langkah selanjutnya

Mengonfigurasi pengguna dan tim