跳转到主要内容
模块库

沉淀通用能力跨流程复用

模块不是另一套模板,而是可被多条流程引用的子流程。每个模块都有版本号和明确的输入输出契约,升级、复用和排查都有边界。

492可用模块
SEMVER版本化升级
I/O类型化契约
产品界面

在哪里管理所有模块

模块库陈列你从「市场」下载的所有模块。模块带有显式 inputs / outputs 契约,父工作流可在 sub_workflow 步骤里按名称引用。

Braidrun 模块库截图
模块库:装进来的模块列出输入输出契约和被哪些工作流引用,改一处,引用它的流程一起生效
模块契约

模块契约

跨父子传数据的唯一方式是 inputs / outputs(显式契约)。

INPUTS / OUTPUTS

模块契约

调用方必须传入的参数(带名称、类型、必填、默认值、描述)

SEMVER

模块升级与版本兼容

编辑和验证时检查必填输入、输出映射与引用;

SUB_WORKFLOW

父工作流如何调用模块

填写模块工作流名称,也可以在编辑器中选择具体工作流。

内置模块库

492 个模块:数据拉取、报表生成、消息送达这些常用环节都有现成的

utility-*

通用工具(utility-* 前缀,约 140 个)

模块库自带 492 个内置模块(平台登录、时间窗计算、ASA 报表拉取、Excel 报表、Slack 投递等),详见

ads-*

广告与归因

这批模块来自真实的投放运营场景,覆盖主要广告平台的报表拉取与归因数据。按用途列出主要几类:

business-*

业务场景(business-* 前缀,约 150 个)

数量最多的一批:围绕某个外部系统给出可直接上线的业务动作,例如异常巡检、运营简报、数据同步。命名规律是「business-module-<服务>-<用途>」,找模块时按服务名搜最快。

integration-*

连接健康检查(integration-* 前缀,约 70 个)

与业务服务一一对应的探活模块,用来确认某条连接当前是否可用。适合放在长流程开头做前置检查,或单独挂一条定时任务巡检所有连接。

复用收益

改一个模块,多条流程同步获得新能力

父流程只依赖模块公开的输入输出契约。模块内部可以持续升级,调用方按版本查看差异、验证兼容性,再决定何时采用。

  • 一份能力,多处调用日报、告警和分析流程可以共享同一个模块。
  • 升级有版本边界调用方可以查看差异并选择升级时机。
  • 引用关系可追踪知道哪些流程正在使用,改动前先评估影响。
复用方式

父工作流如何调用模块

  1. 父工作流如何调用模块 填写模块工作流名称,也可以在编辑器中选择具体工作流。
  2. 模块契约 调用方必须传入的参数(带名称、类型、必填、默认值、描述)
  3. 模块升级与版本兼容 编辑和验证时检查必填输入、输出映射与引用;
  4. 自定义模块 先把要复用的逻辑整理成一条边界清晰的工作流并保存。
先从模板库选起点,再用模块库补能力
模板库和模块库是两个后台入口:一个管理下载的完整流程,一个管理下载的可复用模块。