設定機器人的內容變數

發行項
07/03/2024

重要

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

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

本文列出 Azure 及 Copilot Studio Bot 的內容變數，以及在 Customer Service 全通路中設定這些變數的方式。若要了解如何建立內容變數，請參閱管理內容變數。

Azure 機器人的內容變數

下表包含 Customer Service 全通路中內容變數的清單，您可以將這些變數用於設定 Azure 機器人。

內容變數類型	內容變數名稱	Description	如何在 Azure 中進行對應
交談前問卷	使用您在 Customer Service 全通路中建立的交談前問卷問題名稱。	系統會將交談前問卷的回覆存儲為內容變數。	使用下列資訊，將 Customer Service 全通路中的問題名稱與 Azure 中的變數類型進行對應：單行：字串多行：字串選項組：字串使用者同意：布林值
自訂內容	使用您在 Customer Service 全通路中所建立，或透過 setContextProvider API 所傳遞的變數名稱。	您建立的自訂內容變數透過即時聊天 SDK 來傳遞。	對應 JSON 格式的使用者回覆，以便在 Customer Service 全通路中使用自訂內容變數。
交談	msdyn_ConversationId	使用此內容變數，其中包含進行中交談的交談識別碼，而且此內容變數可以擷取 Microsoft Dataverse 中的記錄，並對記錄執行作業。	字串：字串
連絡人	msdyn_contact_msdyn_ocliveworkitem_Customer	使用此內容變數，其中包含連結至交談之客戶 (連絡人) 記錄的記錄識別碼。	剖析 JSON 以擷取記錄識別碼
帳戶	msdyn_account_msdyn_ocliveworkitem_Customer	使用此內容變數，其中包含連結至交談之客戶記錄的記錄識別碼。	剖析 JSON 以擷取記錄識別碼
案例	msdyn_incident_msdyn_ocliveworkitem	使用此內容變數，其中包含連結至交談之案例記錄的記錄識別碼。	剖析 JSON 以擷取記錄識別碼

Note

請使用定義的內容變數名稱，而且當您在 Azure 或 Copilot Studio Bot 中撰寫流程時不要變更它們。此外，也請務必使用 [完全相符] 將值傳遞給內容變數，因為這會區分大小寫。如果有不相符，則不會自動識別記錄。其他資訊：自動識別記錄

Copilot Studio 機器人的內容變數

下表包含 Customer Service 全通路中可用內容變數的清單，您可以將這些變數用於設定 Copilot Studio Bot。

重要

為了使用傳訊及語音變數，請確定您已先安裝擴充解決方案。

內容變數類型	內容變數名稱	Description	如何在 Copilot Studio 中進行對應
交談前問卷	使用您在 Customer Service 全通路中建立的交談前問卷問題名稱。	系統會將交談前問卷的回覆存儲為內容變數。	使用下列資訊，將 Customer Service 全通路中的問題名稱與 Copilot Studio 中的變數類型進行對應：單行：使用者的完整回覆多行：使用者的完整回覆選項組：使用者完整回覆使用者同意：布林值
自訂內容	使用您在 Customer Service 全通路中所建立，或透過 setContextProvider API 所傳遞的變數名稱。	您建立的自訂內容變數透過即時聊天 SDK 來傳遞。	使用下列資訊，將 Customer Service 全通路中的自訂內容變數與 Copilot Studio 中的變數類型進行對應：字串：使用者的完整回覆布林值：布林值數字、浮點數：數字
交談	msdyn_ConversationId	使用此內容變數，其中包含進行中交談的交談識別碼，而且此內容變數可以擷取 Microsoft Dataverse 中的記錄，並對記錄執行作業。	字串：使用者的完整回覆。
傳訊及語音變數	msdyn_CustomerType	將這個包含客戶類型的內容變數用於已連結至交談的客戶或連絡人記錄。	選取 Customer Service 全通路擴充解決方案變數。
	msdyn_CustomerName	將這個包含客戶名稱的內容變數用於已連結至交談的客戶或連絡人記錄。	選取 Customer Service 全通路擴充解決方案變數。
	msdyn_CustomerId	將這個包含客戶識別碼的內容變數用於已連結至交談的客戶或連絡人記錄。	選取 Customer Service 全通路擴充解決方案變數。
	msdyn_CaseId	使用這個包含已連結至交談之案例記錄的識別碼的內容變數。	選取 Customer Service 全通路擴充解決方案變數。
	msdyn_CaseTitle	使用這個包含已連結至交談之案例記錄的標題的內容變數。	選取 Customer Service 全通路擴充解決方案變數。
只有語音的變數	CustomerPhoneNumber	將此內容變數用於電話語音活動中的客戶電話號碼。	選取 Customer Service 全通路擴充解決方案變數。
	OrganizationPhoneNumber	將此內容變數用於電話語音活動中的組織電話號碼。	選取 Customer Service 全通路擴充解決方案變數。
擴充方法名稱	va_SurveyConsent	使用此對話方塊來判斷客戶是否已同意在交談期間參與問卷。	使用此方法，將交談詳細資料上呈至 Customer Service 全通路。
	va_CustomerLocale	使用此對話方塊，將目前與機器人談話的使用者轉移至另一個可以說不同語言的機器人。	選取輸入變數並使用正確的地區設定代碼，以設定代碼。

設定 Copilot Studio Bot 的內容變數

若要讓 Copilot Studio 機器人從全通路讀取內容變數，請執行下列步驟：

在主題頁面上，選取新增主題和從空白開始。
輸入主題的名稱 (例如，「設定內容變數」) 並儲存。
將新節點新增至主題，然後選取變數管理 > 設定變數值
在新節點的設定變數底下，選取建立新變數。
按一下新變數名稱以開啟變數屬性窗格。在窗格中，將變數名稱設定為完全比對全通路內容變數的名稱 (區分大小寫)。
在參考區段中，選取省略符號 (...)，然後選取如果為空白，從這個節點取得值。 Copilot Studio 機器人在執行階段從此節點擷取變數值。
在使用方式區段中，選取全域 (任何主題皆可存取) 和外部來源可以設定值。 Copilot Studio 接受全通路的資料。關閉變數屬性窗格。
在節點的目標值中，輸入與機器人預期資料類型相符的值。例如，如果機器人需要字串，請設定 Text(“”)。如果資料未進入交談中，則 Copilot Studio 會以您在此處設定的值來遞補。
儲存並發佈變更。

在聊天期間，全通路內容變數的資料是在 Copilot Studio 變數中設定，並可用於機器人的邏輯。

機器人還可以在交談期間設定全通路內容變數。若要從 Copilot Studio 邏輯設定全通路變數，請確定機器人使用的是正確的變數名稱，並設定變數管理節點中 [目標值] 屬性的值。 Copilot Studio 會在轉接專員期間將變數移交給全通路。這通常用於在機器人上呈交談給專員時將交談連結至案例。有關如何從此資料連結全通路中記錄的詳細資訊：將客戶和案例連結至交談

上呈交談時，可以將 Copilot Studio 中建立的全域變數傳遞至 Customer Service 全通路。如需完整清單，請參閱轉接時可用的內容變數。

剖析 JSON 物件以擷取記錄識別碼

確定您有下列詳細資料：

Customer Service 全通路內容變數，例如 msdyn_contact_msdyn_ocliveworkitem_Customer。
結構描述詳細資料

一份範例結構描述詳細資料如下所示：

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue 包含 Dataverse 實體中屬性的值。實體屬性的對應如下：

案例：案例標題
連絡人：全名
客戶：名稱

以下是範例內容記錄。

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

另請參閱

整合 Copilot Studio Bot
整合 Azure Bot
設定 Bot 以上呈和結束交談
 即時聊天 SDK 參考

共用方式為