Coze工作流配置:在扣子平台搭建可运行自动化流程
Coze 工作流配置的本质,是在扣子(Coze)平台里新建一个「工作流」类型的应用,然后用开始节点、大模型节点、插件节点和结束节点把处理逻辑串起来。
它不是一个全局开关,也不能在已有 Bot 里随意附加,必须单独创建工作流并逐节点设置输入输出。
下面按实际操作顺序说明。
先确定流程目标和输入输出
动手之前先写清楚三件事:这个工作流接收什么输入、中间要调用哪些能力、最终输出什么格式。
例如做一个「用户问题分类」工作流,输入是用户原始问题文本,中间调用大模型判断类别,输出是类别名称和置信理由。
目标不清楚时,节点会越加越乱。
准备条件:
- 已注册并登录扣子平台,账号能进入「工作空间」。
- 明确工作流要使用的模型(平台内可选模型以控制台实际显示为准)。
- 如果要用插件,提前确认插件已授权可用。
创建工作流并配置开始节点
在扣子控制台进入目标工作空间,点击「资源库」或「工作流」入口,选择「创建工作流」。
填写名称和描述后进入画布编辑器。
开始节点定义外部传入的参数。
点击开始节点,在右侧面板添加输入字段,例如:
字段名:user_query
类型:String
描述:用户原始问题
是否必填:是
字段名建议用英文小写加下划线,后续节点引用时不容易写错。
多个输入就继续添加字段。
串联大模型节点与结束节点
从左侧节点栏拖入「大模型」节点,用连线把开始节点连到大模型节点。
点击大模型节点配置:
- 选择模型。
- 在提示词区域引用开始节点的变量,例如
{{user_query}}。 - 设置输出格式。如果结束节点需要结构化结果,可在大模型节点里定义输出变量,如
category和reason。
再把大模型节点连到「结束」节点,在结束节点里把大模型的输出变量映射为最终返回字段。
连线时注意方向必须从上游指向下游,否则试运行会提示节点未连接或变量未定义。
配置完成后点击画布右上角「试运行」,填入测试输入,观察每个节点的输入输出。
如果某个节点报错,先检查该节点的变量引用名是否与上游输出字段完全一致。
调试与发布时容易踩的坑
变量名不一致是最常见的问题。
开始节点叫 user_query,提示词里写成 {{query}},运行就会取不到值。
建议复制变量名而不是手打。
结束节点没有映射输出会导致返回为空。
结束节点必须显式选择要输出的变量,不能留空。
模型节点超时或额度不足时,试运行会卡住或报错。
先确认账号模型额度,再检查提示词是否过长。
确认试运行结果符合预期后,点击「发布」把工作流发布为可调用资源。
发布后可以在 Bot 编排里引用该工作流,或通过 API 调用。
发布前建议用两到三条不同输入各跑一遍,确认输出稳定再上线。
验证配置是否生效
发布后回到工作流列表,确认状态为已发布。
进入引用该工作流的 Bot 对话测试,输入一条真实问题,检查返回内容是否包含结束节点定义的字段。
如果 Bot 没有按预期调用工作流,检查 Bot 编排里是否已添加该工作流节点并正确绑定输入参数。
Coze 工作流配置的关键不在节点数量,而在每个节点的输入输出是否对齐。
先把一条最短链路跑通,再逐步增加插件和分支,排错成本会低很多。