Konfigurasikan variabel konteks untuk bot
Penting
Power Virtual Agents kemampuan dan fitur sekarang menjadi bagian dari Microsoft Copilot Studio mengikuti investasi signifikan dalam AI generatif dan integrasi yang ditingkatkan Microsoft Copilot.
Beberapa artikel dan tangkapan layar mungkin merujuk saat Power Virtual Agents kami memperbarui dokumentasi dan konten pelatihan.
Artikel ini mencantumkan variabel konteks untuk Azure dan Copilot Studio bot, dan cara mengonfigurasinya di Multisaluran untuk Customer Service. Untuk memahami cara membuat variabel konteks, lihat Mengelola variabel konteks.
Variabel konteks untuk bot Azure
Tabel berikut berisi daftar variabel konteks di Multisaluran untuk Customer Service yang dapat Anda gunakan untuk mengonfigurasi bot Azure.
| Jenis Variabel Konteks | Nama variabel konteks | Description | Cara memetakan di Azure |
|---|---|---|---|
| Survei pra-percakapan | Gunakan nama pertanyaan survei pra-percakapan yang Anda buat di Multisaluran untuk Customer Service. | Sistem menyimpan respons dari survei pra-percakapan sebagai variabel konteks. | Gunakan informasi berikut untuk memetakan nama pertanyaan di Multisaluran untuk Customer Service dengan jenis variabel di Azure:
|
| Konteks kustom | Gunakan nama variabel yang Anda buat di Multisaluran untuk Customer Service atau lewatkan dengan menggunakan setContextProvider API. | Variabel konteks kustom yang Anda buat dapat diteruskan melalui SDK chat langsung. | Petakan respons pengguna sebagai JSON untuk menggunakan variabel konteks kustom di Multisaluran untuk Customer Service. |
| Percakapan | msdyn_ConversationId | Gunakan variabel konteks yang berisi ID percakapan untuk percakapan yang sedang berlangsung dan dapat mengambil serta melakukan operasi pada rekaman di Microsoft Dataverse. | String: String |
| Kontak | msdyn_contact_msdyn_ocliveworkitem_Customer | Gunakan variabel konteks ini yang berisi ID rekaman untuk rekaman pelanggan (kontak) yang ditautkan ke percakapan. | Uraikan JSON untuk mengekstrak ID rekaman |
| Akun | msdyn_account_msdyn_ocliveworkitem_Customer | Gunakan variabel konteks ini yang berisi ID rekaman untuk rekaman akun yang ditautkan ke percakapan. | Uraikan JSON untuk mengekstrak ID rekaman |
| Kasus | msdyn_incident_msdyn_ocliveworkitem | Gunakan variabel konteks ini yang berisi ID rekaman untuk rekaman kasus yang ditautkan ke percakapan. | Uraikan JSON untuk mengekstrak ID rekaman |
Catatan
Gunakan nama variabel konteks seperti yang ditentukan dan jangan mengubahnya saat Anda menulis alur di Azure atau Copilot Studio bot. Selain itu, pastikan untuk menggunakan pencocokan yang tepat untuk meneruskan nilai ke variabel konteks, sebab variabel peka terhadap huruf besar-kecil. Jika terjadi ketidakcocokan, rekaman tidak akan teridentifikasi secara otomatis. Informasi selengkapnya: Mengidentifikasi rekaman secara otomatis
Variabel konteks untuk Copilot Studio bot
Tabel berikut berisi daftar variabel konteks yang tersedia di Multisaluran untuk Customer Service yang dapat Anda gunakan untuk mengonfigurasi Copilot Studio bot.
Penting
Untuk menggunakan variabel pesan dan suara, pastikan Anda menginstal solusi ekstensi terlebih dahulu.
| Jenis Variabel Konteks | Nama variabel konteks | Description | Cara memetakan di Copilot Studio |
|---|---|---|---|
| Survei pra-percakapan | Gunakan nama pertanyaan survei pra-percakapan yang Anda buat di Multisaluran untuk Customer Service. | Sistem menyimpan respons dari survei pra-percakapan sebagai variabel konteks. | Gunakan informasi berikut untuk memetakan nama pertanyaan di Multisaluran untuk Customer Service dengan variabel ketik Copilot Studio:
|
| Konteks kustom | Gunakan nama variabel yang Anda buat di Multisaluran untuk Customer Service atau teruskan menggunakan setContextProvider API. | Variabel konteks kustom yang Anda buat dapat diteruskan melalui SDK chat langsung. | Gunakan informasi berikut untuk memetakan variabel konteks kustom di Multisaluran untuk Customer Service dengan variabel ketik di Copilot Studio:
|
| Percakapan | msdyn_ConversationId | Gunakan variabel konteks yang berisi ID percakapan untuk percakapan yang sedang berlangsung dan dapat mengambil serta melakukan operasi pada rekaman di Microsoft Dataverse. | String: Keseluruhan respons pengguna. |
| Variabel pesan dan suara | msdyn_CustomerType | Gunakan variabel konteks ini yang berisi jenis pelanggan untuk akun atau rekaman kontak yang ditautkan ke percakapan. | Pilih variabel solusi ekstensi Multisaluran untuk Customer Service. |
| msdyn_CustomerName | Gunakan variabel konteks ini yang berisi nama pelanggan untuk akun atau rekaman kontak yang ditautkan ke percakapan. | Pilih variabel solusi ekstensi Multisaluran untuk Customer Service. | |
| msdyn_CustomerId | Gunakan variabel konteks ini yang berisi ID pelanggan untuk akun atau rekaman kontak yang ditautkan ke percakapan. | Pilih variabel solusi ekstensi Multisaluran untuk Customer Service. | |
| msdyn_CaseId | Gunakan variabel konteks ini yang berisi ID rekaman kasus yang ditautkan ke percakapan. | Pilih variabel solusi ekstensi Multisaluran untuk Customer Service. | |
| msdyn_CaseTitle | Gunakan variabel konteks ini yang berisi judul rekaman kasus yang ditautkan ke percakapan. | Pilih variabel solusi ekstensi Multisaluran untuk Customer Service. | |
| Variabel hanya panggilan suara | CustomerPhoneNumber | Gunakan variabel konteks ini untuk nomor telepon pelanggan dalam aktivitas Telepon. | Pilih variabel solusi ekstensi Multisaluran untuk Customer Service. |
| OrganizationPhoneNumber | Gunakan variabel konteks ini untuk nomor telepon organisasi dalam aktivitas Telefoni. | Pilih variabel solusi ekstensi Multisaluran untuk Customer Service. | |
| Nama metode ekstensi | va_SurveyConsent | Gunakan dialog ini untuk menentukan apakah pelanggan telah setuju untuk berpartisipasi dalam survei selama percakapan berlangsung. | Gunakan metode ini untuk melakukan eskalasi rincian percakapan ke Multisaluran untuk Customer Service. |
| va_CustomerLocale | Gunakan dialog ini untuk mengalihkan pengguna yang saat ini berbicara dengan bot ke bot lainnya, yang dapat berbicara dalam bahasa yang berbeda. | Atur kode dengan memilih variabel input dan menggunakan kode lokal yang benar. |
Konfigurasikan variabel konteks untuk Copilot Studio bot
Agar bot Copilot Studio membaca variabel konteks dari multisaluran, lakukan langkah-langkah berikut:
Pada halaman Topik , pilih Tambahkan topik dan dari kosong.
Masukkan nama untuk topik Anda (misalnya, "Setel variabel konteks") dan simpan.
Tambahkan node baru ke topik, dan pilih Manajemen > variabel Menetapkan nilai variabel
Di simpul baru Anda, di bawah Atur variabel , pilih Buat variabel baru.
Buka panel Properti variabel dengan mengklik nama variabel baru. Di panel, atur Nama variabel agar sama persis dengan nama variabel konteks multisaluran (peka huruf besar/kecil).
Di bagian Referensi , pilih elipsis (...) dan pilih Dapatkan nilai dari simpul ini jika kosong. The Copilot Studio bot mengambil nilai variabel dari node ini saat runtime.
Di bagian Penggunaan , pilih Global (topik dapat mengakses) dan Sumber eksternal dapat menetapkan nilai. Copilot Studio menerima data dari multisaluran. Tutup panel Properti variabel.
Di simpul Anda, masukkan nilai di Untuk nilai yang cocok dengan tipe data yang diharapkan bot Anda. Misalnya, jika bot Anda mengharapkan string, atur Text(""). Copilot Studio Kembali ke nilai yang Anda tetapkan di sini jika data tidak tiba dalam percakapan.
Simpan dan terbitkan perubahan.
Selama percakapan, data dari variabel konteks multisaluran diatur dalam Copilot Studio variabel dan dapat digunakan dalam logika bot.
Bot juga dapat mengatur multisaluran variabel konteks selama percakapan. Untuk mengatur variabel multisaluran dari logika Anda Copilot Studio , pastikan bot Anda menggunakan nama variabel yang benar dan tetapkan nilai di properti "To value" di node manajemen variabel Anda. Copilot Studio Lepaskan variabel untuk multisaluran selama Alihkan ke agen. Ini sering digunakan untuk tautkan percakapan ke kasus ketika bot meningkatkan percakapan ke agen. Informasi selengkapnya tentang cara tautkan rekaman dalam multisaluran dari data ini: tautkan pelanggan dan kasus ke percakapan
Variabel global yang dibuat dapat Copilot Studio diteruskan ke Multisaluran untuk Customer Service ketika percakapan meningkat. Untuk daftar lengkap, lihat Variabel kontekstual yang tersedia saat penyerahan.
Uraikan objek JSON untuk mengekstrak ID rekaman
Pastikan Anda memiliki rincian berikut:
- Variabel konteks Multisaluran untuk Customer Service, msdyn_contact_msdyn_ocliveworkitem_Customer.
- Rincian skema
Salinan rincian skema sampel adalah sebagai berikut:
Schema:
{
"type": "array",
"items": {
"type": "object",
"properties": {
"RecordId": {
"type": "string"
},
"PrimaryDisplayValue": {
"type": "string"
}
},
"required": [
"RecordId",
"PrimaryDisplayValue"
]
}
}
PrimaryDisplayValue berisi nilai dari atribut dalam Dataverse entitas. Pemetaan untuk atribut entitas adalah sebagai berikut:
- Kasus: judul kasus
- Kontak: Nama Lengkap
- akun: Nama
Berikut adalah contoh rekaman konteks.
{
"msdyn_contact_msdyn_ocliveworkitem_Customer": [
{
"RecordId": "<GUID>",
"PrimaryDisplayValue": "<FullName>"
}
],
"msdyn_liveworkitemid": "<GUID>"
}
Baca juga
Integrasikan a Copilot Studio bot
Mengintegrasikan bot Azure
Mengonfigurasi bot untuk meningkatkan dan mengakhiri percakapan
Referensi SDK chat langsung
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk