Coze 工作流基础创建与核心节点实战指南

前言

Coze 智能体开发平台凭借可视化工作流编排能力，成为低门槛搭建智能自动化流程的核心工具，尤其适合嵌入式、机器人方向开发者快速落地复杂功能。本文聚焦工作流基础搭建与核心节点实操，从创建规范、节点配置到实战案例逐一拆解，帮助开发者快速掌握流程编排逻辑。

创建工作流

创建工作流是实现复杂功能逻辑自动化的基础步骤，需遵循操作路径、配置规范和初始界面的流程完成框架搭建。

操作路径：从登录到进入创建界面

配置规范：名称与描述的设置规则

工作流名称要求

• 命名约束：仅允许使用字母、数字和下划线，且必须以字母开头，长度建议控制在 64 字符以内。
• 命名建议：采用直观、功能相关的名称，便于后续管理和识别。

例如：

• 翻译类：super_translator
• 内容生成类：xiaohongshu_health_content
• 数据采集类：url_to_feishu_bitable_collect

工作流描述

• 内容要求：简洁说明工作流的核心功能与应用场景，帮助用户和大语言模型理解其用途。
• 注意事项：描述需准确反映实际功能，避免模糊表述，应具体说明输入输出关系。

例如：

• '输入养生主题，自动生成带知识点和配图的小红书图文'
• '根据文章 URL 爬取内容，采集标题、发布者等字段存入飞书多维表格'。

初始界面：默认节点与编辑区域

默认节点

• 开始节点：作为工作流的入口，负责接收外部输入信息（如用户指令、API 参数等），类似于程序的 input 模块。
• 结束节点：作为工作流的出口，用于输出最终处理结果（如生成的文本、数据表格等），类似于程序的 output 模块。

编辑区域

• 左侧面板：提供可添加的节点类型，包括插件、LLM、数据库、条件判断等组件，支持拖拽式添加。
• 中央画布：用于节点的连接与逻辑编排，支持节点位置调整、连接线编辑，可视化呈现流程走向。

节点系统详解

基础节点

基础节点是构建 Coze 工作流的核心基础单元，作为流程中的处理单元，通过输入/输出模型实现数据传递与任务执行。核心类型包括开始节点、结束节点、大模型节点、插件节点和工作流节点。

开始节点

• 功能定位：作为工作流的起点，负责设定启动参数与提取用户输入信息，是流程执行的触发源。
• 配置步骤：支持两种输入参数添加方式。
  • 手动添加：需指定变量名（如 douyin_link）、类型（文本/数字等）及是否必选（必选参数缺失将导致流程中断）。
  • JSON 导入：通过结构化数据批量定义参数，适用于复杂场景。

结束节点

• 功能定位：结束节点是工作流的最终节点，用于返回工作流运行后的结果。支持返回变量和返回文本两种方式。
• 返回变量：以 JSON 格式输出所有返回参数，适用于工作流绑定卡片或作为子工作流的场景。Object 类型的参数最多支持 3 层嵌套。
• 返回文本：直接使用指定的内容回复对话。回答内容中支持引用输出参数，也可以设置流式输出。

大模型节点

• 功能定位：集成大语言模型能力处理文本生成任务，支持基于输入内容用成结构化或非结构化输出，是实现自然语言理解与生成的核心节点。
• 配置要点：
  • 模型选择：支持 GPT-3.5、GPT-4、豆包视觉理解 Pro 等多模型切换。
  • 技能：支持为大模型节点配置技能，添加插件、工作流或知识库，扩展模型能力的边界。
  • 输入：需要添加到提示词中的动态内容。支持引用输入参数，实现动态调整的效果。
  • 系统提示词：用于指定人设和回复风格。支持直接插入提示词库中的提示词模版，也可以自行编写。例如 {{variable}} 表示直接引用变量。
  • 用户提示词：模型的用户提示词是用户在本轮对话中的输入，用于给模型下达最新的指令或问题。
  • 输出：支持文本、Markdown、JSON 格式。
  • 异常处理：可手动设置节点运行超时等异常情况下的处理方式，例如超时时间、是否重试、是否跳转异常分支等。

案例

插件节点

• 核心功能：通过连接外部服务与内部逻辑，扩展机器人的功能边界。将第三方 API、服务能力转化为可编排的工作流组件。
• 分类：
  • 内置插件：平台提供超过 60 种开箱即用的工具，覆盖信息检索、多模态处理、生产力工具等领域。
  • 自定义插件：支持用户通过 API 配置创建专属工具，适用于企业内部系统集成或个性化需求。
• 注意：每个插件节点需要清楚地知道输入参数与输出参数。

工作流节点

• 功能定位：在一個工作流中，可以将另一个工作流作为其中的一个步骤或节点，实现复杂任务的自动化。
• 输入与输出：取决于子工作流定义的输入输出结构，不支持自定义设置。
• 批处理：支持设置此节点使用批处理模式，按照配置多次运行。
• 异常设置：支持忽略异常功能。开启后，如果试运行工作流时此节点运行失败，工作流不会中断，而是继续运行后续下游节点。

实战案例

结合以上基础节点开发一个工作流。扩展新闻：先随机输入一个内容去新闻插件里面获取相关的标题，然后把新闻的标题通过大模型扩展一下，输出一个完整的文案。

插件节点

大模型节点

演示效果