Files
aiagent/可新增节点类型建议.md
2026-01-22 09:59:02 +08:00

16 KiB
Raw Permalink Blame History

可新增节点类型建议

📊 当前已实现的节点类型

基础节点

  • start开始

  • input输入

  • output输出

  • end结束

AI节点

  • llmLLM调用

  • template模板

  • agentAgent调用

逻辑节点

  • condition条件判断

  • loop循环

数据节点

  • transform数据转换

  • database数据库操作

  • file文件操作

网络节点

  • httpHTTP请求

  • webhookWebhook

系统节点

  • schedule定时任务

  • delay/timer延迟/定时器)

通信节点

  • email邮件

  • message_queue消息队列


🆕 建议新增的节点类型(按优先级排序)

🔴 高优先级(核心功能增强)

1. Switch节点多分支路由

  • 类型: switch

  • 分类: 逻辑

  • 功能: 根据多个条件值进行多分支路由类似编程语言的switch/case

  • 配置:

  ```json

  {

    "field": "status",

    "cases": {

      "success": "success_handle",

      "failed": "error_handle",

      "pending": "wait_handle"

    },

    "default": "default_handle"

  }

  ```

  • 使用场景: 多状态处理、多条件分支、路由分发

  • 参考: n8n的Switch节点

2. Merge节点合并分支

  • 类型: merge

  • 分类: 逻辑

  • 功能: 合并多个分支的数据流

  • 配置:

  ```json

  {

    "mode": "merge_all",  // merge_all, merge_first, merge_last

    "strategy": "array"    // array, object, concat

  }

  ```

  • 使用场景: 并行处理后的结果合并、多数据源汇总

  • 参考: n8n的Merge节点

3. Wait节点等待条件

  • 类型: wait

  • 分类: 逻辑

  • 功能: 等待特定条件满足后再继续执行

  • 配置:

  ```json

  {

    "wait_type": "condition",  // condition, time, event

    "condition": "{status} == 'ready'",

    "timeout": 300,

    "poll_interval": 5

  }

  ```

  • 使用场景: 等待异步任务完成、等待外部事件、条件等待

  • 参考: Make.com的Wait节点

4. JSON处理节点

  • 类型: json

  • 分类: 数据

  • 功能: JSON解析、构建、转换、验证

  • 配置:

  ```json

  {

    "operation": "parse",  // parse, stringify, extract, validate

    "path": "$.data.items[*]",

    "schema": {}

  }

  ```

  • 使用场景: API响应处理、数据提取、JSON格式转换

  • 参考: n8n的JSON节点

5. 文本处理节点

  • 类型: text

  • 分类: 数据

  • 功能: 文本拆分、合并、提取、替换、格式化

  • 配置:

  ```json

  {

    "operation": "split",  // split, join, extract, replace, format

    "delimiter": "\n",

    "regex": "\d+",

    "template": "Hello {name}"

  }

  ```

  • 使用场景: 文本清洗、格式化、提取关键信息

  • 参考: Zapier的Text Formatter

6. 缓存节点

  • 类型: cache

  • 分类: 数据

  • 功能: 数据缓存、缓存读取、缓存更新

  • 配置:

  ```json

  {

    "operation": "get",  // get, set, delete, clear

    "key": "user_{user_id}",

    "ttl": 3600,

    "backend": "redis"  // redis, memory

  }

  ```

  • 使用场景: 减少重复计算、提高性能、临时数据存储

  • 参考: n8n的Cache节点


🟡 中优先级(功能扩展)

7. 向量数据库节点

  • 类型: vector_db

  • 分类: AI

  • 功能: 向量存储、相似度搜索、RAG检索

  • 配置:

  ```json

  {

    "operation": "search",  // search, upsert, delete

    "collection": "documents",

    "query_vector": "{embedding}",

    "top_k": 5

  }

  ```

  • 使用场景: RAG应用、语义搜索、知识库检索

  • 参考: LangChain的VectorStore

8. Slack/钉钉/企业微信节点

  • 类型: slack / dingtalk / wechat_work

  • 分类: 通信

  • 功能: 发送消息、创建频道、获取消息

  • 配置:

  ```json

  {

    "operation": "send_message",

    "channel": "#general",

    "message": "Hello {user}",

    "attachments": []

  }

  ```

  • 使用场景: 团队通知、工作流通知、协作沟通

  • 参考: Zapier的Slack集成

9. 短信节点SMS

  • 类型: sms

  • 分类: 通信

  • 功能: 发送短信、批量发送、短信模板

  • 配置:

  ```json

  {

    "provider": "aliyun",  // aliyun, tencent, twilio

    "phone": "{phone_number}",

    "template": "验证码:{code}",

    "sign": "公司名称"

  }

  ```

  • 使用场景: 验证码发送、通知提醒、营销短信

  • 参考: n8n的SMS节点

10. 对象存储节点S3/OSS

  • 类型: object_storage

  • 分类: 数据

  • 功能: 文件上传、下载、删除、列表

  • 配置:

  ```json

  {

    "provider": "oss",  // oss, s3, cos

    "operation": "upload",

    "bucket": "my-bucket",

    "key": "files/{filename}",

    "file": "{file_data}"

  }

  ```

  • 使用场景: 文件存储、大文件处理、静态资源管理

  • 参考: n8n的S3节点

11. CSV处理节点

  • 类型: csv

  • 分类: 数据

  • 功能: CSV解析、生成、转换

  • 配置:

  ```json

  {

    "operation": "parse",  // parse, generate, convert

    "delimiter": ",",

    "headers": true,

    "encoding": "utf-8"

  }

  ```

  • 使用场景: 数据导入导出、报表生成、批量处理

  • 参考: n8n的CSV节点

12. PDF处理节点

  • 类型: pdf

  • 分类: 数据

  • 功能: PDF解析、生成、合并、拆分

  • 配置:

  ```json

  {

    "operation": "extract_text",  // extract_text, generate, merge, split

    "pages": "1-10",

    "template": "report_template.html"

  }

  ```

  • 使用场景: 文档处理、报告生成、数据提取

  • 参考: Zapier的PDF工具

13. 图像处理节点

  • 类型: image

  • 分类: 数据

  • 功能: 图像缩放、裁剪、格式转换、OCR识别

  • 配置:

  ```json

  {

    "operation": "resize",  // resize, crop, convert, ocr

    "width": 800,

    "height": 600,

    "format": "png"

  }

  ```

  • 使用场景: 图片处理、OCR识别、图像分析

  • 参考: n8n的Image节点

14. 错误处理节点Try-Catch

  • 类型: error_handler

  • 分类: 逻辑

  • 功能: 捕获错误、错误重试、错误通知

  • 配置:

  ```json

  {

    "retry_count": 3,

    "retry_delay": 1000,

    "on_error": "notify",

    "error_handler_workflow": "error_workflow_id"

  }

  ```

  • 使用场景: 错误处理、重试机制、异常通知

  • 参考: Make.com的错误处理

15. 日志节点

  • 类型: log

  • 分类: 系统

  • 功能: 记录日志、调试输出、性能监控

  • 配置:

  ```json

  {

    "level": "info",  // debug, info, warning, error

    "message": "Processing: {data}",

    "include_data": true

  }

  ```

  • 使用场景: 调试、监控、审计日志

  • 参考: n8n的Log节点


🟢 低优先级(高级功能)

16. 子工作流节点Subworkflow

  • 类型: subworkflow

  • 分类: 逻辑

  • 功能: 调用其他工作流、工作流复用

  • 配置:

  ```json

  {

    "workflow_id": "workflow_123",

    "input_mapping": {

      "param1": "{value1}",

      "param2": "{value2}"

    }

  }

  ```

  • 使用场景: 模块化设计、工作流复用、复杂任务拆分

  • 参考: n8n的Subworkflow节点

17. 代码执行节点Code/Function

  • 类型: code

  • 分类: 逻辑

  • 功能: 执行自定义代码Python/JavaScript

  • 配置:

  ```json

  {

    "language": "python",  // python, javascript

    "code": "result = input_data['value'] * 2\nreturn {'output': result}",

    "timeout": 30

  }

  ```

  • 使用场景: 复杂计算、自定义逻辑、快速原型

  • 参考: n8n的Code节点

18. API认证节点OAuth

  • 类型: oauth

  • 分类: 网络

  • 功能: OAuth认证、Token管理、自动刷新

  • 配置:

  ```json

  {

    "provider": "google",  // google, github, custom

    "client_id": "xxx",

    "client_secret": "xxx",

    "scopes": ["read", "write"]

  }

  ```

  • 使用场景: 第三方API集成、安全认证

  • 参考: Zapier的OAuth集成

19. 数据验证节点

  • 类型: validator

  • 分类: 数据

  • 功能: 数据格式验证、类型检查、规则验证

  • 配置:

    
    {
    
      "schema": {
    
        "type": "object",
    
        "properties": {
    
          "email": {"type": "string", "format": "email"},
    
          "age": {"type": "number", "minimum": 0, "maximum": 150}
    
        },
    
        "required": ["email"]
    
      },
    
      "on_error": "reject"  // reject, continue, transform
    
    }
    
    
  • 使用场景: 数据质量保证、API输入验证、数据清洗

  • 参考: JSON Schema验证

20. Excel处理节点

  • 类型: excel

  • 分类: 数据

  • 功能: Excel读取、写入、格式转换、公式计算

  • 配置:

    
    {
    
      "operation": "read",  // read, write, convert, formula
    
      "sheet": "Sheet1",
    
      "range": "A1:C10",
    
      "format": "xlsx"  // xlsx, xls, csv
    
    }
    
    
  • 使用场景: 报表处理、数据分析、批量导入导出

  • 参考: n8n的Spreadsheet节点

21. XML处理节点

  • 类型: xml

  • 分类: 数据

  • 功能: XML解析、生成、转换、XPath查询

  • 配置:

    
    {
    
      "operation": "parse",  // parse, generate, convert, xpath
    
      "xpath": "/root/item[@id='1']",
    
      "encoding": "utf-8"
    
    }
    
    
  • 使用场景: XML数据交换、配置文件处理、数据提取

  • 参考: n8n的XML节点

22. 日期时间处理节点

  • 类型: datetime

  • 分类: 数据

  • 功能: 日期格式化、时区转换、日期计算、解析

  • 配置:

    
    {
    
      "operation": "format",  // format, parse, add, subtract, convert_timezone
    
      "format": "YYYY-MM-DD HH:mm:ss",
    
      "timezone": "Asia/Shanghai",
    
      "value": "{timestamp}"
    
    }
    
    
  • 使用场景: 时间戳转换、时区处理、日期计算

  • 参考: Moment.js / Day.js

23. 数学运算节点

  • 类型: math

  • 分类: 数据

  • 功能: 数学计算、统计、聚合、公式求值

  • 配置:

    
    {
    
      "operation": "calculate",  // calculate, sum, average, max, min, formula
    
      "formula": "{a} + {b} * {c}",
    
      "precision": 2
    
    }
    
    
  • 使用场景: 数值计算、统计分析、数据聚合

  • 参考: n8n的Math节点

24. 变量设置节点

  • 类型: set_variable

  • 分类: 逻辑

  • 功能: 设置工作流变量、变量作用域管理

  • 配置:

    
    {
    
      "variables": {
    
        "user_name": "{input.name}",
    
        "timestamp": "{now()}",
    
        "counter": "{counter + 1}"
    
      },
    
      "scope": "workflow"  // workflow, execution, global
    
    }
    
    
  • 使用场景: 状态管理、计数器、临时变量存储

  • 参考: Make.com的Set Variable节点

25. 变量获取节点

  • 类型: get_variable

  • 分类: 逻辑

  • 功能: 获取工作流变量、变量查询

  • 配置:

    
    {
    
      "variable_name": "user_name",
    
      "default_value": "Unknown",
    
      "scope": "workflow"
    
    }
    
    
  • 使用场景: 变量读取、状态查询、条件判断

  • 参考: Make.com的Get Variable节点

26. 批处理节点

  • 类型: batch

  • 分类: 逻辑

  • 功能: 数据分批处理、批量操作、批处理控制

  • 配置:

    
    {
    
      "batch_size": 100,
    
      "mode": "split",  // split, group, aggregate
    
      "wait_for_completion": true
    
    }
    
    
  • 使用场景: 大数据处理、批量API调用、性能优化

  • 参考: n8n的Split In Batches节点

27. 去重节点

  • 类型: deduplicate

  • 分类: 数据

  • 功能: 数据去重、唯一性检查、重复项过滤

  • 配置:

    
    {
    
      "key": "id",  // 去重字段
    
      "method": "first",  // first, last, all
    
      "case_sensitive": true
    
    }
    
    
  • 使用场景: 数据清洗、去重处理、唯一性保证

  • 参考: n8n的Remove Duplicates节点

28. 排序节点

  • 类型: sort

  • 分类: 数据

  • 功能: 数据排序、多字段排序、自定义排序规则

  • 配置:

    
    {
    
      "fields": [
    
        {"field": "priority", "order": "desc"},
    
        {"field": "created_at", "order": "asc"}
    
      ],
    
      "type": "number"  // number, string, date
    
    }
    
    
  • 使用场景: 数据排序、优先级处理、列表整理

  • 参考: n8n的Sort节点

29. 过滤节点

  • 类型: filter

  • 分类: 数据

  • 功能: 数据过滤、条件筛选、数据过滤规则

  • 配置:

    
    {
    
      "conditions": [
    
        {"field": "status", "operator": "equals", "value": "active"},
    
        {"field": "age", "operator": "greater_than", "value": 18}
    
      ],
    
      "logic": "AND"  // AND, OR
    
    }
    
    
  • 使用场景: 数据筛选、条件过滤、数据清洗

  • 参考: n8n的Filter节点

30. 聚合节点

  • 类型: aggregate

  • 分类: 数据

  • 功能: 数据聚合、分组统计、汇总计算

  • 配置:

    
    {
    
      "group_by": ["category", "status"],
    
      "aggregations": {
    
        "total": "sum(amount)",
    
        "count": "count()",
    
        "average": "avg(price)"
    
      }
    
    }
    
    
  • 使用场景: 数据统计、报表生成、数据分析

  • 参考: SQL的GROUP BY


📋 实施建议

开发优先级

  1. 第一阶段(核心功能): Switch、Merge、Wait、JSON处理、文本处理、缓存
  2. 第二阶段(常用功能): 向量数据库、日志、错误处理、CSV处理、对象存储
  3. 第三阶段(扩展功能): 通信节点Slack/钉钉/企业微信/短信、PDF/图像处理、Excel处理
  4. 第四阶段(高级功能): 子工作流、代码执行、OAuth、数据验证、批处理

技术实现要点

  1. 节点注册机制: 统一的节点注册和发现机制
  2. 配置验证: 每个节点需要配置Schema验证
  3. 错误处理: 统一的错误处理和重试机制
  4. 性能优化: 异步执行、批量处理、缓存机制
  5. 可扩展性: 插件化架构,支持自定义节点

测试建议

  1. 单元测试: 每个节点的核心功能
  2. 集成测试: 节点之间的数据流
  3. 性能测试: 大数据量、并发场景
  4. 用户体验测试: UI交互、错误提示、文档

📚 参考资源


总结

本文档列出了30个建议新增的节点类型,分为三个优先级:

  • 高优先级6个: 核心功能增强,建议优先实现
  • 中优先级9个: 功能扩展,提升系统能力
  • 低优先级15个: 高级功能,满足复杂场景需求

建议根据实际业务需求和开发资源,按优先级逐步实现这些节点类型,持续完善工作流编辑器的功能。