用 Wordware 编辑器搭建并运行第一个 AI 流程

Wordware 的核心思路很简单：一切围绕提示词展开。提示词可以是文本、图片、音频，也可以是一段结构复杂的输入；而 Wordware 把这些提示词连同它们周围的逻辑一起放进一个编辑器里，让你能构建、测试、协作并部署 AI 应用。这篇教程面向第一次接触 Wordware 的读者，目标是把一个可运行的流程从零搭起来，并知道怎么执行、怎么分享、怎么发布成独立应用。如果你更想先看看站内有没有配套工具，可以访问 Wordware 条目了解概况，再回到本文按步骤操作。

需要先说明一点：Wordware 里的「流程」（flow）既是你的文档，也是你的程序。你在编辑器里写下的内容，本身就是可执行的逻辑，不需要再另写一份代码去对应它。理解这一点，后面的操作会顺很多。

准备工作

开始之前，先把下面几件事确认好。

• 账号与入口：Wordware 通过浏览器访问，登录后进入的是编辑器工作区。免费账号即可开始搭建和运行流程。
• 账号类型会影响可见性：默认情况下，免费账号上的提示词是公开的。付费用户可以在需要时把提示词设为私有。如果你打算处理不适合公开的内容，先确认自己的账号类型，再决定是否在公开状态下编写。
• 组织与协作：你可以把其他用户加入自己的组织，一起编辑同一批提示词。如果只是自己试用，这一步可以跳过。
• 不需要预先准备代码：本文的最小示例只用文本提示词和一个生成节点，不涉及自定义代码。后续想扩展时，Wordware 支持在流程中加入自定义 JavaScript 或 Python 代码，但那不是入门必需。

另外建议先想清楚一件事：你要做的项目是一个流程就能装下，还是需要拆成多个流程。小项目放在单个流程里管理最省事；项目变大之后，拆成多个流程、让流程之间互相调用，会更容易维护。这个判断在动手前做，比写到一半再重构轻松得多。

操作步骤

第一步：认识编辑器与流程面板

进入编辑器后，正中间最显眼的是流程面板（flow pane），当前正在编辑的流程就显示在这里。流程是 Wordware 用来拆分项目的基本单位：一个流程对应一份可运行的逻辑，你可以把它当成一个文件来管理。

编辑器承担四件事：构建、测试、协作、部署。你在里面写提示词，也在里面直接运行它们，还可以把别人拉进来一起改，最后把结果发布出去。这四件事共用同一个界面，不需要在多个工具之间来回切换。

第二步：新建一个流程

点击导航栏最左侧的文件按钮，右侧会展开一个新的侧边面板，里面出现三个按钮。你所有新建的流程都放在这里，也是在这里管理已有流程。

• New flow：新建一个空白流程。本文的示例从这里开始。
• Add folder：新建文件夹，用来给流程分组。流程数量变多之后，按项目或用途分文件夹会明显好找。
• Templates：打开预置的 WordApp 模板。想快速看到成品长什么样，可以从模板入手，再改成自己的内容。

对已有流程，你可以复制、重命名和删除。复制适合在现有流程基础上做变体，重命名用于保持命名清晰，删除则用来清理不再需要的试验品。

第三步：用斜杠命令插入节点

流程由节点组成。要添加新节点，在编辑器里输入 /，然后继续输入你想添加的节点名称，从候选里选中即可。这是添加非文本节点的统一入口。

如果只是想写一段普通文本提示词，不需要任何命令，直接在编辑器里开始打字就行。你输入的任何内容都是提示词的一部分。

Wordware 提供的节点类型覆盖了常见的流程控制与生成需求，包括：

• 生成类节点（Generation、Structured Generation）
• 流程控制类节点（If-Else、Loop）
• 交互类节点（Ask a Human、Input）
• 代码执行节点（Code execution）
• 辅助类节点（Mention、Triggers、Actions、Comment、Tool Formatting）

入门阶段不必全部用上。先用文本加一个生成节点把流程跑通，再按需要逐个引入其他节点，是更稳妥的路径。

第四步：按「所见即所得」组织内容

Wordware 编辑器遵循「所见即所得」（What You See is What You Get）原则：在流程中，位于某个生成节点上方的任何内容，该次生成所用的 AI 都能看到并与之交互。换句话说，你在编辑器里看到的版面顺序，就是 AI 实际接收到的上下文顺序。

这条规则有两个直接后果，值得在搭建时记住：

• 位置就是语义：想让 AI 参考某段说明、某个示例或某份数据，就把它放在生成节点之前。放在后面的内容不会被这次生成读到。
• 内容量几乎不受限：你可以放入大量、多种形式的内容，从一句话到一份导出的数据库都可以，只要它在生成节点上方，就会被纳入上下文。

「所见即所得」有少量例外，最需要注意的是注释。注释对 AI 不可见；如果你之后把流程部署成应用，注释同样不会出现在部署后的应用里。因此注释适合写给人看的说明、待办和备注，不适合承载需要被模型读取的指令。

第五步：理解执行顺序

节点按它们在流程中出现的顺序执行：从上到下，从左到右。这个顺序是确定的，不依赖你点击运行的时机。

有些节点可以包含其他节点，例如 If-Else 和 Loop，它们内部可以有多条分支内容。这类嵌套结构同样遵循从上到下的顺序，只是行为上多了两点：不满足条件的分支会被跳过，你设定要重复的分支会被重复执行。搭建带条件判断或循环的流程时，把分支内部的节点顺序理顺，比记住节点名称更重要。

流程还可以调用其他流程。当项目被拆成多个流程时，这条能力让主流程能够复用子流程的逻辑，而不必把所有内容堆在一个文件里。

第六步：运行流程

流程写好后，点击右上角的 Run 按钮执行，或者用键盘快捷键 CTRL + R（Mac 上是 CMD + R）。

运行过程中，你可以实时观察你写的 WordApp 一步步执行：流程会就你定义过的输入项向你提问，并在输出生成时把结果显示出来。AI 的响应是实时可见的，你甚至可以在它生成内容的过程中与它交互。

这一步也是调试的主要手段。改一段提示词、跑一次、看输出，再改，循环往复。因为流程本身就是程序，你不需要额外的构建或编译环节。

第七步：分享与协作

导航栏右侧是运行按钮和分享控制。Wordware 的协作能力体现在几个层次：

• 组织内协作：把其他用户加入你的组织，大家在同一批提示词上共同工作。
• 公开分享：把提示词公开分享出去，与任何地方的人协作。
• 嵌入：把提示词嵌入你自己的网站或应用里。
• 私有化：付费用户点击导航栏右侧的锁形图标，即可把提示词设为私有，此后只有你和被加入组织的人能看到。

注意免费账号默认公开这一点。如果你在免费账号上写了包含敏感信息的内容，在分享之前先确认可见性状态。

第八步：部署为独立 WordApp

要把流程变成一个可以发给任何人、在任何地方打开的独立应用，点击 🚀 Deploy 按钮，填写要求的字段即可完成发布。这是把项目作为独立应用交付的主要方式，也是把成果公开给外部使用者的路径。

部署前值得回头检查一遍注释：注释不会进入部署后的应用，如果某些说明你希望最终用户看到，就不能只写在注释里。

一个完整示例

下面用一个最小可运行的流程，把前面的步骤串起来。这个示例只做一件事：接收一段主题描述，生成一段介绍文字。

1. 新建流程。点击导航栏最左侧的文件按钮，在展开的面板里点 New flow，得到一个空白流程。

2. 写上下文。在编辑器顶部直接输入一段说明，作为 AI 的背景信息。例如：

你是一名技术文档编辑。下面我会给出一个主题，请用简体中文写一段 150 字左右的介绍，
面向第一次接触该主题的读者，不使用夸张的营销措辞。

这段文字位于生成节点上方，因此会被生成时的 AI 读到。这就是「所见即所得」在起作用。

3. 插入生成节点。在编辑器里输入 /，继续输入生成节点的名称，从候选中选择它。节点会插入到当前流程中。

4. 定义输入。在流程中定义你希望运行时向用户索取的输入项，例如一个名为「主题」的文本输入。运行流程时，Wordware 会就这个输入项向你提问。

5. 在生成节点里引用输入。在生成节点的提示词中引用上一步定义的输入项，让模型知道要针对哪个主题写作。引用方式按编辑器提供的输入引用机制填写。

6. 加一条注释。在流程里插入一个 Comment 节点，写上「本流程用于生成主题介绍，输出长度控制在 150 字」。这条注释对 AI 不可见，也不会出现在部署后的应用里，纯粹是给协作者看的。

7. 运行。按 CTRL + R（Mac 上 CMD + R），或点击右上角 Run。流程会先向你询问「主题」，填入内容后继续执行，生成结果实时显示出来。

8. 调整。如果输出太长或语气不对，回到第 2 步的说明文字里修改约束，再运行一次。整个循环不需要离开编辑器。

9. 发布。满意之后点击 🚀 Deploy，填写要求的字段，把这个流程发布成一个独立 WordApp，把链接发给需要使用它的人。

这个示例虽然简单，但已经覆盖了完整链路：新建流程、写上下文、插入节点、定义输入、运行、迭代、部署。后续要加条件分支或循环，只需在流程中插入 If-Else 或 Loop 节点，把相应内容放进分支里，执行顺序规则不变。

注意事项

• 注释对 AI 不可见：这是「所见即所得」最主要的例外。不要把需要模型读取的指令写进注释。
• 注释不会进入部署产物：部署成 WordApp 之后，注释同样不出现。面向最终用户的说明要写在注释之外。
• 免费账号默认公开：免费账号上的提示词默认是公开的。需要私有时，付费用户可点击导航栏右侧的锁形图标切换为私有。
• 上下文只向上生效：生成节点只能看到位于它上方的内容。把参考资料放错位置，模型就读不到。
• 嵌套节点按分支执行：If-Else 和 Loop 内部的多条分支，不满足条件的会被跳过，设定重复的会被重复执行。调试时留意实际走了哪条分支。
• 快捷键因平台而异：Windows 用 CTRL + R，Mac 用 CMD + R。
• 项目规模决定流程拆分：小项目单流程即可，大项目拆成多个流程并让流程互相调用更易维护。这个决定越早做越好。
• 功能与配额以官网当前信息为准：账号类型对应的可见性策略、部署能力等可能随时间调整，动手前请以官网当前说明为准。

把上面这套流程走通一遍之后，下一步通常是引入更多节点类型：用 If-Else 做分支、用 Loop 批量处理、用 Code execution 插入自定义 JavaScript 或 Python 逻辑。每加一种节点，都回到「从上到下、从左到右」的执行顺序和「上方内容对生成可见」这两条规则上检查一遍，大多数搭建问题都能自己定位。