Power Fx kullanarak ifadeler oluşturma

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Power Fx, Excel benzeri formüller kullanan düşük kodlu bir dildir. Aracılarınızın verileri işlemesine olanak tanıyan karmaşık mantık oluşturmak için Power Fx kullanın. Örneğin Power Fx formülü, bir değişken değeri belirleyebilir, bir dizeyi ayrıştırabilir veya bir koşulda bir ifade kullanabilir. Daha fazla bilgi edinmek için bkz. Power Fx genel görünümü ve formül referansı.

Note

Copilot Studio'daki Power Fx formüllerinde ABD stili numaralandırma kullanılır. Yani 12,567.892 örneğinde olduğu gibi ondalık ayracı noktadır. Bu, , olarak virgül () kullanmanız gerektiği anlamına gelir.

Prerequisites

• Konuları oluşturma ve düzenleme
• Değişkenlere genel bakış

Formülde değişkenleri kullanma

Power Fx formülünde değişken kullanmak için, değişkenin kapsamını belirtmek için adına bir ön ek eklemeniz gerekir:

• Sistem değişkenleri için System.'i kullanın.
• Global değişkenler için Global.'i kullanın.
• Konu değişkenleri için Topic.'i kullanın.
• Çevre değişkenleri içinEnvironment.

Örneğin, Conversation.Id sistem değişkenini bir formülde kullanmak için System.Conversation.Id olarak sistem değişkenine başvurun.

Formülde sabit değerleri kullanma

Power Fx formülünde değişkenleri kullanmanın yanı sıra sabit değerler de girebilirsiniz. Formülde bir değişmez değer kullanmak için değeri, türüne karşılık gelen formatta girmeniz gerekir. Aşağıdaki tabloda veri türleri ve karşılık gelen hazır bilgi değerlerinin biçimi listelenmektedir.

Türü	Format örnekleri
String	"hi", "hello world!", "copilot"
Boolean	Yalnızca true veya false
Number	1, 532, 5.258,-9201
Kayıt ve Tablo	[1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
DateTime	Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Seçenek	Desteklenmiyor
Boş	Sadece Blank()

Ortak Power Fx formülleri

Aşağıdaki tabloda, her veri türüyle kullanabileceğiniz veri türleri ve Power Fx formülleri listelenmiştir.

Türü	Power Fx formülleri
String	Text işlevi Concat ve Concatenate işlevleri Len işlevi Lower, Upper ve Proper işlevleri IsMatch, Match ve MatchAll işlevleri EndsWith ve StartsWith işlevleri İşlev bul Değiştir ve Yerine Koy işlevi
Boolean	Boole işlevi And, Or ve Not işlevleri If ve Switch işlevleri
Number	Decimal, Float ve Value işlevleri Int, Round, RoundDown, RoundUp ve Trunc işlevleri
Kayıt ve Tablo	Concat ve Concatenate işlevleri Count, CountA, CountIf ve CountRows işlevleri ForAll işlevi First, FirstN, Index, Last ve LastN işlevleri Filter, Search ve LookUp işlevleri JSON işlevi ParseJSON işlevi
DateTime	Date, DateTime ve Time işlevleri DateValue, TimeValue ve DateTimeValue işlevleri Day, Month, Year, Hour, Minute, Second ve Weekday işlevleri Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday işlevleri DateAdd, DateDiff ve TimeZoneOffset işlevleri Text işlevi
Boş	Blank, Coalesce, IsBlank ve IsEmpty işlevleri Error, IfError, IsError, IsBlankOrError işlevleri

Bir değişken ayarlamak için Power Fx kullanma

Bu örnekte, Power Fx ifadesi müşterinin büyük harflerle yazılmış adını depolar ve çıktısını verir.

1. Konu oluşturun ve Soru düğümü ekleyin.

2. İleti girin bölümüne "What is your name?" sorusunu girin.

3. Tanımla altında, varlık Kişi adını seçin.

4. Kullanıcı yanıtını farklı kaydet altındaki kutuyu seçin ve ardından Var1 değişkenini seçip customerName olarak adlandırın.

5. Soru düğümü altında + öğesini seçin ve sonra Değişken değeri olarak ayarla'yı seçin.

6. Değişken ayarla altındaki kutuyu ve sonra Yeni değişken oluştur'u seçin ve adını capsName yapın.

7. Hedef değer kutusunda, > okunu seçin ve sonra Formül sekmesini seçin.

8. fx kutusunda Upper(Text(Topic.customerName)) yazın ve sonra Ekle'yi seçin.

   

9. Soru düğümünün altında + öğesini ve sonra Bir ileti gönder'i seçin.

10. "HELLO" yazın, {x} öğesini seçin, ardından capsName öğesini seçin.

    

Power Fx formülünü koşul olarak kullanma

Daha karmaşık ifadeleri değerlendirmek için Power Fx formüllerini kullanmak üzere Koşul düğümlerini ayarlayın.

Bu örnekte aracı, bir rezervasyon tarihinin indirim için uygun olup olmadığını belirler. Bunu yapmak için müşteri tarafından sağlanan rezervasyon tarihinin geçerli tarihten 14 gün veya daha fazla olup olmadığını kontrol eder.

1. Konu oluşturun ve Soru düğümü ekleyin.

2. Bir ileti girin alanına"Booking date?" sorusunu girin.

3. Tanımla altında, varlık Tarih ve saat seçin.

4. Kullanıcı yanıtını farklı kaydet altındaki kutuyu seçin ve ardından Var1 değişkenini seçip bookingDate olarak adlandırın.

   

5. Soru düğümünün altında Düğüm ekle simgesini seçin, ardından Koşul ekle'yi belirleyin.

6. Condition düğümündeki üç noktayı (...) seçin ve ardından Formüle Dönüştür'ü seçin.

7. İşlev kutusunda, > okunu seçin ve sonra Formül sekmesini seçin.

8. fx kutusunun içeriklerini Topic.bookingDate > (DateAdd (Now(), 14)) formülü içeriği ile değiştirin ve sonra Ekle'yi seçin.

9. Koşul düğümünde, bir İleti düğümü ekleyin ve "İndirim almaya hak kazandınız." iletisini girin.

10. Diğer tüm koşullar düğümünde, bir İleti düğümü ekleyin ve "Üzgünüz, indirim almaya uygun değilsiniz." iletisini girin.