Mengaktifkan plugin untuk AI generatif (pratinjau)

[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]

Perwakilan layanan pelanggan Anda (perwakilan layanan atau perwakilan) mengandalkan data dan informasi dari berbagai sistem. Dengan plugin, Anda dapat berinteraksi langsung dengan data CRM non-Microsoft Anda. Interaksi langsung ini membantu mengurangi kebutuhan perwakilan layanan untuk beralih ke tab dan alat lain untuk melakukan pekerjaan mereka, serta meningkatkan waktu penyelesaian dan kepuasan pelanggan.

Prasyarat

• Dalam Copilot Studio, jika Anda ingin menggunakan plugin prompt di agen AI yang disematkan, buat plugin prompt.
• Dalam Copilot Studio, jika Anda ingin menggunakan plugin konektor di agen AI yang disematkan, buat plugin konektor kustom.

Mengonfigurasi plugin

Untuk menggunakan plugin prompt atau plugin konektor di agen AI yang disematkan setelah membuat plugin Copilot Studio, Anda harus mengaktifkan plugin di pusat admin. Bagian berikut menjelaskan cara mengaktifkan dan mengonfigurasi plugin.

Plugin prompt

1. Di pusat admin Layanan Copilot, pilih Produktivitas.
2. Pada halaman Produktivitas , pilih Kelola untuk Plugin untuk AI generatif (Pratinjau). Halaman Plugin untuk AI generatif (Pratinjau) muncul dengan semua permintaan plugin yang dihasilkan untuk lingkungan.
3. Pilih plugin prompt yang ingin Anda aktifkan, lalu pilih Aktifkan pada bilah perintah.
4. Pada Pilih jenis akses, pilih salah satu jenis berikut:
   • Semua agen yang memiliki Copilot: Agen yang mengaktifkan Copilot untuk mereka melalui profil pengalaman agen mereka.
   • Peran pengguna tertentu: Pilih peran dalam daftar.
5. Layar Tentukan input(opsional) muncul. Langkah ini bersifat opsional, dan memungkinkan Anda memberikan konteks yang dapat digunakan Copilot secara otomatis untuk menghasilkan jawaban. Jika Anda tidak menambahkan input, perwakilan layanan harus menentukan konteks secara manual saat mereka menjalankan plugin. Untuk mengonfigurasi input dan mempelajari selengkapnya tentang cara kerja fitur ini, lakukan langkah-langkah di bagian Tentukan input .
6. Pilih Berikutnya, lalu pada layar Data plugin, pilih Simpan data plugin ini. Data disimpan dalam database Anda Dataverse sebagai bagian dari interaksi perwakilan layanan Anda dengan Copilot sebagai transkrip obrolan. Pelajari selengkapnya di transkrip Copilot dan data interaksi.
7. Pilih Aktifkan plugin.
8. Pilih Terbitkan perubahan pada pesan pemberitahuan di bagian atas halaman, lalu pilih Konfirmasi pada dialog konfirmasi yang muncul. Diperlukan waktu hingga 15 menit agar perubahan dipublikasikan.

Plugin konektor khusus

1. Di peta situs pusat admin Layanan Copilot, pilih salah satu langkah berikut untuk mengakses plugin:

   • Pilih Plugin Produktivitas>untuk AI generatif (Pratinjau) di bawah Pengalaman agen.
   • Pilih Plugin Wawasan>untuk AI generatif (Pratinjau) di bawah Operasi.

2. Pilih Kelola.

3. Pada halaman Plugin untuk AI generatif (Pratinjau), pilih plugin konektor kustom, lalu pilih Aktifkan pada bilah perintah.

4. Pada dialog Pilih autentikasi pengguna, pilih tombol elipsis (...) di Menyiapkan tautan ke konektor, lalu pilih koneksi yang diperlukan. Tanda centang hijau menunjukkan bahwa sumber data berhasil terhubung.

5. Di Autentikasi pengguna, pilih salah satu opsi berikut:

   • Admin: Menggunakan autentikasi admin untuk memberikan akses data kepada perwakilan layanan.
   • Agen: Mengharuskan perwakilan layanan untuk memberikan autentikasi saat runtime. Opsi ini direkomendasikan jika data dibatasi atau sensitif.

6. Pada layar Kelola akses pengguna, pilih salah satu jenis akses berikut:

   • Semua agen yang memiliki Copilot: Perwakilan yang mengaktifkan Copilot untuk mereka melalui profil pengalaman agen mereka.
   • Peran pengguna tertentu: Pilih peran dalam daftar.

7. Pilih Selanjutnya.

8. Layar Tentukan input(opsional) muncul. Langkah ini bersifat opsional, dan memungkinkan Anda memberikan konteks yang dapat digunakan Copilot secara otomatis untuk menghasilkan jawaban. Jika Anda tidak menambahkan input, perwakilan layanan harus menentukan konteks secara manual saat mereka menjalankan plugin. Untuk mengonfigurasi input dan mempelajari selengkapnya tentang cara kerja fitur ini, lakukan langkah-langkah di bagian Tentukan input .

9. Di Tanggapan, pilih Jangan ringkas respons plugin jika Anda tidak ingin Copilot menafsirkan jawaban dan sebagai gantinya menyajikan seluruh respons yang tersedia di plugin.

10. Pilih Berikutnya dan pada layar Simpan data plugin di Dynamics 365 , lalu pilih Simpan data plugin ini dalam Dynamics 365 Copilot transkrip. Data disimpan dalam database Anda Dataverse sebagai bagian dari interaksi perwakilan layanan Anda dengan Copilot sebagai transkrip obrolan. Pelajari lebih lanjut di Transkrip dan data interaksi Copilot.

    Penting

    Terlepas dari apakah Anda memilih kotak centang, Copilot Studio menyimpan semua data plugin sebagai bagian dari transkrip percakapan perwakilan layanan. Microsoft tidak memiliki akses ke informasi ini.

11. Pilih Aktifkan plugin.

12. Pilih Terbitkan perubahan pada pesan pemberitahuan di bagian atas halaman, dan pilih Konfirmasi pada dialog konfirmasi yang muncul. Diperlukan waktu hingga 15 menit agar perubahan dipublikasikan.

Menentukan input untuk perintah

Saat menambahkan input di layar Tentukan input (opsional), Anda mengaktifkan perintah untuk menjadi sadar konteks dengan menggabungkan data yang relevan secara otomatis. Input ini memungkinkan Copilot untuk langsung mengakses bidang yang ditentukan tanpa mengharuskan perwakilan layanan pelanggan untuk memasukkan informasi yang sudah ada dalam sistem secara manual.

Jika Anda tidak mengonfigurasi input, perintah tetap statis dan tidak memiliki kemampuan untuk mengakses konteks. Plugin kemudian meminta perwakilan layanan untuk informasi tambahan yang harus mereka masukkan secara manual.

Misalnya, Anda memiliki prompt yang mengambil detail pesanan pelanggan berdasarkan nama pelanggan dan ID kasus. Anda dapat menambahkan nama pelanggan dan bidang id kasus sebagai input di Tentukan input (opsional) .

Saat perwakilan layanan membuka kasus dan memicu perintah, Copilot secara otomatis mengambil nama pelanggan dan ID kasus dari catatan kasus dan menggunakannya sebagai input ke perintah.

Untuk agen AI yang disematkan, Anda perlu membuat kunci Parameter. Kunci Parameter adalah pengidentifikasi unik yang digunakan dalam file JavaScript untuk mengambil konteks yang diperlukan dari CRM non-Microsoft.

Menyiapkan kunci parameter

Untuk menyiapkan parameter pada halaman Tentukan Input , lakukan langkah-langkah berikut:

1. Tentukan bidang Jenis rekaman danData. Anda perlu menentukan informasi ini untuk menghasilkan kunci Parameter.

2. Pilih Salin untuk menyalin nilai dalam kunci Parameter. Nilai kunci Parameter adalah variabel yang digunakan sistem dalam JavaScript untuk menyimpan nilai yang diteruskan sistem ke plugin sebagai input.

3. Pilih Simpan.

   

4. Pilih Berikutnya untuk pergi ke Menyimpan data plugin di Dynamics 365, lalu selesaikan langkah-langkah untuk menyelesaikan konfigurasi plugin.

5. Gunakan Kunci Parameter yang Anda salin pada langkah 2 dalam file JavaScript. Pelajari lebih lanjut di Meneruskan kunci parameter sebagai input ke plugin.

6. Konfigurasikan URL file JavaScript di CRM non-Microsoft untuk menyelesaikan penyiapan.

Teruskan kunci parameter sebagai input ke plugin

Buat file JavaScript yang menggunakan variabel Kunci Parameter yang Anda salin di langkah 2 Menyiapkan kunci parameter dan berlangganan Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData fungsi dalam Microsoft CCaaS Embed SDK. Tindakan berikut berlaku:

• Fungsi ini mendengarkan permintaan untuk mendapatkan data plugin.
• Ini mengambil data yang diperlukan dari sistem dan menetapkan nilai ke variabel kunci Parameter. Variabel kunci Parameter ini adalah nilai yang disalin di langkah 2 bagian Menyiapkan kunci parameter .
• Ini mengembalikan nilai variabel kunci Parameter ke plugin. Plugin menggunakan nilai ini sebagai input untuk prompt.

Misalnya, Anda membuat dua Kunci Parameter, incident____customerid_account____accountid dan customerid_account____accountid di halaman Tentukan Input (opsional). Berikut adalah contoh kode fungsi yang mengembalikan nilai 1 for incident____customerid_account____accountid dan 2 untuk customerid_account____accountid itu kemudian diteruskan sebagai input ke plugin.

Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData((request) => {
  return new Promise((resolve, reject) => {
    // 7 get plugin data
    const { objectData } = request;
    const pluginContext = objectData || {};
    const { entityId, entityName, parameters, parameterValues } = pluginContext;
    let responseData = null;
  console.log("External adapter plugin invoked...");
 
    if (entityName === "incident" && // sample entity name (case == incident)
      parameters.length > 0) {
      // copy parameter values
      const values = parameterValues;
      // override parameter values for 1P or 3P scenario
      parameters.forEach((param) => {
        if (param === "incident____customerid_account____accountid") {
          values[param] = "1";
        }
    
    if (param === "customerid_account____accountid") {
          values[param] = "2";
        }
      });
      // return the updated parameter values
      responseData = {
        entityId,
        entityName,
        parameters,
        parameterValues: values,
      };
    }
    const dataResponse = {
      objectId: request.objectId,
      objectType: request.objectType,
      data: responseData,
    };
  console.log("External adapter sending data from plugin:",responseData);
    resolve(dataResponse);
  });
});

Catatan

Pastikan Anda menghosting file ini di server web dan membuatnya dapat diakses publik untuk menghindari masalah autentikasi.

Mengonfigurasi URL di CRM non-Microsoft

Anda dapat menambahkan URL file JavaScript ke URL widget yang dapat disematkan Copilot yang Anda gunakan untuk menyematkan widget Copilot di CRM non-Microsoft Anda dengan menambahkan "&copilotExtensionUrl=<URL to customer hosted .js file>" ke URL sematan yang ada.

Misalnya, jika URL untuk file https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js JavaScript Anda, maka URL yang perlu Anda tambahkan di CRM non-Microsoft adalah sebagai berikut:

https://copilotforservice-prod.azureedge.net/widget/index.html?dynamicsUrl=https://X<your_org_URL>&copilotExtensionUrl=https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js

Kelola plugin

Gunakan opsi pada menu perintah untuk mengelola plugin. Tombol edit memungkinkan Anda memperbarui pengaturan plugin dan menerbitkan perubahan. Anda tidak dapat mengubah pengaturan apa pun saat publikasi sedang berlangsung.

Pertimbangan

• Anda hanya dapat menambahkan satu tindakan plugin.
• Jika Anda memperbarui plugin, sebaiknya simpan dan publikasikan ulang plugin Copilot Studio. Anda kemudian dapat memilih Refresh pada Plugin untuk AI generatif (Pratinjau) di pusat admin Copilot Service untuk melihat perubahan.