Bagikan melalui

Konfigurasikan variabel konteks untuk bot

  • Artikel

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.

Catatan

Informasi ketersediaan fitur adalah sebagai berikut.

Dynamics 365 pusat kontak—tertanam Dynamics 365 pusat kontak—mandiri Dynamics 365 Customer Service
No Ya Ya

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:
  • Satu Baris: String
  • Beberapa baris: String
  • rangkaian pilihan: String
  • Izin Pengguna: Boolean
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:
  • Baris tunggal: Keseluruhan respons pengguna
  • Beberapa baris: Keseluruhan respons pengguna
  • Rangkaian pilihan: Seluruh respons pengguna
  • Izin Pengguna: Boolean
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:
  • String: Keseluruhan respons pengguna
    • Boolean: Boolean
  • Angka, Angka Mengambang: Angka
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:

  1. Pada halaman Topik , pilih Tambahkan topik dan dari kosong.

  2. Masukkan nama untuk topik Anda (misalnya, "Setel variabel konteks") dan simpan.

  3. Tambahkan node baru ke topik, dan pilih Manajemen > variabel Menetapkan nilai variabel

  4. Di simpul baru Anda, di bawah Atur variabel , pilih Buat variabel baru.

  5. 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).

  6. 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.

  7. Di bagian Penggunaan , pilih Global (topik dapat mengakses) dan Sumber eksternal dapat menetapkan nilai. Copilot Studio menerima data dari multisaluran. Tutup panel Properti variabel.

  8. 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.

    Mengkonfigurasi variabel konteks di topik.

  9. 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