Tworzenie wyrażeń regularnych za pomocą usługi Power Fx

Ważne

Możliwości i funkcje Power Virtual Agents są teraz częścią Microsoft Copilot Studio w wyniku znacznych inwestycji w generatywną AI i poprawioną integracje z Microsoft Copilot.

Niektóre artykuły i zrzuty ekranów mogą odwoływać się do Power Virtual Agents podczas aktualizowania dokumentacji i zawartości szkoleniowej.

Power Fx to język z małą ilością kodu, który używa formuł podobnych do formuł programu Excel. Zastosowanie Power Fx do tworzenia złożonej logiki pozwalającej pomocnikom pracę z danymi. Na przykład formuła Power Fx może ustawić wartość zmiennej, przeanalizować ciąg lub użyć wyrażenia w warunku. Aby uzyskać więcej informacji, zobacz omówienie języka Power Fx i dokumentację formuł.

Uwaga

Formuły Power Fx w usłudze Microsoft Copilot Studio używają numerowania w stylu amerykańskim. To oznacza, że separator dziesiętny to kropka, na przykład 12,567.892. Oznacza to również, że parametry języka Power Fx muszą być rozdzielone przecinkami (,).

Wymagania wstępne

• Tworzenie i edytowanie tematów
• Używanie zmiennych

Użyj zmiennych w formule

Aby używać zmiennej w formule Power Fx, należy dodać prefiks do jego nazwy, aby wskazać zakres zmiennej:

• Dla zmiennych systemowych użyj System.
• Dla zmiennych globalnych użyj Global.
• Dla zmiennych tematycznych użyj Topic.

Aby na przykład użyć zmiennej systemowej Conversation.Id w formule, należy odwołać się do tej zmiennej jako System.Conversation.Id.

Używanie wartości literałów w formule

Oprócz używania zmiennych w formułach Power Fx można wprowadzać wartości literałów. Aby użyć wartości literału w formule, należy wprowadzić ją w formacie odpowiadającym jej typowi. W poniższej tabeli przedstawiono typy danych i format ich odpowiednich wartości literałów.

Type	Przykłady formatów
String	"hi", "hello world!", "copilot"
Wartość logiczna	Tylko true lub false
telefonu	1, 532, 5.258, -9201
Table	[1], [45, 8, 2], ["cats", "dogs"]
Nagraj	{ 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")
Opcja wyboru	Nieobsługiwane
Pusta	Tylko Blank()

Użyj Power Fx, by ustawić wartość zmiennej

W tym przykładzie użyjemy wyrażenia Power Fx do przechowywania nazwy klienta i zapisywania danych wyjściowych wielkimi literami.

1. Utwórz temat i dodaj węzeł Pytanie.

2. W polu Wprowadź komunikat wprowadź What is your name?.

3. W obszarze Zidentyfikuj wybierz encję Imię i nazwisko osoby.

4. Zaznacz pole w obszarze Zapisz odpowiedź jako, a następnie wybierz zmienną Var1 i nadaj jej nazwę customerName.

   

5. W węźle Pytanie wybierz + i wybierz pozycję Ustaw wartość zmiennej.

6. Zaznacz pole w obszarze Ustaw zmienną, a następnie wybierz pozycję Utwórz nową i nadaj jej nazwę capsName.

7. W polu Do wartości wybierz strzałkę >, a następnie wybierz kartę Formuła.

8. W polu fx wprowadź Upper(Text(Topic.customerName)), a następnie wybierz pozycję Wstaw.

   

9. W węźle Pytanie wybierz + i wybierz pozycję Wyślij wiadomość.

10. Wprowadź HELLO , wybierz {x}, a następnie wybierz capsName.

    

Używanie formuły Power Fx jako warunku

Aby oceniać bardziej złożone warunki, należy skonfigurować węzły Warunek w celu używania formuł Power Fx.

W tym przykładzie pomocnik decyduje o tym, czy data rezerwacji kwalifikuje się do rabatu. W tym celu sprawdza, czy podany przez klienta data rezerwacji to 14 dni lub więcej od aktualnej daty.

1. Utwórz temat i dodaj węzeł Pytanie.

2. W polu Wprowadź komunikat wprowadź Booking date?.

3. W obszarze Zidentyfikuj wybierz encję Data i godzina.

4. Zaznacz pole w obszarze Zapisz odpowiedź jako, a następnie wybierz zmienną Var1 i nadaj jej nazwę bookingDate.

   

5. Wybierz ikonę znaku +, a następnie wybierz Dodaj warunek.

6. W węźle Warunek wybierz menu węzła (⋮), a następnie wybierz Zmień na formułę.

   

7. W polu Funkcja wybierz strzałkę >, a następnie wybierz kartę Formuła.

8. Zastąp zawartość pola fx formułą Topic.bookingDate > (DateAdd (Now(), 14)), a następnie wybierz Wstaw.

9. W obszarze węzła Warunek dodaj węzeł Wyślij wiadomość i wprowadź wiadomość You qualify for a discount.

10. W obszarze węzła Wszystkie inne warunki dodaj węzeł Wyślij wiadomość i wprowadź wiadomość Sorry, you don't qualify for a discount.