使用 Azure 入口網站 建立 Azure Bot 資源

適用於: SDK v4

Azure Bot 資源 (Bot 資源) 可讓您向 Azure AI Bot Service 註冊 Bot,並將 Bot 連線至通道。 您可以建置、連線及管理 Bot,以與使用者互動,無論使用者身在何處,從您的應用程式或網站到 Teams、Messenger 和其他許多頻道。

本文說明如何透過 Azure 入口網站 建立 Bot 資源。

管理資源

當您建立 Bot 資源時,Azure 會建立相關聯的資源。 建立的一些資源取決於您決定如何管理 Bot 的身分識別。

Bot 的身分識別可以透過數種方式在 Azure 中管理:

  • 身為 由使用者分配的管理式身分,因此您不需要人工管理憑證。
  • 作為單一 租 用戶應用程式。
  • 作為多租戶應用程式。

附註

  • Bot Framework SDK for C#、JavaScript 和 Python 中提供 使用者指派的受控識別 和 單一租戶 應用程式類型支援。
  • 其他 SDK 語言、Bot Framework Composer、Bot Framework Emulator 或 Dev Tunnel 不支援 這些應用程式類型。

重要

  • 多租戶機器人建立將在 2025 年 7 月 31 日之後被淘汰。
  • 現有的多租使用者 Bot 將繼續運作,但該日期之後將不再支援新的多租使用者 Bot 建立。
  • 若要確保持續支援,請繼續使用單一租戶或使用者指派的受控身份。

支援的應用程式類型

應用程式類型 支援於
使用者指派的受控識別 Azure AI Bot Service;C#、JavaScript 和 Python SDK
單一租戶 Azure AI Bot Service;C#、JavaScript 和 Python SDK
多租戶 (已淘汰 – 將於 2025 年 7 月 31 日終止) Azure AI Bot Service; 所有 Bot Framework SDK 語言; Bot Framework Composer; 模擬器; 開發管道

必要條件

  • 如果您沒有 Azure 訂用帳戶,請在開始前建立免費帳戶。
  • 適用於 C# 或 JavaScript 的 Bot Framework SDK 4.15.0 或更新版本,適用於使用者指派的受控識別和單一租用戶機器人。

建立資源

建立 Azure Bot 資源,可讓您向 Azure AI Bot 服務註冊 Bot。

提示

無法建立新的 Web 應用程式 Bot 和 Bot 通道註冊 資源;不過,任何已設定和部署的現有資源都會繼續運作。 從 SDK 4.14.1.2 版或更新版本建立的 VSIX 或 Yeoman 樣本所建立的 Bot 包含將產生 Azure Bot 資源的 ARM 範本。

  1. 前往 Azure 入口網站。

  2. 在右窗格中,選取 [建立資源]。

  3. 在搜尋方塊中輸入 bot,然後按 Enter。

  4. 選取 Azure Bot 卡片。

    選取 Azure Bot 資源

  5. 選取 建立。

  6. 在必要欄位中輸入值,然後檢閱和更新設定。

    1. 在專案詳細資料下提供資訊。 選取您的機器人要採用全域或本地資料駐留。 目前,「本地資料落地」功能適用於位於「westeurope」和「centralindia」區域的資源。 如需詳細資訊,請參閱 Azure AI Bot Service 中的區域化。

      Azure Bot 資源的專案詳細數據設定

    2. 在 Microsoft App ID 下提供資訊。 選取如何在 Azure 中管理 Bot 身分識別,以及建立新的身分識別或使用現有的身分識別。

      Azure Bot 資源的Microsoft應用程式標識碼設定

  7. 選取 [檢閱 + 建立]。

  8. 如果驗證通過,請選取 [ 建立]。

  9. 部署完成後,請選取 前往資源。 您應該會看到 Bot 和相關資源列在您選取的資源群組中。

  10. 如果您還沒有 Bot Framework SDK,請選取 [從 GitHub 下載] 以瞭解如何取用您慣用語言的套件。

    在 SDK 中建立 Bot

您現在已準備好使用 Bot Framework SDK 建置 Bot。

提示

當 Azure 使用新的應用程式識別碼建立新的單一租使用者或多租使用者 Azure Bot 資源時,也會產生 密碼。

Bot 身分識別資訊

請遵循下列步驟,將身分識別資訊新增至 Bot 的組態檔。 檔案會根據用來建立 Bot 的程式設計語言而有所不同。

重要

  • Bot Framework SDK 的 Java 版本僅支援 多租戶 機器人。
  • C#、JavaScript 和 Python 版本支援這三種應用程式類型來管理 Bot 的身分識別。
語言 檔案名稱 備註
C# appsettings.json 支援這三種應用程式類型來管理 Bot 的身分識別。
JavaScript .env 支援這三種應用程式類型來管理 Bot 的身分識別。
JAVA application.properties 僅支援多租戶機器人。
Python config.py 支援這三種應用程式類型來管理 Bot 的身分識別。

您需要新增的身分識別資訊取決於 Bot 的應用程式類型。 在您的組態檔中提供下列值。

適用於 C#、JavaScript 和 Python Bot。

屬性 值
MicrosoftAppType UserAssignedMSI
MicrosoftAppId 使用者指派受控識別的用戶端標識碼。
MicrosoftAppPassword 不適用。 若為使用者指派的受控識別 Bot,請將此欄位留白。
MicrosoftAppTenantId 使用者指派受控識別的租用戶標識碼。

更新您的應用程式服務

如果您的 Bot 有現有的 App Service 資源(Web 應用程式),而 Bot 是 使用者指派的受控識別 應用程式,您可能需要更新 Bot 的應用程式服務:

  1. 移至 Bot Web 應用程式的 App Service 刀鋒視窗。
  2. 在 [設定] 底下,選取 [身分識別]。
  3. 在 身分識別 刀鋒中,選取 使用者指派 索引標籤,然後選取 新增 (+)。
  4. 在 [ 新增使用者指派的受控識別 ] 刀鋒視窗上:
    1. 選取您的訂用帳戶。

    2. 針對 [使用者指派的受控識別],選取 Bot 的受控識別。 如果為您自動產生受控識別,其名稱會與您的 Bot 相同。

    3. 選取 [ 新增 ] 以針對您的 Bot 使用此身分識別。

      已選取 Bot 的受控識別的 App Service Identity 刀鋒。

取得您的應用程式 ID 或租用戶 ID

若要取得您的機器人應用程式 ID 或租用戶 ID:

  1. 前往您 Bot 的 Azure Bot 資源分頁。
  2. 前往機器人的 設定 窗格。 在此刀鋒視窗中,您可以複製 Bot 的 Microsoft App ID 或 App Tenant ID。

產生新密碼

單一租用戶和多租用戶機器人具有某些作業需要用到的應用程式祕密或密碼。 Azure AI Bot Service 會隱藏您的機器人密碼。 不過,Bot App Service 資源的擁有者可以產生新的密碼:

  1. 前往您 Bot 的 Azure Bot 資源分頁。
  2. 前往機器人的 設定 窗格。
  3. 選取 Manage(位於 Microsoft App ID 旁),以前往該 App Service 的 Certificates + secrets 刀鋒視窗。
  4. 請按照刀鋒中的指示建立新的用戶端密碼,並將其值記錄在安全的地方。

其他資訊

附註

Bot Framework Composer 和 Bot Framework 模擬器目前僅支援多租用戶 Bot。 使用者指派的受控識別身分和單一租用戶 Bot 需要適用於 C# 或 JavaScript 的 Bot Framework SDK 4.15.0 或更新版本。

技能支援

某些類型的技能使用者無法使用某些類型的技能機器人。 下表描述支援哪些組合。

  多租使用者技能 單一租使用者技能 使用者指派的受控識別技能
多租戶取用者 受支援 不支援 不支援
單一租用戶客戶 不支援 如果兩個應用程式都屬於相同的租使用者,則支援 如果兩個應用程式都屬於同一個租戶,則受支援
使用者指派的受控識別取用者 不支援 如果兩個應用程式都屬於同一個租戶,則支援 若兩個應用程式皆屬於同一租用戶,則受支援

如需如何設定技能或技能取用者的資訊,請參閱 實作技能 或 實作技能取用者。

下一步