Menggunakan variabel global

Note

Artikel ini menjelaskan fitur yang digunakan pada agen atau alur agen yang didukung oleh harness standar.

Variabel menyimpan tanggapan pelanggan terhadap pertanyaan dari agen Anda. Misalnya, Anda dapat menyimpan nama pelanggan dalam variabel yang disebut UserName. Agen kemudian dapat menangani pelanggan berdasarkan nama saat percakapan berlanjut.

Secara default, Anda hanya dapat menggunakan nilai variabel dalam topik tempat Anda membuat variabel. Namun, Anda mungkin ingin menggunakan kembali nilai di beberapa topik. Misalnya, topik selamat datang meminta nama pelanggan dan alamat email. Dalam topik Pemesanan Janji Temu, Anda ingin agen mengingat apa yang sudah disediakan pelanggan dan tidak bertanya lagi.

Anda dapat menggunakan kembali variabel dengan meneruskan variabel dari satu topik ke topik lain. Anda juga dapat membuat variabel global dalam cakupan. Artikel ini membahas variabel global. Mereka disebut variabel global karena tersedia di semua topik di seluruh agen. Agen Anda juga dapat mengaturnya dari sumber eksternal.

Variabel global berlaku selama sesi pengguna tunggal. Anda menentukan variabel mana yang bersifat variabel global untuk membedakannya dari variabel tingkat topik.

Buat variabel global

Anda membuat variabel global dengan mengubah cakupan variabel topik.

Note

Nama variabel global harus unik di semua topik.

Aplikasi web

1. Buat variabel atau gunakan panel Variabel untuk membuka variabel yang ada.

2. Pada panel properti variabel, pilih Global (setiap topik dapat mengakses). Nama variabel mendapatkan awalan Global. untuk membedakannya dari variabel tingkat topik. Misalnya, variabel UserName menjadi Global.UserName.

3. Simpan topik.

Rencana tim

1. Pilih variabel yang Anda inginkan.

2. Di panel properti variabel, dalam penggunaan, pilih Bot (setiap topik dapat mengakses).

3. Nama variabel mendapatkan awalan bot. untuk membedakannya dari variabel tingkat topik. Misalnya, variabel UserEmail menjadi bot.UserEmail.

Gunakan variabel global

Aplikasi web

Saat Anda membuat pesan dalam simpul Pesan atau node Pertanyaan , pilih ikon {x} untuk melihat variabel yang dapat diakses topik. Anda juga dapat menggunakan variabel global dalam simpul Alat yang memanggil perintah atau alur kerja. Variabel global muncul pada tab Kustom bersama dengan variabel topik apa pun. Variabel tercantum dalam urutan abjad.

Rencana tim

Saat Anda membuat pesan dalam simpul Pesan atau node Pertanyaan , pilih ikon {x} untuk melihat variabel yang dapat diakses topik. Variabel tercantum dalam urutan abjad, dan semua variabel global muncul bersamaan karena semuanya dimulai dengan bot..

Bila Anda menggunakan node kondisi, node alur tindakan, atau node keterampilan, Anda juga akan melihat variabel global yang tersedia di sana.

Menemukan semua topik yang menggunakan variabel global

Anda dapat menemukan di mana variabel global didefinisikan dan topik lain mana yang menggunakannya. Fitur ini berguna jika Anda mengerjakan agen baru atau jika Anda memiliki beberapa variabel dan percabangan topik yang kompleks.

Aplikasi web

1. Pilih variabel global yang Anda inginkan pada kanvas penulisan atau di panel Variabel .

2. Pada panel Properti variabel, di bagian Referensi, pilih Lihat semua referensi.

3. Beralih ke tab Lainnya, dan pilih topik apa pun di mana variabel digunakan untuk langsung ke topik dan node tersebut.

Rencana tim

Pilih variabel yang Anda inginkan pada kanvas penulisan. Panel Properti variabel muncul.

• Untuk langsung masuk ke simpul tempat Anda membuat variabel global, pilih Buka sumber.

• Untuk membuka topik yang menggunakan variabel ini, pilih topik yang diinginkan di bagian Digunakan oleh.

Menghapus variabel global

Jika Anda menghapus variabel global yang digunakan dalam topik lain, referensi ke variabel tersebut dalam topik ditampilkan sebagai Unknown. Anda mendapatkan peringatan tentang menghapus variabel global sebelum Anda dapat mengonfirmasi operasi.

Node yang berisi referensi ke variabel global yang dihapus menunjukkan bahwa mereka berisi variabel yang tidak diketahui.

Topik dengan node yang berisi referensi ke variabel global yang dihapus mungkin berhenti berfungsi. Pastikan Anda menghapus atau memperbaiki semua topik yang menggunakan variabel yang kini telah dihapus sebelum mempublikasikan agen Anda.

Siklus hidup variabel global

Aplikasi web

Secara default, nilai variabel global bertahan hingga sesi berakhir. Simpul Kosongkan nilai variabel mengatur ulang nilai variabel global. Topik sistem Atur Ulang Percakapan menggunakan node ini. Saat pengalihan memicu topik tersebut (atau saat pengguna memasukkan frasa seperti "Mulai dari awal"), semua variabel global akan diatur ulang.

Rencana tim

Anda dapat mengakses variabel global dari topik apa pun, dan nilainya bertahan sepanjang sesi.

Nilai hanya dibersihkan ketika pengguna agen diarahkan ke Topik Mulai lagi, atau ketika pengguna memicu topik ini secara langsung (misalnya, dengan mengetik "Mulai lagi"). Dalam hal ini, semua variabel global diatur ulang dan tidak memiliki nilai.

Inisialisasi variabel global

Jika variabel global dipicu sebelum diinisialisasi (atau "terisi"), agen akan secara otomatis memicu bagian topik dengan variabel global yang didefinisikan pertama kali, bahkan saat berada di topik yang berbeda, sebelum kembali ke topik asli. Perilaku ini memungkinkan agen untuk mengisi semua variabel tanpa mengganggu percakapan.

Misalnya, pelanggan memulai percakapan pada topik "pemesanan janji temu", yakni variabel global bot.UserName akan digunakan. Namun, variabel bot.UserName mula-mula didefinisikan di topik "selamat datang".

Bila percakapan sampai ke titik dalam topik "Pemesanan janji temu" dengan bot.UserName dirujuk, maka agen akan mulus berporos ke node pertanyaan dengan bot.UserName pertama kali ditentukan.

Setelah pelanggan menjawab pertanyaan, agen akan melanjutkan topik "pemesanan janji temu".

Perilaku variabel global saat menerapkan tindakan melalui alur atau keterampilan Power Automate

Terkadang, Anda dapat menggunakan alur atau keterampilan untuk menginisialisasi atau mengisi variabel.

Namun saat pengguna berinteraksi dengan agen, variabel dapat diisi di titik sebelumnya dalam percakapan, atau Anda mungkin telah menetapkan variabel secara eksternal.

Dalam situasi ini, alur atau keterampilan akan tetap berjalan dan mengisi variabel, menimpa apa pun yang sebelumnya disimpan dalam variabel.

Mengatur variabel global dari sumber eksternal

Aplikasi web

Untuk memastikan agen memulai percakapan dengan beberapa konteks, gunakan variabel global dan tetapkan nilainya dari sumber eksternal. Misalkan situs Anda mengharuskan pengguna untuk masuk. Jika Anda menyimpan nama pengguna dalam variabel global dan meneruskannya ke agen, agen dapat menyapa pelanggan dengan nama sebelum mereka mulai mengetikkan pertanyaan pertama mereka. Contoh skenario lain adalah meneruskan konteks dari Dynamics 365 Customer Service ke agen sehingga dapat memulai percakapan dengan pengetahuan tentang apa yang ingin dicapai pelanggan.

Untuk mencegah latensi yang tidak diinginkan, tentukan berapa lama agen Anda dapat menunggu nilai. Anda juga dapat mengatur nilai default untuk digunakan saat sumber eksternal gagal merespons tepat waktu.

Note

Agen yang diterbitkan ke saluran Dynamics 365 Contact Center untuk kasus penggunaan IVR tidak mendukung nilai batas waktu yang dikonfigurasi untuk variabel global yang ditetapkan oleh sumber eksternal.

1. Buat topik khusus untuk menyimpan konfigurasi untuk semua variabel yang dimaksudkan untuk diatur dari sumber eksternal. Anda dapat menamai topik ini "Tetapkan variabel konteks" misalnya. Topik ini tidak melayani tujuan lain, jadi tidak perlu menetapkan frasa pemicu.

2. Tambahkan node Tetapkan nilai variabel ke topik khusus Anda.

3. Di bawah Atur variabel, buka pemilih variabel, lalu pilih Buat variabel baru.

4. Pilih nama default variabel baru. Panel Properti variabel muncul.

5. Ganti nama default dengan nama yang persis sama dengan nama variabel yang diteruskan dari sistem eksternal.

6. Di Penggunaan, pilih Global (topik apa pun dapat mengakses), dan sumber Eksternal dapat mengatur nilai yang ditetapkan.

7. Di bawah Referensi, pilih tiga titik (⋮) di sudut kanan atas, dan pilih Dapatkan nilai dari simpul ini jika kosong.

8. (Opsional) Atur penundaan batas waktu, dalam milidetik. Nilai ini menentukan berapa lama agen Anda dapat menunggu variabel diatur oleh sumber eksternal sebelum waktu habis dan melanjutkan dengan nilai default yang Anda tetapkan di node Tetapkan nilai variabel. Pengaturan ini relevan dalam skenario di mana variabel bergantung pada proses yang berjalan lama atau asinkron, tetapi agen Anda harus menghormati latensi maksimum untuk memastikan pengalaman pengguna yang baik.

   Untuk variabel yang berasal dari Multisaluran untuk Layanan Pelanggan, gunakan nilai 10 detik (10.000 ms) sebagai waktu tunggu maksimum.

9. Dalam simpul Atur nilai variabel , masukkan nilai default yang akan digunakan jika batas waktu tercapai. Pada runtime, agen Anda mengharapkan nilai dengan jenis data yang sama. Jika Anda ingin nilai default ini menjadi string kosong, gunakan Text("") sebagai rumus.

   

10. Untuk nilai lain yang Anda harapkan berasal dari sistem eksternal, tambahkan lebih banyak node Atur nilai variabel ke topik khusus Anda, dan konfigurasikan variabel global yang diperlukan dengan cara yang sama.

Saat Anda mengonfigurasi agen dengan cara ini, agen tersebut siap untuk diuji. Saat agen dipanggil, alih-alih menunggu tanpa batas waktu hingga semua variabel diisi, agen Anda dapat segera mulai mengirim pesan apa pun yang tidak bergantung pada variabel yang diteruskan. Saat agen Anda mencoba mengakses variabel yang sedang diatur secara eksternal, agen akan menunggu hingga nilainya tersedia atau batas waktu tercapai. Pelajari selengkapnya di Mengoptimalkan agen untuk meminimalkan latensi.

Penting

Selama alur normal percakapan, jika agen Anda menetapkan variabel yang seharusnya datang dari nilai eksternal, nilai yang ditetapkan dari dalam agen Anda akan berlaku. Setiap nilai yang diteruskan dalam konteks diabaikan. Aturan ini mencegah agen Anda menimpa nilai yang sengaja ditetapkan dalam topik.

Rencana tim

Anda dapat mengatur variabel global yang akan diinisialisasi dari sumber eksternal. Tindakan ini memungkinkan agen memulai percakapan dengan konteks tertentu.

Misalnya, seorang pelanggan membuka chat dengan agen di situs web Anda, dan situs tersebut sudah mengetahui nama pelanggan. Anda mengizinkan agen mengetahui nama pengguna sebelum memulai percakapan, dan agen dapat memiliki percakapan yang lebih cerdas dengan pelanggan tanpa harus meminta nama mereka lagi.

1. Pilih variabel global yang Anda inginkan.

2. Di panel Properti variabel, pilih Sumber eksternal dapat mengatur nilai.

Mengatur variabel global dalam agen tertanam

Aplikasi web

Jika Anda menyematkan agen di halaman web sederhana, Anda dapat menambahkan variabel dan definisinya ke URL agen. Atau, jika Anda menginginkan sedikit lebih banyak kontrol, Anda dapat menggunakan blok kode <script> untuk memanggil dan menggunakan variabel secara terprogram.

Nama variabel dalam string kueri URL harus sesuai dengan nama variabel global, tanpa awalan Global.. Misalnya, untuk variabel global Global.UserName, gunakan hanya UserName dalam kueri.

Contoh berikut menggunakan deklarasi dasar untuk variabel. Dalam skenario produksi, Anda mungkin meneruskan variabel lain yang sudah menyimpan nama pengguna (misalnya, jika Anda memiliki nama pengguna dari skrip masuk) sebagai parameter kueri atau definisi variabel.

Tambahkan variabel dan definisinya ke URL agen sebagai parameter string kueri dalam format botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Contohnya:

• Anda memiliki variabel global bernama Global.UserName.
• URL agen Anda adalah https://web.powerva.microsoft.com/webchat/bots/12345.
• Saat memulai percakapan dengan agen di situs web Anda, untuk menyertakan nama pengguna, lampirkan string kueri UserName= sebagai berikut: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

Nama parameter tidak peka huruf besar/kecil: username=Ana juga berfungsi dalam contoh ini.

Rencana tim

Anda dapat menambahkan variabel dan definisinya jika Anda hanya menyematkan agen Anda di halaman web sederhana. Atau, Anda dapat menggunakan <script> blok kode untuk memanggil dan menggunakan variabel secara terprogram.

Note

Nama variabel dalam string kueri harus cocok dengan nama variabel global, tanpa awalan bot. . Misalnya, variabel global bot.UserEmail harus muncul sebagai UserEmail=.

Contoh berikut menggunakan deklarasi dasar untuk variabel. Dalam skenario produksi, Anda mungkin meneruskan variabel lain yang sudah menyimpan nama pengguna (misalnya, jika Anda memiliki nama pengguna dari skrip masuk) sebagai parameter kueri atau definisi variabel.

1. Tambahkan variabel dan definisinya ke URL agen sebagai parameter string kueri (dalam format botURL?variableName1=variableDefinition1&variableName2=variableDefinition2), misalnya:

   • Anda memiliki variabel global bernama bot.UserEmail.
   • URL agen Anda adalah https://web.powerva.microsoft.com/webchat/bots/12345.
   • Untuk meneruskan nama pengguna saat memulai percakapan dengan agen di situs web, tambahkan string kueri UserEmail= sebagai berikut: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. Nama parameter tidak peka huruf besar/kecil: useremail=Ana@contoso.com juga berfungsi dalam contoh ini.

Tambahkan variabel global ke kanvas kustom

Anda juga dapat menambahkan variabel ke kanvas kustom.

Aplikasi web

1. Di Bagian <script> pada halaman tempat Anda memiliki agen, tentukan variabel sebagai berikut, dengan mengganti variableName1 untuk nama variabel tanpa awalan Global. dan variableDefinition1 untuk definisi. Pisahkan beberapa variabel dengan koma (,).

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. Di bagian <script> Anda, Panggil store saat Anda menanamkan agen Anda, seperti dalam contoh berikut di mana store disebut tepat sebelum tempat styleOptions disebut (Anda harus mengganti BOT_ID dengan ID agen Anda):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

Rencana tim

1. Di Bagian <script> pada halaman tempat Anda memiliki agen, tentukan variabel sebagai berikut, dengan mengganti variableName1 untuk nama variabel tanpa awalan bot. dan variableDefinition1 untuk definisi. Pisahkan beberapa variabel dengan koma ,.

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. Dalam bagian <script> Anda, Panggil store saat Anda menanamkan agen Anda, seperti dalam contoh berikut di mana store disebut tepat sebelum tempat styleOptions disebut (Anda harus mengganti BOT_ID dengan ID Anda):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

Variabel global terkait autentikasi

Tergantung pada konfigurasi autentikasi agen, Anda akan memiliki seperangkat variabel global yang terkait dengan penyedia otentikasi yang dipilih. Untuk rincian tentang kumpulan variabel yang tersedia dan cara penggunaannya, lihat Tambahkan autentikasi pengguna ke topik.

---

Konten terkait

• Menggunakan variabel
• Menyesuaikan tampilan dan nuansa agensi