你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将机器人注册到 Azure

  • 项目

适用于：SDK v4

如果当前未在 Azure 中托管机器人，仍可在 Azure 中使用它，并可使用 Azure 将机器人连接到通道。 为此，请在 Azure 中输入托管机器人的网页地址。

本文演示如何使用将此类机器人注册到 Azure AI 机器人服务。

重要

如果机器人未托管在 Azure 中，则只需注册机器人。 使用 Azure CLI 创建的机器人已注册到 Azure AI 机器人服务。

可以通过几种不同的方式在 Azure 中管理机器人标识。

  • 作为用户分配的托管标识，因此无需自行管理机器人的凭证。
  • 作为单租户应用。
  • 作为多租户应用。

对用户分配的托管标识和单租户应用类型的支持已添加到版本 4.15.0 中的 Bot Framework SDK 中（适用于 C# 和 JavaScript）。 其他语言或 Bot Framework Composer、Bot Framework Emulator 或 ngrok 不支持这些应用类型。

应用类型 支持
用户分配的托管标识 Azure AI 机器人服务和 C# 和 JavaScript SDK
单租户 Azure AI 机器人服务和 C# 和 JavaScript SDK
多租户 Azure AI 机器人服务、所有 Bot Framework SDK 语言、Composer、Emulator 和 ngrok

本文不介绍如何创建或部署要注册的机器人。 有关详细信息，请参阅：

创建资源

创建 Azure 机器人资源，以便将机器人注册到 Azure AI 机器人服务。

提示

无法创建新的 Web 应用机器人和机器人通道注册资源；但是，已配置和部署的任何此类现有资源将继续有效。 使用（从 SDK 版本 4.14.1.2 或更高版本创建的）VSIX 或 Yeoman 模板创建的机器人包含将生成 Azure 机器人资源的 ARM 模板。

  1. 转到 Azure 门户。

  2. 在右窗格中，选择“创建资源”。

  3. 在搜索框中，键入 bot，然后按 Enter。

  4. 选择 Azure 机器人卡。

    Select Azure bot resource

  5. 选择创建。

  6. 在必填字段中输入值，并检查和更新设置。

    1. 在“项目详细信息”下提供信息。 选择机器人是具有全局数据驻留还是本地数据驻留。 目前，本地数据驻留功能可用于“westeurope”和“centralindia”区域中的资源。 有关详细信息，请参阅 Azure AI 机器人服务中的区域化。

      The project details settings for an Azure Bot resource

    2. 在“Microsoft 应用 ID”下提供信息。 选择如何在 Azure 中管理机器人标识，以及是创建新的标识还是使用现有标识。

      The Microsoft app ID settings for an Azure Bot resource

  7. 选择“查看 + 创建”。

  8. 验证通过后，选择“创建”。

  9. 部署完成后，请选择“转到资源”。 应会看到所选资源组中列出的机器人和相关资源。

  10. 如果还没有 Bot Framework SDK，请选择“从 GitHub 下载”，了解如何使用首选语言的包。

    Create bot in SDK

现在，你已经准备好使用 Bot Framework SDK 生成机器人。

提示

当 Azure 使用新的应用 ID 创建新的单租户或多租户 Azure 机器人资源时，它还会生成密码。

机器人标识信息

按照以下步骤将标识信息添加到机器人的配置文件。 该文件因创建机器人所用的编程语言而异。

重要

Bot Framework SDK 的 Java 和 Python 版本仅支持多租户机器人。 C# 和 JavaScript 版本支持所有三种应用程序类型来管理机器人的标识。

语言 文件名 说明
C# appsettings.json 支持所有三种应用程序类型来管理机器人的标识。
JavaScript .env 支持所有三种应用程序类型来管理机器人的标识。
Java application.properties 仅支持多租户机器人。
Python config.py 仅支持多租户机器人。 将标识属性作为参数提供给 os.environ.get 方法调用。

需要添加的标识信息取决于机器人的应用程序类型。 提供配置文件中的以下值。

仅适用于 C# 和 JavaScript 机器人。

属性 值
MicrosoftAppType UserAssignedMSI
MicrosoftAppId 用户分配的托管标识的客户端 ID。
MicrosoftAppPassword 不适用。 此处为用户分配的托管标识机器人保留空白。
MicrosoftAppTenantId 用户分配的托管标识的租户 ID。

若要更新应用服务

如果机器人具有现有的App 服务资源（Web 应用），并且机器人是用户分配的托管标识应用程序，则可能需要更新机器人的应用服务：

  1. 转到机器人 Web 应用的“应用程序服务”边栏选项卡。
  2. 在“设置”下选择“标识”。
  3. 在“标识”边栏选项卡上，选择“用户分配”选项卡和“添加”（+）。
  4. 在“添加用户分配的托管标识”边栏选项卡上：

    1. 选择订阅。

    2. 对于用户分配的托管标识，请选择机器人的托管标识。 如果自动生成托管标识，它将与机器人同名。

    3. 选择“添加”以将此标识用于机器人。

      The App Service Identity blade with the managed identity for the bot selected.

若要获取应用或租户 ID

若要获取机器人的应用或租户 ID：

  1. 转到机器人的“Azure 机器人”资源边栏选项卡。
  2. 转到机器人的“配置”边栏选项卡。 在此边栏选项卡中，可以复制机器人的“Microsoft 应用 ID”或“应用租户 ID”。

若要生成新密码

单租户和多租户机器人具有某些操作所需的应用机密或密码。 Azure AI 机器人服务会隐藏机器人机密。 但是，机器人的应用服务资源的所有者可以生成新密码：

  1. 转到机器人的“Azure 机器人”资源边栏选项卡。
  2. 转到机器人的“配置”边栏选项卡。
  3. 选择“管理”，在 Microsoft 应用 ID 旁边，转到应用服务的“证书 + 机密”边栏选项卡。
  4. 按照边栏选项卡上的说明创建新的客户端密码，并将值记录在安全的位置。

手动应用注册

发生以下情况时需要手动注册：

  • 你无法在组织中注册，需要另一方为你正在生成的机器人创建应用 ID。
  • 你需要手动创建自己的应用 ID 和密码。

更新机器人

若要更新机器人的配置文件以包含其应用 ID 和密码，请参阅如何配置机器人注册设置中的应用 ID 和密码。

其他信息

有关 Azure 应用程序的一般信息，请参阅以下文章。

Subject 文章
应用注册 快速入门：将应用程序注册到 Microsoft 标识平台
托管标识 什么是 Azure 资源的托管标识？
单租户应用和多租户应用 Microsoft Entra ID 中的租户

后续步骤

管理机器人