工作流

工作流编辑器用于把一个表单式或任务式 AI 能力包装成用户端可执行的工具。它关注输入字段、输出字段、运行平台、计费规则和用户端展示。

你可以在这里做什么

目标	操作入口	影响范围
配置工作流卡片	基础信息	用户端工具列表和详情页
接入外部工作流	平台配置	Coze、系统内置、三方开发者等运行来源
配置输入输出字段	输入字段、输出字段	用户填写表单和结果展示
配置模型槽位	系统内置工作流运行时	模型、凭证、Base URL、Bearer Token
配置扣费规则	售卖策略	会员、按次、按输入、按输出、按 token
调试执行效果	运行预览	上线前验证真实生成结果

一、什么时候用工作流

工作流适合有明确输入和输出的任务，例如：

场景	典型输入	典型输出
文案生成	产品名称、卖点、风格	标题、正文、话题
图片或视频生成	提示词、图片、比例	图片链接、视频链接
结构化分析	文档、链接、关键词	表格、摘要、报告
批量内容生产	商品列表、素材列表	多条内容结果

如果用户需要持续追问和多轮上下文，优先使用智能体；如果用户提交参数后等待结果，优先使用工作流。

二、配置基础信息

填写工作流名称。
选择分类。
写清简介，说明用户输入什么、能得到什么。

图片展示的是飞书工作流配置界面中基础信息配置部分。界面上方有“上传图标”按钮。下方有三个必填项，分别是“名称”“分类”“简介”，其中“名称”输入框提示“给工作流起个响亮的名字”，“分类”下拉框提示“选择合适的分类”，“简介”输入框提示“简短描述工作流的功能和特点...”。该图片与文档中“配置基础信息”部分上下文对应，直观呈现了配置工作流基础信息时需填写的关键内容。

配置图标、封面、演示视频等素材。

图片展示的是工作流配置界面中“写清简介”部分的标签、媒体资源及高级设置区域。标签区域提示输入标签后按回车添加；媒体资源部分有上传背景图和封面图的选项，还设有上传演示视频的区域；高级设置中，精选推荐开关处于关闭状态，展示状态开关则处于开启状态。该图片与上下文紧密相关，直观呈现了配置工作流时需填写标签、上传相关媒体资源及设置高级选项的操作界面。

按需要添加标签。
设置精选推荐、展示状态和排序。
保存前确认用户端展示文案不含内部测试信息。

工作流简介要避免写成「调用某某接口」，更适合写成「根据商品信息生成可直接发布的小红书笔记」。

详细教程文档：、

三、接入工作流来源

来源	适合场景	配置重点
Coze 工作流	已在 Coze 搭好流程	授权凭证、空间、工作流
系统内置工作流	平台提供的内置生产能力	资源选择、模型槽位、运行时配置
第三方开发者	外部开发者提供的工作流	开发者凭证、项目选择
直连平台	Dify、Coze 新版等	API Key、Base URL、项目 ID

导入或选择资源后，要检查输入字段和输出字段是否符合用户端需要。外部平台字段名常常偏技术，建议在后台调整成用户能理解的中文名称。

系统工作流列表：

其他工作流详细教程文档：、、、

四、配置输入字段

输入字段决定用户如何提交任务。

建议按以下原则配置：

必填字段只保留业务真正需要的信息。
字段名称使用用户语言，例如「产品卖点」而不是 selling_points。
对图片、视频、文件等字段，确认用户端上传和素材选择都能正常使用。
数字型字段要明确单位，例如「生成数量」「时长秒数」。
上线前用真实数据填一遍，确认表单不会让用户困惑。

如果后续要使用「按输入收费」，计费字段必须是可计算的数值型输入字段。

五、配置输出字段

输出字段影响结果页如何展示，也影响按输出收费。

输出类型	使用建议
文本	标题、正文、摘要、建议等
图片	海报、封面、产品图
视频	生成视频、剪辑结果
数组	多条文案、多张图、多段结果
数值	评分、数量、时长、消耗等

如果工作流输出 JSON，建议配置清楚字段名和展示名称。按输出收费时，要选择能代表业务产出的数组字段或数值字段。

六、配置系统内置工作流运行时

系统内置工作流可能包含多个模型槽位。每个槽位都可以配置运行渠道。

运行模式	含义
官方算力	使用平台官方模型通道
授权中心凭证	使用授权中心已保存的模型凭证
自定义	手动填写 Base URL、Bearer Token、Provider Type
关闭	禁用该槽位

配置时要确认模型 ID 与渠道匹配。修改模型槽位后，应重新执行一次工作流，避免保存成功但运行失败。

七、售卖和扣费规则

模式	含义	适合场景
免费模式	用户使用不扣点	免费试用、引流工具
按次数收费	每次运行扣固定点数	大多数普通工作流
按输入收费	按输入字段的数量扣费	批量生成、多商品处理
按输出收费	按生成结果数量扣费	多图、多视频、多条文案
按 token 收费	按模型消耗估算扣费	文本量差异大的任务

工作流还可以配置会员专享、源码下载和单独付费。正式上线前，建议用测试账号完整走一遍购买、扣费和生成流程。

八、上线前检查

输入字段能被普通用户理解。
输出字段能正常渲染结果。
工作流至少用 3 组真实参数测试通过。
失败时不会产生误导性结果。
扣费规则和生成成本匹配。
展示状态在测试通过后再开启。

九、常见问题

为什么用户端提交后没有结果？
检查工作流来源、授权凭证、输入字段映射、外部平台额度和运行日志。

按输入收费为什么不能选择字段？
通常是输入字段没有配置为数值型，或字段结构不符合计费要求。

系统内置工作流换模型后失败怎么办？
确认模型 ID、渠道、凭证和 Base URL 是否匹配，再用预览重新执行。