Botlar için bağlam değişkenlerini yapılandırma

Bu makalede, Azure ve Copilot Studio botları için bağlam değişkenleri listelenmekte ve bunları Customer Service için Çok Yönlü Kanal'da nasıl yapılandıracağınız açıklanmaktadır. Bağlam değişkenlerinin nasıl oluşturulacağını anlamak için bkz. Bağlam değişkenlerini yönetme.

Azure botları için bağlam değişkenleri

Aşağıdaki tablo, Customer Service için Çok Yönlü Kanal'da Azure botlarını yapılandırmak için kullanabileceğiniz bağlam değişkenlerinin listesini içerir.

Copilot Studio botları için bağlam değişkenleri

Aşağıdaki tablo, Customer Service için Çok Yönlü Kanal'da Copilot Studio botlarını yapılandırmak için kullanabileceğiniz bağlam değişkenlerinin listesini içerir.

Copilot Studio botu için bağlam değişkenlerini yapılandırma

Copilot Studio botunuun Çok Yönlü Kanal'dan bağlam değişkenlerini okumasını sağlamak için aşağıdaki adımları uygulayın:

1. Konular sayfasında, Konu ekle ve sıfırdan seçin.

2. Konunuz için bir ad girin (örneğin, "Bağlam değişkenlerini ayarlayın") ve kaydedin.

3. Konuya yeni bir düğüm ekleyin ve ardından Değişken yönetimi > Değişken değeri ayarla'yı seçin

4. Yeni düğümünüzde, Değişken belirle bölümünde Yeni değişken oluştur'u seçin.

5. Yeni değişken adını tıklatarak Değişken özellikleri bölmesini açın. Bölmede, Değişken adını Çok Yönlü Kanal bağlamı değişkeninin adıyla tam olarak eşleşecek şekilde ayarlayın (büyük ve küçük harf duyarlıdır).

6. Başvuru bölümünde, elipsleri (...) seçin ve Boşsa bu düğümden değer al seçeneğini belirleyin. Copilot Studio botu, çalışma zamanında bu düğümden değişken değerini alır.

7. Kullanım bölümünde Global (tüm konular erişebilir) ve Harici kaynaklar, değerleri ayarlayabilir öğesini seçin. Copilot Studio Çok Yönlü Kanal verileri kabul eder. Değişken özellikleri bölmesini kapatın.

8. Düğümünüzde, botunuzun beklediği veri türüyle eşleşen bir değeri Değere kısmına girin. Örneğin, botunuz bir dize bekliyorsa, Text("") ayarlayın. Copilot Studio veriler konuşmaya gelmiyorsa, burada ayarladığınız değere geri düşer.

   

9. Değişiklikleri kaydedin ve yayımlayın.

Konuşma sırasında, Çok Yönlü Kanal bağlam değişkeninin verileri Copilot Studio değişkenleri içinde ayarlanır ve botun mantığında kullanılabilir.

Bot bir konuşma sırasında Çok Yönlü Kanal bağlam değişkenlerini de ayarlayabilir. Copilot Studio mantığınızdan bir Çok Yönlü Kanal değişkeni ayarlamak için, botunuzun doğru değişken adını kullandığından emin olun ve değişken yönetimi düğümünüzde "Değere" özelliğindeki değeri ayarlayın. Copilot Studio aracıya aktarma sırasında değişkeni Çok Yönlü Kanal'a bırakır. Bu genellikle bot bir temsilciye konuşmayı iletirken, konuşma ile bir servis talebi arasında bağlantı oluşturmak için kullanılır. Bu veriden Çok Yönlü Kanal kayıtlarının nasıl bağlantı altına alındığı hakkında daha fazla bilgi: Müşteriyi ve servis talebini bir konuşmaya bağlama

Copilot Studio'ta oluşturulan genel değişkenler, bir konuşma yönlendirildiğinde Customer Service için Çok Yönlü Kanal'a geçirilebilir. Listenin tamamı için bkz. Devirden sonra kullanılabilen bağlamsal değişkenler.

Kayıt kimliğini ayıklamak için JSON nesnesini ayrıştırma

Aşağıdaki ayrıntılara sahip olduğunuzdan emin olun:

• msdyn_contact_msdyn_ocliveworkitem_Customer gibi Customer Service için Çok Yönlü Kanal bağlam değişkeni.
• Şema ayrıntıları

Örnek şema ayrıntılarının bir kopyası aşağıdaki gibidir:

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue, Dataverse varlıklarındaki öznitelik değerini içerir. Varlık özniteliklerinin eşlenmesi aşağıdaki gibidir:

• Servis Talebi: Servis talebi başlığı
• İlgili Kişi: Adı ve soyadı
• Firmalar: Adı

Örnek bağlam kaydı aşağıda verilmiştir.

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

Ayrıca bkz.

Bir Copilot Studio bot'u tümleştirme
Bir bot'u Azure ile tümleştirme
Konuşmaları ilerletmek ve sonlandırmak için botları yapılandırma
Canlı sohbet SDK başvurusu