配置要在 Copilot Studio 中使用的 Bot Framework 技能

重要提示

继在生成式人工智能的重大投资和跨 Microsoft Copilot 的增强集成之后，Power Virtual Agents 功能和特性现已成为 Microsoft Copilot Studio 的一部分。

在我们更新文档和培训内容时，一些文章和截图可能会参考 Power Virtual Agents。

Copilot Studio 用于使用 Bot Framework 技能扩展助手。 如果已经（使用 Bot Framework SDK 和程序代码工具）在组织中为特定方案创建和部署了机器人，可以将这些机器人转换为技能，并在 Copilot Studio 助手中注册该技能。

备注

您可以在 Microsoft Teams 中的 Copilot Studio 应用中添加技能，但是您必须拥有 Microsoft Copilot Studio 独立订阅。

本文面向熟悉 Bot Framework 技能的系统管理员或 IT 专业人员。 在 Copilot Studio 助手中注册技能之后，创作者可无缝地在对话中触发技能操作。

先决条件

• 查看 Copilot Studio 中使用的技能的限制和验证

重要提示

Copilot Studio 助手仅支持使用 Bot Framework SDK 版本 4.12.0+ 构建的技能。

经典 助手仅支持使用 Bot Framework SDK 版本 4.7+ 构建的技能。

如果您使用的是 Bot Framework Composer，强烈建议您使用 Composer 2.x。 如果您想要使用现有的 Composer 1.x 助手，请首先将其迁移到 Composer 2.x，然后再将其用作技能。

要配置技能，您的技能在 Microsoft Entra ID 中的关联应用程序注册应设置为多租户配置。

流操作和技能操作

下表可帮助确定何时为对话使用技能。

	流操作	技能操作
角色	助手作者可以创建可重复使用的流以嵌入到任何助手对话中	开发人员可以在自己的环境中创建，部署和托管自定义技能
对话	将流用于简单的单回合操作。 例如，下订单或获取订单状态。	将技能用于复杂的多回合操作。 例如，安排会议或预订航班。
响应	将流用于发出助手响应。 例如，显示个性化的消息或内联图像。	使用技能发出任何受支持的助手响应。 例如，显示自适应卡或发送随机响应。
操作	使用流触发服务器端单回合操作。 例如，调用 HTTP API 或触发自定义连接器。	使用技能触发服务器端和客户端事件和操作。 例如，在收到助手响应时导航到某个页面。

配置技能

首先，使用 Copilot Studio 创建 助手和使用程序代码工具创建技能并部署到组织中。

注册技能之前，将助手的 ID 提供给技能开发人员，以便为助手授予在技能中调用操作的权限。 了解有关技能允许列表的详细信息。 您可以从添加技能窗口获取助手的 ID。

为助手添加技能：

1. 在左侧导航窗格中，展开设置并选择技能。

2. 在技能页面顶部，选择添加技能。

3. 复制您的助手 ID 并将其提供给您的技能开发人员。

   

4. 输入技能清单的 URL。 技能清单中包含助手要触发技能内的操作所需信息。

5. 选择下一步开始执行验证流程。 验证成功后，您的技能将添加到您的助手中。 现在可以在主题中使用此技能。

合规性注意事项

为了保护用户隐私，我们要求技能在已登录用户的 Microsoft Entra ID 租户中注册为应用。

诊断技能注册期间的错误

将对 URL 进行一系列验证检查。 这些检查确保要添加到助手的技能的合规性、治理和可用性。 注册技能之前，需要解决这些错误。

错误消息	疑难解答/缓解
获取技能清单时遇到问题。 (MANIFEST_FETCH_FAILED)	请尝试在 Web 浏览器中打开您的清单 URL。 如果该 URL 在 10 秒钟内呈现页面，请重新注册技能。
清单不兼容。 (MANIFEST_MALFORMED)	(a) 检查清单是否是有效的 JSON 文件。 (b) 检查清单中是否包含必需属性 例如（name、msaAppId、单个 endpoint、activities/id、activities/description、activities/type（仅支持 event 或 message））。
终结点中存在不匹配 (MANIFEST_ENDPOINT_ORIGIN_MISMATCH)	检查您的技能端点是否与您的 Microsoft Entra ID 申请注册的 Publisher domain（首选）或 Home page URL 字段匹配。 详细了解为终结点设置主页。
要添加技能，必须首先进行注册 (APPID_NOT_IN_TENANT)	检查您的技能的申请 ID 是否已在贵组织的 Microsoft Entra ID 租户中注册。
链接无效；链接必须以 https:// 开头 （URL_MALFORMED、URL_NOT_HTTPS）	重新输入安全 URL 形式的链接。
此清单太大； (MANIFEST_TOO_LARGE)	检查清单的大小。 必须小于或等于 500KB。
此技能已添加到您的助手。 (MANIFEST_ALREADY_IMPORTED)	删除技能，然后重试注册。
技能不能超过 100 个操作。 (LIMITS_TOO_MANY_ACTIONS)	技能清单中定义的技能操作过多。 删除操作，然后重试。
操作不能超过 25 个输入。 (LIMITS_TOO_MANY_INPUTS)	技能操作输入参数太多。 删除参数，然后重试。
操作不能超过 25 个输出。 (LIMITS_TOO_MANY_OUTPUTS)	技能操作输出参数太多。 删除参数，然后重试。
助手最多可以有 100 个技能。 (LIMITS_TOO_MANY_SKILLS)	助手中添加的技能太多。 删除一个现有技能，然后重试。
似乎出现了问题。 (AADERROR_OTHER)	验证技能时出现暂时性错误。 请重试。
检查技能时出错。 （ENDPOINT_HEALTHCHECK_FAILED、HEALTH_PING_FAILED）	检查技能终结点是否已联机且正在响应消息。
此技能未将您的助手 (ENDPOINT_HEALTHCHECK_UNAUTHORIZED) 列入允许列表中	检查是否已将您的助手添加到技能允许列表中。