应用开发常见问题

开始节点

101501

开始组件全局变量缺失。

工作流启动失败，定义的全局变量未能获取到有效的初始赋值。

请检查工作流触发时的输入参数，确保所有在开始节点定义的全局变量均已传入或设有默认值。

结束节点

101531

结束组件初始化失败。

结束节点在工作流运行结束时尝试初始化输出逻辑失败。

请检查结束组件的输出结构配置，确保其引用的变量在整个工作流上下文中是可达的。

101532

结束组件模板组装错误。

结束节点在尝试按照预设模板格式化最终输出数据时发生异常。

请检查结束组件的Response模板语法，确保引用的占位符与实际输出变量名匹配。

101533

结束组件流数据处理错误。

在流式（Streaming）输出模式下，结束节点无法正确聚合或转发最后的流片段。

请检查客户端连接状态，并确认前置节点的流式输出是否完整闭合。

大模型节点

101561

LLM组件初始化失败。

LLM节点尝试加载模型配置或建立连接失败。

请检查工作流中该节点的模型选择、API Key配置及Endpoint连通性。

101562

LLM组件模板组装错误。

LLM节点的提示词模板组装失败，可能存在引用的变量未定义或语法错误。

请核对提示词中的变量占位符，确保其已在节点输入中正确映射。

101563

LLM获取流式输出错误。

在与大模型交互过程中，流式响应中途断开或返回非法格式。

请检查网络环境的稳定性，或确认模型服务商是否存在并发配额限制及超时问题。

代码节点

101591

代码组件初始化失败。

脚本组件在准备运行环境或解析输入参数时发生异常。

请检查代码节点的输入映射配置，确保所有引用的变量已正确连接。

101592

代码沙箱请求失败。

无法向代码执行沙箱发起请求，可能是沙箱服务未启动、网络不可达或接口鉴权失败。

请检查沙箱服务的运行状态及网络配置，并确认系统环境变量中的沙箱端点地址是否正确。

101593

代码沙箱执行错误。

用户编写的代码在沙箱内执行时报错。

请根据sandbox_msg中的报错信息（如语法错误、索引越界或超时等）检查并修正您的代码逻辑。

101594

代码沙箱非预期错误。

沙箱服务内部发生崩溃或遇到了未处理的系统异常，导致执行非正常中断。

请尝试重新运行工作流。如果问题持续，请联系系统管理员检查沙箱服务的资源占用及日志信息。

101595

代码调用执行异常。

代码组件在执行过程中发生了非预期的运行时异常。

请检查代码中的逻辑，特别是涉及外部调用、第三方库引用或大规模数据处理的部分。

120007

代码返回值Key缺失。

代码节点执行完毕后，返回的字典中不包含画布上定义的输出变量名。

请检查Python/JS脚本的return语句，确保返回的字典键名与节点“输出设置”中的定义严格一致。

120008

代码返回值类型错误。

代码节点的返回对象类型非法。系统要求返回一个dict（字典），以便进行变量映射，但实际收到了其他类型。

请修改代码逻辑，确保最终结果以{"key": value}的格式返回，不要直接返回字符串或列表。

消息节点

101651

消息组件初始化失败。

消息节点在准备发送逻辑或加载配置时发生异常。

请检查消息节点的输入参数映射，确保消息类型（如文本、卡片）配置完整。

101652

消息模板缺失。

消息组件未配置必选的消息模板内容，导致无法生成待发送的消息主体。

请在组件配置中填写消息内容模板，或选择一个已有的模板进行引用。

101653

消息模板组装错误。

在将变量渲染到消息模板时发生错误，通常是由于引用的占位符变量不存在。

请检查模板中的变量引用语法，确保所有占位符对应的变量已在该节点的输入列表中定义。

101654

消息组件调用非预期错误。

同步调用消息组件发送接口时发生未捕获的运行时异常。

请查看系统后台日志排查网络连接或第三方消息网关的返回状态。

意图识别节点

101098

意图识别提示词执行异常。

提示词执行引擎在提交渲染后的最终指令阶段发生非预期中断。

请确认提示词引擎状态，并检查完整提示词长度是否超过了模型上下文窗口限制。

101097

模型输入消息转换失败。

将业务参数转换为LLM消息序列（Role/Content结构）时发生格式错误。

请检查对话历史记录的组织形式，确保Role定义符合该模型的要求。

101096

意图识别模型调用失败。

请求大模型推理服务进行意图判定时，服务端返回错误或网络连接超时。

请确认模型API状态、网络连通性以及API Key的配额是否充足。

101095

意图识别输入预处理失败。

在对用户原始输入进行清洗、格式化或截断处理时发生逻辑错误。

请检查输入数据是否为空或包含异常特殊字符，确保满足组件的处理要求。

101094

意图识别模板创建失败。

系统在根据意图列表和用户输入变量渲染提示词模板时发生异常。

请核对模板中的占位符是否与组件输入的字段名一致，检查是否有非法语法字符。

提问器节点

102053

模板格式化错误。

模板语法存在错误（如大括号未闭合、使用了非法转义字符），导致Jinja2或String格式化引擎无法渲染最终结果。

请检查提示词文本中的语法格式，确保占位符使用正确且没有语法逻辑冲突。

103004

模型调用失败。

规划引擎在请求大模型进行任务规划时，收到错误响应或连接超时。

请检查后端模型服务的可用性、API Key有效性及网络连通性。

101042

提问组件响应类型非法。

提问组件接收到的响应格式不符合预期（例如期望结构化数据但收到纯文本），导致无法继续后续逻辑。

请检查反问逻辑中的输出约束，或在提示词中明确要求模型返回特定的数据类型。

101043

超过最大追问次数。

提问组件为了补全关键信息与用户进行的交互轮数超过了系统设定的阈值，为防止无限循环已强制中断。

请优化提问策略以更高效地收集信息，或在组件配置中调大最大对话轮数。

101044

问题构建方法非法。

组件配置了不支持的问题生成方式，导致系统无法正确构造向用户提问的文案。

请检查组件配置中的“提问方式”选项，确保选择了系统当前支持的构建引擎或模板。

101045

直接采集模式下问题内容为空。

在设置为“直接收集用户回复”的模式下，未配置发送给用户的问题描述，导致交互无法开始。

请在该组件的配置项中填写具体的提问文案，用于引导用户进行输入。

101047

护栏初始化失败。

提问组件关联的安全护栏（Rails）模块无法加载配置或初始化引擎失败。

请检查安全策略配置是否符合语法规范，并确认相关依赖库已正确安装。

101048

输入护栏执行失败。

在对用户输入进行安全检查（自定义输入护栏）时发生异常，导致无法判断内容是否合规。

请检查自定义输入护栏的脚本逻辑或后端检测服务的可用性。

101049

自定义执行护栏错误。

在组件执行过程中的特定安全检查环节触发了自定义护栏逻辑异常。

请排查自定义校验规则的代码是否存在逻辑漏洞或执行超时。

101050

默认执行护栏错误。

系统内置的默认安全护栏在处理组件输出结果时发生非预期崩溃。

请检查模型输出是否包含特殊不可见字符，并确保系统内置护栏规则库为最新版本。

101059

提问组件反思逻辑失败。

提问组件在进行“自我反思”时模型调用失败或逻辑中断。

请检查反思步骤关联的模型状态，确保其提示词能够引导模型输出正确的判定结论。

问答节点

120000

问答选项列表为空。

在执行问答（QA）类节点或组件时，预设的备选选项配置为空，导致模型或系统无法进行选择。

请检查问答节点的配置，确保“选项”列表中至少包含一个有效的备选项。

120001

不支持的问答策略。

问答节点配置了系统无法识别的检索或匹配策略。

请在节点设置中重新选择支持的匹配策略（如“精确匹配”或“语义匹配”）。

120002

索引超出范围。

系统尝试根据索引获取选项或数据时，索引值超过了数组或列表的实际长度。

请检查前置逻辑生成的数据量，确保索引访问在合法区间内。

120003

输入键缺失。

问答组件在处理输入数据时，未能找到指定的参数键。

请检查节点间的连线映射，确保上游节点正确输出了变量。

插件节点

101741

API组件初始化失败。

API组件在尝试加载接口配置、初始化鉴权信息或准备执行环境时发生异常。

请检查API组件的连接器配置，确保目标接口的访问地址及基本认证参数正确无误。

101742

API组件参数校验错误。

API组件接收到的输入参数不符合目标接口的要求，如缺少必填字段或参数类型不匹配。

请根据接口文档核对并修正该组件的参数映射，确保传入数据格式合法。

101743

API组件输入未定义。

API组件的输入端（Inputs）配置缺失，导致无法构造有效的请求报文发送至目标服务器。

请在组件配置面板中定义输入变量，并确保其已正确连接至前置节点的输出数据。

101744

API组件输出处理错误。

目标API成功响应，但在尝试解析响应体（Response Body）或将结果映射到工作流变量时失败。

请检查响应解析逻辑（如JSON Path），确保其与目标接口实际返回的数据结构保持一致。

101745

API组件执行异常。

在执行网络请求期间发生底层错误，包括但不限于连接超时、DNS解析失败或收到5xx系列服务器错误。

请确认外部服务是否运行正常，并检查网络防火墙或代理服务器是否允许编排引擎访问该接口地址。

105001

插件未知异常。

插件系统触发了未捕获的运行时异常，通常由于插件包逻辑错误或与当前引擎版本不兼容导致。

请检查插件运行日志，定位具体的崩溃堆栈信息，并确认插件的依赖库是否完整。

105002

插件已存在。

尝试上传或注册一个标识符（Plugin ID）已存在的插件。

请更改插件名称或版本号，或使用“更新插件”接口对现有插件进行覆盖安装。

105003

插件未找到。

工作流在调用插件时，无法在插件库或文件系统中检索到对应的执行文件或配置。

请确认该插件是否已在插件管理页面成功发布，并检查ID引用是否正确。

105004

插件参数校验失败。

调用插件时传入的动态参数不符合插件定义的规范（如缺少必填项或类型不匹配）。

请根据插件定义的输入规范调整工作流中的输入变量，确保参数合法。

105006

插件数据库异常。

插件管理服务在读写插件元数据、权限或状态时发生数据库连接错误。

请检查后端数据库服务状态及连接池配额，确认插件配置表未被锁定。

105009

插件向量推理失败。

在对插件描述进行语义向量化以便进行搜索推荐时，向量模型服务返回错误。

请检查Embedding模型服务的可用性，确认插件的描述文本长度未超过模型限制。

105010

API鉴权失败。

调用外部API插件时，目标服务器返回了身份验证错误（如401 Unauthorized）。

请重新检查插件配置中的API Key、Bearer Token或OAuth2凭证是否有效且未过期。

105011

API响应状态码错误。

外部API响应了非200/201的异常状态码（如403，404，500等）。

请根据返回的具体HTTP状态码排查三方服务逻辑，确保接口地址和请求方法正确。

105012

API请求超时。

外部API在预设时间内未返回数据。可能是由于网络延迟或三方服务处理耗时过长。

请在插件设置中适当调大超时阈值，或检查目标服务的网络连通性。

105013

响应体过大。

插件返回的数据量超过了系统设定的安全负载上限，可能导致内存溢出。

请限制API返回的数据条数，或在插件中启用分页/流式处理。

105014

代理连接失败。

系统尝试通过代理服务器访问外部插件API时，代理服务器拒绝连接或无法解析目标。

请检查全局代理配置（Proxy Server/Port/Credentials）是否正确，并确认内网穿透状态。

工作流节点

101801

子工作流构建失败

系统无法根据中间表示（IR）构造子工作流实例。这通常是因为引用的子工作流已被删除、未发布或ID不存在。

请确认子工作流是否存在且处于已发布状态，并重新保存父工作流以刷新引用。

101802

子工作流初始化错误。

子工作流在加载资源、准备变量空间或连接内部组件时发生非预期异常。

请单独测试运行该子工作流，排除其内部节点配置导致的初始化障碍。

101803

子工作流配置校验失败。

父工作流中定义的子工作流节点参数配置不完整或不符合子工作流的输入要求。

请进入该组件的参数映射界面，确保所有子工作流要求的必填输入项均已正确映射。

101804

子工作流执行异常。

子工作流在运行过程中由于内部节点报错导致流程中断。

请查看该子工作流的具体执行日志，定位内部具体哪个节点触发了异常。

101805

非法的子工作流引用。

递归调用冲突：检测到子工作流ID与当前父工作流ID相同。系统禁止自循环引用以防止死循环。

请更换引用的子工作流，避免在工作流中直接或间接地调用自身。

循环节点

101811

不支持的循环类型。

循环组件配置了系统无法识别的循环模式。

请检查循环节点的类型设置，确保其为系统支持的模式（如按次数循环或按列表项迭代）。

101812

循环组件必填项缺失。

在执行循环时，关键配置字段为空，导致循环引擎无法确定起始条件或迭代对象。

请在循环组件配置中填写缺失的字段，例如迭代列表或终止条件。

101813

循环组件字段类型错误。

字段的输入类型与循环模式要求的类型不符（例如：列表循环要求输入为list，但实际收到了string）。

请检查前置节点传递给循环组件的变量类型，确保数据格式满足循环逻辑的要求。

变量聚合节点

101831

聚合值类型不一致。

尝试对不同类型的数据进行聚合（例如将数字和对象强行合并到同一个列表），导致类型冲突。

请确保所有参与聚合的数据项类型一致，或在聚合前使用脚本节点统一数据格式。

101832

不支持的聚合策略。

系统无法执行指定的聚合策略（例如无效的合并算法或摘要算法）。

请在聚合组件配置中选择有效的策略，如“追加到列表”、“对象合并”或“字符串拼接”。

输入节点

101850

输入字段不能为空。

组件要求的必填输入字段未能获取到任何数据（None或空字符串）。

请检查工作流的上游节点是否输出了该字段，或在当前节点为该字段配置默认值。

101862

循环次数非法。

循环次数配置超出了系统允许的范围[1,1000]，旨在防止因配置失误导致的死循环或资源耗尽。

请将循环次数调整为1到1000之间的整数。

MCP服务节点

101870

不支持的MCP类型。

系统接收到无法识别的MCP组件类型可能是协议版本不匹配或引用了未注册的扩展协议。

请检查MCP服务器的协议版本，并确保在编排引擎中正确配置了对应的协议处理器。

101872

MCP组件必填项缺失。

在执行协议交互时，关键字段为空。

请完善MCP组件的配置信息，确保所有标识外部服务或资源的必填参数均已填写。

101873

MCP执行错误。

在与MCP服务器进行通信或执行远程指令时发生异常

请检查外部MCP服务的运行状态、网络连通性以及该服务生成的详细错误日志。

101874

不支持的MCP方法。

尝试调用MCP协议中未定义或当前服务器未实现的方法

请核对MCP服务器支持的功能列表（Capabilities），确保调用的方法在协议规范内。

101875

MCP参数类型错误。

参数的输入值类型与协议预定义的类型不符。

请检查工作流中传递给MCP组件的变量类型，确保其符合协议定义的规范。

插件节点

100703

SQL执行失败。

执行SQL指令时发生数据库层面异常。

请根据MySQL返回的具体错误原因排查是否涉及表结构缺失、数据冲突或连接超时。

100704

SQL语法校验失败。

构建的SQL命令未能通过预检查，可能是语法错误或包含非法字符。

请核对生成的动态SQL语句，确保表名、字段名拼写正确且符合语法规范。

判断节点

101623

表达式包含非法字符。

分支表达式中包含了系统禁止的安全敏感字符或不受支持的特殊符号。

请移除表达式中的非法字符，仅使用标准的操作符、数字、字符串及已定义的变量名。

101624

条件评估异常。

分支逻辑在判定条件的真伪时触发了底层异常。

请根据详细的错误提示检查逻辑分支的配置，确保复杂条件的嵌套逻辑清晰且无冲突。

意图识别

101681

意图识别LLM初始化失败

意图识别组件在加载大语言模型配置或建立服务连接时发生错误

请检查该节点选择的模型名称、API Key以及对应的模型推理服务状态

101093

意图识别输出解析错误

模型返回的结果无法解析为预期的意图标签，通常由于输出格式不符合规范

请检查提示词中的输出格式约束，并确保模型具备生成结构化数据的能力

高级意图节点

109000

高级意图初始化失败。

高级意图识别节点在加载语义模型、分类、规范或初始化向量时发生错误。

请检查该节点所选的分类模型是否在线，并验证意图分类列表是否符合JSON规范。

全局变量

120005

全局变量类型错误。

全局变量的默认值类型与定义的变量类型（如String,Integer,Object）不匹配。

请在全局变量管理页面核对该变量的类型定义，并确保默认值符合该格式。

工作流

101901

组件配置加载失败。

加载组件的具体配置时失败，原因可能是该组件已下线或版本配置不匹配。

请更新该节点的组件版本，或在组件库中重新确认该组件的发布状态。

101902

IR校验错误。

工作流的中间表示（Intermediate Representation）未能通过语法或逻辑一致性校验。

请根据详细提示修复画布中的逻辑冲突（如循环依赖或必填端口未连线）。

101903

无效的ID格式。

工作流或节点ID包含了系统禁止的特殊字符，目前仅支持数字、字母和下划线。

请修改ID名称，移除空格、连字符（-）或其他特殊符号。

101904

初始化数据类型错误。

启动工作流时传入的初始参数不完整，必须提供完整的IR（定义）或workflow_state（状态恢复数据）。

请检查调用接口的Payload，确保提供了正确的启动参数。

101905

组件执行超时

节点的运行时间超过了预设的上限，系统为防止资源长期占用已自动终止该任务。

请检查该节点的业务逻辑是否存在死循环或长耗时操作，或者在组件设置中调大执行超时时间限制。

101906

工作流初始化失败。

工作流在启动阶段无法正确加载运行环境、解析IR定义或分配执行资源。

请根据报错原因排查工作流配置的完整性，并确认编排引擎的系统资源是否充裕。

101907

工作流执行被终止。

执行实例已被手动中止或由于系统级指令强制关停。

如果这不是预期的手动操作，请检查是否有外部监控服务触发了强制停止逻辑。

101912

获取异步结果失败。

引擎尝试从后端存储检索异步任务的运行结果时失败。

请确认任务存储服务的连通性，并检查任务结果是否已过期被清理。

101913

取消异步任务失败。

尝试停止异步任务时，由于任务已完成、任务已不存在或调度器拒绝操作而失败。

请确认任务的实时状态，若任务仍在运行但无法取消，请检查调度引擎的响应能力。

101914

Celery代理初始化失败。

工作流异步引擎无法连接到Celery。

请检查中间件服务的运行状态及连接字符串配置，确保网络防火墙已放行对应端口。

101920

ApsWorker注册失败。

执行节点尝试在异步工作流调度中心注册自身身份时发生错误。

请检查工作节点的网络环境及集群配置，确保各节点ID唯一且心跳同步正常。

101921

Redis监听器异常。

ApsWorker在监听Redis消息发布订阅（Pub/Sub）频道时发生连接中断或数据解析错误。

请确认Redis服务的稳定性，并检查是否存在大并发消息导致监听缓冲区溢出。

101922

获取本地主机名错误。

异步工作节点在尝试识别本地主机标识时失败，导致无法完成服务注册。

请检查运行环境的系统配置，确保/etc/hosts或相关的DNS配置允许正确解析主机名。

101923

Worker ID异常。

异步执行任务时发现Worker ID不合法或已失效，导致任务无法被正确指派或认领。

请重启该节点的Worker服务，确保系统自动分配一个有效的唯一标识。

101924

异常终点组件触发终止。

执行流程进入了预设的“异常结束”节点，该节点主动触发了工作流的非正常终止逻辑。

这是由于业务逻辑触碰了预设的报错路径（Error Path），请根据业务流程排查为何会流转至此异常终点。

101931

工作流流式回调实例无效。

工作流在尝试进行流式数据推送到前端或下游时，发现注册的回调处理实例（Callback Instance）已销毁、未初始化或类型不匹配。

请检查流式调用接口的上下文生命周期，确保在整个执行期间回调对象保持活跃，且没有被提前回收。

101032

工作流定义失效。

工作流拓扑结构定义存在逻辑断点或不合法，导致执行引擎无法定位后续待执行的节点。

请检查工作流画布中的节点连接线是否完整，确保没有孤立节点，并重新保存/发布工作流以刷新定义。

101039

组件执行错误。

工作流运行至具体的某个节点时，组件内部逻辑抛出异常。该错误通常由组件特有的运行环境或业务逻辑触发。

请查看对应节点的输入输出日志，根据报错详情定位并修复具体组件的配置问题。

101040

工作流执行异常。

工作流引擎在调度或管理执行生命周期时遇到系统级错误。这可能涉及内存溢出、线程中断或数据库状态同步失败。

请尝试重新触发工作流任务，若错误持续出现，请联系系统管理员检查后台服务运行状态。

101046

工作流循环执行超限。

工作流中存在逻辑回环，且运行时的总跳转次数或循环轮数已超过系统全局设定的硬性上限。此机制用于防止无限循环耗尽计算资源。

请优化工作流逻辑，确保循环具备明确的跳出条件，或检查是否存在逻辑设计死循环。

101051

回调异常信息采集失败。

工作流在触发异常回调时，未能成功捕获或序列化当前执行栈的错误上下文。

请检查回调记录器的存储空间或外部日志系统的连接状态，确保系统有权限写入异常追踪数据。

101052

组件单步调试异常。

在对组件进行单步跟踪或调试模式执行时发生错误。

请检查调试器连接状态及组件的上下文信息。

101053

组件类型不支持调试。

当前组件类型（如某些内置原子组件或加密组件）不支持单步调试功能。

请确认组件定义中是否开启了调试支持，或尝试直接运行而非调试模式执行。

101054

组件IR非法。

单个组件的IR定义不符合规范，解析失败。

请检查组件的配置文件或DSL编译结果，确保其IR结构完整。

101057

组件输入输出一致性校验失败。

组件的初始化检查失败，其输出字段必须与输入字段保持一致（如状态透传组件）。

请调整组件定义，确保指定的输入输出字段名和类型完全匹配。

101058

全局上下文类型冲突。

尝试在全局上下文中写入数据，但已存在的全局项类型不是字典（dict），导致无法合并或追加。

请检查全局状态管理逻辑，确保在整个编排流程中全局变量的基准类型是一致的。

101621

分支表达式语法错误。

条件分支节点中的表达式不符合逻辑运算语法规范，导致解析器无法识别。

请检查表达式中的括号是否闭合、操作符（如==，!=，>，<）是否书写正确，以及变量名是否合法。

101622

表达式计算错误。

在执行表达式时发生运行时错误，通常是由于引用的变量为None或类型不匹配（例如尝试将字符串与数字进行比较）。

请确保表达式中引用的所有变量在执行到该节点时均已有值，且数据类型支持所选的操作符。

101041

规划器类型非法。

规划器组件配置了系统无法识别的规划算法类型，导致任务拆解引擎无法初始化。

请检查Planner节点的“规划模式”设置，确保选择了当前版本支持的合法类型。

109510

处理器创建失败。

系统无法为当前的对话会话创建上下文处理器，可能是由于自定义处理逻辑脚本加载失败。

请检查上下文处理流的插件或中间件配置，确保相关类名或函数路径正确。

101908

任务达到最大迭代次数。

任务节点执行的循环次数超过了系统或节点设定的硬上限，通常是为了防止逻辑死循环。

请检查循环逻辑的终止条件是否正确，确保在预期内能正常退出循环。

101911

异步执行冲突。

尝试对同一个执行实例进行并发异步操作，或分布式环境下任务锁定冲突。

请确保不要对同一执行ID同时发起多个状态变更请求，并检查分布式锁（例如 Redis Lock）的状态。

102308

工作流IR反思修正失败。

在对生成的IR进行自我检查和反思修正（Self-Reflection）时，修正逻辑报错。

优化反思阶段的提示词设置，使其能够给出更明确的纠错指令。

102303

意图澄清预处理失败。

在自然语言转Agent的第一阶段，系统尝试理解用户模糊意图并引导澄清时发生错误。

请调整预处理阶段的提示词指令，使其能够更健壮地处理非结构化用户输入。

102302

IR转换为云端DSL失败。

将IR转换为可在华为云平台运行的特定DSL描述时失败。

请检查中间表示逻辑是否过于复杂，超出了目标云平台DSL的支持范围。

102305

工作流IR生成失败。

模型虽然设计了结构，IRJSON 时失败。

请检查后端生成模板，确保其生成的JSON结构符合规范。

102304

工作流结构设计失败。

模型无法根据用户需求设计出合理的节点拓扑结构（如节点间连线冲突或逻辑环路）。

请尝试简化用户需求描述，或者增加可用工具/插件的描述信息以便模型更好地拆解。

102307

工作流状态机异常。

在NL2Agent动态构建工作流时，当前生成的会话状态或工作流状态不匹配，导致流程中断。

请清除当前生成缓存，尝试启动一个新的生成会话。

102306

NL2Agent模型服务异常。

NL2Agent专用模型在调用过程中返回错误。

检查模型服务的并发限额及健康状况。

101956

组件池初始化失败。

系统在启动时扫描插件目录或建立组件索引失败。

请检查插件目录权限、配置文件路径以及是否有损坏的第三方组件包导致扫描中断。

101951

组件类冲突。

尝试在组件池中注册组件，但该类型名称已被其他组件占用。

请检查自定义组件的命名空间或类型定义，确保每个扩展组件在全局范围内具有唯一的类型标识。

101953

注册对象类型错误。

组件池注册接口期望接收到一个类对象（Class），但实际传入了实例、函数或其他非类类型的数据。

请确保在调用注册方法时传递的是组件类本身，而非已实例化的对象或方法引用。

101952

无效的组件类名称。

组件类型名称不符合系统命名规范（如包含特殊字符或关键字冲突）

请修改组件类的注册名称，仅使用合法的字符组合，并避开系统的保留字。

101955

组件实例化失败。

组件池找到了类定义，但在调用构造函数创建组件实例时抛出异常。这通常由组件构造函数中的逻辑错误或缺少必要的构造参数引起。

请检查组件类的__init__方法代码，确保其能够独立于特定执行上下文正确创建对象。

101954

组件类未找到。

工作流引擎尝试加载节点，但在当前运行环境的组件池中未找到对应的注册信息。

请确认该自定义组件是否已正确导入并执行了注册逻辑，或者检查 IR中定义的类型名称是否拼写正确

109300

记忆IR配置错误。

记忆引擎的IR配置文件存在逻辑错误或格式不合法，导致无法正确映射记忆分片与检索策略。

请检查记忆模块的DSL或JSON配置文件，确保记忆类型（如语义记忆、情节记忆）的参数定义符合规范。

120006

工作流节点超限。

当前工作流包含的节点总数超过了系统允许的最大限制。

建议将复杂的工作流拆分为多个子工作流（Sub-workflow），或精简冗余节点以优化执行效率。

单智能体

103025

Agent输入类型不支持。

Agent接收到了无法识别的输入格式（如不支持的文件类型或非法的多模态数据流），导致推理引擎无法解析任务指令。

请检查传递给Agent的变量类型，确保其符合当前模型支持的输入规范（如文本、图片链接或标准JSON）。

103028

工具切换配置非法。

用于控制Agent动态选择工具的切换逻辑字典（Tool Switch Dict）格式不正确，导致Agent无法在多个工具间进行路由。

请核对tool_switch字段的结构，确保其为一个合法的键值对映射，且Key值与已注册的工具名称一致。

103029

插件更新类型错误。

尝试动态更新Agent的技能集时传入了非法对象。系统要求输入RestFulApi或Function的列表。

请确保在更新插件列表时，传入的对象是标准的API定义或函数定义类，而非原始字符串或其他基础类型。

103030

任务ID长度超限。

Agent内部生成的任务追踪ID或外部传入的task_id长度超过了系统预设的最大阈值，可能导致数据库写入失败。

请缩短任务标识符的长度，或检查任务生成逻辑中是否存在重复拼接ID的异常。

103031

MCP插件更新类型错误。

在通过Model Context Protocol (MCP)扩展Agent能力时，传入的参数类型不符合规范。

请核对MCP接口定义，确保传入的是合法的MCP协议对象列表。

控制器

103100

参数提取原子能力调用失败。

控制器在调用底层原子技能尝试从用户输入或上下文提取参数时发生异常，通常是由于模型未按规范要求输出或变量映射失败。

请检查参数提取器的配置，并核对模型是否能够准确识别当前上下文中的关键槽位信息。

103101

参数修正原子能力调用失败。

在执行参数补全或修正逻辑时，控制器无法正确构造修正指令或接收到模型反馈的错误信息。

请验证“参数修正”环节的提示词引导词，确保模型在参数缺失时能正确触发反问或补充逻辑。

103102

控制器执行中断。

控制器在管理执行流时收到了预料之外的中断信号，可能源于用户的主动干预或系统级的高优先级强制抢占。

请检查当前控制器的并发策略，并确认是否存在其他模块触发了非法的中断指令。

103103

全局意图跳转超限。

由于全局意图频繁触发，控制器执行的跳转次数超过了系统设定的阈值，旨在防止陷入意图切换死循环。

请优化全局意图的触发阈值或关键词权重，确保意图识别的精准度，避免多个意图配置过于接近。

103104

意图识别错误。

控制器在意图检测模块执行期间发生内部崩溃或返回了非预期的分类结果。

请检查意图分类器所依赖的分类模型及样本库，确保意图定义列表不为空且格式合法。

103105

意图关联工作流执行错误。

意图识别成功，但在调度该意图所绑定的对应工作流执行时发生故障。

请进入该意图对应的工作流画布进行调试，确认起始节点的输入参数与控制器传递的意图上下文兼容。

多智能体

103200

多智能体运行器已启动。

尝试启动一个已经在运行中的多智能体协作任务。系统禁止对同一个Runner实例进行重复初始化。

请检查调用逻辑，确保在发起新任务前旧任务已结束，或直接通过状态查询接口获取当前进度。

103201

目标成员不存在。

在多智能体分发任务或进行路由跳转时，系统无法在当前群组中找到标识的Agent成员。

请核对协作网络中的Agent注册名称，确保分发逻辑或路由配置中指向的成员ID正确无误。

103202

消息处理挂起。

多智能体流转进入了人工干预节点或需要外部反馈的环节，当前消息处理进程已挂起，等待用户输入。

请通过人工审核接口或对话框提供所需的反馈数据，以恢复智能体协作流。

103203

协作处理被中断。

多智能体在进行跨Agent通讯或推理过程中收到了强制中断信号，导致当前的协作事务链条断裂。

请检查是否存在节点超时或系统资源抢占导致的任务强制释放。

103204

运行器未在运行。

尝试对一个已经停止、崩溃或处于闲置状态的运行器发送控制指令（如挂起、终止）。

请先验证运行器的实时状态，确保指令发送对象处于活跃的运行周期内。

103205

运行器尚未启动。

在运行器完成初始化并正式启动之前，尝试调用其执行接口，导致非法操作异常。

请确保在执行run()或next()方法前，已正确完成了运行器的配置与start()调用。

103231

运行空间执行错误。

多智能体在共享的运行空间内执行协作任务时发生底层运行环境崩溃或未捕获的运行时异常。这通常涉及线程池满载或内存溢出。

请检查系统资源占用情况，或查看详细堆栈日志以确认是否由于某个Agent的私有代码逻辑导致了环境污染。

103232

消息队列关闭失败。

在尝试销毁运行空间时，无法正常关闭Agent间通讯的消息总线。

请确认是否存在残留的死锁进程正在持续写入队列，必要时请手动重置消息代理服务。

103233

停止运行任务失败。

控制器尝试终止正在运行的协作任务，但由于某个Agent处于不可中断的阻塞调用中，导致任务停止指令超时或失效。

请检查Agent工具调用是否设置了合理的超时时间，确保所有长时间运行的节点都能响应中断信号。

103234

空闲停止执行失败。

运行空间检测到所有Agent已进入空闲状态，尝试自动关停环境以节省资源时发生异常。

检查运行空间的垃圾回收（GC）逻辑，确保没有非托管资源在空闲期阻碍销毁进程。

103235

停止条件校验失败。

在每次迭代后校验“终止条件”时，由于上下文变量解析错误或逻辑表达式非法，导致无法判断协作是否该结束。

请核对协作配置中的终止表达式语法，并确保表达式引用的变量在上下文中确实存在。

103236

执行Stop-When逻辑错误。

控制器在执行特定的stop_when触发器逻辑时发生错误。与一般条件校验不同，这通常涉及更复杂的代码片段执行失败。

请调试stop_when的自定义函数逻辑，确保其在各种边界场景（如空响应或异常返回）下均能稳定运行。

103261

成员消息处理失败。

这通常是因为该成员的提示词模板损坏或输入参数不符合其预设规范。

请检查该成员的独立配置，并核对前置Agent传递给它的上下文数据是否完整。

103262

消息执行期间异常。

成员在执行推理任务的生命周期中抛出未捕获异常。这可能涉及模型接口调用失败、插件执行崩溃或内存溢出。

查看该成员的运行日志以定位具体崩溃位置，确保其依赖的外部服务和插件环境正常。

103291

消息未处于处理状态。

尝试对消息进行操作（如更新状态或强制中止）时，发现该消息已离开处理队列，或处于非活动状态（如已完成、已丢弃）。

请检查消息ID是否过期，并确认任务调度器是否已意外移除了该消息。

103300

智能体群组已启动。

尝试对一个已处于Active状态的群组实例执行start()命令。

在发起新一轮群组协作前，请先确认旧任务是否已通过stop()释放资源，或直接使用当前活跃实例。

103301

群组未初始化。

在群组组件未完成初始化或未进入运行状态时尝试调用其协作接口。

请检查群组定义的IR结构，确保在调用执行方法前已成功执行了init()过程。

103302

群组执行异常。

群组在协调多个Agent间的流转逻辑（如投票、轮询或分发）时发生系统级错误。

重点排查群组的选择器（Selector）逻辑，确保其能根据当前上下文正确计算出下一个执行的Agent。

103303

成员注册失败。

向群组添加Agent成员时失败。

请检查Agent成员的唯一性，确保没有重复将同一个Agent实例以不同角色注册到同一个群组中。

Elasticsearch存储

100201

Elasticsearch初始化失败。

在初始化 Elasticsearch 客户端时发生异常，可能是由于主机地址无效、协议不匹配或证书错误。

请核对Elasticsearch的连接地址、端口以及身份验证信息是否正确。

接口服务

100000

资源无法找到。

资源不存在。

检查是否存在资源。

100001

鉴权失败。

身份验证凭据无效或已过期。

请重新登录系统。

100002

参数校验失败。

输入参数格式不正确或缺少必要参数。

请检查请求参数是否符合接口规范。

100003

SDK请求失败。

第三方服务或SDK用返回异常。

请检查SDK配置、网络连接或目标服务状态。

100004

加密操作失败。

调用默认加密方法时发生异常，可能是密钥无效或数据格式不支持。

请检查加密算法配置、密钥强度及待加密数据的合法性。

100005

解密操作失败。

调用默认解密方法时发生异常，可能是解密密钥不匹配或密文已被损坏。

请确保使用正确的解密密钥，并检查密文数据完整性。

100006

加解密初始化失败。

加密组件或加解密组件初始化异常，可能是由于环境缺失或配置错误。

请检查环境是否包含必要的密码库，并核对加解密配置参数是否正确。

100007

接口功能保留，当前方法不支持。

该接口目前处于预留状态，当前版本暂不支持调用。

请查阅最新API文档，确认该功能是否已开放或是否有替代接口。

100010

无可用连接服务器。

连接池中没有可用的服务器实例，可能是所有节点都已离线或达到最大连接数。

请检查后端服务运行状态、网络负载情况或增加服务器节点。

100011

连接已关闭。

尝试通过已关闭的连接发送请求或调用函数。

请检查连接状态，在调用前确保连接处于活动状态，必要时重新建立连接。

100012

连接不存在。

指定的连接ID未绑定到当前服务器，或连接信息已失效。

请核对SDK和ID是否正确，并确认该连接是否已成功在目标服务器上注册绑定。

100013

SSL上下文类型错误。

提供的ssl_context参数类型无效，不符合ssl.SSLContext或ContexConfigDict的要求。

请检查传入的SSL配置对象，确保其类型为指定的SSLContext或配置字典格式。

100014

长连接服务启动失败。

在启动指定的长连接服务器实例时发生异常。

请根据错误详情中的key值检查相关端口占用、权限配置或网络资源状态。

100015

WebSocket端口类型错误。

尝试使用非整数类型的端口号启动WebSocket服务。

请修正配置中的端口号，确保其为有效的整数（int）类型。

100016

WebSocket主机地址类型错误。

尝试使用非法类型的主机地址（Host）启动WebSocket服务，期望类型为字符串（str）或空值（None）。

请检查配置中的host参数，确保其为有效的字符串格式IP地址、域名或None。

100017

WebSocket连接校验失败。

在建立新连接的过程中，服务端期望收到的回响（Echo）标识与实际收到的sdk_id不匹配。

请检查握手协议逻辑，确保客户端发送的验证标识与服务端预期的sdk_id一致。

100018

缺失SSL上下文配置。

当前连接模式强制要求启用SSL/TLS加密，但未检测到有效的ssl_context配置。

请为该连接模式提供正确的ssl.SSLContext实例或ContexConfigDict配置字典。

100020

日志最大字节数设置错误。

配置文件中设定的日志滚动最大字节数不是一个正整数。

请检查并修改配置文件，确保max bytes的值是一个大于0的整数。

100021

LLM服务配置缺失。

缺少必要的LLM服务配置信息，导致无法初始化模型服务。

请检查配置文件中的LLM相关参数（如API Key、端点地址等）是否完整。

100022

LLM字段格式缺失。

LLM服务返回或请求的内容中缺少必要的格式化字段。

请核对提示词模板或解析逻辑，确保所有必填字段均已定义。

100023

LLM响应结构错误。

LLM返回的响应数据不符合预定义的结构要求。

检查模型输出是否符合JSON或预设格式，必要时调整提示词以增强输出稳定性。

100024

LLM模型来源错误。

指定的模型来源无效或无法访问（如未授权或路径不存在）。

请验证模型提供商、模型名称或本地模型路径是否正确。

100025

模型请求失败。

向LLM服务发起请求时发生网络异常、超时或接口返回错误。

请检查网络连接、API配额是否充足以及服务端运行状态。

100026

模型加载失败。

模型权重加载失败或推理后端初始化异常。

请检查显存/内存资源是否足够，以及模型文件是否完整。

100027

模型类型错误。

使用了不支持的模型类型或模型任务类型不匹配。

请在配置中确认模型类型（如Chat,Completion,Embedding）是否与调用方法一致。

100028

模型解析器解码失败。

解析LLM输出结果时解码器发生异常，通常是由于非法的编码或截断导致。

请检查模型的解码参数（如max_tokens）或尝试清理输出中的异常字符。

100029

Agent IR校验失败。

Agent的IR字段验证未通过，内部逻辑流转数据异常。

请检查Agent的提示词设计或工具链输出是否符合预期的IR规范。

100066

GET请求执行失败。

执行HTTP GET请求时发生错误。

请检查请求的URL是否正确、网络联通性以及目标服务器是否正常响应。

状态管理

100040

IR数据校验失败。

数据不符合预定义的规范或存在逻辑冲突。

请检查生成的IR数据结构是否完整，并核对字段属性是否合法。

100042

IR版本不支持。

当前系统环境无法识别或不支持该版本的IR数据。

请检查IR版本号，并确保系统已更新至支持该版本的最新状态。

100043

IR版本配置错误。

环境变量或配置项EXECUTION_SUPPORTED_IR_VERSIONS的值格式不正确或为空。

请检查环境配置，确保该变量包含有效的版本列表（如["v1","v2"]）。

100044

IR数据加载失败。

无法从提供的JSON字符串或文件中解析出有效的IR数据，可能存在语法错误。

请检查JSON格式是否正确，并确保其编码为UTF-8。

100045

无效的执行ID。

在状态存储介质（如Redis或内存）中找不到指定的执行ID（Key）。

请确认执行ID是否正确，或检查该ID是否已过期、被清理。

数据库

100051

数据库连接失败。

无法建立与数据库服务器的连接，可能是由于地址错误、端口不通或认证失败。

请检查数据库服务运行状态、网络防火墙配置及连接字符串中的账号密码。

100052

数据库执行异常。

SQL语句执行过程中发生错误，可能是由于语法错误、约束冲突或权限不足。

请检查生成的SQL语句逻辑，并核对数据库表结构与索引配置。

100702

MySQL配置检查错误。

数据库初始化时，必要的MySQL配置项（如Host,Port,User）缺失或格式不正确。

请检查环境变量或配置文件中的数据库连接参数，确保连接地址和凭证有效。

Redis存储

100061

序列化失败。

对象转换为可传输或可存储格式（如JSON/Protobuf）时发生异常。

请检查对象中是否包含循环引用或不支持序列化的数据类型。

100062

反序列化失败。

无法将原始数据转换回指定的数据对象，通常是数据损坏或格式不匹配导致。

请校验输入数据的完整性，并确保其符合目标数据结构的定义。

100100

Redis服务不可用。

找不到指定的Redis服务，或者当前的连接状态异常。

请检查Redis服务器地址配置、端口开放状态以及网络防火墙设置。

100101

Redis初始化失败。

在建立Redis连接池或初始化客户端时发生异常。

请核对Redis认证密码、数据库索引（DB Index）以及客户端依赖库版本。

100102

Redis数据插入失败。

向Redis写入数据时发生异常，可能是由于OOM（内存溢出）或类型不匹配。

请检查Redis剩余内存空间以及所操作的Key对应的数据类型是否正确。

100103

Redis列表追加失败。

尝试向Redis列表（List）末尾添加元素时失败。

确保目标Key是列表类型，并检查Redis是否处于可写状态。

100104

Redis元素删除失败。

从Redis列表中移除指定元素时发生错误。

请检查Key是否存在以及指定的元素值是否在列表中。

100105

Redis指定位置修改失败。

尝试设置Redis列表中特定索引位置的值时失败，可能索引越界。

请确保指定的索引（Index）在列表范围内，且Key类型正确。

100106

Redis获取列表元素失败。

无法从Redis列表中获取指定范围或位置的值。

请确认Key是否为列表类型，并检查索引范围是否有效。

100107

Redis弹出元素失败。

尝试从列表中弹出（Pop）元素时发生异常。

请检查列表是否为空，或连接是否在操作期间中断。

100108

Redis获取列表长度失败。

无法获取指定列表的长度信息。

请确认该Key确实存在且为列表类型。

100109

Redis获取历史数据失败。

从Redis中读取历史记录时发生异常，可能是数据格式损坏或Key已过期。

请核对历史数据的存储键名，并确保数据序列化格式兼容。

100110

Redis存储历史数据失败。

将历史记录写入Redis时失败，可能触发了内存阈值或连接问题。

请检查Redis写入权限及可用内存空间。

100111

Redis设置元素失败。

向Redis写入元素值时发生异常。

请检查数据大小是否超过限制，或Redis是否配置为只读模式。

100112

Redis删除元素失败。

尝试从Redis中删除指定的Key失败。

请确认该Key是否被锁定或当前用户是否有删除权限。

100113

Redis集群节点配置错误。

Redis集群节点格式不正确，期望格式为以逗号分隔的IP:PORT列表。

请检查配置文件中的cluster_node参数，确保每个节点都包含正确的IP地址和端口号。

100114

获取Redis集群节点失败。

无法从Redis中获取集群节点列表，可能是集群状态异常或权限限制。

请检查Redis集群的运行状态，并确保当前连接账号拥有CLUSTER NODES执行权限。

OBS存储

100502

OBS配置项错误。

必要的OBS配置参数不正确或缺失，导致无法通过初始化检查。

请检查Access Key(AK)、Secret Key(SK)以及Endpoint等配置是否填写正确。

100503

存储桶检查失败。

执行Head Bucket操作失败，通常是因为存储桶不存在、名称错误或访问权限不足。

请确认存储桶（Bucket）名称是否正确，并检查当前账号是否拥有该桶的访问权限。

100504

OBS文件上传失败。

上传文件到OBS时被服务端拒绝或发生网络中断。

请根据返回的状态码检查上传权限、对象大小限制或存储空间配额。

100505

OBS获取对象失败。

无法从存储桶获取对象，可能是对象已被删除或路径错误。

请确保存储桶中存在该对象，并核对对象的Key路径是否完整。

100506

OBS复制对象失败。

在存储桶内复制对象时操作失败。

请检查源对象是否存在，以及目标路径是否具有写权限。

100507

OBS删除对象失败。

尝试从存储桶中删除对象时失败。

请确认当前账号拥有该对象的删除权限，并核对对象标识符。

编排引擎

100300

Embedding服务请求失败。

调用向量化（Embedding）服务时发生异常，可能是网络超时、API密钥错误或输入文本过长。

请检查Embedding服务的可用性、网络连接以及请求参数是否符合模型输入规范。

101001

配置格式错误。

系统需要“操作配置”（action_map）是键值对的格式（比如“名称：内容”），但传入的格式不符合要求。

请检查配置内容，确认“操作配置”（action_map）部分是“名称：内容”这样的键值对格式，而非其他格式。

101002

配置规则冲突。

在使用异步函数（async_fn）模式下，禁止同时指定包装类（wrap_cls）。

请根据函数性质选择其一：使用wrap_cls进行同步对象包装，或使用async_fn进行纯异步函数注册。

101003

配置函数类型错误。

async_fn参数必须是一个异步函数（使用async def定义），不能传入普通同步函数。

请检查函数定义，确保在函数名前添加了async关键字。

101004

配置类型非法。

wrap_cls必须是Invokable的子类，以便引擎进行合规的生命周期管理。

请检查类继承关系，确保自定义的包装类继承自框架提供的Invokable基类。

101005

配置不支持的关键字参数。

检测到其作用类的init方法中存在不支持的关键字参数。

请简化类的构造函数参数，或使用框架支持的标准参数命名规范。

101006

环境变量TGF_ENABLE取值错误。

系统环境变量TGF_ENABLE必须设为'true'或'false'（不区分大小写），当前值不合法。

请检查环境配置文件或export命令，将TGF_ENABLE设置为合法布尔值字符串。

101007

未找到可调用实体。

在指定的引用范围或归属者中找不到可调用实体。

请核对编排文件中的节点名称是否与注册的组件名称严格匹配。

101008

未找到指定变量值。

编排逻辑中引用的变量在当前的上下文或作用域中不存在。

请检查数据流传递配置，确保该变量在之前的步骤中已被正确定义或赋值。

101009

配置数据格式错误（JSON格式非法）。

生成的JSON结构损坏或不符合编排引擎规范。

请检查编译器的输出，或验证手动修改后的内容满足规范。

101010

集合类型非法。

invokable_irs字段期望为一个字符串列表（每个字符串应为JSON格式），但实际传入类型不符。

请检查传入参数，确保invokable_irs是一个包含JSON字符串的列表。

101011

参数格式错误。

无法解析或不符合规范。

请根据提示修复对应索引处的JSON语法或结构错误。

101012

系统配置类型错误。

system_configs参数必须以列表（list）形式提供。

请将系统配置项封装在列表结构中后再进行传递。

101013

Agent标识信息缺失。

在执行删除操作时，每个Agent必须同时提供agentId和version属性。

请核对待删除列表，确保每个项都包含完整的ID和版本号信息。

101014

执行器状态码不支持。

接收到了一个执行器层面的未知或不支持的状态码。

请检查执行器版本是否与编排引擎匹配，或核对自定义状态码的定义。

101015

未知流状态码。

流式处理过程中出现了未定义的响应状态码。

请查阅流式接口协议文档，确认该状态码是否为新增类型或异常上报。

101016

IR注销失败。

尝试注销指定的中间表示（IR）组件时失败。

请检查该IR是否正在运行中，并根据返回的状态码确认注销权限。

101017

IR运行异常。

启动或执行指定的IR实例时发生错误。

请检查IR依赖的服务是否就绪，以及运行时输入的参数是否符合要求。

101018

用户输入发送失败。

无法将用户输入透传给IR实例。

请确认会话（Session）是否仍处于活动状态，并检查网络连接或回调地址是否有效。

101019

IR注册失败。

向管理中心注册新的IR组件时被拒绝。

请检查IR标识（ID）是否冲突，以及提交的IR定义是否完整且符合规范。

101020

IR更新失败。

尝试更新已存在的IR定义时发生错误。

请验证更新内容的版本号一致性，并确保当前服务允许热更新操作。

101021

IR管理器缺失。

系统中找不到I管理器实例，导致管理操作无法路由。

请检查初始化配置中是否正确注册了该名称的管理器，并核对拼写是否正确。

101022

Invokable管理器缺失。

无法找到指定的可调用（Invokable）管理器，导致组件调用失败。

请确认执行引擎中已正确配置并启动了对应的Invokable管理服务。

101023

Invokable JSON格式非法。

可调用实体（Invokable）的定义数据无法被正确解析，通常由于JSON语法错误或缺少必要描述字段。

请校验Invokable定义的JSON文本，确保其符合框架的组件描述规范。

101024

Invokable注册路径类型错误。

从目录批量注册可调用实体时，路径参数必须是字符串（str）类型，当前传入类型不符。

请确保传入register_from_dir方法的参数是一个有效的文件夹路径字符串。

101025

Invokable注册路径非法。

指定的注册路径不是一个有效的目录，导致无法扫描其中的组件定义。

请检查路径是否存在，并确保该路径指向的是一个文件夹而非文件或快捷方式。

101026

目录批量注册Invokable失败。

在扫描目录并批量注册组件的过程中发生异常中断。

请检查目录下的所有组件定义文件是否完整，并根据错误详情排查具体哪个文件导致了中断。

101027

插件管理器注册失败。

尝试将可调用实体注册到指定的插件管理器（PluginManager）时被拒绝。

请检查插件管理器的状态，确认是否存在名称冲突或权限限制。

101028

Invokable操作失败。

对可调用实体执行特定操作（如启动、停止、卸载）时失败。

请根据返回的错误码和详细信息，检查该实体的当前状态是否允许执行该操作。

101029

HTTP内容类型不匹配。

用户输入中的数据类型与请求头或配置中设定的Content-Type不一致。

请根据错误提示修正请求头的Content-Type，或调整传入参数的格式以符合预期类型。

101030

编排引擎未知错误。

编排引擎在执行过程中遇到了未捕获的非预期异常。

请查看系统日志以获取详细的堆栈信息，并联系开发人员排查潜在的逻辑漏洞。

101034

执行管理器配置缺失。

缺少用于Invokable管理的可调用实体管理配置项，导致执行器无法初始化。

请检查application.yaml配置文件，确保已正确定义相关管理参数（如存储、路由等）。

101035

工作节点配置缺失。

缺少用于AgentIR管理的工作节点（Worker）配置信息。

请在application.yaml中补充必要的Agent运行时配置，以确保执行引擎能正确调度IR。

101036

模型类未找到。

系统无法找到模型实现类，可能是类名拼写错误或该模型未被扫描加载。

请确认该模型类已正确注册到模型仓库中，并检查其所在的路径是否在扫描范围内。

101037

会话通知失败。

IR管理器尝试向指定会话发送状态通知或回调时失败。

请检查会话连接状态（如WebSocket是否断开）以及回调服务地址是否能正常访问。

101052

组件单步调试异常。

在对组件进行单步跟踪或调试模式执行时发生错误。

请检查调试器连接状态及组件的上下文信息。

101053

组件类型不支持调试。

当前组件类型（如某些内置原子组件或加密组件）不支持单步调试功能。

请确认组件定义中是否开启了调试支持，或尝试直接运行而非调试模式执行。

101054

组件IR非法。

单个组件的IR定义不符合规范，解析失败。

请检查组件的配置文件或DSL编译结果，确保其IR结构完整。

101055

组件结束调用输入错误。

组件结束（End Component）时接收到的输入参数中'userFields'字段应为字典类型。

请检查前序组件的输出或当前组件的参数映射，确保传入的是字典格式。

101056

组件运行输入校验失败。

组件在运行时检测到输入参数不符合其定义。

请根据校验错误提示核对上游组件传递给该组件的参数格式和值范围。

101057

组件输入输出一致性校验失败。

组件的初始化检查失败，其输出字段必须与输入字段保持一致（如状态透传组件）。

请调整组件定义，确保指定的输入输出字段名和类型完全匹配。

101058

全局上下文类型冲突。

尝试在全局上下文中写入数据，但已存在的全局项类型不是字典（dict），导致无法合并或追加。

请检查全局状态管理逻辑，确保在整个编排流程中全局变量的基准类型是一致的。

101099

组件配置加载失败。

在初始化组件时，无法加载其特定的配置文件或参数。

请检查该组件关联的JSON/YAML配置文件路径是否正确，以及文件权限是否正常。

101100

组件结束配置映射缺失。

在组件配置的'userFields'中定义了字段，但在实际传入的'inputs'数据中未找到该字段。

请确保配置中声明要透传或处理的字段在输入数据流中确实存在。

101101

插件函数列表类型错误。

插件的函数集合定义非法，期望为字符串格式的列表、元组或集合。

请检查插件注册信息，确保functions字段是一个包含函数名称字符串的集合。

101102

任务插件操作失败。

在对任务插件执行特定操作（如加载、卸载）时失败。

请根据详细的错误信息排查插件服务状态或权限问题。

101103

更新插件类型不匹配。

更新插件时提供的组件类型非法。系统仅接受RestFulApi或Function对象的列表。

请检查更新调用中的参数类型，确保传入的是标准API定义或函数对象。

101104

任务参数字段名错误。

在解析任务参数或配置时发现未定义的非法字段名。

请核对任务定义的规范，移除或修正配置文件中拼写错误的字段。

101105

任务规划配置初始化失败。

动态编排中的规划器（Planner）无法加载必要的配置，导致任务拆解功能不可用。

请检查规划器相关的application.yaml配置段，确保策略模型和参数已正确设定。

101106

任务模型初始化失败。

任务执行所依赖的底层模型（如用于意图识别或规划的大模型）初始化异常。

请检查模型连接凭证、资源可用性（GPU/内存）或后端服务地址。

101107

任务插件初始化失败。

在任务启动阶段，必要的扩展插件未能成功加载或建立连接。

请查看系统日志定位具体是哪个插件初始化超时或报错。

101200

编排校验失败。

在对编排模型进行合法性检查时发现校验错误。

请根据详细的描述信息修正DSL结构或组件连接逻辑，确保符合编排规范。

101201

组件JSON根类型错误。

组件定义的JSON根节点类型非法。系统仅接受对象（dict）或列表（list）。

请检查JSON文件的最外层结构，确保其为{}或[]格式。

101260

子图操作失败。

在对根IR执行操作时，其中的子IR发生错误。

请检查子图组件的依赖关系及运行状态，确认子IR是否已被正确定义或加载。

101261

根图操作失败。

尽管所有子图组件都已成功处理，但在执行根Agent IR的最后步骤（如合并或持久化）时发生错误。

请检查根组件的全局配置及状态存储介质的写入权限。

101285

复合组件缺少引用。

复合类型组件定义不完整：既没有指定IR构建器（Builder），也缺少可选的IR静态定义。

请为复合组件提供有效的builder_spec或optional_ir路径。

101286

复合组件构建器未找到。

系统无法定位复合组件所声明的IR构建器逻辑。

请确认构建器类的包名和路径是否正确，并确保已包含在系统的类路径中。

101287

构建器导入失败。

在动态加载复合组件构建器时发生Python导入异常。

请检查构建器代码是否存在语法错误，或其依赖的第三方库是否已安装。

101288

构建器类型错误。

加载的对象并不是一个合法的IR构建器类。

请确保自定义构建器类实现了预期的构建接口或继承了BaseIRBuilder。

101289

复合组件构建执行失败。

构建器在尝试动态生成复合组件实例的IR时发生内部执行错误。

请检查构建器的build()方法逻辑，特别是其对输入参数的处理是否严谨。

101290

内部内置组件注册失败。

在执行操作期间，系统尝试自动注册内置的可调用实体（Invokable）时触发了内部异常。

这通常属于底层框架异常，请检查系统启动日志中关于基础库加载的部分，并确认核心内置插件包是否完整且未被篡改。

Prompt引擎

102001

LLM服务返回空值。

模型推理服务响应成功但在Body中未包含任何文本内容或有效负载，通常发生在模型拒绝回答或触发安全过滤时。

请检查输入提示词是否敏感，或尝试调整模型的温度值以改变生成策略。

102002

HTTP请求网络错误。

在调用远程模型接口时发生网络层异常，如DNS解析失败、网关超时（504）或连接被重置。

请检查模型服务商的API地址是否可访问，并确认网络防火墙或代理服务器配置正常。

102003

LLM业务逻辑错误。

模型服务返回了非200状态码，或者在协议层面返回了明确的错误标识。

请根据具体报错信息检查账户余额、Token配额或API参数是否合法。

102004

LLM服务连接失败。

建立TCP连接或SSL握手时失败，通常由于目标服务器宕机或网络不稳定。

请验证模型服务端点（Endpoint）是否正确，并尝试增加连接重试机制。

102005

环境变量获取失败。

提示词引擎无法从执行上下文中读取必要的环境变量（如API_KEY、BASE_URL），导致无法发起请求。

请确保系统环境变量已正确注入，或者在工作流的全局配置中补全缺少的配置项。

102006

输出解析器初始化失败。

定义的解析逻辑在创建实例时报错。

请检查输出解析器的配置是否符合规范，确保与预期的模型输出格式匹配。

102007

输出解析器执行异常。

在处理模型返回的字符串时，解析器抛出异常。通常是因为模型输出并非合法的JSON或未包含预期的关键字。

请优化提示词以引导模型输出更严谨的结构化数据，或在解析前增加数据清洗步骤。

102008

MEP协议返回异常。

多模型执行协议（MEP）在分发或聚合多个模型请求时发生逻辑错误。

请检查MEP路由规则配置，确保下游各个备选模型的健康状况正常。

102009

运行时上下文缺失。

提示词引擎在执行过程中丢失了必需的运行时上下文引用，导致无法读取Trace ID或变量池。

请检查线程池调度或异步调用链中是否正确传递了Context对象。

102010

IR构建错误。

在将提示词定义转换为IR时解析失败。

请检查提示词配置中的DSL语法，确保条件分支和变量引用的逻辑闭环。

102011

不支持的模型服务类型。

配置中指定了系统无法识别的服务提供商或协议类型。

请核对支持的服务类型列表（例如OpenAI, Anthropic, DashScope等），修正拼写或更新驱动包。

102012

LLM执行被中断。

组件在等待模型返回时接收到了来自运行环境的中断信号，可能是由于用户主动取消或工作流整体超时。

无需特别处理，如非预期中断，请排查前端是否存在误触取消操作或调大全局超时设置。

102050

变量初始化参数错误。

在创建提示词变量对象时传入了错误的参数类型或配置项，导致变量引擎无法识别占位符。

请检查模板中定义的变量属性（如Name, Type, Default Value），确保其符合变量定义的规范。

102051

组装器初始化错误。

提示词组装器在初始化时接收到的配置信息不完整，无法建立模板与变量之间的映射关系。

请核对组装器的核心配置，确保传入了有效的模板内容和变量列表。

102052

组装器键值对匹配错误

更新模板参数时，传入的键（Key）在模板定义中不存在，或者缺少了模板中要求的必填变量。

请根据模板定义的变量名核对输入数据。

102053

模板格式化错误。

模板语法存在错误（如大括号未闭合、使用了非法转义字符），导致Jinja2或String格式化引擎无法渲染最终结果。

请检查提示词文本中的语法格式，确保占位符使用正确且没有语法逻辑冲突。

102054

提示词组件初始化失败。

提示词管理组件在加载配置或连接后端存储时发生异常。

请检查组件的注册状态和配置文件路径，确保组件所需的底层资源已就绪。

102055

提示词组件调用失败。

在执行提示词渲染或处理逻辑时发生非预期中断。

请检查调用链中的变量传递过程，排查是否存在空指针或非法的逻辑跳转。

102056

格式定义非法。

为约束模型输出而定义的格式不符合标准规范。

请使用标准的校验工具检查结构定义，确保keywords（如properties, type）使用正确。

102101

提示词模板重复。

尝试创建或导入模板时，系统检测到已存在相同名称或唯一标识符的模板，导致命名冲突。

请更换模板名称或ID，或在更新现有模板时使用更新接口而非创建接口。

102102

模板数据异常。

从存储中检索到的模板数据格式损坏或关键字段（如内容、版本号）缺失，导致模板无法被正常解析。

请尝试重新保存该模板以修复受损的数据结构，或检查数据库层面的数据一致性。

102103

提示词模板不存在。

引擎尝试加载指定的模板，但在数据库或本地存储中未找到对应的记录。可能是由于模板ID错误、模板已被删除或环境迁移导致数据丢失

请核对模板ID是否正确，并确认该模板在当前租户或空间下是否已保存。

102104

模板存储加载失败。

系统在连接模板仓库时发生I/O错误或权限受限，导致无法读取模板列表。

请检查存储服务的运行状态（如MySQL/Redis），并验证服务账号的读取权限。

102150

提示词变异操作失。

大模型在执行“变异”指令（即对提示词进行同义改写或策略调整）时，未能保留原始模板中的变量占位符，导致新生成的提示词无法与业务参数匹配。

请检查变异指令的提示词，要求模型在优化内容时必须严格保留所有的变量标签。

102151

提示词交叉操作失败。

大模型在执行“交叉”指令（即融合两个优秀提示词的优点）时，生成的混合模板丢失了父级模板中的共有占位符。

请确保参与交叉的父模板具有一致的占位符结构，并优化交叉引导词以强调结构完整性。

102152

测试用例占位符不匹配。

在提示词评估或自优化过程中，测试用例中定义的变量占位符与原始模板不一致，导致数据无法正确注入。

请核对测试用例的数据结构，确保其Key值与原始提示词模板中的变量名完全对应。

102153

测试用例内容不匹配。

测试用例中的消息模板内容与系统中存储的原始模板内容不符，无法建立有效的版本对应关系进行对比优化。

请刷新测试用例，确保其基于当前最新的提示词模板版本构建。

102154

提示词优化参数非法。

启动优化任务时传入的配置参数（如迭代次数、样本比例或评估指标权重）不符合逻辑或超出范围。

请根据接口文档核对优化参数的取值范围，并确保所有必填配置项均已正确填写。

102155

提示词优化任务不存在。

系统无法根据提供的Job ID检索到对应的优化任务记录，可能是任务已被物理删除或ID输入错误。

请确认任务ID的准确性，或在任务列表中重新发起优化申请。

102156

任务状态异常。

尝试执行的操作（如停止、重启）与任务当前所处的状态冲突（例如：无法重启一个正在运行中的任务）。

请先刷新任务状态，待当前流程结束后再尝试后续操作。

102157

提示词优化评估失败。

在对新生成的提示词变体进行自动评分或效果对比时发生异常。可能是由于评估模型不可用或评估逻辑代码崩溃。

请检查评估器的配置，并确保评估模型及其API Key状态正常。

102158

优化任务启动失败。

任务调度器在尝试拉起优化工作流时发生底层错误。通常涉及资源锁定、并发配额限制或初始化超时。

请稍后重试，或检查系统后端调度引擎的负载情况。

102159

优化任务重启失败。

尝试对已失败或已停止的任务进行断点续传或重跑时失败。

如果多次重启失败，建议直接克隆该任务并创建一个全新的优化作业。

102160

优化用例校验失败。

导入或执行优化任务时，测试用例的数据格式未能通过校验。

请按照指定的CSV/JSON模板格式重新整理测试用例数据，并注意字符编码规范。

102161

无法获取评估标签。

在优化评估阶段，系统无法从历史消息记录中提取出作为基准的预期结果，导致无法计算准确率或评分。

请检查测试数据集，确保每个测试用例都包含正确的预期输出。

102170

优化任务存储失败。

在保存优化中间过程、变体结果或评估报告时，数据库写入发生异常。

请检查后端存储服务的磁盘空间及连接池状态，确保系统具备持久化大规模评估数据的能力。

102201

不支持的元模板类型。

请求的元模板标识符不在系统支持的预设列表内，无法匹配对应的生成逻辑。

请核对元模板名称是否正确，或参考系统文档获取当前支持的元模板清单。

102202

元模板不存在。

尝试调用的元模板文件或配置在存储层缺失，可能已被删除或路径配置错误。

请确认元模板资源已部署至正确目录下，或联系管理员同步模板库。

102203

元模板工具解析失败。

在解析用于生成提示词的工具描述（Tool/Function Definition）时发生错误，通常由于工具的JSON格式非法。

请检查传入元模板的工具定义，确保其符合标准的OpenAPI或Function Calling规范。

102204

元模板构建失败。

元模板渲染引擎在将基础元数据转化为最终提示词时发生内部崩溃或逻辑死锁。

请排查元模板内容的复杂性，并检查系统内存资源是否足以支撑大规模模板构建。

102205

元模板输入项缺失。

调用元模板生成接口时，未提供该模板必需的控制参数。

请根据元模板的要求补全输入参数，确保所有必填Key均已赋值。

102206

LLM配置类型不支持。

为元模板指定的下游推理模型类型尚未适配模板生成引擎。

请切换至主流的LLM类型（如OpenAI、Azure或系统内置驱动），或联系开发团队增加模型适配。

102207

LLM生成结果失败。

在执行提示词自动生成的推理过程中，模型返回了错误信息或连接中断。

请检查后端LLM服务的状态、配额以及请求超时设置。

102208

模板编辑失败。

在对现有模板进行程序化修改或打补丁（Patching）时发生错误，通常与文件权限或并发锁定有关。

请确认当前用户具备该模板的编辑权限，并检查是否有其他任务正在占用该资源。

102209

存储类型不匹配。

提示词引擎试图通过错误的存储协议访问数据。

请核对系统配置中的Storage Backend设置，确保与物理存储类型保持一致。

102210

提示词模块初始化错误。

提示词引擎的核心配置文件加载失败，或者依赖的外部环境变量存在逻辑冲突。

请重新检查主配置文件（如config.yaml）的语法，并确保所有必需的外部依赖项已安装。

102211

捕获到未知异常。

提示词引擎触发了未预见的代码逻辑异常。

请将详细的错误堆栈反馈给技术支持团队，并尝试重启相关服务模块。

102212

SSL环境配置解析异常。

用于SSL证书验证的环境变量JSON字符串格式非法，导致引擎无法建立安全连接。

请核对SSL_VERIFY相关环境变量的JSON格式，确保双引号和转义字符使用正确。

102213

优化反馈处理异常。

在处理用户提供的针对提示词效果的反馈数据时发生异常。

请检查反馈数据的入参结构，确保反馈ID与优化任务ID正确对应

102214

优化Badcase异常。

系统在尝试根据Badcase数据反向优化提示词时失败，可能是由于Badcase样本量不足或格式不兼容。

请增加Badcase样本的多样性，并确保每个样本都包含明确的错误分类标签。

规划引擎

103001

规划器配置校验失败。

规划器组件的元数据或运行参数不完整，导致无法通过预执行检查。

请检查规划器节点的设置界面，确保所有必填项已正确填写，且逻辑连接无误。

103002

提示词名称缺失。

规划器未关联具体的提示词（Prompt）模板，导致引擎无法构造任务拆解指令。

请在规划器配置中选择一个有效的提示词模板，或在关联的提示词节点中指定名称。

103003

规划模型缺失。

未为规划器指定执行推理的大语言模型（LLM），导致规划逻辑无法启动。

请在规划器设置中关联一个已配置的模型服务。

103004

模型调用失败。

规划引擎在请求大模型进行任务规划时，收到错误响应或连接超时。

请检查后端模型服务的可用性、API Key有效性及网络连通性。

103005

规划状态类获取失败。

系统无法根据当前的规划模式找到对应的状态管理类，通常由插件加载错误引起。

请检查规划模式设置是否与当前引擎版本兼容，并确认相关扩展组件已安装。

103006

正则解析失败。

规划器尝试利用正则表达式从模型返回的文本中提取结构化步骤时失败，模型输出格式不符合预期。

请优化规划器的提示词，引导模型输出更加规范的格式，或调整正则表达式的匹配规则。

103007

索引访问失败。

规划引擎在尝试访问步骤列表或变量数组时，索引值超出了实际范围。

请排查前置逻辑是否产生了预期的列表数据，确保索引操作在合法范围内。

103008

插件配置获取失败。

规划器无法从全局配置中心读取所需的插件参数（如API密钥或Endpoint）。

请检查全局变量或插件中心的配置信息，确保规划器依赖的参数已正确注入。

103009

比较表达式解析失败。

规划器中的条件判断表达式非法，导致无法得出布尔值（True/False）结果。

请核对比较运算符（如==,>,<）的使用方式，确保比较的对象类型可兼容。

103010

IR模板获取失败。

系统找不到对应规划模式的中间表示（IR）模板文件，导致无法生成可执行的执行图。

请确认规划模式配置正确，并检查系统资源目录中是否存在对应的.ir或配置文件。

103011

提示词格式化失败。

在将运行时变量注入规划提示词模板时发生错误，通常是由于变量占位符语法错误。

请检查提示词模板中的变量标签，确保其与传入的参数名称一一对应。

103012

技能配置获取失败。

规划器无法读取技能的详细配置参数。

请在技能管理页面检查该技能的定义，确保其配置参数已正确保存。

103013

技能类型获取失败。

规划引擎无法识别目标技能的调用类型（如HTTP, Python, Shell）。

请确认技能的元数据定义完整，且该类型技能在当前环境中已被支持。

103014

工作流起始组件解析失败。

规划器在尝试调用子工作流时，无法识别该工作流的起始节点。

请打开被调用的子工作流，确保其包含且仅包含一个合法的起始节点。

103015

工作流组件运行失败。

规划器指派的工作流节点在执行过程中发生非预期中断或内部错误。

请查看子工作流的执行日志，定位具体的异常节点并进行修复。

103016

指定版本的IR模板获取失败。

系统尝试根据版本号加载规划模式的IR模板，但在存储库中未找到匹配的记录。可能是该版本已被移除或版本号不合法。

请核对规划器配置中的版本信息，确保所引用的版本在模板库中已发布且处于可用状态。

103017

规划器配置类型校验失败。

字段的参数类型不正确。

请进入规划器节点的参数设置界面，根据提示的类型要求重新配置相关字段，确保数据格式合法。

103018

规划器流式处理异常。

规划引擎在执行流式输出（Streaming）或处理模型增量响应时发生非预期中断。

请检查网络连接的稳定性，并确认模型服务端是否支持当前所选规划模式下的流式输出协议。

102301

模型信息参数非法。

在启动NL2Agent（自然语言生成Agent）流程时，传入的模型配置信息（如名称、版本、Endpoint）校验不通过。

请确保modelInfo中包含有效的模型标识及必要的认证信息。

执行引擎

104001

流式运行异常。

执行引擎在以流式（Stream）模式启动任务时，未能正确建立实时传输通道，或在传输过程中遭遇非预期的连接中断。

请检查前端与后端之间的Web Socket或SSE连接状态，确保中间件未拦截长连接。

104002

执行器内部错误。

执行器在处理任务调度或线程分配时触发了底层系统异常。这通常涉及CPU调度超时或内核级指令错误。

请尝试重启执行引擎服务，若错误持续，请检查服务器系统日志排查资源竞争问题。

104003

通用请求错误。

执行器向外部服务（如数据库或第三方API）发起请求时发生未知错误，通常是由于网络抖动或请求格式不符合对方规范。

请检查网络防火墙配置，并验证执行器对外部资源的访问权限。

104004

算子执行失败。

执行引擎在运行特定的算子逻辑（如数据转换、数学运算节点）时抛出异常。可能是由于输入数据类型非法或算子内部算法崩溃。

请进入画布检查该节点的输入值格式，确保符合算子的业务逻辑要求。

104005

从管理器获取节点列表失败。

分布式环境下的执行器无法从管理节点同步当前的Worker节点列表，导致任务无法正常分发。

请检查管理节点的服务状态，并确保执行器与管理器之间的RPC通信（如gRPC/HTTP）未被拦截。

104006

会话清理失败。

任务结束后，执行器尝试回收Session资源、删除临时文件或释放内存缓存时发生冲突。

请排查是否存在文件句柄被其他进程锁定，或增加会话清理的重试机制。

104007

用户输入执行失败。

执行器在处理用户实时注入的指令（如动态参数修改）时，由于指令校验未通过或执行环境不支持动态干预而报错。

请确保用户输入的参数符合预设的规范，且当前执行状态允许动态更新。

104008

流式数据处理失败。

执行引擎在解析来自模型的流式Token块或中间过程数据时发生序列化错误。

请检查模型输出的协议版本是否与执行引擎匹配，避免因不兼容的Stream格式导致解析中断。

上下文引擎

109500

上下文配置错误。

上下文引擎的基础配置设置不当

请核对系统设置中的Context Policy，确保滑动窗口或摘要策略的参数在模型支持的范围内。

109501

记忆客户端初始化失败。

上下文引擎在尝试初始化负责连接后端记忆存储的代理（Proxy）或客户端时失败。

请检查后端存储服务（如Redis,Milvus或数据库）的连接地址、端口及鉴权凭证是否正确。

Insight

108003

子节点执行索引缺失。

在追踪调用链时，父节点下属的子节点执行顺序索引不存在。这会导致Insight无法正确还原执行拓扑图。

请检查执行引擎在下发子任务时是否正确生成了Sequence ID，并确认分布式链路追踪数据的完整性。

108004

调用ID不存在。

尝试查询特定执行记录时，系统无法找到该invoke_id。可能是数据已被清理，或者在异步写入数据库时发生了延迟。

请确认查询的ID是否准确。如果是在任务刚结束时查询，请稍后重试以等待数据同步完成。

108005

调用类型不匹配。

Insight分析引擎预期处理的是提示词类型的调用数据。

请核对监控过滤器设置，确保请求的分析对象与实际节点的组件类型保持一致。

108006

项目ID缺失。

Insight请求头中缺少必填的x-insight-project-id参数，导致无法对监控数据进行项目隔离。

请在请求Header中补充项目ID，确保监控指标能归档到正确的业务组下。

系统运行

999999

系统内部错误。

系统内部错误。

请联系技术支持进行定位。

动态规划

109011

策略环境变量未配置。

系统尝试加载外部自定义策略，但环境变量JIUWEN_CUSTOM_STRATEGY_PATH未在服务器中定义。

请在系统环境变量或配置文件中设置该路径，指向存放自定义策略脚本的目录。

109012

策略路径不存在。

配置的策略路径在文件系统中不存在，导致动态加载器无法定位脚本文件。

请检查路径拼写是否正确，并确认执行账户具备访问该目录的读取权限。

109013

无效的策略文件路径。

提供的路径指向了一个目录而非具体的策略执行脚本（如.py或.yaml），导致解析中断。

请明确指定策略脚本的完整文件名及其后缀。

109014

策略注册中心未初始化。

在注册中心完成initialize()过程前，尝试执行策略查找或调用。通常发生在系统启动阶段的竞态冲突。

请检查启动逻辑，确保所有的Provider和策略注册动作在主逻辑运行前已成功闭环。

109015

策略未匹配。

在指定的提供者下未找到规划策略。

请核对策略名称及关联的Provider标识符，确认该策略是否已在系统中注册并启用。

109016

内置策略加载失败。

系统内置的核心策略文件缺失。这通常由于软件包安装不完整或版本更新导致的文件迁移。

请尝试重新部署引擎核心组件，确保builtin_strategies目录下的所有资源完整。

109017

策略异步调用异常。

策略组件在执行异步调用时触发了非预期的运行时错误。

排查策略内部的异步逻辑，检查是否存在未捕获的协程异常或事件循环冲突。

109018

Agent迭代次数配置非法。

智能体的最大迭代步数被设置为非正整数。这会防止模型进入死循环或无法启动任务。

请将max_iteration修改为大于0的整数。

109019

插件地址缺失。

规划策略在尝试分发任务给特定插件时，发现该插件的调用URL为空。

请检查插件管理模块中的Endpoint配置，确保该插件已正确部署并暴露了合法的API地址。