你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
实现在 Copilot Studio 中使用的技能
适用于： SDK v4
技能是指可供另一个机器人使用的机器人。 通过这种方式，可以创建一个面向用户的机器人，并使用一个或多个技能对其进行扩展。 你可以在技能概述中了解有关技能的详细信息，并了解如何在实现技能中生成技能。 或者，虚拟助理模板包含一组预先构建的技能，你可以自定义和部署，而不是从头开始构建。
如果预计你的技能将从 Copilot Studio copilot 中使用，则必须考虑到你的技能存在一些其他限制。
清单限制
Copilot Studio 对你可以在技能清单中声明的内容施加了限制。
- 只能声明 100 个或更少的操作。
- 每个操作仅限 25 个或更少的输入或输出。
- 不能将数组类型用于输入或输出。
相同租户限制
为了确保注册用于 Copilot Studio 中的自定义技能的合规性和充分治理，你的技能机器人必须是 Microsoft Entra ID 中注册的应用程序。 添加技能时，我们会验证技能的应用程序 ID 是否位于已登录用户的租户中，以及技能终结点是否与已注册应用程序的 Home Page URL 匹配。
在 Copilot Studio 中将机器人注册为技能之前，必须确保机器人的主页将Azure 门户中的主页设置为机器人的技能清单 URL。
单租户和多租户限制
Copilot Studio 以前创建了多租户 Entra ID 应用程序。 但是，现在它正在创建单租户 Entra ID 应用程序。 若要使技能能够根据新的单租户 Entra ID 应用程序与代理正常工作，需要为单租户实例配置技能。 有关详细信息，请参阅 将现有技能从多租户转换为单租户 或 将多租户技能更新为单租户技能。
注册技能时执行的验证
当最终用户尝试从其 Copilot 连接到技能时，他们首先需要将技能导入 Copilot Studio。 你的技能需要经过一系列验证检查。 如果其中一项检查失败，可能会导致此表中所述的错误消息。
| 验证步骤 | 错误代码 | 错误消息 | 描述或缓解操作 |
|---|---|---|---|
| 清单 URL 有效 |
URL_MALFORMED, URL_NOT_HTTPS |
链接无效；链接必须以 https:// 开头 | 重新输入安全 URL 形式的链接。 |
| 清单可检索 | MANIFEST_FETCH_FAILED |
获取技能清单时遇到问题。 | 验证你的清单 URL 是指向清单的链接；尝试在 web 浏览器中打开清单 URL。 如果 URL 在 10 秒内呈现页面，请重新注册你的技能。 |
| 清单可读 | MANIFEST_TOO_LARGE |
清单太大。 | 清单的大小必须为 500 KB 或更小。 |
| 清单可读 | MANIFEST_MALFORMED |
清单不兼容。 | 检查清单是否为有效的 JSON 文件。 检查清单是否包含必需的属性，如 name、msaAppId 等。 有关详细信息，请参阅清单限制。 |
| 尚未注册技能 | MANIFEST_ALREADY_IMPORTED |
已将此技能添加到机器人。 | 删除技能并再次注册。 |
| 清单终结点和主页域名匹配 | MANIFEST_ENDPOINT_ORIGIN_MISMATCH |
技能终结点不匹配。 | Microsoft Entra ID 应用的主页 URL 域和清单 URL 域必须匹配。 请参阅相同租户限制 |
| 技能托管在已注册用户的租户中 | APPID_NOT_IN_TENANT |
若要添加技能，必须先注册。 | 管理员必须将技能注册到已登录用户的组织中。 |
| 操作受到限制 | LIMITS_TOO_MANY_ACTIONS |
技能限制为 100 个操作。 | 技能清单中定义的技能操作过多。 删除操作，然后重试。 |
| 操作输入参数受到限制 | LIMITS_TOO_MANY_INPUTS |
操作限制为 25 个输入。 | 技能操作输入参数过多。 请删除参数，然后重试。 |
| 操作输出参数受到限制 | LIMITS_TOO_MANY_OUTPUTS |
操作限制为 25 个输出。 | 技能操作输出参数过多。 请删除此参数，然后重试。 |
| 技能计数受到限制 | LIMITS_TOO_MANY_SKILLS |
机器人最多可以有 25 个技能。 | 机器人中添加了太多的技能。 请删除现有技能，然后重试。 |
| 安全令牌有效 | AADERROR_OTHER |
似乎出现了问题。 | 获取安全令牌以触发技能时可能会出现暂时性错误。 重新导入技能。 |
| 技能正常 |
ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED |
检查技能时出现一些问题。 | Copilot Studio 在向你的技能发送 EndOfConversation 活动时收到未知响应。 确保将单租户技能的应用注册部署到在其中创建代理的同一租户。 |
| 已授权技能 | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
此技能不允许列出你的机器人。 | 检查你的机器人是否在技能的允许列表中。 有关详细信息，请参阅 Copilot Studio 如何 配置技能。 |