Konfigurasi pemboleh ubah konteks untuk bot
Penting
Power Virtual Agents keupayaan dan ciri kini menjadi sebahagian daripada Microsoft Copilot Studio mengikuti pelaburan penting dalam AI penjanaan dan integrasi yang dipertingkatkan di seluruh Microsoft Copilot.
Sesetengah artikel dan tangkapan skrin mungkin merujuk semasa Power Virtual Agents kami mengemas kini dokumentasi dan kandungan latihan.
Nota
Maklumat ketersediaan ciri adalah seperti berikut.
| Dynamics 365 pusat hubungan—terbenam | Dynamics 365 pusat hubungan—kendiri | Dynamics 365 Customer Service |
|---|---|---|
| No | Ya | Ya |
Artikel ini menyenaraikan pemboleh ubah konteks untuk Azure dan Copilot Studio bot serta cara anda boleh mengkonfigurasinya dalam Saluran Omni untuk Customer Service. Untuk memahami cara untuk mencipta pembolehubah konteks, lihat Urus pembolehubah konteks.
Pembolehubah konteks untuk bot Azure
Jadual berikut mengandungi senarai pembolehubah konteks dalam Saluran Omni untuk Customer Service yang anda boleh gunakan untuk mengkonfigurasi bot Azure.
| Jenis pemboleh ubah konteks | Nama pemboleh ubah konteks | Description | Cara untuk memeta dalam Azure |
|---|---|---|---|
| Tinjauan praperbualan | Gunakan nama soalan tinjauan pra-perbualan yang anda cipta dalam Saluran Omni untuk Customer Service. | Sistem ini menyimpan respons daripada tinjauan pra-perbualan sebagai pembolehubah konteks. | Gunakan maklumat berikut untuk memetakan nama soalan dalam Saluran Omni untuk Customer Service dengan jenis pemboleh ubah dalam Azure:
|
| Konteks tersuai | Gunakan nama pemboleh ubah yang anda cipta dalam Saluran Omni untuk Customer Service atau serahkan menggunakan API setContextProvider. | Pemboleh ubah konteks tersuai yang anda buat boleh melalui SDK sembang langsung. | Petakan respons pengguna sebagai JSON untuk menggunakan pemboleh ubah konteks tersuai dalam Saluran Omni untuk Customer Service. |
| Perbualan | msdyn_ConversationId | Gunakan pemboleh ubah konteks yang mengandungi ID perbualan untuk perbualan sedang berjalan dan boleh mengambil dan melaksanakan operasi pada rekod dalam Microsoft Dataverse. | Rentetan: Rentetan |
| Kenalan | msdyn_contact_msdyn_ocliveworkitem_Customer | Gunakan pemboleh ubah konteks ini yang mengandungi ID rekod untuk rekod pelanggan (kenalan) yang dipautkan dengan perbualan tersebut. | Hurai JSON untuk mengekstrak ID rekod |
| Akaun | msdyn_account_msdyn_ocliveworkitem_Customer | Gunakan pemboleh ubah konteks ini yang mengandungi ID rekod untuk rekod akaun yang dipautkan dengan perbualan tersebut. | Hurai JSON untuk mengekstrak ID rekod |
| Kes | msdyn_incident_msdyn_ocliveworkitem | Gunakan pemboleh ubah konteks ini yang mengandungi ID rekod untuk rekod kes yang dipautkan dengan perbualan tersebut. | Hurai JSON untuk mengekstrak ID rekod |
Nota
Gunakan nama pemboleh ubah konteks seperti yang ditakrifkan dan jangan ubahnya apabila anda mengarang mengalir dalam Azure atau Copilot Studio bot. Juga, sila pastikan untuk menggunakan padanan tepat untuk menyerahkan nilai kepada pembolehubah konteks kerana nilai sensitif huruf. Jika terdapat salah padanan, rekod tidak akan dapat dikenal pasti secara automatik. Maklumat lanjut: Kenal pasti rekod secara automatik
Pemboleh ubah konteks untuk Copilot Studio bot
Jadual berikut mengandungi senarai pemboleh ubah konteks yang tersedia dalam Saluran Omni untuk Customer Service yang anda boleh gunakan untuk mengkonfigurasikan Copilot Studio bot.
Penting
Untuk menggunakan pemboleh ubah pemesejan dan suara, pastikan anda memasang penyelesaian sambungan terlebih dahulu.
| Jenis pemboleh ubah konteks | Nama pemboleh ubah konteks | Description | Cara memetakan dalam Copilot Studio |
|---|---|---|---|
| Tinjauan praperbualan | Gunakan nama soalan tinjauan pra-perbualan yang anda cipta dalam Saluran Omni untuk Customer Service. | Sistem ini menyimpan respons daripada tinjauan pra-perbualan sebagai pembolehubah konteks. | Gunakan maklumat berikut untuk memetakan nama soalan dalam Saluran Omni untuk Customer Service dengan jenis pemboleh ubah dalam Copilot Studio:
|
| Konteks tersuai | Gunakan nama pemboleh ubah yang anda cipta dalam Saluran Omni untuk Customer Service atau lulus menggunakan API setContextProvider. | Pemboleh ubah konteks tersuai yang anda buat boleh melalui SDK sembang langsung. | Gunakan maklumat berikut untuk memetakan pemboleh ubah konteks tersuai dalam Saluran Omni untuk Customer Service dengan jenis pemboleh ubah dalam Copilot Studio:
|
| Perbualan | msdyn_ConversationId | Gunakan pemboleh ubah konteks yang mengandungi ID perbualan untuk perbualan sedang berjalan dan boleh mengambil dan melaksanakan operasi pada rekod dalam Microsoft Dataverse. | Rentetan: Keseluruhan respons pengguna. |
| Pembolehubah pemesejan dan suara | msdyn_CustomerType | Gunakan pemboleh ubah konteks ini yang mengandungi jenis pelanggan untuk akaun atau rekod kenalan yang dipautkan ke perbualan. | Pilih pembolehubah penyelesaian sambungan Saluran Omni untuk Customer Service. |
| msdyn_CustomerName | Gunakan pemboleh ubah konteks ini yang mengandungi nama pelanggan untuk akaun atau rekod kenalan yang dipautkan kepada perbualan. | Pilih pembolehubah penyelesaian sambungan Saluran Omni untuk Customer Service. | |
| msdyn_CustomerId | Gunakan pemboleh ubah konteks ini yang mengandungi ID pelanggan untuk akaun atau rekod kenalan yang dipautkan ke perbualan. | Pilih pembolehubah penyelesaian sambungan Saluran Omni untuk Customer Service. | |
| msdyn_CaseId | Gunakan pemboleh ubah konteks ini yang mengandungi ID rekod kes yang dipautkan ke perbualan. | Pilih pembolehubah penyelesaian sambungan Saluran Omni untuk Customer Service. | |
| msdyn_CaseTitle | Gunakan pemboleh ubah konteks ini yang mengandungi tajuk rekod kes yang dipautkan kepada perbualan. | Pilih pembolehubah penyelesaian sambungan Saluran Omni untuk Customer Service. | |
| Pembolehubah suara sahaja | CustomerPhoneNumber | Gunakan pemboleh ubah konteks ini untuk nombor telefon pelanggan dalam aktiviti Telefoni. | Pilih pembolehubah penyelesaian sambungan Saluran Omni untuk Customer Service. |
| OrganizationPhoneNumber | Gunakan pemboleh ubah konteks ini untuk nombor telefon organisasi dalam aktiviti Telefoni. | Pilih pembolehubah penyelesaian sambungan Saluran Omni untuk Customer Service. | |
| Nama kaedah sambungan | va_SurveyConsent | Gunakan dialog ini untuk menentukan sama ada pelanggan bersetuju untuk menyertai tinjauan semasa perbualan. | Gunakan kaedah ini untuk menaikkan butiran perbualan kepada Saluran Omni untuk Customer Service. |
| va_CustomerLocale | Gunakan dialog ini untuk memindahkan pengguna yang sedang bercakap dengan bot ke bot lain yang boleh bercakap dalam bahasa yang berbeza. | Tetapkan kod dengan memilih pembolehubah input dan menggunakan kod tempatan yang betul. |
Mengkonfigurasikan pemboleh ubah konteks untuk Copilot Studio bot
Untuk membolehkan bot anda Copilot Studio membaca pemboleh ubah konteks daripada saluran omni, lakukan langkah berikut:
Pada halaman Topik , pilih Tambah topik dan daripada kosong.
Masukkan nama untuk topik anda (contohnya, "Tetapkan pemboleh ubah konteks") dan simpannya.
Menambah nod baru pada topik dan pilih Pengurusan > pemboleh ubah Setkan nilai pemboleh ubah
Dalam nod baru anda, di bawah Tetapkan pemboleh ubah pilih Cipta pemboleh ubah baru.
Buka anak tetingkap Sifat pemboleh ubah dengan mengklik nama pemboleh ubah baru. Dalam anak tetingkap, setkan nama Pemboleh ubah agar sepadan dengan nama pemboleh ubah konteks saluran omni dengan tepat (ia sensitif huruf).
Dalam seksyen Rujukan , pilih elipsis (...) dan pilih Dapatkan nilai daripada nod ini jika kosong. Bot mengambil Copilot Studio nilai pemboleh ubah dari nod ini pada masa jalan.
Dalam seksyen Penggunaan , pilih Global (sebarang topik boleh capaian) dan Sumber luaran boleh mengesetkan nilai. Copilot Studio menerima data daripada saluran omni. Tutup anak tetingkap Sifat pemboleh ubah.
Dalam nod anda, masukkan nilai dalam Nilai yang sepadan dengan jenis data yang diharapkan oleh bot anda. Contohnya, jika bot anda menjangkakan rentetan, setkan Teks(""). Copilot Studio jatuh kembali kepada nilai yang anda setkan di sini jika data tidak tiba dalam perbualan.
Simpan dan terbitkan perubahan.
Semasa perbualan, data dari pemboleh ubah konteks saluran omni ditetapkan dalam Copilot Studio pemboleh ubah dan boleh digunakan dalam logik bot.
Bot juga boleh menetapkan pembolehubah konteks saluran omni semasa perbualan. Untuk mengesetkan pemboleh ubah saluran omni daripada logik anda Copilot Studio , pastikan bot anda menggunakan nama pemboleh ubah yang betul dan tetapkan nilai dalam sifat "Kepada nilai" dalam nod pengurusan pemboleh ubah anda. Copilot Studio melepaskan pembolehubah kepada saluran omni semasa pemindahan kepada ejen. Ini sering digunakan untuk memautkan perbualan kepada kes apabila bot meningkatkan perbualan kepada ejen. Maklumat lanjut tentang cara memautkan rekod dalam saluran omni daripada data ini:Pautkan pelanggan dan kes ke perbualan
Pemboleh ubah global yang dicipta boleh Copilot Studio diluluskan untuk Saluran Omni untuk Customer Service apabila perbualan ditingkatkan. Untuk senarai lengkap, lihat Pembolehubah kontekstual tersedia semasa penyerahan.
Huraikan objek JSON untuk mengekstrak ID rekod
Pastikan anda mempunyai butiran berikut:
- Pemboleh ubah konteks Saluran Omni untuk Customer Service, seperti msdyn_contact_msdyn_ocliveworkitem_Customer.
- Butiran skema
Salinan butiran skema sampel adalah seperti berikut:
Schema:
{
"type": "array",
"items": {
"type": "object",
"properties": {
"RecordId": {
"type": "string"
},
"PrimaryDisplayValue": {
"type": "string"
}
},
"required": [
"RecordId",
"PrimaryDisplayValue"
]
}
}
PrimaryDisplayValue mengandungi nilai dari atribut dalam Dataverse entiti. Pemetaan untuk atribut entiti adalah seperti berikut:
- Kes: Tajuk kes
- Kenalan: Nama penuh
- Akaun: Nama
Berikut adalah rekod konteks sampel.
{
"msdyn_contact_msdyn_ocliveworkitem_Customer": [
{
"RecordId": "<GUID>",
"PrimaryDisplayValue": "<FullName>"
}
],
"msdyn_liveworkitemid": "<GUID>"
}
Lihat juga
Sepadukan Copilot Studio bot
Mengintegrasikan bot Azure
Mengkonfigurasikan bot untuk menambah dan menamatkan perbualan
Rujukan SDK sembang langsung
Maklum balas
Akan datang: Sepanjang 2024, kami akan menghentikan secara berperingkat Isu GitHub sebagai kaedah maklum balas untuk kandungan dan menggantikannya dengan sistem maklum balas baharu. Untuk mendapatkan maklumat lanjut lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat maklum balas untuk