通过

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

  • 项目

Copilot Studio 可让您使用 Bot Framework 技能扩展代理。 如果您已经在组织中针对特定场景构建并部署了机器人（使用 Bot Framework SDK 和专业代码工具），您可以将这些机器人转换为技能，并将该技能注册到 Copilot Studio 代理中。

备注

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

本文面向熟悉 Bot Framework 技能的系统管理员或 IT 专业人员。 在 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 中与技能相关的应用程序注册设置为多租户配置。

流操作和技能操作

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

流操作 技能操作
角色 代理创作者可以构建可重复使用的流，嵌入到任何代理对话中。 开发人员可以在自己的环境中创建、部署和托管自定义技能。
对话 将流用于简单的单回合操作。 例如，下订单或获取订单状态。 将技能用于复杂的多回合操作。 例如，安排会议或预订航班。
Response 使用流发出代理响应。 例如，显示个性化的消息或内联图像。 使用技能可发出任何受支持的代理响应。 例如，显示自适应卡或发送随机响应。
操作 使用流触发服务器端单回合操作。 例如，调用 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)		 检查您的代理是否已加入技能允许列表。