跳转到主内容
版本发布

42md 知识编排(5):一句话,让 AI 生成编排

记字段、对缩进,不是每个人都乐意——你可以不学。打开 42md 网页端「我的编排」,一句话描述你想做什么,AI 就生成一份编排草稿、自动填进表单,你看一眼、改改名、保存即可。这篇把 AI 生成的那份 YAML 一字一句拆开讲清楚,让你不光会用,还看得懂它写了什么。再用一篇真实 arxiv 论文走一遍:网页生成、命令行按名跑完。

8 分钟
产品发布知识编排recipeAI 生成webapp

前两篇教你手写编排。说实话,记字段、对缩进,不是每个人都乐意——好在你可以不学。

一句话,AI 写给你

打开 cloud.42md.cc 的「我的编排」,点「新建编排」,顶部就是「AI 帮你生成编排」。用大白话说你想要什么:

「AI 帮你生成编排」输入框,一句话描述需求,点绿色按钮生成

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

AI 生成的 arxiv-pdf-summary 编排:上方是效果预览与名称,下方是完整 YAML,按保存收进「我的编排」

想自己动手的人也没被挡在外面:生成的内容就在编辑框里,哪一行不顺眼随手改;不想用 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 助手替你办全套。

知识编排系列


活水 AI 实验室(42ailab) — 探索智能边界的 AI 创新实验室,以认知科学为基石,推动 AI 与人类智能的深度融合,真正理解并增强智能 —— 碳基的,也是硅基的。

活水MD(42md) — 活水 AI 实验室出品的高性能 Markdown 处理工具。AI 时代的 Markdown,一站式处理:42+ 种格式一行转 Markdown,还支持翻译、摘要、导出等十余种知识工具,并支持知识编译、流程编排、本地引擎与 Agent 调用。