使用 Power Fx 建立使用運算式

重要

在對生成式 AI 進行大量投資並增強 Microsoft Copilot 的整合後，Power Virtual Agents 的功能和特性現已成為 Microsoft Copilot Studio 的一部分。

當我們更新文件和培訓內容時，某些文章和螢幕擷取畫面可能會參考 Power Virtual Agents。

Power Fx 是一種使用類似 Excel 公式的低程式碼語言。 使用 Power Fx 建立複雜的邏輯，使您的副手能夠操縱資料。 例如，Power Fx 公式可以設定變數的值、剖析字串，或在條件中使用運算式。 如需詳細資訊，請參閱 Power Fx 概觀和公式參考。

注意

Microsoft Copilot Studio 中的 Power Fx 公式使用美式編號。 也就是，小數點分隔符號為句號或圓點，如 12,567.892 中所示。 這意味著 Power Fx 參數必須以逗號 (,) 分隔。

先決條件

• 建立和編輯主題
• 使用變數

在公式中使用變數

若要在 Power Fx 公式中使用變數，變數名稱必須加上首碼以指示其範圍：

• 如果是系統變數，請使用 System.
• 如果是全域變數，請使用 Global.
• 如果是主題變數，請使用 Topic.

例如，要在公式中使用系統變數 Conversation.Id，您必須將其指稱為 System.Conversation.Id。

在公式中使用常值

除了在 Power Fx 公式中使用變數之外，您還可以輸入常值。 若要在公式中使用常值，您必須以其類型對應的格式輸入該值。 下表列出資料類型以及其對應常值的格式。

類型​	格式範例
字串	"hi"、"hello world!"、"copilot"
布林值	只有 true 或 false
數字	1、532、5.258、-9201
資料表	[1]、[45, 8, 2]、["cats", "dogs"]
錄製	{ id: 1 }、{ message: "hello" }、{ name: "John", info: { age: 25, weight: 175 } }
日期時間	Time(5,0,23)、Date(2022,5,24)、DateTimeValue("May 10, 2022 5:00:00 PM")
選擇	不支援
Blank	僅 Blank()

使用 Power Fx 設定變數

在此範例中，我們使用 Power Fx 運算式來儲存客戶名稱，並將其以大寫字母輸出。

1. 建立主題並新增問題節點。

2. 如果是輸入訊息，請輸入 What is your name?。

3. 在識別下方，選取實體人員名稱。

4. 選取將回覆另存為底下的方塊，然後選取變數 Var1，並將其命名為 customerName。

   

5. 在問題節點下方，選取 +，然後選取設定變數值。

6. 選取設定變數底下的方塊，然後選取建立新變數，並將其命名為 capsName。

7. 在目標值方塊中，選取 > 箭頭，然後選取公式索引標籤。

8. 在 fx 方塊中，輸入 Upper(Text(Topic.customerName))，然後選取插入。

   

9. 在問題節點下方選取 +，然後選取傳送訊息。

10. 輸入 HELLO 、選取{x}，然後選取 capsName。

    

使用 Power Fx 公式做為條件

若要評估更複雜的運算式，請設定條件節點以使用 Power Fx 公式。

在此範例中，副手確定預訂日期是否符合折扣資格。 為了進行判斷，它會檢查客戶提供的預約日期是否距目前日期 14 天或更久。

1. 建立主題並新增問題節點。

2. 如果是輸入訊息，請輸入 Booking date?。

3. 在識別下方，選取實體日期和時間。

4. 選取將回覆另存為底下的方塊，然後選取變數 Var1，並將其命名為 bookingDate。

   

5. 選取 + 圖示，然後選取新增條件。

6. 在條件節點中，選取節點功能表 (⋮)，然後選取變更為公式。

   

7. 在函數方塊中，選取 > 箭頭，然後選取公式索引標籤。

8. 將 fx 方塊的內容取代為公式 Topic.bookingDate > (DateAdd (Now(), 14))，然後選取插入。

9. 在條件節點下方，新增傳送訊息節點，並輸入訊息 You qualify for a discount。

10. 在所有其他條件節點下方，新增傳送訊息節點，並輸入訊息 Sorry, you don't qualify for a discount。