使用 Azure CLI 建立或更新 Azure Bot 資源
適用於： SDK v4
本文說明如何使用 Azure CLI 和 Azure Resource Manager 範本（ARM 範本）建立或更新 Azure Bot 資源。
這是布建和發佈 Bot 之較大程式的一部分。
- 如需完整程式的相關信息，請參閱 布建和發佈 Bot。
- 如需如何建立 App Service 資源的資訊，請參閱 使用 Azure CLI 建立 App Service 資源。
- 如需如何使用 Azure 入口網站 的指示，請參閱建立 Azure Bot 資源快速入門。
注意
Bot Framework JavaScript、C# 和 Python SDK 將會繼續受到支援，不過，Java SDK 即將淘汰，最終長期支援將於 2023 年 11 月結束。
使用 Java SDK 建置的現有 Bot 將繼續運作。
針對新的 Bot 建置，請考慮使用 Microsoft Copilot Studio ，並閱讀 選擇正確的 Copilot 解決方案。
如需詳細資訊，請參閱 Bot 建置的未來。
必要條件
若要使用 Azure CLI 來布建和發佈 Bot，您需要：
具有有效訂用帳戶的 Azure 帳戶。 建立免費帳戶。
Azure CLI 的安裝。
針對您的程式設計語言，請使用下列版本的 Azure CLI。 某些步驟不適用於較新版本的 CLI。
語言 CLI 版本 C# 和 JavaScript 2.39.0 或更新版本 Python 2.55.0 或更新版本 Java 2.29.2
此程式會使用 Azure Resource Manager 範本（ARM 範本）為您的 Bot 建立 Azure Bot 資源。
如果您沒有目前的範本，請在 deploymentTemplates 資料夾的 Bot 專案中建立複本：C#、JavaScript、Python 或 Java。
提示
這是布建和發佈 Bot 之較大程式的一部分。 如需必要條件的完整清單，請參閱如何 布建和發佈 Bot 。
編輯參數檔案
編輯 ARM 範本的參數檔案，以包含您想要使用的值。
重要
當您建立 App Service 和 Azure Bot 資源時，必須使用相同的 appType 和 appId 值。
如果您的專案尚未包含最新的 ARM 範本和參數檔案，您可以從適用於您語言的 Bot Framework SDK 存放庫複製它們： C#、 JavaScript、 Python 或 Java。
下表描述 參數檔案中的部署參數 ，以搭配 parameters 命令選項使用。
根據預設，參數檔案的名稱是 parameters-for-template-AzureBot-with-rg.json。
| 參數 | 類型 | 描述 |
|---|---|---|
azureBotId |
String | 必要。 Bot 的全域唯一且不可變的句柄，例如 ContosoCustomerService。 |
azureBotSku |
String | 選擇性。 Azure Bot 資源的 SKU。 允許的值：「F0」 （free） 和 「S1」 （standard）。 預設值為 「S1」。 |
azureBotRegion |
String | 選擇性。 Azure Bot 的位置。 允許的值：「global」、“westeurope”、“westus” 和 “centralindia”。 預設值為 「global」。。 |
botEndpoint |
String | 選擇性。 Bot 的傳訊端點，例如 https://<appServiceName>.azurewebsites.net/api/messages。 |
appType |
String | 必要。 Bot 資源的身分識別如何管理。 允許的值為：“MultiTenant”、“SingleTenant”和 “UserAssignedMSI”。 預設值為 「MultiTenant」。 |
appId |
String | 必要。 您稍早建立之身分識別資源的用戶端識別碼或應用程式識別碼。 這是應用程式服務的Microsoft應用程式標識碼。 |
UMSIName |
String | 選擇性。 針對使用者指派的受控識別應用程式類型，識別資源的名稱。 |
UMSIResourceGroupName |
String | 選擇性。 針對使用者指派的受控識別應用程式類型，識別資源的資源群組。 |
tenantId |
String | 選擇性。 針對使用者指派的受控識別和單一租使用者應用程式類型，Microsoft身分識別資源的 Entra ID 租使用者標識符。 |
提示
必須先設定 Bot 的傳訊端點，才能接收已發佈的 Bot 訊息。
並非所有參數都適用於所有應用程式類型。
提供、 UMSIResourceGroupName和tenantId的值UMSIName。
建立 Azure Bot 資源
若要為您的 Bot 建立 Azure Bot 資源，請使用下列命令。
az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
| 選項 | 描述 |
|---|---|
| 資源群組 | 要在其中建立App Service 的 Azure 資源群組名稱。 |
| template-file | App Service 的 ARM 範本路徑。 路徑可為相對路徑或絕對路徑。 |
| parameters | 要與 ARM 範本搭配使用的參數檔案路徑。 路徑可為相對路徑或絕對路徑。 |
對於使用最新產生器建立的專案，ARM 範本和參數檔案位於 專案的 DeploymentTemplates\DeployUseExistResourceGroup 資料夾中。 默認檔名為 template-AzureBot-with-rg.json 和 parameters-for-template-AzureBot-with-rg.json。
更新 Azure Bot 資源
若要新增或更新 Azure Bot 的傳訊端點，請使用下列命令。
az bot update --resource-group <resource group> --name <azureBotId> --endpoint <messaging-endpoint>
| 選項 | 描述 |
|---|---|
| 資源群組 | 包含 App Service 的 Azure 資源群組名稱。 |
| NAME | Bot 的全域唯一且不可變的句柄。 |
| endpoint | Bot 的傳訊端點，例如 https://<appServiceName>.azurewebsites.net/api/messages。 |
其他資訊
如需 ARM 範本的詳細資訊，請參閱 什麼是 ARM 範本？ 以及如何 搭配 Azure CLI 使用 Azure Resource Manager （ARM） 部署範本。
下一步
如果您已建立 App Service 作為 Bot 部署的一部分，請參閱 使用 ARM 範本 建立資源以繼續程式。