文档模板库从模板实例化

推荐路径 · 5 分钟

从模板实例化一条工作流

90% 的用户第一条工作流都是从模板克隆出来的。这一篇讲清楚"克隆 → 按业务定制 → 上线"的完整流程。

在 Braidrun 里，"从模板实例化" 是最主流的工作流生成方式：90% 以上的用户第一条工作流都不是从白板写的，而是从模板克隆一条，再按自己的业务做调整。这一篇把这个流程拆到每一个按钮。

三种生成工作流的方式对比

从模板实例化（本页） — ⭐ 推荐。5 分钟就能跑起来，专家已经帮你把坑都填了。
AI 助手自然语言生成 — 适合没找到合适模板时，让 AI 按你的描述给出初稿，然后你精修。
从零手写 — 只在上述两种都不适用时选；对平台非常熟悉后再考虑。

完整流程概览

浏览模板库，按分类 / 标签 / 搜索挑一个
读模板详情卡片，确认前提条件与预估成本
点"使用此模板"，克隆到你的工作区
在编辑器里按变量说明改业务参数
补齐凭据中心里的 key
先 dry-run 校验结构、再真跑一次
按需绑定调度 / Webhook 触发器

第 1 步 · 浏览模板库

1.1 打开入口

左侧主导航「模板库」。页面结构：

顶部筛选栏 —— 10 个行业大类 + 标签 + 关键词搜索
模板卡片网格 —— 显示名称、描述、标签、预估时长、复杂度
右上角"我的收藏" —— 长期用的模板可以收藏，下次直接进入

1.2 常见的选择策略

需求很具体 — 直接搜索关键词。比如你要做"TestFlight 证书到期提醒"，搜 certificate expiry 就能立刻锁定。
需求偏宽泛 — 按行业先收敛。挑一个你最熟悉的行业大类，翻两三页大致了解我们有哪些类型的流程。
想"看看行业里别人怎么做" — 按"复杂度"倒排，挑最复杂的几个看 —— 它们通常代表了端到端的成熟实践。

第 2 步 · 阅读模板详情

点某个模板卡片进入详情页，重点看四块：

2.1 「描述」段

两三段文字，告诉你：它解决什么问题、最适合什么场景、不适合什么场景、使用前需要哪些准备。

2.2 「所需凭据」列表

一清二楚列出跑这条工作流需要哪些凭据，例如：

openai_api_key — OpenAI API Key（必需）
slack_webhook_url — Slack Incoming Webhook URL（用于投递，可选）
apple_appstoreconnect — App Store Connect JWT（仅 Apple 相关模板需要）

"必需"的凭据缺一个，工作流跑到对应 step 时会失败。"可选"的缺失时，相关 step 会被 condition 跳过。

2.3 「预估耗时与成本」

一次完整执行：

耗时 —— 2 分钟 / 15 分钟 / 1 小时，取决于工作流复杂度与外部依赖响应速度
Token 用量 —— 平均 xxx input / xxx output
$ 预估 —— 按平台默认 preset 与 OpenAI 单价算的大概值

2.4 「示例输入与示例输出」

一份具体的输入样例（你可以直接照抄跑一次）+ 对应产生的输出样例（让你心里有底 "大概能得到什么"）。

第 3 步 · 克隆到工作区

右上角点 「使用此模板」。
弹窗里给你的副本起个名字（默认是模板名 + 时间戳，你可以改成更有业务意义的）。
选择目标团队（如果你在多个团队里）。这决定了这条工作流能被谁看到 / 编辑。
点确认。平台为你生成一份 独立副本，你的修改不会回传模板，模板后续更新也不会自动改动你的副本。

模板版本 vs 你的副本版本

克隆那一刻会记录"克隆自哪个模板的哪个版本"。之后模板发了新版本，你可以在编辑器里先预览改动、再一键升级 —— 见本页下方「模板升级」一节。

第 4 步 · 定制业务参数

4.1 variables 段是你唯一需要认真看的地方

编辑器打开后先翻 YAML 到顶部的 variables 段。所有"这条工作流要按你业务情况调的东西"都在这里，已经注释好了：

yaml

variables:
  target_date:
    type: string
    default: yesterday    # ← 改成你要跑哪一天的数据
    description: |
      支持 yesterday / last_7_days / last_30_days /
      或具体日期 2026-04-17

  top_n:
    type: number
    default: 10           # ← 要拉多少条新闻
    description: 抓取的新闻数量上限

  target_channel:
    type: string
    default: "#my_daily_digest"  # ← 改成你的 Slack 频道名或保留默认 webhook 目标
    description: Slack 目标频道或 Incoming Webhook 默认目标

4.2 按注释改默认值

默认值只是"示例"，要换成你业务里真实的值。改 variables 不会破坏结构，放心改。

4.3 不动 steps 是好习惯

第一次跑模板不建议动 steps 段的结构 —— 先用默认流程跑一次，看数据流，再决定是否改。

第 5 步 · 补齐凭据中心

打开凭据中心。
把模板详情页列出的每个"必需"凭据都创建一条对应的凭据，name 必须和 YAML 里引用的完全一致。
"可选"凭据可以暂时不建 —— 相关 step 会被跳过。

常见坑：凭据名字拼写

YAML 里引用的名字和凭据中心的 name 必须一字不差（区分大小写、下划线 / 短横线敏感）。一半以上的"credential_not_found"错误都是拼写问题。

第 6 步 · 先 dry-run，再真跑

6.1 dry-run 的意义

dry-run 零成本地走完一遍 DAG，跳过所有 LLM 与副作用。它帮你在花钱之前确认：

variables 是不是都填对了
变量在 step 之间流得通
condition / classifier 的分支选对了
依赖的凭据名能解析到

6.2 真跑

dry-run 通过后，取消勾选 dry-run 再次点"执行"。这次会真调 LLM、真发副作用。页面右侧实时事件流让你看每一步的进展。

6.3 跑完后看什么

「查看执行详情」—— 甘特图 + 每步输入 / 输出
「产物栏」—— 生成的 Markdown / Excel / 图像可直接下载
「tokens / cost」—— 这一次总共花了多少

第 7 步 · 按需绑触发器

手动跑通后，工作流就具备了"上线"条件。常见的三种触发方式：

定时调度 — 每天 / 每周 / 每月一次，或按 interval 重复
Webhook 触发 — 外部系统 POST 过来触发，用 API Key 认证（也兼容 HMAC 签名）
API 触发 —— 你的内部系统用 API Key 调 REST API 启动执行

模板升级：跟进模板的新版本

克隆出来的副本不会被模板更新自动改动。当原模板发了新版本、你又想跟进时，用「从模板升级」流程：先看一份预览，确认后一键升级。

入口在哪

两个地方都能进：编辑器工具栏菜单里的「从模板升级」，或工作流设置面板变量区上方的「检查升级」提示。打开的对话框会显示当前版本与目标版本。

升级前先看预览

预览把变量差异分成三类，逐个列出：

保留 — 你已经改过、新模板里仍存在的变量，升级后保留你的值
新增 — 新模板新加的变量，填入模板默认值，升级后按需再调
删除 — 新模板里已不存在的变量，升级后会被丢弃 —— 确认前逐条检查这个列表

升级时发生什么

先自动保存当前工作流为一个版本快照，后悔了可以在「版本」菜单里回退
步骤 DAG、Agent prompt、代码、超时等结构性配置按新模板覆盖
你自己选的模型会保留：同名 Agent 的模型选择、对应的模型凭据引用不被新模板覆盖
工作流名称、标签、并发这类属于你的设置不动

这几种情况会被阻止升级

还有未结束的执行 —— 等它们完成或取消后再升级
已经是最新模板版本 —— 无事可做
源模板已被移除 —— 你的副本不受影响，继续照常运行即可

老工作流没记录来源模板？

早期克隆的工作流可能没登记来源，此时编辑器菜单里的同一项会显示为「关联模板…」。补登它来自哪个模板（可以顺便标记当前对应哪个版本），之后就能正常走升级流程。

进阶：让 AI 助手按你的描述改

克隆之后，如果业务需求和模板不完全一致，可以让 AI 助手帮你修：

右下角 FAB 打开 AI 助手抽屉
描述你的需求 —— 例如 "把 step.deliver 从 Telegram 换成飞书"
助手会给出一份 diff 预览，你 accept 或 reject
满意后点"应用"—— 10 级撤销栈保护你随时回滚

何时该改用 AI 助手或手写？

场景	建议方式	理由
业务场景常规、有对应模板	从模板实例化	5 分钟跑起来，专家设计
场景有模板但需求大改	模板 + AI 助手	结构照抄，细节让 AI 调
场景独特、没有合适模板	AI 助手自然语言生成	描述需求 → 拿到初稿 → 精修
你已经完全熟悉平台	手写 YAML	精确控制每个字段

下一步

分类详解与典型模板 — 每个行业大类精选代表，告诉你每一类能做什么
可视化编辑器 — 克隆出来之后到底点哪些按钮
AI 助手 — 用自然语言改 / 生成工作流