設定變數(客戶對話)

變數標籤位於「共享設定」面板中,列出了在編排中每個代理程式間共享的變數。 變數有三種類型:

  • 系統變數:由系統定義。 大多數系統變數都是唯讀的。
  • 自訂變數:由您定義。 自訂變數是可讀寫的,隨著對話進行會依照你自己的邏輯填充。
  • 聯絡中心變數:在對話過程中由外部來源填入。 在建構器中建立的變數可由連接的聯絡中心填入(外部來源可設定值),而在聯絡中心建立的變數可將數值傳送給建構器(外部來源可接收值)。

變數範圍

  • 主題:預設只能在建立該變數的主題內存取。 你可以改變這個行為,讓主題變數能從多個主題存取。
  • 全域:可從多個主題存取。 所有系統變數皆具有全域作用域。 全域變數會出現在你用來從指令中參考物件的 / 指令裡。
  • 環境:限於該環境。

常見系統變數

系統變數對於設計語音通話的對話特別有用。 下表列出了一些常用的系統變數。

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 套用其專用自然語言理解模型之前

管理變數

你可以從兩個地方設定變數:共享設定面板,或是主題中的 設定變數 節點。

  1. 在 Copilot Studio 開啟你的代理程式,選擇 「建構」 標籤。
  2. 打開共享設定,選擇變數標籤。
  3. 選擇 自訂 標籤以查看你建立的變數,或選擇 系統 標籤以檢視平台提供的內建變數。
  4. 要建立自訂變數,請選擇 「建立」。
  5. 使用 搜尋變數 來依名稱尋找特定變數。

或者,編輯主題時,使用 設定變數 節點直接從主題建立或設定變數。