快速上手：你的第一个工作流

适用版本：ChengOS v0.1.0+ ｜ 最后核对：2026-08-12 ｜ 来源：chengflow-ui/src/features/editor、deploy/workflow-templates/、crates/cheng-nodes/src/nodes/builtin

本文带你从空白画布搭建并运行一个工作流。大约需要十分钟，产出的东西虽小但确实有用：一个接收文本、交给大语言模型、然后把结果显示出来的工作流。你需要一套运行中的安装——如果还没有，参见安装 ChengOS。

术语

四个词承载了大部分含义，而且它们与你在界面上看到的东西一一对应：

• 工作流是一张有向图。它是你保存、做版本控制、运行和发布的单位。
• 节点是其中一步。每个节点声明带类型的输入和输出，它的配置表单由后端发布的 JSON Schema 生成——这正是为什么无需任何人手写表单，每个节点的属性面板看起来都是一致的。
• 连线把一个节点的输出端口连到另一个节点的输入端口。连线承载数据，也定义了执行顺序。
• 执行是工作流的一次运行。它有自己的记录、自己的状态机（等待中 → 运行中 → 完成 / 失败 / 已取消），以及事后可查的轨迹。

节点以 分类/名称 的形式标识——io/input_text、ai/llm、utils/preview。你会在整个文档中看到这些标识符，它们与 API 使用的标识符完全相同。

第 1 步——打开编辑器

访问 http://<你的主机>:8080 并登录。全新安装中还没有任何用户，因此你会被引导至首次初始化流程；你在那里创建的账号即为管理员。

在编辑器中新建一个工作流。你会看到一张空白画布：左侧是节点面板，中间是画布，右侧是属性面板。

第 2 步——添加输入节点

在节点面板中找到 io/input_text，把它拖到画布上。这个节点是工作流接收文本的入口。

点击选中它，右侧属性面板会显示它的配置。给字段起一个之后能认出来的名字——比如 user_input——也可以填一个默认值，方便测试。

第 3 步——添加模型节点

把 ai/llm 拖到画布上，放在输入节点的右侧。

选中它，在属性面板中配置模型：选择供应商和模型，并写好提示词。要引用上一个节点传来的文本，请使用变量引用而不是直接写死内容——正是这一步把两个步骤串联起来。例如：

用一句话总结以下内容：

{{user_input}}

如果还没有配置任何供应商，请先到设置中添加一个。凭证保存在加密凭证库中，绝不会内联在节点里——模型节点持有的是一个引用，真正的密钥在请求时于服务端注入。这是刻意的设计：即使在智能体自主决定调用什么的时候，大语言模型也永远看不到你的 API 密钥。

第 4 步——连接节点

从 io/input_text 右边缘的输出端口拖动到 ai/llm 左边缘的输入端口，两者之间会出现一条连线。

连接是做类型检查的。如果某个端口拒绝连接，说明两个端口承载的类型不兼容——编辑器是在阻止一次注定中途失败的运行，而不是让你到执行时才发现类型对不上。

第 5 步——查看输出

把 utils/preview 拖到画布上，并把 ai/llm 的输出连过去。预览节点的唯一作用就是在开发过程中显示某个值，因此它是理解一个节点究竟输出了什么的最快方式。

现在你的图是：io/input_text → ai/llm → utils/preview。

第 6 步——保存并运行

保存工作流——点击工具栏按钮，或按 Ctrl+S。首次保存会提示输入名称；工作流持久化在 PostgreSQL 中，而不是浏览器里。

然后运行它。执行视图通过 WebSocket 实时推送事件，因此你会看到节点按顺序依次亮起，而不是干等最终结果：每个节点先显示运行中，然后是完成或失败，预览节点在收到输入后填充内容。

如果某个节点失败了，点击它。执行详情会显示该节点的具体错误，以及它实际收到的输入，这通常足以定位问题。首次运行最常见的失败是模型配置——缺少凭证，或者供应商无法识别的模型名。

接下来可以探索什么

从模板出发。 每个新工作区在初始化时都会安装一批内置工作流模板，读懂一个能跑的工作流，比自己搭一个简单示例学到的更多：

再往后： 把工作流变成对话界面，给智能体配备工具让它自己决定调用什么，或者把工作流发布为应用（带独立页面）。

下一步

• 发布为应用——给它一个别人可以访问的 URL。
• REST API 总览——用代码运行同一个工作流。
• 环境变量参考——启用智能体记忆与向量检索。