Menggunakan variabel

Menggunakan variabel untuk menyimpan respons pelanggan sehingga Anda dapat menggunakan kembali respons mereka nanti dalam percakapan.

Anda juga dapat menggunakan variabel untuk membuat ekspresi logis yang secara dinamis mengarahkan pelanggan ke jalur percakapan yang berbeda. Misalnya, simpan nama pelanggan dalam variabel yang disebut customerName, dan agen dapat memanggil pelanggan dengan nama saat percakapan berlanjut.

Anda dapat meneruskan variabel ke, dan mengembalikannya dari, topik lain dan alur Power Automate.

Membuat variabel

Aplikasi web

Setiap node yang mengembalikan output, seperti node Pertanyaan, secara otomatis membuat variabel output dengan jenis yang sesuai.

Tip

Ganti nama node agar lebih mudah diidentifikasi. Pilih kolom nama node untuk memperbarui nama secara langsung, atau pilih tiga titik (…) pada node dan pilih Ganti Nama dari menu. Anda juga dapat mengganti nama node di editor kode.

Tidak mungkin mengganti nama node Pemicu dan node Menuju langkah.

Nama node dapat memiliki panjang hingga 500 karakter.

Klasik

1. Buka halaman Topik untuk chatbot klasik Anda dan buka topik yang diinginkan.

2. Pilih ikon Tambahkan node di bawah node setelah Anda menambahkan node pertanyaan. Selanjutnya, pilih Ajukan Pertanyaan. Copilot Studio secara otomatis membuat variabel untuk menyimpan respons pengguna.

   

Pilih entitas untuk digunakan

Aplikasi web

Node pertanyaan menggunakan opsi pilihan ganda secara default. Untuk menggunakan entitas bawaan atau kustom yang berbeda, pilih kotak Identifikasi, lalu pilih jenis informasi yang Anda inginkan.

Klasik

Node pertanyaan menggunakan opsi pilihan ganda secara default. Untuk menggunakan entitas bawaan atau kustom yang berbeda, pilih kotak Identifikasi, lalu pilih jenis informasi yang Anda inginkan.

Ubah Nama Variabel

Aplikasi web

Supaya agen Anda lebih mudah dipelihara, gantilah nama default setiap variabel dengan nama yang bermakna.

1. Pilih variabel. Panel Properti variabel muncul.

2. Di bawah Nama variabel, masukkan nama yang Anda inginkan untuk variabel.

Klasik

Variabel yang dibuat secara otomatis dilengkapi dengan nama default. Untuk mengganti nama variabel, pilih namanya, masukkan nama yang diinginkan di panel Properti variabel, dan simpan perubahan Anda.

Atur Variabel

Biasanya, Anda menggunakan node Pertanyaan untuk menyimpan input pengguna dalam variabel. Namun, Anda mungkin ingin mengatur nilai variabel sendiri. Dalam kasus tersebut, gunakan node Tetapkan nilai variabel.

1. Pilih ikon Tambahkan node di bawah node tempat Anda ingin menambahkan node Atur nilai variabel.

2. Pilih Manajemen variabel>Tetapkan nilai variabel. Sebuah node Atur nilai variabel muncul di kanvas.

3. Pilih kotak di bawah Tetapkan Variabel. Panel Pilih variabel muncul.

   • Jika variabel yang ingin Anda atur sudah ada, pilih variabel tersebut.

   • Atau, pilih Buat baru. Langkah ini membuat variabel baru. Jenisnya tidak diketahui sampai Anda menetapkan nilai padanya.

     

4. Untuk Pada nilai, tetapkan nilai menggunakan salah satu opsi berikut:

   • Ketikkan nilai harfiah.

   • Pilih variabel yang ada dengan jenis yang sama.

   • Gunakan rumus Power Fx. Rumus Power Fx berguna untuk jenis yang lebih kompleks di mana nilai harfiah tidak dapat digunakan, seperti jenis Tabel dan Rekaman.

Menggunakan variabel dalam node Tindakan

Saat Anda menggunakan variabel di node Tindakan, jika jenis dasarnya cocok dengan tipe parameter yang ditentukan untuk alur, atau untuk keterampilan Bot Framework, Anda dapat memasukkannya ke parameter tersebut. Output dari node Tindakan menghasilkan variabel baru.

Pelajari selengkapnya di:

• Memanggil alur agen dari agen
• Menggunakan alur agen dengan agen Anda

Gunakan nilai harfiah untuk input variabel

Di node tempat Anda dapat mengatur nilai untuk parameter input, Anda dapat memasukkan nilai harfiah alih-alih memilih variabel lain sebagai nilai.

Node mencoba menafsirkan nilai harfiah sebagai string, angka, atau Boolean. Misalnya, 123 ditafsirkan sebagai angka. Jika Anda ingin node menginterpretasikan nilai tersebut sebagai string, bungkus nilai tersebut dengan tanda kutip ganda, seperti ini: "123".

Untuk beberapa skenario, seperti skenario yang menggunakan tipe kompleks, Anda mungkin perlu menggunakan rumus Power Fx untuk menetapkan jenis tertentu.

Menggunakan variabel lingkungan untuk rahasia Azure Key Vault

Variabel lingkungan dapat mereferensikan rahasia di Key Vault. Variabel lingkungan rahasia adalah kasus khusus variabel lingkungan dengan pertimbangan unik.

Untuk membuat variabel lingkungan rahasia di Power Apps, Anda harus mengonfigurasi Key Vault.

Untuk mengotorisasi Copilot Studio membaca Key Vault ini, selesaikan tindakan berikut:

1. Tetapkan peran Pengguna Rahasia Key Vault ke aplikasi Layanan Microsoft Copilot Studio.

2. Untuk mengotorisasi semua agen dari lingkungan untuk mengakses rahasia, buat tag AllowedEnvironments pada rahasia dan tambahkan ID lingkungan yang diizinkan yang dipisahkan dengan koma.

3. Untuk mengotorisasi hanya agen tertentu dari lingkungan untuk menggunakan brankas ini, buat tag AllowedAgents dan masukkan pengidentifikasi agen dalam format {envId}/{schemaName}. Untuk beberapa nilai, pisahkan nilai dengan koma.

   Jika Anda mencapai jumlah maksimum karakter tetapi masih perlu menambahkan lebih banyak agen, tambahkan tag lain dengan nama deskriptif tetapi unik (misalnya: AllowedAgents2).

Runtime Dialog menyimpan nilai rahasia tersebut dalam cache selama lima menit. Meng-cache pembacaan yang tidak berhasil selama 30 detik.

Peringatan

Dengan menambahkan rahasia dalam agen, Anda mungkin mengekspos nilai rahasia ini. Siapa pun yang dapat mengedit agen di lingkungan dapat menambahkan node Pesan dan mengembalikan nilai variabel lingkungan rahasia dalam pesan.

Panel variabel

Aplikasi web

Pada panel Variabel, Anda dapat melihat semua variabel yang tersedia untuk topik, terlepas dari node mana yang didefinisikan atau digunakan.

Untuk membuka panel Variabel, pilih Variabel pada bilah menu topik.

Untuk setiap variabel topik, Anda dapat memilih apakah variabel dapat menerima nilainya dari topik lain, mengembalikan nilainya ke topik lain, atau keduanya. Anda juga dapat memilih variabel untuk mengedit propertinya di panel Properti variabel.

Klasik

Pada panel Variabel, Anda dapat melihat semua variabel yang tersedia untuk topik, terlepas dari node mana yang didefinisikan atau digunakan. Untuk setiap variabel, Anda dapat memilih apakah variabel dapat menerima nilainya dari topik lain, mengembalikan nilainya ke topik lain, atau keduanya. Anda juga dapat memilih variabel untuk mengedit propertinya di panel Properti variabel.

1. Pada bilah menu topik, pilih Variabel.

   

2. Untuk setiap variabel dalam topik, pilih apakah Anda ingin nilai diteruskan, diterima, atau keduanya di antara topik.

   

Panel properti Variabel

Di panel Properti variabel, Anda dapat mengganti nama variabel, melihat di mana agen Anda menggunakannya, atau mengonversinya menjadi variabel global. Anda tidak dapat mengonversi variabel global kembali ke variabel topik. Anda juga dapat memilih apakah variabel topik dapat menerima nilai dari atau meneruskan nilainya ke topik lain.

Untuk membuka panel Properti variabel untuk variabel, pilih variabel yang diinginkan di panel Variabel. Anda juga dapat membuka panel Properti variabel dari node mana pun yang menggunakan variabel dengan memilih variabel yang diinginkan.

Meneruskan variabel antar topik

Saat Anda mengalihkan satu topik ke topik lain, Anda dapat meneruskan nilai variabel dari topik asal ke topik tujuan dan juga mengembalikan nilai dari topik tujuan ke topik asal. Meneruskan variabel antar topik sangat berguna ketika topik sebelumnya telah mengumpulkan informasi yang dibutuhkan topik selanjutnya. Pengguna Anda tentu menghargai jika mereka tidak perlu menjawab pertanyaan yang sama lebih dari sekali.

Terima nilai dari topik lain

Saat topik mendefinisikan variabel (misalnya, di node Pertanyaan), agen mengajukan pertanyaan kepada pengguna untuk mengisi nilai variabel. Jika agen sudah memperoleh nilai dalam topik sebelumnya, tidak ada alasan untuk mengajukan pertanyaan lagi. Dalam kasus seperti itu, Anda dapat mengatur variabel ke Terima nilai dari topik lain. Ketika topik lain mengalihkan ke topik ini, topik tersebut dapat meneruskan nilai variabel atau nilai harfiah ke variabel ini, dan melewati pertanyaan. Pengalaman bagi pengguna yang berbicara dengan agen berlangsung mulus.

Aplikasi web

Contoh ini menggunakan dua topik, Salam dan Bicara dengan Pelanggan. Kedua topik tersebut meminta nama pelanggan. Namun, jika topik Salam berjalan lebih dulu, topik Bicara dengan Pelanggan akan melewati pertanyaannya. Sebagai gantinya, ini menggunakan nilai variabel yang diteruskan dari topik Salam.

Berikut adalah alur topik Bicara dengan Pelanggan:

Seperti yang ditunjukkan di panel pengujian, jika topik ini dipicu terlebih dahulu, topik ini menanyakan pada pengguna, "Boleh saya tahu nama Anda?" Ini menyimpan nilai dalam variabel string yang disebut customerName. Variabel customerName juga diatur untuk mendapatkan nilainya dari topik lain. Topik diakhiri dengan pesan, "Saya harap Anda mengalami hari yang indah, customerName!"

Berikut adalah alur topik Salam:

Seperti yang ditunjukkan di panel pengujian, jika topik ini dipicu terlebih dahulu, topik ini menanyakan pada pengguna, "Siapa nama Anda?" Ini menyimpan nilai dalam variabel string yang disebut customerName. Topik mengirimkan pesan, "Senang bertemu dengan Anda, customerName!" Kemudian dialihkan ke topik Bicara dengan Pelanggan , yang mengirimkan pesan, "Saya harap Anda mengalami hari yang menyenangkan, customerName!" Namun, perhatikan bahwa topik Bicara dengan Pelanggan melewati menanyakan nama pengguna lagi. Sebagai gantinya, hal ini menggunakan nilai variabel customerName yang diteruskan dari topik Salam.

Terakhir, berikut ini adalah percakapan kedua lagi, kali ini dari perspektif topik Bicara dengan Pelanggan:

Ikuti langkah-langkah untuk menyiapkan topik untuk menerima nilai dari topik lain. Contoh skenario ini menggunakan topik Salam yang telah ditentukan sebelumnya sebagai topik sumber, dan topik baru Bicara dengan Pelanggan sebagai topik tujuan, tetapi langkah yang sama berlaku untuk topik apa pun yang harus menggunakan nilai dari topik sebelumnya jika memungkinkan.

Menyiapkan topik tujuan

Topik tujuan menerima nilai dari topik lain. Dalam contoh ini, ini adalah Bicara dengan Pelanggan.

1. Buat topik baru dan beri nama "Bicara dengan Pelanggan".

2. Tambahkan frasa pemicu seperti "ayo bicara dengan saya", "bicaralah dengan saya", dan "mengobrollah dengan saya."

3. Tambahkan node Pertanyaan dan masukkan "Boleh saya tahu nama Anda?" untuk pesan tersebut.

4. Di bawah Identifikasi, pilih entitas bawaan Nama orang.

5. Pilih nama variabel. Panel Properti variabel terbuka.

6. Ganti nama default dengan customerName, lalu pilih Terima nilai dari topik lain.

   

7. Tambahkan node Pesan.

8. Di kotak pesan, masukkan "Saya harap Anda mengalami hari yang indah, ".

9. Pilih ikon Sisipkan variabel ({x}), lalu pilih customerName.

10. Pilih spasi setelah variabel dan masukkan tanda seru (!).

11. Simpan topik.

Konfigurasi topik sumber

Topik sumber adalah topik yang mengalihkan ke topik lain. Ini memberikan nilai dan meneruskannya ke topik tujuan. Dalam contoh ini, ini adalah Salam.

1. Buka topik Salam dan hapus node default, kecuali node Pemicu.

2. Tambahkan node Pertanyaan dan masukkan "Siapa nama Anda?" untuk pesan tersebut.

3. Di bawah Identifikasi, pilih entitas bawaan Nama orang.

4. Ganti nama default dengan customerNameFromGreeting.

5. Tambahkan node Pesan.

6. Di kotak pesan, masukkan "Senang bertemu dengan Anda".

7. Pilih ikon Sisipkan variabel ({x}), lalu pilih customerNameFromGreeting.

8. Pilih spasi setelah variabel dan masukkan tanda seru (!).

9. Tambahkan node Pengalihan , dan pilih topik tujuan Bicara dengan Pelanggan.

10. Pilih Tambahkan input, lalu pilih variabel dari topik tujuan yang ingin Anda teruskan nilainya.

    

11. Pilih ikon >, lalu pilih variabel yang nilainya ingin Anda teruskan, customerNameFromGreeting, dalam contoh ini.

    Node Pengalihan akan terlihat seperti ini:

    

12. Simpan topik.

Klasik

Untuk menerima nilai dari topik lain, atur properti variabel:

1. Di node Pertanyaan, pilih variabel yang ingin Anda terima nilainya dari topik lain.

2. Di panel Properti variabel, di bawah Topik (cakupan terbatas) pilih Terima nilai dari topik lain.

   

   Catatan

   Anda tidak dapat meneruskan variabel berdasarkan entitas berjenis Tanggal dan waktu, Durasi, atau Opsi pilihan ganda, atau variabel berdasarkan entitas kustom antar topik.

3. Simpan topik.

4. Buka topik yang ingin Anda alihkan. Ikuti langkah-langkah di Mengalihkan ke topik lain untuk mengalihkan ke topik yang benar.

5. Pilih Tambahkan input untuk topik tujuan.

   

6. Pilih variabel dalam topik yang dialihkan yang ingin Anda teruskan variabelnya.

   

7. Di bawah Masukkan atau pilih nilai, pilih variabel dalam topik saat ini yang ingin Anda teruskan ke topik yang dialihkan.

   

   Variabel ditampilkan di node yang dialihkan.

   

Kembalikan nilai ke topik awal

Dalam agen, topik mengumpulkan potongan informasi tertentu. Beberapa topik lain dapat memanggilnya dan mengharapkan informasi tersebut dikembalikan sebagai variabel. Variabel tersebut menjadi bagian dari topik asalnya dan dapat digunakan seperti variabel lainnya. Dengan membuat informasi yang diperoleh agen tersedia di berbagai topik, pendekatan ini mengurangi kebutuhan akan variabel global.

Aplikasi web

Mari kita lanjutkan dengan contoh dari bagian sebelumnya. Anda mengajukan pertanyaan baru di topik Bicara dengan Pelanggan, lalu mengembalikan jawaban ke topik Salam.

Menyiapkan topik sumber untuk variabel yang dihasilkan

Saat Anda mengembalikan variabel ke topik, topik sumber adalah topik yang memberikan nilai untuk diteruskan kembali ke topik asli. Dalam contoh ini, topik sumbernya adalah Bicara dengan Pelanggan.

1. Buka topik sumber.

2. Tambahkan node Pertanyaan dan masukkan "di Kota mana Anda tinggal?" untuk pesan tersebut.

3. Di bawah Identifikasi, pilih entitas bawaan Kota.

4. Pilih variabel untuk membuka panel Properti variabel. Beri nama customerCity, lalu pilih Kembalikan nilai ke topik asli.

   

5. Tambahkan node Pesan.

6. Pilih ikon Sisipkan variabel ({x}), lalu pilih customerCity.

7. Setelah variabel di kotak pesan, masukkan " pasti indah sepanjang tahun ini!".

8. Simpan topik.

Menyiapkan topik tujuan untuk variabel yang dihasilkan

Saat Anda mengembalikan variabel ke topik, topik tujuan menerima nilai dari topik saat ini. Dalam contoh berikut, topik tujuan adalah Salam.

1. Buka topik tujuan.

2. Variabel yang Anda pilih dalam topik sumber muncul di node Pengalihan sebagai variabel output.

   

3. Simpan topik.

Klasik

Untuk mengembalikan variabel ke topik asli, atur properti variabel:

1. Pada node Pertanyaan, pilih variabel yang ingin Anda kembalikan ke topik lain.

2. Di panel Properti variabel, di bawah Topik (cakupan terbatas) pilih Kembalikan nilai dari topik asli.

   

   Catatan

   Anda tidak dapat meneruskan variabel berdasarkan entitas berjenis Tanggal dan waktu, Durasi, atau Opsi pilihan ganda, atau variabel berdasarkan entitas kustom antar topik.

3. Simpan topik.

4. Buka topik yang ingin Anda alihkan. Ikuti langkah-langkah di Mengalihkan ke topik lain untuk mengalihkan ke topik yang benar.

   Variabel yang Anda kembalikan ke topik muncul dalam topik yang dialihkan. Gunakan variabel yang ditampilkan dalam topik Anda.

   

Nilai penguraian

Node nilai Urai mengonversi nilai dari satu jenis ke jenis lainnya. Salah satu contoh penggunaan umum untuk node Urai nilai adalah mengonversi JSON mentah. Misalnya, sebuah agen memanggil alur yang memanggil API. API mengembalikan hasil. Anda memerlukan cara untuk mengurai hasil ini dan mengembalikan satu atau lebih variabel primitif. Dengan menggunakan node Urai nilai, Anda dapat mengirim seluruh hasil API sebagai string, seperti berikut:

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

Node Nilai parse mengonversi variabel string menjadi variabel bertipe Rekaman. Editor Power Fx menyediakan pelengkapan kode IntelliSense dan saran untuk tipe ini.

Selain mengurai string JSON, kegunaan utama node Urai nilai adalah mengurai objek tidak bertipe pada saat runtime. Kasus penggunaan yang paling umum adalah ketika Anda menerima peristiwa dan perlu mengurai nilai peristiwa. Anda mungkin ingin mengurai properti System.Activity.ChannelData, yang bervariasi menurut saluran selama runtime.

Jika Anda perlu mengurai informasi dari suatu peristiwa yang berasal dari Teams, lihat dokumentasi pengembang Teams untuk menemukan contoh seperti apa peristiwa yang diharapkan. Anda kemudian dapat mengikuti petunjuk di bagian ini, menggunakan contoh peristiwa sebagai data contoh.

Untuk menambahkan node Urai nilai ke topik:

1. Pilih ikon Tambahkan node di bawah node tempat Anda ingin menguraikan nilainya. Arahkan kursor ke Manajemen variabel, dan pilih Urai nilai.

2. Tambahkan node urai nilai, dan pilih variabel yang ingin Anda uraikan.

   

3. Untuk jenis data, pilih Dari Data Sampel.

   

4. Pilih Dapatkan Skema dari JSON Sampel, masukkan contoh JSON yang diinginkan di editor yang terbuka, dan pilih Konfirmasi.

   

5. Pilih variabel untuk menyimpan nilai yang telah diuraikan. Biasanya, Anda akan membuat variabel baru.

   

   Variabel output sekarang memiliki jenis yang diharapkan: rekaman.

   

Konten terkait

• Ikhtisar variabel
• Menggunakan variabel global
• Menggunakan entitas dan pengisian slot di agen
• Menyesuaikan tampilan dan nuansa agen