在由世纪互联运营的 Microsoft Azure 中配置机器人

项目
10/25/2024

本指南可帮助 Microsoft Azure 客户在由世纪互联运营的 Microsoft Azure 平台上部署 Bot Framework 和 Azure AI 机器人服务机器人。

先决条件

由世纪互联运营的 Azure 中的帐户。
想要配置的 C# 或 JavaScript 机器人项目。
Bot Framework SDK 4.14 或更高版本。

使用云适配器

确保机器人使用云适配器，或云适配器派生的适配器。云适配器允许指定特定于 Azure 云的设置。

C#
JavaScript

ConfigurationBotFrameworkAuthentication 类从机器人配置文件读取身份验证设置。创建后，云适配器将使用这些身份验证设置。

请确保 Startup.cs 文件中的 ConfigureServices 方法包含此行。

services.AddSingleton<BotFrameworkAuthentication, ConfigurationBotFrameworkAuthentication>();

ConfigurationBotFrameworkAuthentication 构造函数从机器人配置文件读取身份验证设置。

在 index.js 文件中，用于创建适配器的代码应如下所示：

const botFrameworkAuthentication = new ConfigurationBotFrameworkAuthentication(process.env);

const adapter = new CloudAdapter(botFrameworkAuthentication);

配置 UserAssignedMSI/SingleTenant 机器人

为了确保机器人在 Microsoft Azure 云中正常运行，需要额外的身份验证设置。将“App-Tenant-ID”替换为机器人的租户 ID。

C#
JavaScript

将以下设置添加到 appsettings.json 文件。

"OAuthUrl": "https://token.botframework.azure.cn/", 
"ToChannelFromBotLoginUrl": "https://login.partner.microsoftonline.cn/<App-Tenant-ID>",
"ToChannelFromBotOAuthScope": "https://api.botframework.azure.cn",
"ToBotFromChannelTokenIssuer": "https://api.botframework.azure.cn",
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.cn/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true

将以下设置添加到 .env 文件。

OAuthUrl=https://token.botframework.azure.cn/, 
ToChannelFromBotLoginUrl=https://login.partner.microsoftonline.cn/<App-Tenant-Id>,
ToChannelFromBotOAuthScope=https://api.botframework.azure.cn,
ToBotFromChannelTokenIssuer=https://api.botframework.azure.cn,
ToBotFromChannelOpenIdMetadataUrl=https://login.botframework.azure.cn/v1/.well-known/openidconfiguration,
ToBotFromEmulatorOpenIdMetadataUrl=https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration,
ValidateAuthority=true

配置 MultiTenant 机器人

对于多租户机器人，请使用以下设置。

C#
JavaScript

将以下设置添加到 appsettings.json 文件。

"OAuthUrl": "https://token.botframework.azure.cn/", 
"ToChannelFromBotLoginUrl": "https://login.partner.microsoftonline.cn/microsoftservices.partner.onmschina.cn",
"ToChannelFromBotOAuthScope": "https://api.botframework.azure.cn",
"ToBotFromChannelTokenIssuer": "https://api.botframework.azure.cn",
"ToBotFromChannelOpenIdMetadataUrl": "https://login.botframework.azure.cn/v1/.well-known/openidconfiguration",
"ToBotFromEmulatorOpenIdMetadataUrl": "https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration",
"ValidateAuthority": true

将以下设置添加到 .env 文件。

OAuthUrl=https://token.botframework.azure.cn/, 
ToChannelFromBotLoginUrl=https://login.partner.microsoftonline.cn/microsoftservices.partner.onmschina.cn,
ToChannelFromBotOAuthScope=https://api.botframework.azure.cn,
ToBotFromChannelTokenIssuer=https://api.botframework.azure.cn,
ToBotFromChannelOpenIdMetadataUrl=https://login.botframework.azure.cn/v1/.well-known/openidconfiguration,
ToBotFromEmulatorOpenIdMetadataUrl=https://login.partner.microsoftonline.cn/a55a4d5b-9241-49b1-b4ff-befa8db00269/v2.0/.well-known/openid-configuration,
ValidateAuthority=true

向机器人添加身份验证

机器人可以使用各种标识提供程序代表用户访问资源，例如 Microsoft Entra ID 等 OAuth 提供程序。

Microsoft Azure 云使用的重定向 URL 与用于其他环境的 URL 不同。若要配置机器人进行身份验证，请使用 https://token.botframework.azure.cn/.auth/web/redirect 作为 OAuth 重定向 URL，并按照向机器人添加身份验证中的步骤操作。

配置在一个或多个通道上运行的机器人

若要配置机器人以连接到通道，请完成以下步骤：

登录到 Azure 门户。
选择要配置的机器人。
在左侧窗格的设置下选择渠道。
在右侧窗格中，选择要添加到机器人的通道的图标。可能需要向下滚动才能查看所有可用频道的列表。每个通道的连接步骤各不相同。有关支持的通道的详细信息，请参阅相关文章。

通道	说明
Direct Line	将机器人集成到移动应用、网页或其他应用程序中。
Microsoft Teams	将机器人配置为通过 Microsoft Teams 与用户通信。
网上聊天	使用 Bot Framework Service 创建机器人时自动配置。

后续步骤

通过这些步骤，机器人应被配置为能够成功工作。关于机器人服务的其他有用参考。

通过