42md 知识编排(5):一句话,让 AI 生成编排
记字段、对缩进,不是每个人都乐意——你可以不学。打开 42md 网页端「我的编排」,一句话描述你想做什么,AI 就生成一份编排草稿、自动填进表单,你看一眼、改改名、保存即可。这篇把 AI 生成的那份 YAML 一字一句拆开讲清楚,让你不光会用,还看得懂它写了什么。再用一篇真实 arxiv 论文走一遍:网页生成、命令行按名跑完。
前两篇教你手写编排。说实话,记字段、对缩进,不是每个人都乐意——好在你可以不学。
一句话,AI 写给你
打开 cloud.42md.cc 的「我的编排」,点「新建编排」,顶部就是「AI 帮你生成编排」。用大白话说你想要什么:

点「AI 生成编排」,它就写出一份草稿:名字、说明、每一步的动作都填好,自动进表单。你看一眼对不对,改改名,保存。

想自己动手的人也没被挡在外面:生成的内容就在编辑框里,哪一行不顺眼随手改;不想用 AI、从头手写也行。AI 是个帮手,不抢你的方向盘。
它生成的那份 YAML,逐行看懂
很多人到这一步会犯怵:表单里那一坨缩进的文字,看着像代码,其实读懂只要两分钟。就用上面这份 arxiv-pdf-summary 当例子——它干的事是「读一篇 arxiv PDF 论文,转成 Markdown,再提炼一份要点摘要」:
name: arxiv-pdf-summary
description: 读取 ArXiv PDF 论文,转为 Markdown 并提取摘要
steps:
- id: extract
run: acquire
with: ["{{ input }}"]
produces: md
- id: summarize
run: tools.summarize
with: ["{{ steps.extract.output }}"]
billed: true
output: "{{ steps.summarize.output }}"
一字一句对着看:
| 这一行 | 在说什么 |
|---|---|
name | 这条编排的名字,以后就按它运行 |
description | 一句话说明它干什么,列表里会显示给你看 |
steps | 步骤清单,从上往下一步接一步跑 |
id: extract | 给第一步起个代号「extract」,后面要引用它的产物 |
run: acquire | 这步调「主获取」:把 PDF / 网页 / 录音转成 Markdown |
with: ["{{ input }}"] | 传给它的料——你运行时给的那份文件 |
produces: md | 这步的主产物是一份 .md,往下就传它 |
id: summarize | 第二步,代号「summarize」 |
run: tools.summarize | 这步调「AI 摘要」 |
with: ["{{ steps.extract.output }}"] | 喂给摘要的,是上一步 extract 产出的那份 Markdown |
billed: true | 这步要花 AI 额度,标一下,跑前会先提示你 |
output | 最后把哪一步的产物交到你手上——这里交摘要 |
只剩两个像「暗号」的符号,记住就通了:
{{ input }}—— 你运行时给的那份文件。写命令时跟在编排名后面的输入,就填进这里。{{ steps.extract.output }}—— 「extract 这一步产出的文件」。你不用关心它叫什么名、存哪个文件夹,编排替你接好,直接喂给下一步。
看懂这两个暗号,整条编排就读通了:第一步把你给的 PDF 转成 Markdown,第二步拿这份 Markdown 提炼摘要,最后把摘要交给你。AI 生成的、你手写的,都是这套写法,没有第二套。
用一篇真论文走一遍
光看不够,拿一篇真的 arxiv 论文跑跑看。保存好上面那条 arxiv-pdf-summary 后,到命令行直接按名字运行——比如经典的 Transformer 论文:
42md recipe run arxiv-pdf-summary https://arxiv.org/pdf/1706.03762
一条命令,它会:抓下这篇 PDF、转成 Markdown、再提炼一份要点摘要落盘。含 AI 步骤,开跑前会把计划列给你看一次——分几步、哪步花钱、预估多少,按 Y 才真跑。
不记得名字?42md recipe list 把内置的、你自己写的、网页上存的,全列在一起;网页生成的会标着来源,直接挑一条 run 就行。
生成在网页,运行在命令行
这里有个特意的安排,值得说一句:
- 生成在网页——AI 替你把编排写好、存进「我的编排」
- 运行在命令行——
42md recipe run <名> <输入>
为什么不在网页里直接跑?因为编排处理的是你电脑里的文件,放命令行跑更直接:每一步在做什么、产物落哪、花多少,你都看得清。网页负责把流程设计出来,命令行负责在你机器上把它跑完。
网页上存的编排,命令行按名字就能取用,不必记一长串 ID(早先分享用的 @编排id 写法仍然认)。
花钱这事,说在前头
生成这一步会耗一点点 AI 额度(你那句话很短,花得很少)。42md 的规矩照旧:
- 只有你点「生成」才会调 AI,不在后台偷偷跑
- 动手前弹窗显示预估消耗 + 当前余额,你可以取消
- 按确认才走
生成出来的编排,保存和按名运行本身不再花钱——真正计费的是它里头那些 AI 步骤(翻译、摘要…),和你手写的编排一个样。
还能更省心
让 AI 写编排,已经省了学语法的功夫。再往前一步,是把「挑流程、跑命令」也交出去——下一篇,让 AI 助手替你办全套。
知识编排系列
- 第(1)篇:多步流程,一条命令跑完
- 第(2)篇:七个内置编排,开箱即用
- 第(3)篇:写一条自己的编排
- 第(4)篇:让编排更灵活、更可靠
- 第(5)篇:一句话,让 AI 生成编排(本篇)
- 第(6)篇:把编排交给 AI 助手
活水 AI 实验室(42ailab) — 探索智能边界的 AI 创新实验室,以认知科学为基石,推动 AI 与人类智能的深度融合,真正理解并增强智能 —— 碳基的,也是硅基的。
活水MD(42md) — 活水 AI 实验室出品的高性能 Markdown 处理工具。AI 时代的 Markdown,一站式处理:42+ 种格式一行转 Markdown,还支持翻译、摘要、导出等十余种知识工具,并支持知识编译、流程编排、本地引擎与 Agent 调用。