了解错误代码

重要提示

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

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

当助手在对话过程中遇到问题时，它会回复一条消息，其中包含所遇到的特定问题的错误代码。 助手用户应将此错误代码告知管理员。

作为助手制作者，如果您在使用测试面板测试您的助手时出现问题，除错误代码外，您还会看到一条有关该问题的更多信息。 或者，您可以使用主题检查器面板来验证您的助手。

错误列表

Web 应用程序

备注

在引用主题时，术语对话用于一些错误消息中。

错误代码	Description
ContentError	主题内容有误。
DataLossPreventionViolation	存在数据丢失防护冲突。
FlowActionException	执行云端流时出错。
FlowActionBadRequest	对云端流发出的请求格式错误。
FlowActionTimedOut	云端流运行需要的时间超过 100 秒，已超时。
InvalidContent	向代码编辑器中添加的内容无效。
InfiniteLoopInBotContent	节点执行次数过多。
LatestPublishedVersionNotFound	无法检索已发布的助手版本。
RedirectToDisabledDialog	主题将重定向到已禁用的主题。
RedirectToNonExistentDialog	主题将重定向到另一个不再存在的主题。
SystemError	Microsoft Copilot Studio 中出现系统错误。

ContentError

错误消息：此错误会根据错误的上下文生成动态消息。

解决办法：对于与您的助手内容相关的问题，这是一个包罗万象的错误。 请参阅错误消息以了解更多详细信息。

常见问题包括：

• 节点缺少必需属性。
• 通过代码编辑器添加的 YAML 无效。
• Power Fx 公式包含错误。

DataLossPreventionViolation

错误消息：此环境要求用户登录后才能使用助手。 转到“管理”>“安全”>“身份验证”并选择要求用户登录的选项。”

解决：

• 环境的数据丢失防护 (DLP) 策略要求用户登录。 请参阅配置用户身份验证。
• 助手中使用的一个或多个连接器不在同一数据组中。 请参阅Microsoft Copilot Studio连接器。
• 租户管理员阻止了助手中使用的一个或多个连接器。

FlowActionException

错误消息：

• “没有从流 {FlowName} ({FlowId}) 中收到输出，即使根据助手定义应该收到输出也是如此。”
• “响应数据中缺少流 {FlowName} ({FlowId}) 上名称为 {ItemKey} 的输出参数。 请刷新此流，或确保此流返回该值。”
• “输出架构中缺少流 {FlowName} ({FlowId}) 上名称为 {ItemKey} 的输出参数。 请刷新此流。”

解决方法：检查流是否有错误。

FlowActionBadRequest

错误消息：

• “流 {FlowName} ({FlowId}) 上名称为 {KeyName} 的参数被声明为 {ItemTypeKind} 类型。 调用 Power Automate 时不支持此类型。 当前，仅支持文本、布尔和数字。”
• “‘调用流’操作中缺少流 {FlowName} ({FlowId}) 上名称为 {ItemKey} 的输出参数。”
• “流 {FlowName} ({FlowId}) 上名称为 {KeyName} 的参数被评估为 {ResolveType} 类型，但预期类型为 {ExpectedType}。”
• “流 {FlowName} ({FlowId}) 无法运行，响应代码为 {ResponseCode}，错误代码为 {FlowErrorCode}。”

解决方法：检查您传递给流的任何变量的基本类型是否与参数的类型匹配。

FlowActionTimedOut

错误消息：“id 为 {FlowId} 的流已超时。错误代码：{FlowErrorCode}”

解决：检查流是否存在错误，以了解为什么云端流在返回助手之前需要超过 100 秒来运行。 尝试优化查询以及从后端系统返回的数据。 如果在将结果发送到助手后，某些云端流逻辑可以继续运行，将这些操作放在云端流中的“将值返回 Microsoft Copilot Studio”步骤之后。

InvalidContent

错误消息：“助手中总共存在 {TotalComponents} 个组件，但没有一个是有效的。”

解决方法：打开代码编辑器以查看内容问题。

InfiniteLoopInBotContent

错误消息：“操作 {DialogId}.{TriggerId}.{ActionId} 连续执行超过 {MaxTurnCount} 次。 这表明对话执行中有一个循环，因此对话执行将被终止。”

解决方法：确保主题正确结束，或链接到正确结束的其他主题，如升级系统主题。

LatestPublishedVersionNotFound

错误消息：“无法检索最新发布的助手版本。”

解决方法：发布助手。

RedirectToDisabledDialog

错误消息：“ID 为 {DialogId} 的对话在定义中处于禁用状态。 请在使用对话之前启用它。”

解决方法：重新启用主题或删除重定向节点。

RedirectToNonExistentDialog

错误消息：“在定义中未找到 ID 为 {DialogId} 的对话。 请检查对话是否存在并且 ID 是否正确。”

解决方法：创建一个要重定向到的新主题或删除重定向节点。

SystemError

错误消息：此错误不会生成错误消息

解决方法：联系客户支持。

经典

Error	机器人响应	解决
2000	“用户陷入了无限循环。 请进行检查以确保 {Topic Name} 得出合乎逻辑的结论。”	确保主题正确结束，或链接到正确结束的其他主题，如升级系统主题。
2001	“机器人内容无效。”	检查主题是否有错误。
2002	“我们遇到了 CDS 问题。”	访问 Dataverse 时出现问题。 检查配置中是否出错。 如果没有，请稍后重试，可能是因为有服务问题。
2003	“{Topic Name} 中的 {Flow Name} 有问题。 请检查您的内容。”	检查流是否有错误并在流运行历史记录中查找失败的运行。
2004	“{Topic Name} 中的 {Skill Name} 有问题。 请检查您的内容。”	您的技能有问题。 请检查技能和主题是否有错误。
2005	“我们遇到了问题。 请检查您的内容。”	您的 Power Automate 流模板有问题。 检查流是否有错误。
2006	“我们未能找到您的机器人。”	无法找到您的机器人，原因是机器人或机器人的环境已被删除。 要配置新机器人，请参阅创建和删除机器人。 要配置新环境，请参阅使用环境。
2007	“机器人包含的内容过多，无法工作。”	请减少消息长度或主题数量，然后重试。 阅读有关内容限制的详细信息。
2008	“我们未能找到用户的令牌。”	请检查您的机器人的授权配置是否有错误。
2009	“要使用此机器人，请在 Microsoft Copilot Studio 中发布它。”	要使用此机器人，请在 Microsoft Copilot Studio 中发布它。
2010	“我们无法检索您的机器人内容。”	找不到内容，原因是内容已被删除。 要配置新机器人，请参阅创建和删除机器人。 要配置新环境，请参阅使用环境。
2011	“我们在 {Topic Name} 中找不到 {Skill Name}。 请检查您的内容。”	找不到技能，原因是技能已被删除。 要创建新技能，请参阅配置技能。
2012	“我们在 {Topic Name} 中找不到 {Flow Name}。 请检查您的内容。”	找不到您的 Power Automate 流，原因是流已被删除。 要创建新流，请参阅使用 Power Automate 添加操作。
2014	“翻译服务未响应。”	请稍后重试。 如果此问题仍然存在，请与客户支持联系。
2015	“您无权呼叫 {Skill Name}。 请检查该技能及其用法是否存在任何问题。”	请检查您的技能配置，确保您的机器人已被添加到技能的允许列表中。
2016	“抱歉，我们未能找到您的机器人。”	Azure 机器人服务渠道出现问题。 渠道可能已被删除或配置不正确。
2017	“抱歉，我们未能访问您的机器人。”	Azure 机器人服务渠道无法访问。 检查渠道配置是否存在身份验证问题。
2018	“用户键入得过快。”	您发送消息太快。 阅读有关 Microsoft Copilot Studio 中的配额和限制的详细信息。
2019	“我们未能找到您的环境。 可能已删除了它。”	您的环境已被删除。 要配置新环境，请参阅使用环境。
2020	“出现了问题，{Flow Name} 未在 {Topic Name} 中工作。 请稍后重试。 如果问题仍然存在，请检查您的流的设置和运行历史记录。”	您的 Power Automate 流未正常工作。 请稍后重试。 如果问题仍然存在，请检查流是否有错误。
2021	“当前轮次中执行的对话次数超过了最大值 {Dialog Limit}。”	默认情况下，主题数最多为 50 个。 请减少主题数量，然后重试。
2022	“机器人在此轮中发送了超过 {Message Limit} 条消息。”	请将每轮消息限制在 30 条以下。
2023	“我们在执行您的编辑器对话时遇到问题。”	请检查 Composer 对话是否有错误。
2024	“此环境要求用户登录后才能使用机器人。 转到“管理”>“安全”>“身份验证”并选择要求用户登录的选项。”	环境的数据丢失防护 (DLP) 策略要求用户登录。 若要了解如何要求用户登录，请参阅配置用户身份验证。
2025	“主题 {Topic Name} 中有一个或多个空节点，请检查您的内容。”	请向空节点添加内容或从主题中删除节点。
2025	“{Topic Name} 正在重定向到一个已关闭的主题。 请返回到 {Topic Name} 并检查您的内容。”	您的主题正在重定向到另一个已关闭的主题。 请重新启用主题或删除重定向节点。
2025	“您尝试重定向的主题已不存在。 请返回到 {Topic Name} 并检查您的内容。”	您正在尝试重定向的主题已不存在。 请创建一个新的用于重定向的主题或删除重定向节点。
2026	“Power Automate 流出现问题。 请检查您的内容。”	检查流是否有错误。
2030	“检查 Power Automate 流运行历史记录，确保流运行成功。”
2101	“用户与机器人的对话过久或用户的消息过长。”	请尝试重新启动与机器人的对话或使用较短的消息。
2102	“用户发送的消息太大，无法处理。”	您发送的消息太大，无法处理。 请缩短消息，然后重试。
3000	“意外错误”	出现系统错误。 请联系客户支持了解更多详细信息。
3001	“Power Automate 现在不可用于您的流 {Flow Name}。 请稍后重试。”	Power Automate 未响应。 请重新启动与您的机器人的对话，然后重试。 如果此问题仍然存在，请与客户支持联系。
3002	“Power Automate 中出现了问题，因此未接受您对流 {Flow Name} 的请求。 请稍后重试。”	Power Automate 中发生错误，对您的流的请求未被接受。 您的流可能需要 2 分钟以上的时间作出响应。
3003	“连接到您的流 {Flow Name} 时出现网络问题。 请稍后重试。”	请稍后重试。 如果此问题仍然存在，请与客户支持联系。

Teams

Error	机器人响应	解决
2100	“用户键入得过快。”	与机器人的交互会受速率限制，以减少垃圾邮件。 请放慢键入速度重试。