你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
配置机器人注册设置
适用于：SDK v4
可在机器人配置文件窗格中查看和修改 Azure 机器人资源设置，如显示名称、图标和说明。 可在配置窗格中查看和修改 Azure 机器人资源设置，如消息传送终结点、Microsoft 应用 ID 和 Application Insights。
机器人配置文件
机器人配置文件字段列表如下：
| 字段 | 说明 |
|---|---|
| 图标 | 自定义图标，用于直观地识别通道中的机器人，并作为 Microsoft Teams 等服务中机器人的图标。 |
| 显示名称 | 通道和目录中机器人的名称。 稍后可以随时更改此值。 |
| 机器人句柄 | 机器人的唯一标识符。 使用机器人服务创建机器人后，无法更改此值。 |
| 说明 | 机器人说明。 有些通道显示说明。 稍后可以随时更改此值。 |
如要保存所做的更改，请选择边栏选项卡底部的应用。
配置
配置字段列表如下：
| 字段 | 说明 |
|---|---|
| 消息传送终结点 | 与机器人通信的终结点。 |
| Microsoft 应用 ID | 机器人的唯一标识符。 无法更改此值。 可单击“管理”链接生成新密码。 |
| 架构转换版本 | 用于此机器人的机器人架构转换版本。 如欲了解详细信息，请参阅将机器人连接到通道。 |
| Application Insights 检测密钥 | 机器人遥测数据的唯一密钥。 如果要接收此机器人的机器人遥测数据，请将 Azure Application Insights 密钥复制到此字段。 此值是可选的。 有关此字段的更多详细信息，请参阅 Application Insights 密钥。 |
| Application Insights API 密钥 | 机器人分析的唯一密钥。 如果要在仪表板中查看有关机器人的分析，请将 Azure Application Insights API 密钥复制到此字段。 此值是可选的。 有关此字段的更多详细信息，请参阅 Application Insights 密钥。 |
| Application Insights 应用程序 ID | 机器人分析的唯一 ID。 如果要在仪表板中查看有关机器人的分析，请将 Azure Insights 应用程序 ID 密钥复制到此字段。 此值是可选的。 有关此字段的更多详细信息，请参阅 Application Insights 密钥。 |
如要保存所做的更改，请选择边栏选项卡底部的应用。
机器人标识信息
按照这些步骤将标识信息添加到机器人的配置文件。 该文件因创建机器人所用的编程语言而异。
重要
Bot Framework SDK 的 Java 和 Python 版本仅支持多租户机器人。 C# 和 JavaScript 版本支持所有三种机器人标识管理应用程序。
| 语言 | 文件名 | 说明 |
|---|---|---|
| C# | appsettings.json | 支持所有三种机器人标识管理应用程序。 |
| JavaScript | .env | 支持所有三种机器人标识管理应用程序。 |
| Java | application.properties | 仅支持多租户机器人。 |
| Python | config.py | 仅支持多租户机器人。 将标识属性作为 os.environ.get 方法调用的参数提供。 |
需要添加的标识信息取决于机器人的应用程序类型。 提供配置文件中的以下值。
仅适用于 C# 和 JavaScript 机器人。
| 属性 | Value |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
用户分配的托管标识的客户端 ID。 |
MicrosoftAppPassword |
不适用。 为用户分配的托管标识机器人留空。 |
MicrosoftAppTenantId |
用户分配的托管标识的租户 ID。 |
其他信息
可以使用 az bot update 从命令行更新机器人设置。