使用變數

您可以使用變數來儲存客戶的回覆，並在稍後的交談中重複使用其內容。

您也可以使用變數來建立邏輯運算式，將客戶動態傳遞至不同的交談路徑。 例如，將客戶的名稱保存在名為 UserName的變數中，隨著對話的繼續，專員可以按名稱稱呼客戶。

變數也可以傳遞至其他主題和 Power Automate 流程，或從中傳回。

Web 應用程式

變數可以存在於四個層級或範圍：

• 主題變數只能在創建它們的主題中使用。 此範圍是您所建立變數的預設範圍。
• 全域變數 可用於所有主題。 您可以變更任何主題變數的範圍，使之成為全域變數。
• 系統變數 是使用專員自動創建的。 這些變數提供更多關於交談或使用者的關聯式資訊。 在所有主題中都能使用。
• 環境變數 是在中創建 Power Platform 的，並且是唯讀的 Copilot Studio。 環境變數儲存參數索引鍵和值，然後將其作為各種其他應用程式物件的輸入，包括 Copilot Studio。 將參數與取用物件分開可在同一環境中或將解決方案移轉到其他環境時變更值。 另一種選擇是將硬式編碼的參數值保留在使用它們的元件中。

變數類型

變數與基底類型相關聯。 類型決定變數可以包含哪些值，以及將其用於建構邏輯運算式時所能使用的運算子。

類型​	描述
字串	用於表示文字的字元序列
布林值	只能是 true 或 false 的邏輯值
數字	任何實數
資料表	值的清單，但是所有的值都必須是相同的類型
錄製	名稱/值組的集合，其中值可以是任何類型
日期時間	相對於某個時間點的日期、時間、星期幾或月份
選擇	具有關聯同義詞的字串值清單
Blank	「無值」或「未知值」的預留位置；如需詳細資訊，請參閱 Power Fx 中的空白

變數的類型是在第一次為其指派值時所設定。 在那之後，該變數的類型便已固定，無法為其指派任何其他類型的值。 例如，如果指定的起始值為 1 變數，則指派類型數字。 嘗試將其分配給 String 值 "apples" 會導致錯誤。

當您測試專員時，變數可能會暫時顯示為 unknown 類型。 尚未指派值的未知變數。

變數順序是由製作畫布由上至下的位置所決定。 創作畫布頂部的節點先於底部的節點考慮。

使用條件節點建立分支時，分支是從左至右排序。 最左側分支中的節點被視為最右側分支中的節點之前。

實體

Copilot Studio 會使用實體，從使用者的回覆中找出特定類型的資訊。 找出的資訊會儲存在類型適合該資訊的變數中。 下表列出了與預生成實體關聯的變數基類型。

Entity	變數基底類型
多選選項	選擇
使用者的整個回覆	字串
年齡	數字
布林值	布林值
縣/市	字串
色彩	字串
洲別	字串
國家或地區	字串
日期和時間	日期時間
Email	字串
事件	字串
Integer	Integer
語言	字串
Money	數字
數字	數字
序數	數字
組織	字串
百分比	數字
人員姓名	字串
電話號碼	字串
景點	字串
速度	數值
州/省	字串
街道地址	字串
溫度	數字
URL	字串
粗細	數字
郵遞區號	字串
自訂實體	選擇

建立變數

任何提示您選取變數做為輸出的節點 (例如問題節點) 會自動建立屬於適當類型的輸出變數。

提示

重新命名節點以使其更易於識別。 選擇節點的名稱欄位以直接更新名稱，或選擇節點的更多圖示 (...)，並從功能表中選擇重新命名。 您也可以在程式碼編輯器中重新命名節點。

無法重新命名觸發程序節點和前往步驟節點。

節點名稱的長度最多可達 500 個字元。

挑選要使用的實體

默認情況下，問題 節點是使用多選選項創建的。 若要使用不同的預生成或自定義實體，請選中 Identify (識別 ) 框，然後選擇專員應偵聽的信息類型。

重新命名變數

建立變數時，系統會自動指派其名稱。 最佳做法是為您的變數指定有意義的名稱，以便必須維護專員的其他任何人清楚地了解它們的用途。

1. 在變數屬性窗格中選取變數以打開它。

2. 在變數名稱下方，輸入變數的新名稱。

設定變數

通常，您可以使用 Question（問題 ） 節點將使用者輸入保存到變數中。 但是，在某些情況下，您可能希望自己設置該值。 在這些情況下，請使用設定變數值節點。

1. 選擇新增節點 (+) 以新增節點，然後選擇變數管理>設定變數值。

2. 選取設定變數底下的方塊，然後選取建立新變數。

   

   新變數已建立。 在您將值指派給此變數之前，其類型為未知。

   

3. 如果是到值，請使用以下選項之一指派值：

   • 輸入常值。
   • 選取類型相同的現有變數。 此動作會將您的變數設定為與您所選變數相同的值。
   • 使用 Power Fx 公式。 Power Fx 公式對於無法使用常值的較複雜類型 (例如資料表和記錄類型) 很有用。

注意

在設置字串類型變數時，如果遇到 Set variable 和 To value 不匹配，則會顯示錯誤消息和 Fix type mismatch 按鈕。 選擇該按鈕可 Copilot Studio 自動生成 Power Fx 解決不匹配的公式 。

使用常值

您可以在任何變數中輸入常值，而不是選取變數值。

節點嘗試將常值解釋為字串、數字或布林值。 例如，123 會解譯為數字。 如果您要改以字串值來解譯，則可將值括在雙引號中，像這樣："123"。

在某些案例中，或使用更複雜的類型時，請使用 Power Fx 公式來設定特定類型。

[變數] 窗格

變數窗格可用來檢視主題中可用的所有變數，無論這些變數是在哪些節點中定義或使用。 對於每個變數，您都可以選擇讓變數從其他主題接收其值、將其值傳回給其他主題，還是兩者兼而有之。 您也可以選取變數以在變數屬性窗格中編輯其屬性。

若要開啟變數窗格，請選取主題的功能表列中的變數。

變數屬性窗格

在變數屬性窗格中，您可以重新命名變數、查看其使用所在位置，或將其轉換為全域變數。 不過，無法將其從全域變數轉換回主題變數。 您也可以選擇讓變數可以從其他主題接收值，還是將值傳遞給其他主題。

若要打開變數屬性窗格，請在變數窗格中選取一個變數。 您也可以選取任何節點中的變數來開啟變數屬性窗格。

環境變數

環境變數 是一個 Power Platform 概念。 環境變數會啟用在 Power Platform 環境中移動應用程式的基本應用程式生命週期管理 (ALM) 案例。 在這個情境中，應用程式保持完全不變，只是來源環境和目標環境之間有一些關鍵的外部參考不同。

使用環境變數的方式與使用主題變數、全域變數和系統變數相同。 比較需要注意的區別是只能在唯讀模式下使用環境變數。 專員作者無法修改環境變數。 Copilot Studio 但是，管理員可以在 PowerApps 入口網站中更改環境變數的值。

Copilot Studio 中的環境變數類型對應到 PowerApps 資料類型，如下所示：

Copilot Studio 中的類型	PowerApps 中的類型
十進位數	數字
JSON	從值中偵測類型。 如果不是 Json => 未指定 (驗證錯誤)
文字	string
是/否	布林值
資料來源	string
祕密	字串

注意

環境變數錯誤在測試聊天和發佈時可見。 但是，這些錯誤不會顯示在主題清單中，因為它們不是主題變數。

您無法在 Copilot Studio 中建立或編輯環境變數。 您必須使用 PowerApps 入口網站更改或設定環境變數。 從 Copilot Studio 中，您可以使用變數窗格查看有關環境變數的資訊。 變數 窗格還具有原生創作體驗的連結。

使用 Azure Key Vault 密碼的環境變數

環境變數可以參考 Key Vault 中的祕密。 這是一種特殊的環境變數情況，具有獨特的考量。

若要在 PowerApps 入口網站中建立祕密環境變數，必須設定其 Key Vault。

除了上述設定之外，還必須執行以下操作以授權 Copilot Studio 讀取此 Key Vault：

1. 將 Key Vault Secrets User 角色指派給 Microsoft Virtual Agents Service 應用程式。

2. 要授權環境中的所有代理訪問金鑰，請在金鑰上創建標籤 AllowedEnvironments 並添加允許的環境 ID (以逗號分隔)。

3. 若要僅授權環境中的特定代理使用此 Key Vault，請創建一個標記 AllowedAgents 並將專員標識符採用以下格式 {envId}/{schemaName}。 對於多個值，請用逗號分隔這些值。

如果您達到最大字元數但仍需要添加更多代理，請添加另一個具有描述性但唯一名稱的標記 (例如： AllowedAgents2)。

祕密值在對話方塊執行階段快取五分鐘。 不成功的讀取會快取 30 秒。

警告

通過在專員中添加金鑰，您可以將此金鑰的值公開給所有可以在環境中編輯專員的使用者，因為這些使用者可以編輯專員以返回節點中的 SendMessage 值。

系統變數

每個專員都帶有內置的系統變數，用於提供有關對話的其他資訊。

注意

有關啟用語音的專員變數的更多資訊，請參閱 使用語音變數。

並非所有系統變數都會顯示在清單中。 您必須使用 Power Fx 公式來存取這些隱藏的系統變數。

若要在 Power Fx 公式中使用系統變數，您必須在變數名稱前加上 System.。 例如，若要在公式中包含系統變數 User.DisplayName，請將其稱為 System.User.DisplayName。

姓名	類型​	定義
Activity.Attachments	表格	使用者提供的檔案附件
Activity.Channel	選擇	目前交談的管道識別碼
Activity.ChannelData	任何	包含特定管道內容的物件
Activity.ChannelId	string	目前交談的管道識別碼，其類型為字串
Activity.From.Id	string	傳送者的管道特定唯一識別碼
Activity.From.Name	string	傳送者的管道特定使用者易記名稱
Activity.Name	string	事件的名稱
Activity.Recipient.Id	string	傳入活動的 Type 屬性。
Activity.Recipient.Name	string	表示通道中專員的顯示名稱。 在電話管道上下文中，此變數的值將是專員附加到的電話號碼。
Activity.Text	string	使用者傳送的最新訊息
Activity.Type	選擇	活動的類型
Activity.TypeId	string	活動的類型，做為字串
Activity.Value	任何	開放端點值
Bot.EnvironmentId	string	專員的環境 ID
Bot.Id	string	#的 ID 專員
Bot.Name	string	你的專員
Bot.SchemaName	string	#的架構名稱專員
Bot.TenantId	string	#的租户 ID 專員
ClientPluginActions	選擇	生成式編排需要考慮的 Dynamic Client Plugin Actions 集合
Conversation.Id	string	目前交談的唯一識別碼
Conversation.InTestMode	boolean	布林值旗標，表示交談是否發生在測試畫布中
Conversation.LocalTimeZone	string	使用者要使用的時區名稱，採用 IANA 時區資料庫格式
Conversation.LocalTimeZoneOffset	datetime	目前本地時區與 UTC 的時間偏移量
Error.Code	string	目前錯誤的錯誤碼。 注：僅當發射鍵受 On Error支援時，才支援此變數。
Error.Message	string	目前錯誤的錯誤訊息。 注：僅當發射鍵受 On Error支援時，才支援此變數。
FallbackCount	數值	此變數會計算主題無法與使用者輸入相符的次數。 注：僅當發射鍵受 On Unknown Intent支援時，才支援此變數。
InactivityTimer.Continue	boolean	布林值旗標，表示計時器是否需要繼續。 注：僅當發射鍵支援 Inactivity時，才支援此變數。
InactivityTimer.Count	數值	在設定時間後，由於使用者處於非活動狀態而觸發 OnInactivity 計時器的次數。 注：僅當發射鍵支援 Inactivity時，才支援此變數。
LastMessage.Id	string	使用者所傳送上一則訊息的識別碼
LastMessage.Text	string	使用者傳送的上一則訊息
Recognizer.ExtractedEntities	選擇	表示從觸發訊息中提取的實體。 注：僅當發射鍵支援 On Select Intent時，才支援此變數。
Recognizer.IntentOptions	選擇	表示識別器傳回不明確結果時的意圖選項。 注：僅當發射鍵支援 On Select Intent時，才支援此變數。
Recognizer.SelectedIntent	選擇	表示從識別器中選擇的意圖。 注：僅當發射鍵支援 On Select Intent時，才支援此變數。
Recognizer.TriggeringMessage.Id	string	觸發目前主題之使用者訊息的識別碼
Recognizer.TriggeringMessage.Text	string	觸發目前主題的使用者訊息
Recognizer.MultipleTopicsMatchedReason	string	用於確定匹配多個主題的原因。 注：僅當發射鍵支援 On Select Intent時，才支援此變數。
User.Language	選擇	此變數用於設定每個對話的使用者語言區域設定。
SignInReason	選擇	用於確定觸發主題時需要什麼登入選項。 注：僅當發射鍵受 On Sign In支援時，才支援此變數。

用於整合驗證的變數 (預設)

當您將專員配置為使用 Microsoft 進行身份驗證時，以下變數可用。 這將使用 Entra ID 驗證，並且僅允許 Teams 和 PowerApps 頻道。 這是新代理的預設設置。

有關更多資訊，請參閱 身份驗證變數。

姓名	類型​	定義
User.DisplayName	string	當前與專員對話的使用者的顯示名稱。
User.Email	string	當前與專員通信的用戶的電子郵件位址。
User.FirstName	string	當前與專員對話的使用者的名字。
User.Id	string	當前與專員通信的使用者的唯一 ID。
User.IsLoggedIn	boolean	布林值表示當前與專員通信的使用者是否經過身份驗證的標誌。
User.LastName	string	當前與專員對話的使用者的姓氏。
User.PrincipalName	string	當前與專員通信的用戶的用戶主體名稱。

使用 Generic OAuth 2 進行手動身份驗證的變數

當您將專員配置為使用 Generic OAuth 2 服務提供者時，以下變數可用。

姓名	類型​	定義
User.AccessToken	string	使用專員進行身份驗證的使用者的存取權杖。
User.DisplayName	string	當前與專員對話的使用者的顯示名稱。
User.Id	string	當前與專員通信的使用者的唯一 ID。
User.IsLoggedIn	boolean	布林值表示當前與專員通信的使用者是否經過身份驗證的標誌。

使用 Microsoft Entra ID 進行手動驗證的變數

當您將專員配置為使用 Microsoft Entra ID (以前 Azure Active Directory) 服務提供者時，以下變數可用。

姓名	類型​	定義
User.AccessToken	string	使用專員進行身份驗證的使用者的存取權杖。
User.DisplayName	string	當前與專員對話的使用者的顯示名稱。
User.Email	string	當前與專員通信的用戶的電子郵件位址。
User.FirstName	string	當前與專員對話的使用者的名字。
User.Id	string	當前與專員通信的使用者的唯一 ID。
User.IsLoggedIn	boolean	布林值表示當前與專員通信的使用者是否經過身份驗證的標誌。
User.LastName	string	當前與專員對話的使用者的姓氏。
User.PrincipalName	string	當前與專員通信的用戶的用戶主體名稱。

支持語音的代理的變數

以下變數僅在支持語音的代理中可用。

注意

有關啟用語音的專員變數的更多資訊，請參閱 使用語音變數。

姓名	類型​	定義
Activity.InputDTMFKeys	string	從電話接收的原始 DTMF 金鑰值。
Activity.SpeechRecognition.Confidence	數值	ASR 假設整個結果的信賴度分數，0 到 1。
Activity.SpeechRecognition.MinimallyFormattedText	string	ASR 假設結果的稍微格式化的文字。 例如，五百美元。 單字是拼寫的，但包括基本的大寫和標點符號。
Activity.UserInputType	選擇	終端使用者最近輸入的輸入類型。 該值可以是測試、語音或 DTMF。
Conversation.OnlyAllowDTMF	boolean	布林值旗標，表示 IVR 是否應在執行時設定為僅 DTMF 模式。
Conversation.SipUuiHeaderValue	string	UUI 標頭字串，用於在呼叫開始時將上下文傳遞到 IVR。

在主題之間傳遞變數

將主題重新導向至其他主題時，您可以在原始主題與目標主題之間傳遞變數的值。 當先前主題已收集到後來主題所需的資訊時，在主題之間傳遞變數特別有用。 使用者會很高興不必再次回答相同的問題。

接收來自其他主題的值

當主題定義變數時 (例如，在 Question 節點中)，專員會詢問使用者問題以填寫變數的值。 如果專員已經在較早的主題中獲得了該值，則沒有理由再次詢問該問題。 在這些情況下，可以將此變數設定為接收其他主題的值。 將其他主題重新導向至此主題時，可以將變數的值 (或常值) 傳遞至此變數，並略過該問題。 使用者與專員交談的體驗是無縫的。

在此範例中，我們使用兩個主題「問候」和「跟客戶談話」。 這兩個主題都要求提供客戶的姓名。 不過，如果「問候」主題先執行，則「跟客戶談話」主題會略過其問題。 反而改用從「問候」主題傳來的變數值。

以下是「跟客戶談話」主題的流程：

如 Test 專員 (測試 #) 窗格中所示，如果首先觸發此主題，它會詢問使用者，“我應該怎麼稱呼你？它將值存儲在名為 userName userName 變數也會設定成從其他主題取得值。 此主題以訊息「希望您度過美好的一天，{userName}！」做為結尾

以下是「問候」主題的流程：

如 Test 專員 (測試 #) 窗格中所示，如果首先觸發此主題，它會詢問使用者“你叫什麼名字？它將值存儲在名為 UserName 主題會傳送訊息「很高興見到您，{UserName}！」，重新導向至「跟客戶談話」主題，這會傳送訊息「希望您度過美好的一天，{userName}！」請注意，「跟客戶談話」主題已略過再次詢問使用者姓名的步驟。 反而改用從「問候」主題傳來的 UserName 變數值。

最後，這裡又是那第二次交談，這次是從「跟客戶談話」主題的角度來看：

讓我們逐步解說設定要讓主題從其他主題接收值的步驟。 我們會使用目前的範例，只要主題需要取得先前主題中的值，同樣的步驟就會奏效。

設定目的地主題

目的地主題是要重新導向到的主題，此主題會接收來自其他主題的值。 在本範例中，這是「跟客戶談話」。

1. 建立或移至目的地主題。

2. 新增問題節點並輸入 What should I call you? 做為訊息。

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

4. 選取變數以開啟變數屬性窗格。 將其命名為 userName，然後選取從其他主題接收值。

   

5. 添加 Message 節點。

6. 在訊息方塊中，輸入 I hope you're having a wonderful day,。

7. 選取插入變數圖示 ({x})，然後選取 userName。

8. 選取變數後面的空白處，並鍵入 !。

9. 儲存主題。

設定來源主題

來源主題是執行重新導向的主題，此主題提供要傳遞給目的地主題的值。 在本範例中，這是「問候」。

1. 移至來源主題。

2. 添加 Redirect 節點 並選擇目標主題。

3. 選取 + 新增輸入，然後從要將值傳遞至的目的地主題中選取變數。

   

4. 選取 > 圖示，然後選取要傳遞其值的變數。

   

   重新導向節點應該看起來像這樣：

   

5. 儲存主題。

將值傳回原始主題

重新導向至某個主題，而此主題透過提出問題或其他方式取得變數時，可將此變數傳回至原始主題。 此變數會變成原始主題的一部分，並且可以像任何其他變數一樣使用。 因此，專員獲得的資訊可以跨主題使用，從而減少對 全域變數的需求。

讓我們繼續上一節中的範例。 我們會在「跟客戶談話」主題中提出新問題，然後將解答傳回給「問候」主題。

設定傳回變數的來源主題

將變數傳回至主題時，來源主題是要重新導向到的主題，也就是提供傳遞回原始主題之值的主題。 在本範例中，這是「跟客戶談話」。

1. 移至來源主題。

2. 新增問題節點並輸入 What city do you live in? 做為訊息。

3. 在識別下方，選取預建實體城市。

4. 選取變數以開啟變數屬性窗格。 將其命名為 userCity，然後選取將值傳回原始主題。

   

5. 儲存主題。

設定傳回變數的目的地主題

將變數傳回至主題時，目的地主題是進行重新導向的主題，也就是從其他主題接收值的主題。 在本範例中，這是「問候」。

1. 移至目的地主題。

2. 在來源主題中選取的變數會在重新導向節點中顯示為輸出變數。

   

3. 儲存主題。

傳統

實體和變數類型

Copilot Studio 會使用實體，從使用者的回覆中找出特定類型的資訊。 變數類型在儲存時與已識別的資訊相關聯。 變數類型與實體類似。

每個實體或變數類型都會對應至基底類型，如下表所示。 當您使用對應的變數建立邏輯運算式時，基準類型會決定您可以使用的運算子。 它也會判斷是否可以將變數以輸入參數的方式饋送到流程或 Bot Framework 技能。

例如，對應到運算子「等於」的布林值基底類型，可能的值為 True 或 False。 數字基底類型提供數字運算子，例如「等於」、「大於」或「大於或等於」等。

實體	變數基底類型
多選選項	字串
使用者的整個回覆	字串
年齡	數值
布林值	布林值
縣/市	字串
色彩	字串
洲別	字串
國家或地區	字串
日期和時間	字串
Duration	字串
Email	字串
事件	字串
語言	字串
Money	字串
數值	字串
序數	字串
組織	字串
百分比	數值
人員姓名	字串
電話號碼	字串
景點	字串
速度	數值
州/省	字串
街道地址	字串
溫度	數值
URL	字串
Weight	數值
郵遞區號	字串
自訂實體	字串

建立變數

在機器人製作畫布中，新增問題節點。 變數會自動建立在節點中。

1. 轉到機器人 的 Topics (主題) 頁面 ，然後打開要向其添加變數的主題。

2. 選取新增節點 (+)，然後選取提出問題。

   

   會自動建立包含使用者回覆的變數。

   

挑選要使用的實體

根據預設，會建立有多個選項的問題節點。 若要使用不同的預建或自訂實體，請選擇要從節點進行識別的內容。

重新命名變數

自動建立的變數會以預設名稱提供。 若要重新命名變數，請選取變數名稱，輸入新名稱，然後選取完成。

在動作節點中使用變數

在動作節點中使用變數時，如果其基底類型符合您為流程或 Bot Framework 技能指定的參數類型相符，則可以將其提供給該參數。 動作節點的輸出會產生新的變數。

在動作節點中使用常值

您可以在動作節點的變數輸入欄位中輸入文字值，而不是從功能表中選取變數。

剖析值節點

剖析值節點可讓您將一種類型的值轉換成其他類型的值。 將節點新增至主題時，請選取 [新增節點 (+)]、[變數管理] 和 [剖析值]。

使用剖析值節點的主要案例主要是將原始 JSON 或非類型化變數 (在執行階段之前均未知其值或結構；例如 ChannelData) 轉換為具象類型。

程序會在呼叫流程時開始，然後流程再呼叫 API。 然後 API 會傳回結果。 通常，您可能必須剖析此回覆，並將一個或多個基本變數傳回 Copilot Studio。 使用剖析值節點，您可以將整個 API 結果做為字串傳送：

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

您可以將現在使用的字串變數轉換為記錄變數，並在 Power Fx 中使用這個新節點來進行完整的 IntelliSense 支援。 使用範例資料的範例將有助於闡明此程序。

使用剖析值節點的範例

1. 新增剖析值節點，然後選取您要剖析的變數。

   

2. 選取資料類型。 在此案例中，請選擇「來自範例資料」。

   

3. 現在您可以按一下 [從範例 JSON 取得結構描述] 來提供 JSON。 按一下此處開啟編輯器，您可以在其中貼上範例。

   

4. 最後，指定要置入已剖析的值之變數。 通常，您會為此建立新的變數。

   

   請注意，輸出變數現在屬於正確類型 – 記錄。

   

現在您可以使用新變數。 在此處 Power Fx 編輯器中，您可以看到您已取得各種屬性的完整 IntelliSense。

除了剖析 JSON 字串之外，剖析值節點的金鑰使用將在執行階段時進行剖析 UntypedObjects。 其中最常見的是當您收到事件並且需要解析事件值時。 或者，您可能想要剖析 System.Activity.ChannelData 屬性，而此屬性在執行階段會依管道而有所不同。

在以下範例中，如果事件來自 Teams，則您需要使用 Teams 開發人員文件來尋找傳入事件外觀的範例，然後使用本節中所述的範例資料。

在主題之間傳遞變數

當重新導向至其他主題時，您可以將值傳遞至目的地主題中的變數，或是從中取得變數。 當您已經有主題所需的資訊時，在各主題之間傳遞變數就顯得非常有用。 您的使用者會很高興不必再次回答問題。 這在重構主題並將其分成可重複使用的元件，和想跨主題傳遞變數時也很實用。

Note

類型為 Custom Entity、Date and Time、Duration 和 Multiple-choice 的變數無法在主題之間傳遞。

接收來自其他主題的值

當主題定義變數 (例如，透過問題節點) 時，Bot 會詢問使用者問題以填寫變數值。 如果機器人已取得該值，則無需再次提問。 在這些情況下，可以將此變數定義為接收其他主題的值。 當其他主題重新導向至此主題時，其可以將變數 (或 常值) 傳遞至此變數，並跳過該問題。 使用者與機器人交談時帶來完美的體驗。

若要從其他主題接收值，請設定變數的屬性：

1. 在問題節點中，選取要從其他主題接收值的變數。

2. 在變數屬性窗格的主題 (有限範圍) 下，選取接收其他主題的值。

   

3. 儲存主題。

4. 移至要重新導向到的主題。 依照重新導向至其他主題中的步驟，重新導向至正確的主題。

5. 選取 + 為目的地主題新增輸入。

   

6. 從要將變數傳遞至的重新導向主題中，選取變數。

   

7. 在輸入或選取值下，在目前主題中選取要傳遞至重新導向主題的變數。

   

   變數會顯示在重新導向的節點中。

   

將值傳回原始主題

當主題提出問題 (或以其他方式從動作中取得變數) 時，可將此變數傳回已重新導向到它的原始主題。

在這種情況下，該變數也會變成原始主題的一部分，且可以做為任何其他變數使用。 這可協助您建構主題，讓機器人取得的資訊可在各主題間使用，減少對全域變數的需求。

若要將變數傳回至原始主題，請設定變數的屬性：

1. 在問題節點中，選取要從其他主題接收值的變數。

2. 在變數屬性窗格的主題 (有限範圍) 下，選取將變數傳回原始主題。

   

3. 儲存主題。

4. 移至要重新導向到的主題。 依照重新導向至其他主題中的步驟，重新導向至正確的主題。

   傳回主題的變數會顯示在重新導向主題中。 在主題中使用傳回的變數。

   

使用 [變數] 窗格

使用變數窗格一次選取多個變數的接收或傳回狀態。

1. 在主題的功能表列上，選取變數。

   

2. 對於主題中的每個變數，選取是否要在主題之間傳遞、接收 (或兩者) 值。

   

在變數輸入上使用常值

您可以將常值和變數傳遞至主題。 若要傳遞常值，請輸入要做為輸入的值，而不是選取變數。

相關內容

• 使用變數在各主題間攜帶內容
• 自訂專員的外觀