變數標籤位於「共享設定」面板中,列出了在編排中每個代理程式間共享的變數。 變數有三種類型:
- 系統變數:由系統定義。 大多數系統變數都是唯讀的。
- 自訂變數:由您定義。 自訂變數是可讀寫的,隨著對話進行會依照你自己的邏輯填充。
- 聯絡中心變數:在對話過程中由外部來源填入。 在建構器中建立的變數可由連接的聯絡中心填入(外部來源可設定值),而在聯絡中心建立的變數可將數值傳送給建構器(外部來源可接收值)。
變數範圍
- 主題:預設只能在建立該變數的主題內存取。 你可以改變這個行為,讓主題變數能從多個主題存取。
-
全域:可從多個主題存取。 所有系統變數皆具有全域作用域。 全域變數會出現在你用來從指令中參考物件的
/指令裡。 - 環境:限於該環境。
常見系統變數
系統變數對於設計語音通話的對話特別有用。 下表列出了一些常用的系統變數。
| Variable | 類型 | Description |
|---|---|---|
System.Activity.From.Name |
String | 代理使用者的來電號碼 |
System.Activity.Recipient.Name |
String | 用於呼叫或連接代理程式的號碼 |
System.Conversation.SipUuiHeaderValue |
String | 透過直接路由電話號碼轉接時的 SIP 標頭值 |
System.Activity.UserInputType |
String | 代理程式使用者在通話中是否使用DTMF或語音 |
System.Activity.InputDTMFKey |
String | 代理程式使用者的原始 DTMF 輸入 |
System.Conversation.OnlyAllowDTMF |
布林值 | 當語音設定為true時,系統會忽略語音輸入。 |
System.Activity.SpeechRecognition.Confidence |
數量 | 上次語音辨識事件的信賴值 (介於 0 和 1 之間) |
System.Activity.SpeechRecognition.MinimalFormattedText |
String | 語音辨識結果(原始文字)在 Copilot Studio 套用其專用自然語言理解模型之前 |
管理變數
你可以從兩個地方設定變數:共享設定面板,或是主題中的 設定變數 節點。
- 在 Copilot Studio 開啟你的代理程式,選擇 「建構」 標籤。
- 打開共享設定,選擇變數標籤。
- 選擇 自訂 標籤以查看你建立的變數,或選擇 系統 標籤以檢視平台提供的內建變數。
- 要建立自訂變數,請選擇 「建立」。
- 使用 搜尋變數 來依名稱尋找特定變數。
或者,編輯主題時,使用 設定變數 節點直接從主題建立或設定變數。