Değişkenlerle çalışma

Müşterilerin yanıtlarını depolamak ve konuşmanın devamında içeriklerini yeniden kullanmak için değişkenleri kullanabilirsiniz.

Müşteriye farklı konuşma yollarını dinamik olarak yönlendiren mantıksal ifadeler oluşturmak için de değişkenler kullanabilirsiniz. Örneğin, bir müşterinin adını "customerName" adlı bir değişkene kaydettiğinize aracı, konuşma devam ederken müşteriye adıyla hitap edebilir.

Değişkenler ayrıca diğer konulara ve Power Automate akışlarına da aktarılabilir ve bunlardan döndürülebilir.

Değişken oluşturma

Web uygulaması

Soru düğümü gibi bir çıkış döndüren herhangi bir düğüm, otomatik olarak uygun türde bir çıkış değişkeni oluşturur.

Bahşiş

Düğümleri daha kolay tanımlayacak şekilde yeniden adlandırın. İsim doğrudan güncellemek için düğümün adı alanını seçin veya düğümün üç noktasını (...) seçip menüden Adını Değiştir'i seçin. Ayrıca kod düzenleyicide düğümleri yeniden adlandırabilirsiniz.

Tetikleyici düğümlerini ve Adıma git düğümlerini yeniden adlandırmak mümkün değildir.

Düğüm adlarının uzunluğu en fazla 500 karakter olabilir.

Klasik

1. Klasik sohbet botunuzun Konular sayfasına gidin ve istediğiniz konuyu açın.

2. Soru düğümü eklemek istediğiniz düğümün altındaki Düğüm ekle simgesini seçin ve ardından Soru sor'a tıklayın. Kullanıcının yanıtını depolamak için otomatik olarak bir değişken oluşturulur.

   

Kullanılacak bir varlık seçme

Web uygulaması

Soru düğümleri, varsayılan olarak, soru düğümü çoktan seçmeli seçeneklerle oluşturulur. Önceden oluşturulmuş veya özel bir varlık kullanmak için Tanımla kutusunu seçin ve ardından istenen bilgi türünü seçin.

Klasik

Soru düğümleri, varsayılan olarak, soru düğümü çoktan seçmeli seçeneklerle oluşturulur. Önceden oluşturulmuş veya özel bir varlık kullanmak için Tanımla kutusunu seçin ve ardından istenen bilgi türünü seçin.

Değişkeni yeniden adlandırma

Web uygulaması

Değişkenler oluşturulduğunda, bunlara otomatik olarak bir ad atanır. En iyi yöntem, aracınızın bakımını yapması gereken herkese amaçlarını açıkça ifade etmek için değişkenlerinize anlamlı adlar vermektir.

1. Değişkenini seçin. Değişken özellikleri paneli görünür.

2. Değişken adı'nın altında değişkeniniz için istediğiniz adı girin.

Klasik

Otomatik olarak oluşturulan değişkenler varsayılan bir adla gelir. Bir değişkeni yeniden adlandırmak için, değişkenin adını seçin, Değişken özellikleri paneline istediğiniz adı girin ve değişikliğinizi kaydedin.

Değişken ayarla

Genellikle, kullanıcı girişini bir değişkende kaydetmek için bir Soru düğümü kullanırsınız. Ancak, bir değişkenin değerini kendiniz ayarlamak istediğiniz durumlar olabilir. Bu durumda bir Değişken değeri ayarla düğümü kullanın.

1. Eklemek istediğiniz bir Değişken değeri ayarla düğümünün ardından, düğümün altındaki Düğüm ekle simgesini seçin.

2. Değişken yönetimi>Değişken değeri ayarla'yı seçin. Tuvalde Değişken değeri ayarla düğümü görüntülenir.

3. Değişken ayarla altındaki kutuyu ve sonra Yeni değişken oluştur'u seçin. Yeni değişken oluşturulur. Bir değere atanana kadar türü bilinmez olur.

   

4. Değere seçeneği için, aşağıdaki seçeneklerden birini kullanarak bir değer atayın:

   • Değişmez değer yazın.
   • Aynı türde varolan bir değişken seçin.
   • Power Fx formülü kullanın. Power Fx formülleri, Tablo ve Kayıt türleri gibi sabit değişmez değerlerin kullanılamadığı daha karmaşık türler için yararlıdır.

Eylem düğümlerinde değişkenleri kullanma

Bir Eylem düğümünde değişken kullandığınızda, temel türü bir akış için veya Bot Framework becerisi için belirtilen parametre türüyle eşleşiyorsa, bunu bu parametreye besleyebilirsiniz. Eylem düğümlerinin çıkışı yeni değişkenler oluşturur.

Daha fazla bağlam için, bir konudan aracı akışı çağırma ve Bilgi geçirmek için giriş ve çıkış değişkenlerini kullanma başlığındaki örnek senaryolara bakın.

Değişken girdilerde değişmez değerleri kullanın

Giriş parametreleri için bir değer ayarlayabildiğiniz düğümlerde, değer olarak başka bir değişken seçmek yerine her zaman değişmez bir değer girebilirsiniz.

Düğüm, değişmez değerleri dize, sayı veya Boole olarak yorumlamaya çalışır. Örneğin, 123 sayı olarak yorumlanır. Bunun yerine bir dize değeri olarak yorumlanmasını istiyorsanız bu değeri şu şekilde çift tırnak içine alabilirsiniz: "123".

Bazı senaryolarda (örneğin, karmaşık türlerin kullanıldığı senaryolar), belirli bir türü ayarlamak için Power Fx formülünü kullanmanız gerekebilir.

Azure Key Vault gizli dizileri için ortam değişkenlerini kullanma

Bir ortam değişkeni Key Vault'taki bir gizli diziye başvurabilir. Gizli ortam değişkenleri, benzersiz dikkat edilmesi gereken noktalara sahip ortam değişkenlerinin özel bir durumudur.

Power Apps portalında gizli bir ortam değişkeni oluşturmak için kendi Key Vault'unu yapılandırmanız gerekir.

Copilot Studio'in bu Key Vault'u okumasına yetki vermek için aşağıdaki işlemleri gerçekleştirmelisiniz:

1. Key Vault Gizli Diziler Kullanıcı rolünü Microsoft Copilot Studio Hizmeti uygulamasına atayın.

2. Ortamdaki tüm ajanların gizliye erişimine izin vermek için gizlide bir etiket AllowedEnvironments oluşturun ve izin verilen ortam kimliklerini virgülle ayırarak ekleyin.

3. Ortamdan yalnızca belirli aracıları bu Key Vault'u kullanma yetkisi vermek için bir etiket AllowedAgents oluşturun ve aracı tanımlayıcısını biçime {envId}/{schemaName} yerleştirin. Birden fazla değer için değerleri virgülle ayırın.

   Maksimum karakter sayısına ulaşıyorsanız ancak daha fazla aracı eklemeniz gerekiyorsa, açıklayıcı ancak benzersiz bir adla başka bir etiket ekleyin (örneğin: AllowedAgents2).

Gizli dizi değeri Diyalog çalışma zamanında beş dakika boyunca önbelleğe alınır. Başarısız okumalar 30 saniye boyunca önbelleğe alınır.

Uyarı

Aracıya gizli anahtarı ekleyerek bu gizli anahtarın değerini açığa çıkarabilirsiniz. Aracıyı ortamda düzenleyebilen herkes bir İleti düğümü ekleyebilir ve gizli ortam değişkenlerinin değerini bir iletide döndürebilir.

Değişkenler paneli

Web uygulaması

Değişkenler paneli, hangi düğümlerde tanımlandıklarına veya kullanıldıklarına bakılmaksızın bir konu için kullanılabilen tüm değişkenleri görüntüleyebileceğiniz yerdir. Her değişkenin değerini diğer konulardan alıp almayacağını, değerini diğer konulara veya her ikisini birden alacağını seçebilirsiniz. Bir değişkeni seçebilir ve özelliklerini Değişken özellikleri panelinde düzenleyebilirsiniz.

Değişkenler panelini açmak için konunun menü çubuğunda Değişkenler'i seçin.

Klasik

Değişkenler paneli, hangi düğümlerde tanımlandıklarına veya kullanıldıklarına bakılmaksızın bir konu için kullanılabilen tüm değişkenleri görüntüleyebileceğiniz yerdir. Her değişkenin değerini diğer konulardan alıp almayacağını, değerini diğer konulara veya her ikisini birden alacağını seçebilirsiniz. Bir değişkeni seçebilir ve özelliklerini Değişken özellikleri panelinde düzenleyebilirsiniz.

1. Konunun menü çubuğunda Değişkenler'i seçin.

   

2. Konudaki değişkenlerin her biri için değerlerin konular arasında iletilmesini mi, konulardan alınmasını mı yoksa her ikisini birden mi istediğinizi seçin.

   

Değişken özellikleri paneli

Değişken özellikleri panelinde bir değişkeni yeniden adlandırabilir, aracınızın kullandığı yeri görebilir veya genel değişkene dönüştürebilirsiniz. Bununla birlikte, genel bir değişkeni tekrar konu değişkenine dönüştüremezsiniz. Ayrıca, bir konu değişkeninin diğer konulardan değer alıp alamayacağını veya değerini diğer konulara geçirip geçiremeyeceğini de seçebilirsiniz.

Bir değişkenin Değişken özellikleri panelini açmak için, istediğiniz değişkeni Değişkenler panelinde seçin. Değişken özellikleri panelini, değişkenleri kullanan herhangi bir düğümden istediğiniz değişkeni seçerek de açabilirsiniz.

Konular arasında değişkenleri ilet

Bir konuyu başka bir konuya yeniden yönlendirdiğinizde, değişkenlerin değerlerini kaynak konudan hedef konuya geçirebilir ve ayrıca hedef konudan kaynak konuya değer döndürebilirsiniz. Konular arasında değişkenler iletmek, sonraki konunun ihtiyaç duyduğu bilgilere zaten sahip olan bir eski konu olduğunda özellikle yararlıdır. Kullanıcılarınız aynı soruları birden çok kez yanıtlamak zorunda kalmadan kesinlikle memnun olur.

Diğer konulardan değer alın

Konu, bir değişkeni tanımladığında (örneğin, bir Soru düğümü ile) aracı, kullanıcıya değişkenin değerini doldurması için soru sorar. Aracı, değeri daha önceki bir konuda edinmişse, soruyu tekrar sormanın bir anlamı yoktur. Bu gibi durumlarda değişkeni Diğer konulardan değer al olarak ayarlayabilirsiniz. Başka bir konu bu konuya yeniden yönlendirdiğinde bir değişken (veya değişmez değer) bu değişkenin değerini aktarılabilir ve soru atlanabilir. Aracıyla konuşan kullanıcıya sorunsuz bir deneyim sağlanır.

Web uygulaması

Bu örnekte, Karşılama ve Müşteriyle Konuşma olmak üzere iki konu kullanıyoruz. Her iki konu da müşterinin adını sorar. Ancak, Selamlama konusu önce çalışırsa, Müşteri ile Konuşma konusu bu soruyu atlar. Bunun yerine, Karşılama konusundan geçirilen değişkenin değerini kullanır.

Müşteri ile Konuşma konusu akışı şöyledir:

Test panelinde gösterildiği gibi, önce bu konu tetiklenirse, kullanıcıya "Size ne demeliyim?" diye sorar. Değeri, customerName adlı bir dize değişkeninde depolar. customerName değişkeni, değerini diğer konulardan alacak şekilde de ayarlanır. Konu, "Umarım harika bir gün geçiriyorsunuz, customerName!" mesajıyla sona eriyor.

Selamlama konusu akışı şöyledir:

Test panelinde gösterildiği gibi, önce bu konu tetiklenirse, kullanıcıya "Adınız ne?" diye sorar. Değeri, customerName adlı bir dize değişkeninde depolar. Konu, "Tanıştığımıza memnun oldum, customerName!" mesajını gönderir. Daha sonra, "Umarım harika bir gün geçiriyorsunuzdur, customerName!" mesajını gönderen Müşteri ile Konuş konusuna yönlendirilir. Ancak, Müşteri ile Konuş konusunun kullanıcının adını tekrar sormayı atladığını unutmayın. Bunun yerine, Karşılama konusundan geçirilen customerName değişkeninin değerini kullanır.

Son olarak da bu ikinci görüşmeyi, Müşteri ile Konuşma konusu açısından tekrar göreceğiz:

Diğer konulardan değer almak için bir konu ayarlamak için gereken adımları gözden alalım. Örnek senaryomuzda, kaynak konu olarak önceden tanımlanmış Karşılama konusu ve hedef konu olarak yeni bir konu olan Müşteriyle Konuşma kullanılmaktadır, ancak aynı adımlar, mümkün olduğunda önceki bir konudan bir değer kullanması gereken tüm konular için geçerlidir.

Varış konu ayarlama

Hedef konu, yönlendirilen ve diğer konulardan değer alan konudur. Bizim örneğimizde bu Müşteri ile Konuşmadır.

1. Yeni bir konu oluşturun ve buna "Müşteriyle Konuşma" adını verin.

2. "Konuş benimle", "konuş benimle", "benimle sohbet et" gibi tetikleme tümcecikleri ekleyin.

3. Bir Soru düğümü ekleyin ve ileti için "Size ne demeliyim?" ifadesini girin.

4. Tanımla altında, önceden oluşturulmuş Kişi adı varlığını seçin.

5. Değişkenin adını seçin. Değişken özellikleri paneli açılır.

6. Varsayılan adı "customerName" ile değiştirin ve ardından Diğer konulardan değer al'ı seçin.

   

7. Bir İleti düğümü seçin.

8. Mesaj kutusuna "Umarım harika bir gün geçiriyorsundur" yazın.

9. Değişken Ekle simgesini ({x}) seçin ve ardından customerName öğesini seçin.

10. Değişkenden sonraki boşluğu seçin ve "!" girin.

11. Konuyu kaydedin.

Kaynak konuyu ayarlama

Kaynak konu, yeniden yönlendirmeyi yapan, değeri sağlayan ve hedef konuya ileten konudur. Örneğimizde bu Selamlamadır.

1. Karşılama konusuna gidin ve Tetikleyici düğümünü silin.

2. Bir Soru düğümü ekleyin ve ileti için "Adınız ne?" ifadesini girin.

3. Tanımla altında, önceden oluşturulmuş Kişi adı varlığını seçin.

4. Varsayılan adı "customerNameFromGreeting" ile değiştirin.

5. Bir İleti düğümü seçin.

6. Mesaj kutusuna, "Tanıştığımıza memnun oldum, " yazın.

7. Değişken Ekle simgesini ({x}) seçin ve ardından customerNameFromGreeting öğesini seçin.

8. Değişkenden sonraki boşluğu seçin ve "!" girin.

9. Bir Yeniden Yönlendirme düğümü ekleyin ve Müşteriyle Konuşma hedef konusunu seçin.

10. Giriş ekle'yi seçin ve sonra değer iletmek istediğiniz hedef konudan değişkeni seçin.

    

11. > simgesini seçin ve ardından değerini geçirmek istediğiniz değişkeni seçin, bu örnekte customerNameFromGreeting.

    Yeniden yönlendirme düğümünün aşağıdaki gibi görünmesi gerekir:

    

12. Konuyu kaydedin.

Klasik

Diğer konulardan değerler almak için değişkenin özelliğini ayarlayın:

1. Soru düğümünde, diğer konulardan değer almak istediğiniz değişkeni seçin.

2. Değişken özellikleri panelinde, Konu (sınırlı kapsam) altında Diğer konulardan değer al'ı seçin.

   

   Not

   Tarih ve saat, Süre veya Çoktan seçmeli türündeki değişkenler ve özel bir varlığı temel alan değişkenler konular arasında geçirilemez.

3. Konuyu kaydedin.

4. Yeniden yönlendirmek istediğiniz bir konuya gidin. Doğru konuya yeniden yönlendirmek için Başka bir konuya yeniden yönlendirme bölümündeki adımları izleyin.

5. Hedef konu için giriş ekle'yi seçin.

   

6. Yeniden yönlendirilen konuda, iletmek istediğiniz değişkeni seçin.

   

7. Bir değer girin veya seçin bölümünde, geçerli konudan yönlendirilen konuya iletmek istediğiniz değişkeni seçin.

   

   Değişken, yeniden yönlendirilen düğümde gösterilir.

   

Değerleri özgün konulara döndürün

Bir aracıda, konu belirli bir bilgi parçasını toplamak içindir. Diğer birçok konu bunu çağırabilir ve bilgileri değişken olarak döndürmesini bekleyebilirsiniz. değişkeni, kaynak konunun bir parçası olur ve diğer değişkenler gibi kullanılabilir. Aracının elde ettiği bilgiler, genel değişkenlere olan gereksinimi azaltarak konular arasında kullanılabilir.

Web uygulaması

Önceki bölümdeki örnek ile devam edelim. Müşteriyle Konuşma konusunda yeni bir soru soruyoruz ve ardından yanıtı Karşılama konusuna döndürüyoruz.

Verilen bir değişken için kaynak konu ayarlama

Bir konuya değişken döndürürken, kaynak konu, özgün konuya geri dönmek için gereken değeri sağlayan konudur. Müşteriyle Konuşma bu örnekte kaynak konudur.

1. Kaynak konuya gidin.

2. Bir Soru düğümü ekleyin ve ileti için "Hangi şehirde yaşıyorsunuz?" ifadesini girin.

3. Tanımla altında, önceden oluşturulmuş Şehir varlığını seçin.

4. Değişken özellikleri panelini açmak için değişkeni seçin. "customerCity" olarak adlandırın ve ardından Değerleri orijinal konulara döndür'ü seçin.

   

5. Bir İleti düğümü seçin.

6. Değişken Ekle simgesini ({x}) seçin ve ardından customerCity öğesini seçin.

7. Mesaj kutusundaki değişkenden sonra "yılın bu zamanında güzel olmalı!" yazın.

8. Konuyu kaydedin.

Verilen bir değişken için hedef konu ayarlama

Bir konuya değişken döndürürken, hedef konu geçerli konudan değer alan konudur. Örneğimizde, hedef konu Karşılama'dır.

1. Hedef konuya gidin.

2. Kaynak konuda seçtiğiniz değişken, Yeniden Yönlendirme düğümünde bir çıkış değişkeni olarak görünmelidir.

   

3. Konuyu kaydedin.

Klasik

Değişkeni orijinal konuya döndürmek için değişkenin özelliğini ayarlayın:

1. Soru düğümünde, diğer konulardan değer almak istediğiniz değişkeni seçin.

2. Değişken özellikleri panelinde Konu (sınırlı kapsam) altında Değerleri özgün konulara döndürün'ü seçin.

   

   Not

   Tarih ve saat, Süre veya Çoktan seçmeli türündeki değişkenler ve özel bir varlığı temel alan değişkenler konular arasında geçirilemez.

3. Konuyu kaydedin.

4. Yeniden yönlendirmek istediğiniz bir konuya gidin. Doğru konuya yeniden yönlendirmek için Başka bir konuya yeniden yönlendirme bölümündeki adımları izleyin.

   Konuya döndürülen değişken, yeniden yönlendirilen konuda gösterilir. Konunuzda döndürülen değişkeni kullanın.

   

Değerleri ayrıştırma

Değeri ayrıştır düğümü, bir türdeki değeri başka bir türdeki değere dönüştürmenize olanak tanır. Ayrıştırma değeri düğümü için yaygın bir kullanım örneği, ham JSON'yi dönüştürmektir. Örneğin, bir ajan bir akışı çağırır ve ardından bu da bir API çağırır. Ardından API bir sonuç döndürür. Şimdi bu sonucu ayrıştırmak ve bir veya daha fazla temel değişken döndürmek için bir yol gerekir. Ayrıştır değer düğümüyle, API sonucunun tamamını aşağıdaki gibi bir dize olarak gönderebilirsiniz:

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

Ayrıştırma değeri düğümü, şimdi sahip olduğunuz dize değişkenini, Power Fx düzenleyicisinin IntelliSense kod tamamlama ve öneriler sağladığı Kayıt türünde bir değişkene dönüştürebilir.

JSON dizelerini ayrıştırmaya ek olarak, Ayrıştırma değer düğümünün anahtar kullanımı, yazılmamış nesneleri çalışma zamanında ayrıştırmaktır. En yaygın kullanım örneği, bir olay aldığınızda olay değerini ayrıştırmanız gerektiğidir. Veya System.Activity.ChannelData özelliğini, çalışma zamanında kanala göre değişen bir özellik olarak ayrıştırmak isteyebilirsiniz.

Teams'den gelen bir etkinlikle ilgili bilgileri ayrıştırmanız gerekiyorsa, beklenen etkinliğin nasıl görünebileceğine ilişkin bir örnek bulmak için Teams geliştirici belgelerine bakın. Ardından örnek olayı örnek veri olarak kullanarak bu bölümdeki yönergeleri izleyebilirsiniz.

Bir konuya Ayrıştırma değeri düğümü eklemek için:

1. Bir değeri ayrıştırmak istediğiniz düğümün altındaki Düğüm ekle simgesini seçin, Değişken yönetimi'nin üzerine gelin ve Değeri ayrıştır'ı seçin.

2. Değeri ayrıştır düğümü ekleyin ve ayrıştırmak istediğiniz değişkeni seçin.

   

3. Veri türünü seçin. Bu durumda Örnek Verilerden seçeneğini belirleyin.

   

4. Örnek JSON'dan Şema Al'ı seçin, açılan düzenleyicide istenen JSON örneğini girin ve Onayla'yı seçin.

   

5. Son olarak, ayrıştırılan değeri tutmak için değişkeni seçin. Genellikle yeni bir değişken oluşturursunuz.

   

   Çıkış değişkeni artık beklenen türe sahiptir: kayıt.

   

İlgili içerik

• Değişkenlere genel bakış
• Global değişkenlerle çalışma
• Aracılarda varlıkları kullanma ve yuva doldurma
• Aracının görünümünü ve tarzını özelleştirme