Global değişkenlerle çalışma

Değişkenler , müşterilerinizin aracınızdaki sorulara verdiği yanıtları depolar. Örneğin, müşterinin adını UserName değişkenine kaydedebilirsiniz. Ardından aracı, konuşma devam ederken müşteriye adıyla hitap edebilir.

Varsayılan olarak, bir değişkenin değeri yalnızca bu değişkenin oluşturulduğu konuda kullanılabilir. Ancak, aynı değeri konuların arasında yeniden kullanmak mümkündür. Örneğin bot, Hoş Geldiniz konusunda müşterinin adını ve e-posta adresini sorar. Randevu Alma konusunda, aracı müşterinin ne girdiğini hatırlamasını ve bir daha sormamasını istiyorsunuz.

Bir değişkeni yeniden kullanmanın bir yolu, değişkeni bir konudan diğerine geçirmektir. Diğer yol ise genel değişkeni kapsam içinde yapmak ve bu makalede bu ele alınır. Genel değişkenler böyle adlandırılır çünkü tüm aracıdaki bütün konularda kullanılabilirler. Harici kaynaklardan da ayarlanabilirler.

Global değişkenler tek bir kullanıcı oturumu sırasında geçerlidir. Hangi değişkenlerin genel değişkenler olduğunu belirterek bunları konu düzeyindeki değişkenlerden ayırt edebilirsiniz.

Global değişken oluşturma

Bir konu değişkeninin kapsamını değiştirerek genel değişken oluşturabilirsiniz.

Not

Genel değişkenin adı tüm konularda benzersiz olmalıdır.

Web uygulaması

1. Bir değişken oluşturun veya mevcut bir değişkeni açmak için Değişkenler panelini kullanın.

2. Değişken özellikleri panelinde, Global (tüm konular erişebilir) seçeneğini belirleyin.

   Konu düzeyindeki değişkenlerden ayırmak için değişken adına Global. öneki verilir. Örneğin, UserName değişkeni şimdi Global.UserName olarak görüntülenir.

3. Konuyu kaydedin.

Klasik / Takımlar

1. İstediğiniz değişkeni seçin.

2. Değişken özellikleri panelinde Kullanım altında Bot (tüm konular erişebilir) seçeneğini belirleyin.

3. Değişken adı, konu düzeyindeki değişkenlerden ayırt edilebilmesi için bot. ön ekiyle işaretlenir. Örneğin, UserEmail değişkeni artık bot.UserEmail olarak görünüyor.

Global değişkenleri kullanma

Web uygulaması

İleti düğümünde veya Soru düğümünde bir ileti oluştururken, konuya yönelik kullanılabilir değişkenleri görüntülemek için {x} simgesini seçin. Global değişkenler, tüm konu değişkenlerinin yanı sıra, Özel sekmesinde görüntülenir. Değişkenler alfabetik olarak listelenir.

Klasik / Takımlar

İleti düğümünde veya Soru düğümünde bir ileti oluştururken, konuya yönelik kullanılabilir değişkenleri görüntülemek için {x} simgesini seçin. Değişkenler alfabetik sıraya göre listelenmiştir ve tüm global değişkenler hepsi bot. ile başladığı için birlikte görünür.

Bir koşul düğümü, bir akış eylemi düğümü veya bir beceri düğümü kullandığınızda, orada da kullanılabilen genel değişkenleri görürsünüz.

Bir global değişkeni kullanan tüm konuları bulun

Genel değişkenin nerede tanımlandığını ve başka hangi konuların kullandığını görebilirsiniz. Bu özellik, yeni bir aracı üzerinde çalışıyorsanız veya birden fazla değişkeniniz ve karmaşık konu dallanması varsa faydalı olabilir.

Web uygulaması

1. Geliştirme tuvalinde veya Değişkenler panelinde istediğiniz global değişkeni seçin.

2. Değişken özellikleri panelinde, Başvuru bölümünde, Tüm başvuruları görüntüle'yi seçin.

3. Diğer sekmesine geçin ve doğrudan o konuya ve düğüme gitmek için değişkenin kullanıldığı herhangi bir konuyu seçin.

Klasik / Takımlar

Yazma tuvalinde istediğiniz değişkeni seçin. Değişken özellikleri paneli görünür.

• Doğrudan genel değişkenin oluşturulduğu düğüme gitmek için Kaynağa git'i seçin.

• Bu değişkeni kullanan bir konuya gitmek için, Kullanan bölümünde istediğiniz konuyu seçin.

Global değişkenleri silme

Diğer konularda kullanılan bir global değişkeni kaldırırsanız, konulardaki o değişkene ait referanslar Unknown olarak işaretlenir. İşlemi onaylayabilmek için global değişkeni silme hakkında bir uyarı alırsınız.

Silinen bir global değişkene referanslar içeren düğümler, bilinmeyen bir değişken içerdiklerini gösterir.

Silinen global değişkenlerine başvurular içeren düğümlere sahip konular çalışmayı durdurabilir. Aracınızı yayınlamadan önce silinen değişkeni kullanan tüm konuları kaldırdığınızdan veya düzelttiğinizden emin olun.

Genel değişkenlerin yaşam döngüsü

Web uygulaması

Varsayılan olarak, bir genel değişkenin değeri oturum bitene kadar devam eder. Değişken değerlerini temizle düğümü, genel değişkenlerin değerlerini sıfırlar ve Konuşmayı Sıfırla sistem konusunda kullanılır. Bir yönlendirme bu konuyu tetiklediğinde (veya kullanıcı "Baştan başla" gibi bir tümcecik girdiğinde), tüm genel değişkenler sıfırlanır.

Klasik / Takımlar

Global değişkenlere herhangi bir konudan erişilebilir ve oturum boyunca kalıcıdır.

Bu değer yalnızca aracı kullanıcısı Baştan başla konusuna yönlendirildiğinde veya kullanıcı doğrudan bu konuyu tetiklediğinde (ör. "Baştan başla" yazarak) silinir. Bu durumda tüm global değişkenler sıfırlanır ve bir değere sahip olmazlar.

Global değişken başlatma

Global değişkeni başlatılmadan (veya "doldurulmadan") önce tetiklenirse aracı, ilk tanımlandığı konu geçerli konudan farklı bile olsa özgün konuya dönmeden önce ilk tanımlandığı konuya ait bölümü tetikler. Bu davranış, aracının konuşmayı kesintiye uğratmadan tüm değişkenleri doldurmasını sağlar.

Örneğin, müşteri bir global değişkeni bot.UserName kullanılan "Randevu ayırma" konusunda bir konuşma başlatır. Ancak bot.UserName değişkeni ilk olarak "Hoş Geldiniz" konusunda tanımlanmıştır.

Konuşma, "Randevu ayırma" konusunda bot.UserName değişkenine başvurulan noktaya geldiğinde aracı, bot.UserName değişkeninin ilk olarak tanımlandığı soru düğümüne sorunsuz bir şekilde yönelecektir.

Müşteri, soruyu cevapladıktan sonra aracı "Randevu ayırma" konusuna devam eder.

Power Automate akışları veya becerileri aracılığıyla eylemleri uygularken küresel değişken davranışı

Bazı durumlarda, değişkeni başlatmak veya doldurmak için akış veya beceri kullanabilirsiniz.

Bir kullanıcı aracı ile etkileşim kurduğunda, değişken konuşmanın daha önceki bir noktasında doldurulabilir veya değişkenleri zaten dışarıdan ayarlamış olabilirsiniz.

Bu durumda, yine de akış veya beceri değişkende daha önce depolanan her şeyin üzerine yazarak çalıştırılır ve değişkeni doldurur.

Harici kaynaklardan global değişkenler ayarlayın

Web uygulaması

Aracının bir bağlamla konuşma başlattığından emin olmak için genel bir değişken kullanabilir ve değerini harici bir kaynaktan ayarlayabilirsiniz. Sitenizin kullanıcıların oturum açmalarını gerektirdiğini varsayalım. Bir kullanıcının adını global bir değişkende depolar ve temsilcinize iletirseniz, temsilci müşterileri ilk sorularını yazmaya başlamadan önce adlarıyla karşılayabilir. Başka bir örnek senaryo, Dynamics 365 Customer Service'ten bir temsilciye bağlam geçirmektir, böylece temsilci müşterinin neyi başarmak istediğini bilerek konuşmayı başlatabilir.

İstenmeyen gecikmeyi önlemek için, aracınızın bir değer için ne kadar bekleyebileceğini belirtebilirsiniz. Ayrıca, dış kaynak zamanında yanıt veremediğinde kullanılacak varsayılan bir değer de ayarlayabilirsiniz.

Not

IVR kullanım örnekleri için Dynamics 365 Contact Center kanalında yayımlanan aracılar, dış kaynaklar tarafından ayarlanan genel değişkenler için yapılandırılan zaman aşımı değerlerini desteklemez.

1. Dış kaynaklardan ayarlanması amaçlanan tüm değişkenlerin yapılandırmasını tutmak için özel bir konu oluşturun. Örneğin, bu konuyu "Bağlam değişkenlerini ayarlama" olarak adlandırabilirsiniz. Bu konu başka bir amaca hizmet etmez, bu nedenle tetikleme tümceciklerinin ayarlanması gerekmez.

2. Özel konunuza bir Değişken değeri ayarla düğümü ekleyin.

3. Değişken ayarla altında değişken seçiciyi açın ve Yeni bir değişken oluştur'u seçin.

4. Yeni değişkenin varsayılan adını seçin. Değişken özellikleri paneli görünür.

5. Varsayılan adı, dış sistemden geçirilen değişkenin adıyla tam olarak eşleşen bir adla değiştirin.

6. Kullanım altında Genel (herhangi bir konu erişebilir) ve Harici kaynaklar değerleri ayarlayabilir öğelerini seçin.

7. Referans altında, sağ üst köşedeki üç noktayı (⋮) seçin ve Boşsa bu düğümden değer al seçeneğini belirleyin.

8. (İsteğe bağlı) Milisaniye cinsinden bir zaman aşımı gecikmesi ayarlayın. Bu değer, aracınızın değişkenin harici bir kaynak tarafından ayarlanmasını beklemeden önce zaman aşımına uğramadan ve Değişken değerini ayarla düğümünde ayarladığınız varsayılan değerle devam etmeden önce ne kadar süre bekleyebileceğini belirler. Bu ayar, değişkenin uzun süre çalışan veya zaman uyumsuz bir işleme bağlı olduğu senaryolarda geçerlidir, ancak aracınızın iyi bir kullanıcı deneyimi sağlamak için maksimum gecikme süresine uyması gerekir.

   Customer Service için Çok Yönlü Kanal'dan gelen değişkenler için maksimum bekleme süresi olarak 10 saniye (10.000 ms) değerini öneririz.

9. Değişken değeri ayarla düğümünde, zaman aşımına ulaşıldığında kullanılacak varsayılan değeri girin. Çalışma zamanında, aracı aynı veri türüne sahip değerler bekler. Eğer bu varsayılan değerin boş bir dize olmasını istiyorsanız formül olarak Text("") kullanın.

   

10. Harici bir sistemden gelmesini beklediğiniz diğer değerler için, özel konunuza daha fazla Değişken değerini ayarla düğümü ekleyin ve gerekli genel değişkenleri aynı şekilde yapılandırın.

Böylece yapılandırılan aracınız test etmeye hazırdır. Aracı çağrıldığında, tüm değişkenlerin doldurulmasını süresiz olarak beklemek yerine, aracınız geçirilen değişkenlere bağımlı olmayan iletileri hemen göndermeye başlayabilir. Aracınız harici olarak ayarlanan bir değişkene erişmeye çalıştığında, değer gelene veya zaman aşımı gerçekleşene kadar duraklatılır. Gecikmeyi en aza indirmek için aracıları optimize etme hakkında daha fazla bilgi edinin.

Önemli

Bir konuşmanın normal akışı sırasında, aracınız aksi takdirde harici bir değer için gelecek bir değişken ayarlarsa, aracınızın içinden ayarlanan değer geçerli olur. Bağlam içinde iletilen herhangi bir değer yoksayılır. Bu kural, aracınızın konularda kasıtlı olarak ayarlanan değerlerin üzerine yazmasını engeller.

Klasik / Takımlar

Global bir değişkenin harici bir kaynaktan başlatılmasını ayarlayabilirsiniz. Bu eylem, aracının konuşmayı bir bağlamla başlatmasını sağlar.

Örneğin, bir müşteri web sitenizden bir aracı sohbetine girdiğinde, site zaten müşterinin adını biliyor. Konuşmaya başlamadan önce aracının kullanıcının adını bilmesine olanak sağlarsınız ve aracı, adını yeniden sormaya gerek kalmadan müşteriyle daha akıllı konuşma gerçekleştirebilir.

1. İstediğiniz global değişkeni seçin.

2. Değişken özellikleri panelinde Harici kaynaklar değerleri ayarlayabilir'i seçin.

Eklenen aracıda global değişkenleri ayarlama

Web uygulaması

Aracınızı basit bir web sayfasına yerleştiriyorsanız, değişkenleri ve tanımlarını aracının URL'sine ekleyebilirsiniz. Daha fazla denetim istiyorsanız değişkenleri programlı olarak çağırıp kullanmak için bir <script> kod bloğu kullanabilirsiniz.

URL'nin sorgu dizesindeki değişken adı, Global. öneki olmadan global değişkenin adı ile eşleşmelidir. Örneğin Global.UserName genel değişkeni, sorguda UserName olarak referans edilir.

Aşağıdaki örneklerde değişkenler için temel bir bildirim kullanılır. Üretim senaryosunda, sorgu parametresini veya değişken tanımını kullanıcının adını zaten depolayan başka bir değişkene aktarabilirsiniz (örneğin, oturum açma komut dosyasındaki kullanıcı adına sahipseniz).

Değişkenleri ve tanımlarını aracının URL'sine, sorgu dizesi parametreleri olarakbotURL?variableName1=variableDefinition1&variableName2=variableDefinition2 biçimde ekleyin.

Örneğin:

• Global.UserName adında bir global değişkeniniz var.
• Aracınızın URL'si: https://web.powerva.microsoft.com/webchat/bots/12345.
• Web sitenizde aracı konuşması başlatırken kullanıcı adını geçmek için UserName= sorgu dizesini şu şekilde ekleyin: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana

Parametre adı büyük/küçük harfe duyarlı değildir. username=Ana bu örnekte de işe yarayacaktır.

Klasik / Takımlar

Aracınızı basit bir web sitesine ekliyorsanız değişkenleri ve tanımlarını basitçe ekleyebilirsiniz veya değişkenleri programlama yoluyla çağırmak ve kullanmak için bir <script> kod bloku kullanabilirsiniz.

Not

Sorgu dizesindeki değişken adı, global değişkenin adından bot. önekinin çıkartılmış haliyle eşleşmelidir. Örneğin, global değişken bot.UserEmail, UserEmail= olarak görünmelidir.

Burada verilen örneklerde değişkenler için basit açıklamalar yapılır. Üretim senaryosunda, sorgu parametresini veya değişken tanımını kullanıcının adını zaten depolayan başka bir değişkene aktarabilirsiniz (örneğin, oturum açma komut dosyasındaki kullanıcı adına sahipseniz).

1. Değişkenleri ve tanımlarını aracının URL'sine sorgu dizesi parametreleri (botURL?variableName1=variableDefinition1&variableName2=variableDefinition2 biçiminde) olarak ekleyin. Örneğin:

   • bot.UserEmail adında bir global değişkeniniz var.
   • Aracınızın URL'si: https://web.powerva.microsoft.com/webchat/bots/12345.
   • Web sitesinde bir aracı konuşması başlatırken kullanıcı adını iletmek için UserEmail= sorgu dizesini https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com olarak ekleyebilirsiniz.

2. Parametre adı büyük/küçük harfe duyarlı değildir. Bu, useremail=Ana@contoso.com değişkeninin bu örnekte de çalışacağı anlamına gelir.

Özel tuvale genel değişkenler ekleme

Ayrıca özel tuvale değişken ekleyebilirsiniz.

Web uygulaması

1. Aracınızın bulunduğu sayfadaki <script> bölümünde değişkenleri aşağıdaki gibi tanımlayın, değişken adı için variableName1 öneki olmadan Global. değişkenini ve tanım için variableDefinition1 değişkenini kullanın. Birden çok değişkeni virgül (,) ile ayırın.

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. <script> bölümünüzde aracınızı katıştırdığınızda store değişkenini çağırın; önceki örnekte store değişkeninin çağrıldığı yerin hemen üzerinde styleOptions değişkeninin çağrıldığı gibi (BOT_ID aracınızın kimliğinizle değiştirmeniz gerekir):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

Klasik / Takımlar

1. Aracınızın bulunduğu sayfadaki <script> bölümünde değişkenleri aşağıdaki gibi tanımlayın, değişken adı için variableName1 öneki olmadan bot. değişkenini ve tanım için variableDefinition1 değişkenini kullanın. Birden çok değişkeni virgül , ile ayırın.

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. <script> bölümünüzde aracınızı katıştırdığınızda store değişkenini çağırın; önceki örnekte store değişkeninin çağrıldığı yerin hemen üzerinde styleOptions değişkeninin çağrıldığı gibi (BOT_ID kimliğinizle değiştirmeniz gerekir):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

Kimlik doğrulamasıyla ilgili global değişkenleri

Aracının kimlik doğrulaması kurulumuna bağlı olarak kullandığınız kimlik sağlayıcısıyla ilişkili global değişkenleri kümesine sahip olabilirsiniz. Hangi değişkenler kümesinin kullanılabileceği ve bunları nasıl kullanabileceğiniz hakkında ayrıntıları öğrenmek için Konulara kullanıcı kimlik doğrulaması ekleme bölümünü inceleyin.

---

İlgili içerik

• Değişkenlerle çalışma
• Bir aracının görünümünü özelleştirme