了解错误代码

AI模型操作请求错误

错误消息：

• 提示输出的计算结果为 {ActualType} 但预期为 {ExpectedType}。

• 缺少提示{ParameterName}的输入参数{PromptName}。

• 输入参数{ParameterName}（提示{PromptName}）为空，但这是必需的。

• 应为： {ExpectedType}. 实际为：{ActualType}。

分辨率： 如果提示作收到不正确的输入或返回意外的输出类型，则会发生此错误。 若要解决此问题，请根据错误执行以下作之一：

• 类型不匹配： 检查提示配置，确保输出架构与预期的变量类型匹配。
• 缺少所需的输入： 验证所有必需的输入是否都连接到具有值的变量。
• 空白所需值： 在调用提示之前，请确保变量具有值。

有关详细信息，请参阅 “创建提示作”。

AIModelActionRequestTimeout

错误消息：命令 prompt-name 执行超时。

解决方法：确保对 AI Builder 模型的调用不超过 100 秒。

AsyncResponsePayloadTooLarge

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

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

身份验证未配置

错误消息：

• 未为此机器人配置身份验证。

• 机器人需要登录，但未配置为进行身份验证。 请更新机器人的身份验证方法。

• 通道 {channel}不支持集成身份验证。

分辨率： 如果代理使用需要用户身份验证的作或功能，但未配置身份验证，则会发生此错误。 解决此问题：

1. 在代理中，转到 “设置 > 安全 > 身份验证”。
2. 选择适当的身份验证方法：对于 Microsoft 365 用户，使用 认证登录到 Microsoft；对于自定义 OAuth 提供程序，使用 手动认证。
3. 如果错误提到特定通道，请验证通道是否支持所使用的身份验证方法。 某些通道不支持集成身份验证。

有关详细信息，请参阅 “配置用户身份验证”。

连接代理认证不匹配

错误消息： 具有架构名称 {AgentSchemaName} 的连接代理与主代理的身份验证不匹配。

分辨率： 业务流程协调程序代理和连接的子代理具有不同的身份验证配置。 为了使多代理业务流程正常工作，这两个代理都必须使用兼容的身份验证设置。 解决此问题：

1. 打开这两个代理，并转到 “设置 > 安全 > 身份验证”。
2. 确保两个代理使用相同的身份验证方法（例如，两者都对 Microsoft 进行身份验证）。
3. 如果使用手动身份验证，请确保这两个代理都配置为使用相同的 OAuth 提供程序和设置。

以下身份验证兼容性规则适用：

• 如果连接的代理未配置 身份验证 ，则可以接受任何业务流程协调程序身份验证。
• 如果连接的代理 需要身份验证，业务流程协调程序必须使用 相同的 身份验证方法。
• 业务流程协调程序上的手动身份验证（通用 OAuth2）与需要身份验证的连接代理不兼容。 两个代理都必须使用相同的手动身份验证配置，或者连接的代理必须没有身份验证要求。

有关详细信息，请参阅配置用户身份验证和在其他代理中使用代理作为操作（预览版）。

未找到连接的代理机器人

错误消息： 找不到架构名称 {AgentSchemaName} 的连接代理。

分辨率： 如果编排代理找不到连通的子代理，则在多代理编排中会出现此错误。 解决此问题：

1. 验证连接代理是否与业务流程协调程序代理位于同一环境中。
2. 确保在业务流程协调程序配置中正确拼写连接的代理的架构名称。
3. 检查你是否对连接的代理具有访问权限。
4. 如果最近创建了连接的代理，请等待几分钟，然后重试。

有关详细信息，请参阅在其他代理中将代理用作操作（预览版）。

连接的代理机器人未发布

错误消息： 需要发布具有架构名称 {AgentSchemaName} 的连接代理才能调用。

解决方案： 必须先发布连接的子代理，然后编排代理才能调用它。 解决此问题：

1. 在 Copilot Studio 中打开连接的代理。
2. 发布智能体。
3. 返回编排代理，然后再次测试。

有关详细信息，请参阅在其他代理中将代理用作动作（预览版）。

连接代理链条不支持

错误消息： 检测到代理级联。 代理无法连接到具有架构名称 {AgentSchemaName} 的代理，因为它已有连接的代理。

分辨率： 不支持多级代理链接。 编排代理可以连接到子代理，但这些子代理不能拥有自己的连接代理。 解决此问题：

1. 查看代理体系结构，并简化层次结构。
2. 将功能从深层嵌套代理移动到编排器或一级连接代理。
3. 请考虑使用主题或操作，而不是其他连接的代理人。

有关详细信息，请参阅在其他代理中使用代理作为动作（预览版）。

连接代理Gpt组件未找到

错误消息： 找不到具有架构名称 {AgentSchemaName}的连接代理的 GPT 组件。

解决方案： 连接的代理缺少被协调代理调用所需的描述或指令。 解决此问题：

1. 在 Copilot Studio 中打开连接的代理。
2. 转到代理的 “概述 ”页。
3. 确保代理已配置明确的 说明 和 说明 。
4. 进行更改后，发布连接的代理。
5. 返回到编排程序代理，然后再次进行测试。

有关详细信息，请参阅在其他代理中将代理用作动作（预览版）。

ConnectorPowerFxError

错误消息： Power Fx 表达式计算失败： {ErrorDetails}

解决方案： 在连接器操作中使用的 Power Fx 表达式未正确计算。 解决此问题：

1. 打开包含连接器操作的主题。
2. 查看操作的输入参数中的 Power Fx 表达式。
3. 使用示例数据测试表达式以确定问题。
4. 使用公式栏的错误指示器查找特定问题。

常见原因包括：

• 语法错误。
• 类型不匹配，例如在不转换的情况下将文本与数字进行比较。
• Null 或空白值。 若要处理，请使用函数，例如 IsBlank()， Coalesce()或 IfError()。
• 函数用法无效。

有关详细信息，请参阅 在 Copilot Studio 中使用 Power Fx。

ContentError

错误消息：此错误基于错误的上下文生成动态消息。

解决方法：对于与代理程序内容相关的问题，此消息是一个通用错误。 错误信息提供了更多详细信息。

常见问题包括：

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

用户未提供同意

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

解决方法：与代理交互的用户必须使用代理的单一登录连接提示来验证连接。

DataLossPreventionViolation

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

解决方案

• 环境的数据策略要求用户登录。 请参阅使用登录系统主题添加用户身份验证。
• 在代理中使用的一个或多个连接器不在同一个数据组中。 请参阅 Copilot Studio 连接器。
• 租户管理员阻止了在代理中使用的一个或多个连接器。

ConversationStateTooLarge

错误消息： 会话状态大小超过允许的最大限制。

分辨率： 会话在其状态中累积了过多的数据，超过了允许的大小限制。 解决此问题：

1. 通过查看主题并减少在聊天期间存储在变量中的数据量来减少变量数据。
2. 将不再需要的未使用变量清空即可。
3. 通过将复杂对话分解为更小、更集中的交互来简化聊天流。
4. 避免在聊天变量中存储大型 JSON 对象、数组或文本块。

若要防止此错误：

• 仅对必须跨主题保留的数据使用变量。
• 请考虑使用 Power Automate 流从外部源存储和检索大数据量，而不是将其保存在会话状态中。

有关详细信息，请参阅 Copilot Studio 配额和限制。

EnforcementMessageC2

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

解决方法：如果代理达到其消息容量或即用即付计量达到其限制，则会出现此消息。 若要解决此问题，请添加更多预付费容量或创建即用即付计费计划。 然后，代理聊天预计将在五分钟内恢复正常工作。 有关详细信息，请参阅 超限处罚。

FlowActionBadRequest

错误消息：

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

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

FlowActionException

错误消息：

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

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

FlowActionTimedOut

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

解决方法： 检查流是否存在错误 ，以了解云流在返回到代理之前运行的时间超过 100 秒的原因。 尝试优化从后端系统返回的查询和数据。 如果某些云流逻辑可以在将结果发送到代理后继续运行，请将这些操作放在云流中的“返回值到 Copilot Studio”步骤之后。

FlowMaker连接已阻止

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

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

GenAISearchandSummarizeRateLimitReached

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

解决方法：如果代理达到 其生成 AI 限制 来搜索和汇总源，则返回此消息。 有关详细信息，请参阅 解决代理中的限制错误。

GenAIToolPlannerRateLimitReached

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

解决方法：如果代理达到 其生成业务流程限制，则返回此消息。 有关详细信息，请参阅 解决代理中的限制错误。

InfiniteLoopInBotContent

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

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

InvalidContent

错误消息：代理中总共存在 {TotalComponents} 组件，但无效。

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

LatestPublishedVersionNotFound

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

解决方法： 发布代理。

OpenAIHate

错误消息：由于负责任的 AI 限制，内容已筛选。

负责任的 AI 检查会阻止被视为可恨的内容。 仇恨内容是指基于这些组的某些区分属性攻击或使用歧视性语言针对个人或标识组的任何内容。

此限制包括但不限于以下内容的内容：

• 种族、民族、国籍
• 性别认同群体和表现
• 性取向
• 宗教
• 个人外貌和体型
• 残疾状况
• 骚扰和欺凌

解决方法：为了避免这种情况，请与代理用户一起强化负责任的 AI 指南。 还可以更新代理 内容审查 策略。

OpenAIJailBreak

错误消息：由于负责任的 AI 限制，内容已筛选。

安全检查会阻止越狱尝试的内容。 越狱尝试是用户提示攻击，它忽略系统提示并尝试更改预期的代理行为。 这些攻击包括尝试更改系统规则、嵌入对话模拟来混淆模型、角色扮演和编码攻击。 有关详细信息，请参阅 Azure AI 内容安全性中的提示防护。

解决方法：为了避免这种情况，请与代理用户一起强化负责任的 AI 指南。 还可以更新代理 内容审查 策略。

OpenAIndirectAttack

错误消息：由于负责任的 AI 限制，内容已筛选。

从代理作者或用户（如外部文档）未直接提供的信息中检测到攻击。 攻击者尝试将指令嵌入由用户提供的根本数据中，以便恶意地通过以下方法控制系统：

• 操作内容
• 入侵
• 未经授权外泄数据或从系统中删除数据
• 阻止系统功能
• 欺诈
• 执行代码和感染其他系统

有关详细信息，请参阅 文档的提示防护。

解决方法：如果您正在测试，并且您不希望测试变成攻击，请确保您的说明与您希望代理能够执行的操作保持一致。 否则，请与代理用户一起强化负责任的 AI 指南，以避免这种情况。

OpenAISelfHarm

错误消息：由于负责任的 AI 限制，内容已筛选。

负责任的 AI 检查阻止了与自我伤害相关的内容。 自我伤害是指与故意自残、损伤身体或意图自杀等行为相关的语言。

此限制包括但不限于以下内容的内容：

• 饮食失调
• 欺凌和恐吓

解决方法：为了避免这种情况，请与代理用户一起强化负责任的 AI 指南。 还可以更新代理 内容审查 策略。

OpenAISexual

错误消息：由于负责任的 AI 限制，内容已筛选。

负责任的 AI 检查阻止了被视为性的内容。 性内容描述了与解剖器官和生殖器、浪漫关系、性行为和以色情或深情术语描述的行为相关的语言，包括那些被描绘为攻击或暴力行为的行为。

此限制包括但不限于以下内容的内容：

• 粗俗内容
• 卖淫
• 裸体和色情
• 滥用
• 儿童剥削、儿童虐待、儿童色诱

解决方法：为了避免这种情况，请与代理用户一起强化负责任的 AI 指南。 还可以更新代理 内容审查 策略。

OpenAIRateLimitReached

错误消息：发生错误。

解决方法：代理达到生成答案响应的最大数量。 查看 消息容量，并查看 代理中解决限制错误的信息。

OpenAIViolence

错误消息：由于负责任的 AI 限制，内容已筛选。

负责任的 AI 检查阻止了被视为暴力的内容。 暴力内容是指与旨在伤害、损坏或杀死某人或某物的身体行为相关的语言。 它还描述了武器、枪支和相关实体。

此限制包括但不限于以下内容的内容：

• 武器
• 欺凌和恐吓
• 恐怖主义和暴力极端主义
• 跟踪

解决方法：为了避免这种情况，请与代理用户一起强化负责任的 AI 指南。 还可以更新代理 内容审查 策略。

OutgoingMessageSizeTooBig

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

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

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

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

RedirectToDisabledDialog

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

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

RedirectToNonExistentDialog

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

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

SystemError

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

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

TooMuchDataToHandle

错误消息：请求导致无法处理过多数据，请评估您所实施操作返回的数据量。

解决方法：此错误指示发送到 OpenAI 的请求超过了允许的最大请求大小。 该请求包括用户输入、先前作的输出、调用的工具和聊天历史记录。 查看使用的工具。 如果可能，请将其输出范围缩小到仅必要的字段。 有关详细信息，请参阅 创建 Power Automate 流 并 将 Power Automate 流作为操作调用。