將傳統聊天機器人做為 Bot Framework 機器人中的技能使用

發行項
12/09/2024

注意

本文包含 Copilot Studio 的資訊僅適用於傳統聊天機器人。此功能 Copilot Studio 在新體驗中不可用。

當您將經典聊天機器人用作 a 技能 with a 機器人時，the Bot Framework 機器人將確定使用者所說的任何內容是否與經典聊天機器人 Bot Framework 的發射鍵短語匹配。如果有匹配項，則機器人 Bot Framework 將對話傳遞給經典聊天機器人。經典聊天機器人提取任何實體並觸發匹配的主題。

您還可以將變數作為 Composer 的 Copilot Studio 輸入傳遞給技能 Bot Framework 主題並使用它返回的輸出。

重要

您必須擁有試用版或完整 Copilot Studio 許可證才能將經典聊天機器人用作技能。此功能不適用於 Teams Copilot Studio 許可證。

要將經典聊天機器人設定為技能：

Bot Framework 將機器人添加到經典聊天機器人的允許清單中。
下載經典聊天機器人的技能清單。
在 Composer 中使用 Bot Framework 下載的技能清單在機器人之間創建連接。
Bot Framework 使用 Emulator 確認機器人作為技能工作。

先決條件

將您的 Bot Framework 機器人新增到經典聊天機器人的允許清單中

Bot Framework 將機器人的應用 ID 添加到要用作技能的經典聊天機器人的允許清單中。機器人必須位於相同的租用戶中。

在 Bot Framework Composer 中，打開將使用技能的機器人。選取設定，然後選取開發資源。在 Microsoft App ID 中複製識別碼。
在中 Copilot Studio，打開要用作技能的經典聊天機器人。
在導覽功能表中，移至設定，然後選取安全性。然後選取允許清單。
選取新增允許的呼叫者。
貼上您的 Bot Framework 機器人應用程式識別碼，然後選取下一步。

注意

經典聊天機器人不能充當其他經典聊天機器人的技能。如果嘗試將屬於 Power Virtual Agent 機器人的應用程式識別碼新增至允許清單，則會收到錯誤訊息。您只能為 Bot Framework 機器人新增應用程式識別碼。

Copilot Studio Bot Framework 驗證機器人的 App ID 並確認它屬於同一租戶中的機器人。
(選用) 為已新增到允許清單的機器人新增顯示名稱。
選取儲存。

如果您輸入了 Bot Framework 機器人，則透過其顯示名稱顯示；如果未輸入顯示名稱，則透過其應用程式識別碼顯示。若要隨時刪除或編輯它，請選取機器人顯示名稱或應用程式識別碼右邊的圖示。

Note

新增至允取清單的 Bot Framework 機器人將不會做為機器人內容的一部分匯出。

下載適用於您的經典聊天機器人的經典聊天機器人技能清單

Bot Framework 機器人可以使用 A Copilot Studio 技能清單來配置與生成清單的經典聊天機器人的連接。

所有經典聊天機器人都有技能清單。這些是包含技能名稱、介面和觸發字詞的 JSON 檔案。

答 Bot Framework 機器人可以使用技能清單來瞭解何時發射鍵經典聊天機器人 (例如，回覆使用者對其說的話)。

Copilot Studio 技能清單跟隨技能清單架構的 Bot Framework 版本 2.2 清單架構，由 intents.lu 和 manifest.json 文件組成。

答 Bot Framework 機器人可以根據清單數據決定 Classic 聊天機器人應處理使用者的請求。它將使用者所說的一切傳遞給經典聊天機器人。然後，經典聊天機器人匹配使用者對 a 主題所說的內容，提取槽填充 Copilot Studio 所需的任何實體，並觸發主題。 Copilot Studio

Copilot Studio 技能清單是自動生成和更新的。經典聊天機器人有兩個技能清單：

測試清單：允許機器人 Bot Framework 連線經典聊天機器人的測試版本。在發佈技能前，可使用測試資訊清單來驗證您的技能變更。
- 測試清單可立即用於每個新創建的經典聊天機器人。
- 它會自動更新，以反映您 每次保存 經典聊天機器人的更改。
已發佈的清單：允許 Bot Framework 機器人連線經典聊天機器人的已發佈版本。
- 已發佈的清單僅適用於至少已發佈一次的經典聊天機器人。
- 它會自動更新，以反映您每次發佈專員時所做的更改。

注意

Published 清單 不適用於從未發佈過的經典聊天機器人。

要生成機器人的 Published 清單，請發佈經典聊天機器人。

這兩種技能資訊清單都會顯示在管理允許清單面板上。

技能資訊清單也會顯示在副手的 [詳細資料] 頁面上。在導覽功能表中，選取設定，然後選取詳細資料。 [詳細資料] 夜面會顯示其他中繼資料，包括環境識別碼、租用戶識別碼和機器人應用程式識別碼。

若要下載資訊清單，請選取它。它將下載為標記為 _<機器人 name>manifest 的 .zip 檔 (對於 Published 清單) 或 < 機器人 name>test__manifest （對於 Test 清單）。

注意

技能清單不包括添加到經典聊天機器人的系統主題和 Composer 對話框。僅包括由副手作者建立的主題和作者新增到機器人的 Composer 意圖觸發程序。

連線在 Composer 中轉換為 a Copilot Studio 技能

使用 Copilot Studio 技能清單在 Composer 的機器人 Bot Framework 中創建技能連接。

在 Bot Framework Composer 專案中，選取新增，然後選取連線至技能。
流覽並選擇 Copilot Studio 清單.zip 存檔，然後選擇 Next (下一步)。
在經典聊天機器人中選擇要添加到 Bot Framework 機器人的主題或目的，然後選擇 Next ( 下一步)。
查看和編輯經典聊天機器人的發射鍵短語，然後選擇 下一步。
請確定已選取將 Orchestrator 用於多機器人專案，然後選取繼續。
Copilot Studio 驗證技能是否已正確添加到您的 Bot Framework 機器人中，以及 Composer 的專案中是否顯示帶有經典聊天機器人名稱的新發射鍵。

在技能資訊清單中找出主題

使用事件發射鍵技能中的 a Copilot Studio 主題。若要從 Composer 呼叫特定主題，請透過技能資訊清單中關聯事件的名稱參考該主題。

選取連線至技能動作。
在技能對話方塊名稱底下，選取顯示技能資訊清單。
在資訊清單中尋找活動。此屬性包含表示經典聊天機器人中可用主題的嵌套屬性。
尋找您要呼叫的主題，並尋找其 name 屬性。當 the Copilot Studio 技能收到具有此名稱的事件時，它會觸發主題。

在此範例中，事件活動名稱為 dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d。

調用 a Copilot Studio 技能主題

您可以直接調用它，而不是依賴使用者對技能 Copilot Studio 主題發射鍵說的話。您只能直接調用 Copilot Studio 技能清單中列出的主題。

在 Composer 製作畫布中，選取新增，然後選取存取外部資源，然後選取連線至技能。
在 技能 Dialog Name (對話框名稱 ) 清單中，選擇您的經典聊天機器人。
查找要調用的經典聊天機器人主題的事件活動名稱。請先複製值，並忽略引號，然後將其儲存以用於後續步驟中。
選取關閉。
在活動區段中選取顯示程式碼。
輸入或貼上下列程式碼。取代 TOPIC_ACTIVITY_NAME 為您主題的事件活動名稱。請確認 name 屬性中沒有引號。
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```

將 input 變數傳遞給 a Copilot Studio 技能主題

Bot Framework Composer 可以將變數作為輸入傳遞給 a Copilot Studio 技能主題。要瞭解如何創建 Copilot Studio 接受輸入變數的主題，請參閱使用變數。

如果您的技能清單中列出了可以接收輸入變數的 a Copilot Studio 主題，則可以向其傳遞 Composer 變數。

在 Composer 製作畫布中，選取新增，然後選取存取外部資源，然後選取連線至技能。
在 技能 Dialog Name (對話框名稱 ) 清單中，選擇您的經典聊天機器人。
查找要調用的經典聊天機器人主題的事件活動名稱。請先複製值，並忽略引號，然後將其儲存以用於後續步驟中。
尋找主題的值屬性。 value 屬性包含 $ref 屬性。複製該值，並將其儲存在後續步驟中使用。

警告

如果 a Copilot Studio 主題沒有輸入，則它不會有 value 屬性。
尋找 definitions 屬性，然後尋找與先前步驟中所找到的 $ref 值相符的嵌套屬性。記下主題 Copilot Studio 輸入的名稱和類型。您可以在後續步驟中使用它們。
選取關閉。
在活動區段下選取顯示程式碼。
輸入或貼上下列程式碼。取代這些值：
1. 取代 TOPIC_ACTIVITY_NAME 為您主題的事件活動名稱。
2. 取代 PVA_INPUT_VARIABLE 為您主題中的輸入變數。
3. 取代 COMPOSER_INPUT_VARIABLE 為將提供值的 Composer 變數。
```
[Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]
```
在此示例中，Composer 變數 dialog.storeLocation 為傳統聊天機器人主題 pva_StoreLocation 中的輸入變數 dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16提供值。

從技能 Copilot Studio 接收輸出變數主題

可以在 Composer 中接收來自技能 Copilot Studio 主題的輸出。要瞭解如何創建 Copilot Studio 返回輸出的主題，請參閱使用變數。

在 Composer 製作畫布中，選取新增，然後選取存取外部資源，然後選取連線至技能。
在 技能 Dialog Name (對話框名稱 ) 清單中，選擇您的經典聊天機器人。
找到要調用的經典聊天機器人主題的活動活動名稱。請先複製值，並忽略引號，然後將其儲存以用於後續步驟中。
尋找主題的 resultValue 屬性。 resultValue 屬性包含 $ref 屬性。複製該值，並將其儲存在後續步驟中使用。

警告

如果 a Copilot Studio 主題沒有 outputs，則它不會有 resultValue 屬性。
尋找 definitions 屬性，然後尋找與先前步驟中所找到的 $ref 值相符的嵌套屬性。記下主題 Copilot Studio 的輸出變數的名稱和類型。您可以在後續步驟中使用它們。

在此示例中，the Copilot Studio 主題返回 String 類型的兩個輸出， pva_State 和 pva_Item。
選取關閉。
在活動區段中選取顯示程式碼。
輸入或貼上下列程式碼。取代 TOPIC_ACTIVITY_NAME 為您主題的事件活動名稱。請確認 name 屬性中沒有引號。
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```
在代碼區域下，將 Property（屬性）設置為 Composer 變數，以接收和存儲來自 Copilot Studio 技能主題的輸出值。
在 Composer 製作畫布中，選取新增，然後選取管理屬性，然後選取設定屬性。
將屬性設定為應儲存所提取值的 Composer 值。然後將 Value 設定為您在中儲存主題輸出的 Composer 變數。

在此示例中，dialog.skillResult.pvaState 和 dialog.skillResult.pvaItem 的輸出 值被提取到新的 Composer 變數 dialog 中。狀態 和 對話。項。

使用 a Bot Framework 將經典聊天機器人作為技能進行測試機器人

Bot Framework 使用 Emulator 測試您的 Bot Framework 機器人是否正確地將經典聊天機器人作為技能調用。

重要

必須將 Your Bot Framework 機器人添加到經典聊天機器人的允許清單中，技能連接才能正常工作。

共用方式為