你当前正在访问 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 连接到技能时，他们首先需要 将技能导入 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 如何 配置技能。 |