通过

了解错误代码

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

作为代理制作者，如果在使用测试窗格测试代理时出现问题，除了错误代码外，还可以看到一条包含更多问题相关信息的消息。 或者，您也可以使用主题检查器面板来验证代理。

错误列表

注释

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

错误代码 Description
AIModelActionRequestTimout 调用 AI Builder 模型时，出现了超时错误。
AsyncResponsePayloadTooLarge 出现与连接器的输出相关的错误。
用户未提供同意 与代理交互的用户拒绝代理的 SSO 请求。
ContentError 主题内容有误。
DataLossPreventionViolation 数据策略冲突。
EnforcementMessageC2 没有足够的预付费容量可用。
FlowActionException 执行 代理流时出错。
FlowActionBadRequest 对 代理流 发出的请求格式不正确。
FlowActionTimedOut 代理流运行超过100秒后超时。
FlowMaker连接阻塞 在连接中使用未经授权的创建者凭据调用的代理流
GenAISearchandSummarizeRateLimitReached 生成式 AI 的使用限制已达到。
GenAIToolPlannerRateLimitReached 已达到生成式业务流程的使用限制。
InvalidContent 向代码编辑器中添加的内容无效。
InfiniteLoopInBotContent 节点执行次数过多。
LatestPublishedVersionNotFound 无法检索代理的已发布版本。
OutgoingMessageSizeTooBig 代理发送的信息过大，无法处理。
TooMuchDataToHandle 用户发出的请求太大，无法处理。
OpenAIRateLimitReached 已达到智能体的产能限制。
RedirectToDisabledDialog 主题将重定向到已禁用的主题。
RedirectToNonExistentDialog 主题将重定向到另一个不再存在的主题。
SystemError Copilot Studio 中出现系统错误。

AIModelActionRequestTimeout

错误信息： 提示prompt-name运行超时。

分辨率： 确保对 AI Builder 模型的调用不超过 100 秒。

AsyncResponsePayloadTooLarge

错误信息： 从连接器返回的输出太大，无法由代理处理。 尝试通过使用可用的连接器筛选器或限制配置的作输出数来减小其大小。

解决方案： 代理的一个实时连接器返回的负载大于代理可以处理的上限。 有关有效负载限制的详细信息，请参阅 Copilot Studio Web 应用限制。

用户未提供同意

错误信息： 未提供 SSO 连接的许可。

分辨率： 与代理交互的用户必须使用代理的单一登录连接提示确认连接。

ContentError

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

解决方法：此消息是与您的智能体内容相关问题的通用错误。 错误信息提供了更多详细信息。

常见问题包括：

DataLossPreventionViolation

错误信息： 此环境要求用户在使用代理之前登录。 转到“管理 > 安全 > 身份验证”，然后选择要求用户登录的选项。

解决方法：

EnforcementMessageC2

错误信息： 此代理当前不可用。 它已达到其使用限制。 请稍后重试。”

分辨率： 当代理达到其消息容量或即用即付计量达到其限制时，将返回此消息。 若要解决此问题，请添加更多预付费容量或创建即用即付计费计划。 然后，代理聊天应在 5 分钟内恢复正常运行。 有关详细信息，请转到超额实施。

FlowActionException

错误消息：

  • 流 {FlowName} （{FlowId}）未收到任何输出，即使根据代理定义预期输出也是如此。
  • 流 {FlowName} （{FlowId}）上名为 {ItemKey} 的输出参数缺少响应数据。 刷新流，或确保流返回此值。
  • 输出架构中缺少在流 {FlowName} ({FlowId}) 中名称为 {ItemKey} 的输出参数。 请刷新流。

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

FlowActionBadRequest

错误消息：

  • 流 {FlowName} （{FlowId}） 上名为 {KeyName} 的参数声明为 {ItemTypeKind} 类型。 调用 Power Automate 时不支持此类型。 目前仅支持 Text、Boolean 和 Numbers。
  • 流 {FlowName} （{FlowId}）上名为 {ItemKey} 的参数在“调用流”作中缺失。
  • 流 {FlowName} ({FlowId}) 上名为 {KeyName} 的参数被评估为类型 {ResolveType}，预期类型为 {ExpectedType}。
  • 流 {FlowName} （{FlowId}） 无法运行响应代码 {ResponseCode}，错误代码： {FlowErrorCode}。

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

FlowActionTimedOut

错误信息： ID 为 {FlowId} 的流已超时。错误代码：{FlowErrorCode}

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

FlowMaker连接已阻止

错误信息： 具有名称 {FlowName} 的流正在使用不允许的创建者连接。 错误代码： {FlowMakerConnectionBlocked}

解决方案： 管理员阻止在从代理流调用的连接中使用创建人凭据。 在 Power Automate 中打开流，并以仅限运行权限共享此云流。

GenAISearchandSummarizeRateLimitReached

错误信息： 已达到搜索和汇总的使用限制。 请稍后重试。”

分辨率： 当代理达到 其生成 AI 限制 以搜索和汇总源时，将返回此消息。 有关详细信息，请参阅 解决代理中的限制错误。

GenAIToolPlannerRateLimitReached

错误信息： 已达到生成式编排的使用限制。 请稍后重试。”

分辨率： 当代理达到 其生成业务流程限制时，将返回此消息。 有关详细信息，请参阅 解决代理中的限制错误。

InvalidContent

错误信息： 代理中总共存在 {TotalComponents} 组件，但没有一个有效。

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

InfiniteLoopInBotContent

错误信息： 作 {DialogId}。{TriggerId}。{ActionId} 在一行中执行的次数超过 {MaxTurnCount} 次。 这表示对话的执行周期，因此对话执行将终止。

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

LatestPublishedVersionNotFound

错误信息： 无法检索代理的最新已发布版本。

解决方法：发布智能体。

OutgoingMessageSizeTooBig

错误信息： 传出消息大小太大。

分辨率： 根据用于传输文件的通道（如 Direct Line 或 Facebook），可能会收到以下错误消息：“请求内容长度超出限制 262,144 字节。这些限制由 频道施加，而不是 Copilot Studio。

在此方案中，有几个选项。 一个选项是提供指向资源的链接作为 Internet 附件。 另一个选项是查看节点，以确保其中任何一个都未使用包含大量文本的变量，例如 JSON.stringify() 静态方法。 如果使用此方法或包含大量文本的变量，修改节点以仅传递必要的文本部分。 例如，如果使用自适应卡片将数据传递到另一个主题，更新变量以仅传递必要的属性。

如需了解更多信息，请参阅在全渠道中使用 Copilot Studio 时的最大通道数据消息大小限制。

OpenAIRateLimitReached

错误信息：出现错误。

解决方法：您的智能体已达到生成式答案回复的最大数量。 查看 消息容量，并查看 代理中解决限制错误的信息。

RedirectToDisabledDialog

错误信息： 定义中禁用 ID 为 {DialogId} 的对话框。 请在使用对话之前启用它。

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

RedirectToNonExistentDialog

错误信息： 定义中找不到 ID 为 {DialogId} 的对话框。 请检查对话框是否存在，ID 是否正确。

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

SystemError

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

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

TooMuchDataToHandle

错误信息： 请求导致的处理数据过多；请评估您操作返回的数据量。

解决方法：这表明发送到 OpenAI 的请求超出了允许的最大请求大小。 构成请求的因素有很多，包括用户输入、先前操作的输出、调用的工具和对话历史记录。 请检查您正在使用的工具，并尽可能将其输出范围缩小到必要的字段。 有关详细信息，请参阅 创建 Power Automate 流 并 将 Power Automate 流作为操作调用。