备注
本文仅适用于经典聊天机器人。 此功能在新的 Copilot Studio 体验中不可用。
将经典聊天机器人用作机器人服务机器人的 技能 时,机器人服务机器人将确定用户所说的任何内容是否与经典聊天机器人的 触发短语匹配。 如果有匹配项,机器人服务机器人可以将聊天传递给经典聊天机器人。 经典聊天机器人会提取任何实体并触发匹配的主题。
重要提示
您必须拥有试用版 或完整 Copilot Studio 授权,才能将经典聊天机器人用作技能。 Teams Copilot Studio 许可证不提供此功能。
将经典聊天机器人设置为技能:
先决条件
将机器人服务机器人添加到经典聊天机器人的允许列表
将机器人服务机器人的应用 ID 添加到要用作技能的经典聊天机器人的允许列表。 机器人必须在同一个租户中。
获取机器人服务机器人的Microsoft应用 ID。 可以在 Azure 门户或机器人配置中找到此信息。
在 Copilot Studio 中,打开您想要用作技能的经典聊天机器人。
在导航菜单中,转到设置,然后选择安全性。 然后选择允许列表。
选择添加允许的呼叫者。
粘贴机器人的应用 ID ,然后选择“ 下一步”。
注意
经典的聊天机器人不能作为其他经典聊天机器人的技能。 如果您尝试将属于 Power Virtual Agent 机器人的应用 ID 添加到允许列表,您将收到错误。 只能为机器人添加应用 ID。
Copilot Studio 验证机器人服务机器人的应用 ID,并确认它属于同一租户中的机器人。
(可选)为您添加到允许列表的聊天机器人添加显示名称。
选择保存。
如果输入了机器人服务机器人,则按其显示名称显示名称显示;如果未输入显示名称,则按其应用 ID 显示。 任何时间要删除或进行编辑,选择机器人显示名称或应用 ID 右侧的图标。
备注
添加到允许列表的机器人服务机器人不会 导出为机器人内容的一部分。
下载经典聊天机器人技能清单,适用于您的经典聊天机器人
机器人服务机器人可以使用 Copilot Studio 技能清单来配置与生成清单的经典聊天机器人的连接。
所有经典聊天机器人都有技能清单。 技能清单是一个 JSON 文件,包含技能名称、界面和触发短语。
机器人服务机器人可以使用技能清单来了解何时触发经典聊天机器人(例如,响应用户对它说的话)。
Copilot Studio 技能清单遵循 机器人服务技能清单架构版本 2.2 ,由 intents.lu 和 manifest.json 文件组成。
机器人服务机器人可能会根据清单数据决定经典聊天机器人应处理用户的请求。 它将用户所说的一切传递给经典聊天机器人。 然后,经典聊天机器人会将用户所说的内容与 Copilot Studio 主题进行匹配,提取出填补空白所需的任何内容,并触发 Copilot Studio 主题。
Copilot Studio 技能清单会自动生成和更新。 经典聊天机器人有两个技能清单:
测试清单:允许机器人服务机器人连接到经典聊天机器人的测试版本。 使用测试清单在发布之前验证技能的更改。
- 测试清单可立即用于每个新创建的经典聊天机器人。
- 每次保存经典聊天机器人时,它都会自动更新以反映更改。
已发布清单:允许机器人服务机器人连接到经典聊天机器人的已发布版本。
- 已发布清单仅可用于至少发布过一次的经典聊天机器人。
- 每次发布代理时,它都会自动更新以反映更改。
这两个技能清单都将在管理允许列表面板上显示。
技能清单还会显示在助手的详细信息页面上。 在导航菜单中,选择设置,然后选择详细信息。 详细信息页面显示其他元数据,包括环境 ID、租户 ID 和机器人应用 ID。
要下载清单,选择它。 它将下载为标记为 <机器人名称>manifest(对于已发布清单)或标记为 <机器人名称>test__manifest(对于测试清单)的 .zip 文件。
备注
技能清单不包括系统主题。 仅包含由 copilot 作者创建的主题和作者添加到机器人的意向触发器。
从机器人连接到 Copilot Studio 技能
可以使用 Copilot Studio 技能清单中的信息在机器人服务机器人中创建技能连接。
若要详细了解技能清单的结构,请参阅 技能清单。
技能清单的活动部分包含经典聊天机器人中提供的主题。
可以在机器人服务机器人中 实现技能使用者 ,以将经典聊天机器人称为技能。
使用机器人服务机器人将经典聊天机器人作为技能进行测试
机器人 服务模拟器 可以测试机器人服务机器人是否正确地将经典聊天机器人称为技能。
重要提示
必须将机器人服务机器人添加到经典聊天机器人的允许列表中,才能使技能连接正常工作。
将多租户机器人服务机器人更新为单租户机器人
下图显示了机器人服务机器人调用经典聊天机器人以将其用作技能的方案。
机器人服务机器人和经典聊天机器人都有一个Microsoft Entra ID 应用注册,由 Azure 机器人实例引用。 这些 Microsoft Entra ID 应用程序注册是作为多租户创建的。 机器人服务机器人从 机器人服务 租户请求令牌,并使用此令牌通过 Azure 机器人服务向 Copilot Studio 进行身份验证。 Copilot Studio 使用相同的机制来联系机器人服务机器人。
现在,Copilot Studio 聊天机器人的应用程序注册是作为单一租户创建的,因此这种通信不再有效。 Microsoft Entra ID 拒绝为不在同一租户中的单租户应用程序注册创建令牌。
此外,Copilot Studio 会验证传入的令牌,并拒绝来自它不希望出现的租户的请求,比如经典聊天机器人应用注册的创建租户 ID。
若要解决此问题,有两种可能的修复方法。
与机器人服务机器人位于同一租户中的经典聊天机器人
如果 Copilot Studio 聊天机器人已部署在机器人服务机器人所在的同一租户中,并且仅此机器人使用,请将机器人更新为单租户配置,然后重新部署机器人服务机器人。 有关如何为单租户配置机器人服务机器人的详细信息,请参阅 预配和发布机器人。
无法更新为单一租户的 Copilot Studio 聊天机器人
如果 Copilot Studio 聊天机器人已部署在机器人服务机器人所在的同一租户中,但机器人无法更新为单租户,则需要更新机器人服务机器人中的代码,以创建令牌以与 Copilot Studio 聊天机器人通信。 该标记需要为 Copilot Studio 聊天机器人创建的租户创建。 此外,响应必须被接受,这可能需要您按照将现有技能从多租户转换为单租户中的步骤操作。