错误类型

本文总结了不同类型节点可能发生的异常和对应的错误类型。

通用错误

  • 系统错误(System Error)

    通常由系统问题引起,例如沙盒服务未开启、网络连接异常等。

  • 操作错误(Operational Error)

    应用开发者无法正常配置或运行节点时发生的错误。

代码节点

代码节点 支持运行 Python 和 JavaScript 代码,用于在工作流或聊天流中对数据进行改造。以下是常见的 4 种运行错误:

  1. 代码节点错误(CodeNodeError)

    此错误是由于开发者编写代码中的异常引起的,例如:缺少变量、计算逻辑错误、将字符串数组输入作为字符串变量处理等。你可以通过错误信息和精确的行号定位问题。

    代码错误
  2. 沙盒网络问题(System Error) 此错误常见于网络流量或连接异常时,例如沙盒服务未开启,代理服务中断了网络。你可以通过以下方式解决:

    1. 检查网络服务质量

    2. 开启沙盒服务

    3. 验证代理设置

    沙盒网络问题
  3. 深度限制错误(DepthLimitError)

    当前节点的默认配置最多仅支持 5 层嵌套结构。如果超过 5 层,则会报错。

    OutputValidationError
  4. 输出验证错误(OutputValidationError)

    如果实际输出变量类型与所选输出变量类型不一致将报错。开发者需要更改所选的输出变量类型规避此问题。

LLM 节点

LLM 节点是 Chatflow 和 Workflow 的核心组件,利用大语言模型的对话、生成、分类和处理能力,基于使用者输入的指令完成各种任务。

以下是运行时常见的 6 种错误:

  1. 未找到对应变量(VariableNotFoundError)

    如果 LLM 找不到系统提示词或在上下文中设置的变量,则会出现此错误。应用开发者可以通过替换异常变量来解决此问题。

    VariableNotFoundError
  2. 上下文结构无效(InvalidContextStructureError)

    LLM 节点内的 上下文 接收到非法数据结构(如 array[object])时会报错。

    上下文仅支持字符串(String)数据结构。

    InvalidContextStructureError
  3. 错误的参数类型(InvalidVariableTypeError)

    系统提示词的类型不为常规的 Prompt 文本或 Jinja 语法格式,则出现此错误。

  4. 模型不存在(ModelNotExistError)

    每个 LLM 节点都需要配置一个模型,如果未选中模型将出现此错误。

  5. LLM 需授权(LLMModeRequiredError)

    LLM 节点所选中的模型未配置 API Key,你可以阅读 此文档 授权模型。

  6. 未找到提示词(NoPromptFoundError)

    LLM 节点的提示词不能为空,否则异常。

HTTP

HTTP 节点允许通过发送 HTTP 请求获取数据、触发Webhook、生成图像或下载文件,从而通过可定制的请求与外部服务无缝集成。以下是该节点常见的 5 种错误:

  1. 授权配置错误(AuthorizationConfigError)

    未配置认证信息(Auth)时出现此报错。

  2. 文件获取错误(FileFetchError)

    无法获取文件变量时出现此报错。

  3. 无效的 HTTP 请求方法(InvalidHttpMethodError)

    请求头非以下方法:GET、HEAD、POST、PUT、PATCH 或 DELETE,出现报错。

  4. 响应大小超限(ResponseSizeError)

    HTTP 返回的响应大小限制为 10MB,如果响应超出限制,出现报错。

  5. HTTP 响应代码错误(HTTPResponseCodeError)

    当请求响应返回非 2 开头的代码时(例如 200, 201)将报错。如果开启了异常处理,当返回的状态码为 400、404、500 时将报错,否则不会报错。

工具

运行时常见以下 3 种错误:

  1. 工具执行异常(ToolNodeError)

    工具本身执行的异常报错,例如达到了目标 API 的请求限制。

  1. 工具参数异常(ToolParameterError)

    所配置的工具节点参数存在异常,传入了不符合工具节点所定义的参数。

  2. 工具文件处理异常(ToolFileError)

    工具节点未找到所需的文件,出现报错。

Last updated