Global değişkenlerle çalışma

Değişkenler müşterilerinizin temsilcinizin sorularına verdiği yanıtları saklar. Ö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, değişkenin değerini yalnızca değişkeni oluşturduğunuz konu başlığında kullanabilirsiniz. Ancak, bir değeri birden çok konu başlığında yeniden kullanmak isteyebilirsiniz. Örneğin, "Hoş Geldiniz" konusu, müşterinin adını ve e-posta adresini sorar. Randevu Oluşturma konusunda, temsilcinin müşterinin daha önce verdiği bilgileri hatırlamasını ve bunları tekrar sormamasını istiyorsunuz.

Değişkeni bir konudan diğerine geçirerek bir değişkeni yeniden kullanabilirsiniz. Değişkeni genel kapsamlı hâle de getirebilirsiniz. Bu makale genel değişkenleri kapsar. Bunlar genel değişkenler olarak adlandırılır çünkü bunlar tüm aracı genelindeki tüm konularda kullanılabilir. Ajanınız bunları harici kaynaklardan da ayarlayabilir.

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.

Note

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. Değişken adı, konu düzeyindeki değişkenlerden ayırt etmek için öneki Global. alır. Örneğin, değişkeni UserName olur Global.UserName.

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üzeyi değişkenlerinden ayırt etmek için öneki bot. alır. Örneğin, değişkeni UserEmail olur bot.UserEmail.

Global değişkenleri kullanma

Web uygulaması

İleti düğümünde veya Soru düğümünde ileti oluşturduğunuzda, konunun erişebileceği değişkenleri görüntülemek için {x} simgesini seçin. Ayrıca, komut istemlerini veya iş akışlarını çağıran Araç düğümlerinde genel değişkenleri de kullanabilirsiniz. Genel değişkenler , Özel sekmesinde tüm konu değişkenleriyle birlikte görünür. Değişkenler alfabetik olarak listelenir.

Klasik / Takımlar

İleti düğümünde veya Soru düğümünde ileti oluşturduğunuzda, konunun erişebileceği 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.

Genel değişken kullanan tüm konuları bulma

Bir genel değişkenin nerede tanımlandığını ve hangi diğer konuların bunu kullandığını bulabilirsiniz. Bu özellik, yeni bir aracı üzerinde çalışıyorsanız veya birden çok değişkeniniz ve karmaşık konu dallanmanız varsa kullanışlıdır.

Web uygulaması

1. Yazma tuvalinde veya Değişkenler panelinde istediğiniz genel 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.

• Genel değişkeni oluşturduğunuz düğüme doğrudan 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 genel değişkeni kaldırırsanız, konu başlıklarında bu değişkene yapılan başvurular olarak Unknowngösterilir. İşlemi onaylamadan önce genel 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. Ajanınızı yayımlamadan önce, artık silinmiş olan değişkeni kullanan tüm konuları kaldırdığınızdan ya da düzelttiğinizden emin olun.

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

Web uygulaması

Varsayılan olarak, genel değişken değeri oturum bitene kadar devam eder. Değişken değerlerini temizle düğümü, genel değişkenlerin değerlerini sıfırlar. Konuşmayı Sıfırla sistemi konusu bu düğümü kullanı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

Herhangi bir konudan genel değişkenlere erişebilirsiniz ve değerleri oturum boyunca devam eder.

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şken, başlatılmadan (veya "doldurulmadan") önce tetiklenirse, aracı ilk tanımlandığı konunun bölümünü, bu konu geçerli konudan farklı olsa bile, öncelikle tetikler ve ardından özgün konuya geri döner. 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 eylem uygularken genel 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ı

Ajanın belirli bir bağlamla sohbete başlamasını sağlamak için genel bir değişken kullanın ve değerini harici bir kaynaktan ayarlayın. Sitenizin kullanıcıların oturum açması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, müşterinin hangi hedeflere ulaşmak istediğini bilerek konuşmaya başlayabilmesi için bağlamı Dynamics 365 Customer Service'den bir aracıya aktarmaktır.

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

Note

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ılmış 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ı beklerken zaman aşımına uğrayıp Değişken değerini ayarla düğümünde belirlediğiniz 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.

   Müşteri Hizmetleri için Omnichannel'den gelen değişkenler için maksimum bekleme süresi olarak 10 saniyelik (10.000 ms) bir değer kullanın.

9. Değişken değeri ayarla düğümünde, zaman aşımına ulaşılırsa kullanılacak varsayılan değeri girin. Çalışma zamanında, aracınız 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.

Ajanınızı bu şekilde yapılandırdığınızda, test etmeye hazır olur. 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. Ajanınız, harici olarak ayarlanan bir değişkene erişmeye çalıştığında, değer gelene ya da zaman aşımı oluşana kadar duraklar. Gecikme süresini en aza indirmek için aracıları iyileştirme bölümünde daha fazla bilgi edinin.

Important

Bir konuşmanın normal akışı sırasında, aracınız aksi takdirde harici bir değerden 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ı sohbeti başlattığında, 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 genel 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, genel değişken Global.UserName için yalnızca UserName sorguda kullanın.

Aşağıdaki örneklerde değişkenler için temel bir bildirim kullanılır. Üretim senaryosunda, kullanıcının adını (örneğin, oturum açma betiğinden kullanıcı adına sahipseniz) sorgu parametresi veya değişken tanımı olarak depolayan başka bir değişken geçirebilirsiniz.

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.
• Ajanı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 çalışır.

Klasik / Takımlar

Aracınızı basit bir web sayfasına ekliyorsanız değişkenleri ve bunların tanımlarını ekleyebilirsiniz. Alternatif olarak, değişkenleri program aracılığıyla çağırmak ve kullanmak için bir <script> kod bloğu kullanabilirsiniz.

Note

Sorgu dizesindeki değişken adı, ön ek olmadan genel değişken adıyla bot. eşleşmelidir. Örneğin, global değişken bot.UserEmail, UserEmail= olarak görünmelidir.

Aşağıdaki örneklerde değişkenler için temel bir bildirim kullanılır. Üretim senaryosunda, kullanıcının adını (örneğin, oturum açma betiğinden kullanıcı adına sahipseniz) sorgu parametresi veya değişken tanımı olarak depolayan başka bir değişken geçirebilirsiniz.

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.
   • Ajanınızın URL'si: https://web.powerva.microsoft.com/webchat/bots/12345.
   • Bir web sitesinde aracı konuşması başlatırken kullanıcı adını geçirmek için sorgu dizesini UserEmail= şu şekilde ekleyin: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. Parametre adı büyük/küçük harfe duyarlı değildir: useremail=Ana@contoso.com bu örnekte de çalışır.

Ö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 Global. öneki olmadan variableName1 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 fonksiyonunu çağırın; aşağıdaki örnekte store fonksiyonunun çağrıldığı yerin öncesinde styleOptions fonksiyonunun çağrıldığı gibi (BOT_ID'yü aracınızın kimliği ile 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 bot. öneki olmadan variableName1 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 styleOptions değişkeninin çağrıldığı yerin hemen üzerinde store 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 ajanın görünümünü ve havasını özelleştirin