抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

工作流

收藏
我的收藏

工作流概述

AI 工作台提供可视化的工作流编排能力,支持通过画布连接大模型、代码、条件选择器、工具等功能节点,将复杂任务拆解为逻辑清晰、过程可控的执行流程,为多步骤、高准确性要求的业务场景提供稳定可靠的 AI 处理能力。

创建工作流

参考以下流程,逐步搭建工作流。

方式一:AI Coding

以自然语言驱动开发,支持通过对话生成、修改与优化工作流代码,将业务需求转化为可执行的流程编排。适用于希望减少手动配置、快速搭建与迭代流程,或通过代码灵活扩展节点能力的场景。

Step1:进入创建入口

在AI工作台左侧进入【新建项目】,在操作框中单击选中「工作流」。

Step2:描述项目需求

    1.通过对话式交互,用户以自然语言描述实际的创编需求,无需手动配置参数或逐节点搭建,即可快速生成符合预期的工作流。支持语音输入;
    2.需求描述尽可能清晰且详细。方向可包含:工作流功能描述、业务实现逻辑和约束条件…
搭建一个抖音热点探索分析工作流,掌握抖音内每日最新热点资讯。

Step3:增加可选配置

    1.文件:支持上传图片、json文件、word文档、压缩包等文件,辅助AI生成;
    2.扩展:平台内提供多种通用资源,用户可按需进行扩展,加强AI生成效果;
    a.智能调用:选择该模式后,模型会根据用户的提示词理解意图,按生产需求自动调用各类资源。在具体资源右侧开启开关,模型会优先加载该资源并评估是否调用;
    b.自定义:选择该模式后,由用户决定模型可调用的资源。在具体资源右侧开启开关,则表明允许模型自动调用该资源;反之,表明模型不能调用该资源。
    3.模型:默认是Auto模型,用户可在列表中选择其他通识模型。

Step4:提交等待生成

    1.完成上述步骤后,即可在输入框中点击发送,页面会跳转至该项目专属编辑页面,可以在此查看实时生成进度。
    2.平台会自动生成工作流项目项目的初始名称,可在第一泳道【我的项目】下找到目标工作流,点击右侧“…”并选择重命名完成工作流项目名称修改。
过程预计需要几分钟,请耐心等待。

方式二:智能编排

平台提供可视化的低代码画布编排能力,支持对节点、连接关系、输入输出及执行条件进行精细化配置与控制。适用于希望直观搭建流程、逐步干预每个环节,或实现复杂业务处理链路的场景。

Step1:进入创建入口

在AI工作台左侧进入【新建项目】,在操作框中单击选中「工作流」。

Step2:创建空壳工作流

    1.直接点击对话框的发送按钮,页面会跳转至该项目空白编辑页面;
    2.工作流生成时默认名称为“未命名”。可在第一泳道【我的项目】下找到目标工作流,点击右侧“…”并选择重命名完成工作流名称修改;
    3.在第三泳道【项目管理-预览】tab下可见工作流画布。

Step3:配置工作流节点

    1.添加节点:根据需求在画布中添加对应功能节点,覆盖流程所需的各个处理环节;
    2.填写参数:逐个完成节点配置,补充输入、输出及处理规则等参数,确保每个节点的职责与执行逻辑明确;
    3.连接节点:按业务处理顺序将节点依次连线,串联成完整的执行路径;可通过检查清单核对未配置或未连接的节点,及时补全遗漏项。

画布介绍

画布是工作流的操作面板,所有编排动作(添加节点、连线、配置参数等)均在画布中完成。
功能点
功能描述
功能示意
展开画布
支持展开画布的操作面板。
操作模式
支持触控板友好模式/鼠标友好模式。
    •触控板友好模式:双指同向移动可拖动画布,双指张开捏合可缩放
    •鼠标友好模式:鼠标左键可拖动画布,滚轮滑动可缩放画布
自动布局
支持一键整理画布布局,将复杂的流程链路自动排布为清晰、整齐的结构。
​
对话设置
支持对话模式/任务模式配置。
    •任务模式
    ◦输入输出自由配置。
    •对话模式
    ◦自动在输入节点配置userinput、在输出节点配置result;也可以新增其他字段;
    ◦可支持配置携带上下文轮次;
    ◦控制流式输出(前端伪流式,非大模型流式输出)。
单节点试运行
​
在不运行整个流程的情况下,针对某个节点独立进行调试与验证,便于隔离并排查单个节点的配置或数据问题。
​
变量
支持查看变量列表
    •系统变量:开启开关则可全局引用,关闭开关则无法引用;
    •节点变量:为下一个节点可被引用的变量。
日志
支持查看调试过程中的运行日志信息,每个节点输入输出信息。

节点介绍

核心节点

原始节点

节点
节点功能
功能示意
开始节点
起点节点,设计基础入参信息,支持配置输入变量和触发器。
    1.配置变量
    a.变量类型:用户可以添加自定义变量作为任务/对话的入参,变量类型包括string、int、float、bool、object、image、imageBase64、video、array
    b.变量添加方式:
    i.自定义添加;
    ii.导入JSON解析:默认case key和case value,会根据case value类型自动选择变量类型和变量名
结束节点
最终节点,返回工作流运行后的结果。
    1.配置输出
    a.JSON模式:输出为对应变量类型和参数值;
    b.文本模式::输出变量值的组合文本。例如:今天{{location}}的温度为{{temperature}}。文本输出:输出为变量

AI能力

节点
节点功能
功能示意
大模型
用于调用大语言模型生成回复。支持通过输入模型名称、模型Key或EP搜索模型,并从搜索结果或展示列表中选择合适模型后进行参数配置
    1.配置模型:模型节点由语言模型驱动,可以根据节点的功能选择不同特性的模型,如处理文本类、图片生成类等
    2.配置变量:
    a.输入变量:可引用前序节点的变量作为输入,并在Prompt中使用这些变量
    ▪System Prompt:描述人设、技能、审核规则、约束条件等内容,不建议在里面添加变量
    ▪User Prompt:描述具体任务,填入待审核/标注内容,通过@添加变量
    b.输出变量:
    ▪JSON:需要定义字段的key,类型,描述;系统会默认通过这些内容来生成prompt自动注入
    ▪文本:输出一段文本内容
    3.节点知识:开启后,支持节点使用自己产生的历史(输入输出)作为上下文
意图分类
利用大模型对输入文本进行意图分类,实现对用户输入的自动识别与匹配
​
    1.输入变量:根据输入参数query进行意图识别和匹配
    2.配置意图:大模型将依据配置的分类名称和分类示例进行分类判断。在配置时,应清晰、准确地描述意图,以获得更好的识别效果
必填项:意图分类;选填项:意图示例和意图规则。
    3.配置模型:根据节点的功能选择不同特性的模型,如处理文本类、图片生成类等
​
字段提取
通过大模型从文本中提取信息
​
    1.输入变量:定义需要处理的原始字段
    2.提取字段:定义需要提取的目标字段
    3.配置模型:选择一个处理模型,建议选择处理速度较快的模型
​
生成式模型
使用多模态生成模型进行图片/视频/音频的生成和编辑
    1.输入变量:单张图片变量类型选择image,变量值传入URL;多张图片变量类型选择[]image,变量值传入URL列表
    2.设置模型:支持GPT、豆包、GEMINI等通识模型,并提供自建模型接入渠道,支持用户接入BA平台、方舟平台等模型
    a.图像生成:需设置图片比例
    b.视频生成:需设置视频分辨率、视频时长、超时时长、视频水印,支持上传图片进行参考
    c.音频生成:需设置音乐生成模式、歌词
    3.提示词:用户输入图片/视频生成提示词

输入&输出

节点
节点功能
功能示意
消息
支持工作流中间过程的消息输出
    1.输出类型
    a.JSON 模式:以结构化变量形式输出中间消息,适合后续节点继续引用处理;
    b.文本模式:以自然语言文本形式输出消息,适合直接向用户展示进度或中间结果
    2.输出变量:点击右上角「自定义」添加变量,配置变量名与变量值,变量值可引用前序节点的输出
    3.回复内容:在回复内容框中编辑要输出的消息文本,支持通过 @ 选择变量,或输入 {{}} 引用变量名称,将前序节点的结果动态拼接到消息中
    4.使用场景:用于在工作流执行过程中向用户推送阶段性消息(如处理进度、中间结论),消息输出后流程继续向下执行

逻辑节点

节点
节点功能
功能示意
条件选择器
IF/ELSE,判断入参是否满足条件并分支处理
该节点在工作流中自上而下匹配条件,可以设置多个条件,当命中某分支时执行对应节点;若所有条件均未命中,则执行兜底ELSE分支。详见:AICore条件配置手册
批处理
对数组中的每个元素依次执行相同的操作步骤,可理解为任务批处理器,通常与数组变量配合使用
    1.功能说明:支持批量执行指定节点;输入变量类型为list,输出变量类型也为list,可选择批处理内部节点的输出变量
    •示例:若输入的字符串数组包含2个元素,则批处理节点会执行2次流程
    2.并行模式
    a.关闭:按顺序逐个处理输入列表中的元素,直到最短列表处理完成
    b.开启:按设定的并行数量同时处理,最大并行数为20
    3.特殊逻辑:批处理节点内部不允许再嵌套其他批处理节点
​
批处理里面的节点输入变量,可选择批处理整体输入变量里的单个元素
批处理中的节点之间没有连线时,是并行处理逻辑
批处理中的节点之间有连线时,是串行处理逻辑
并行模式配置
循环
用于按顺序反复执行一组任务,直到满足指定条件。所有迭代均以串行方式执行,确保逻辑一致性
​
    1.循环类型
    a.使用数组循环:当输入为数组时,循环节点会自动遍历数组中的每个元素。循环体内默认可使用两个变量:
    i.item:当前遍历的数组元素(数字、字符、字符串等);
    ii.index:当前遍历的序号,从0开始
    b.指定循环次数:当需要执行指定次数的重复任务时可选择此模式。循环体内默认提供index变量(当前循环的序号,从0开始)
    2.配置循环节点
    a.中间变量配置:用于记录累加值、状态或下一次循环的输入。例如:将上一轮的计算结果作为下一轮迭代的初始值
    b.循环体设置:创建循环节点后会生成循环节点本体与循环体画布。
    i.循环体画布用于编排循环的核心逻辑,系统将在每次迭代中顺序执行其中的节点;
    ii.只需在循环节点与上下游节点之间连线,无需对循环体与循环节点之间的连线做任何调整;
    iii.设置变量节点、继续循环节点、停止循环节点仅可在循环体内使用;
    iv.不支持跨画布拖动节点(循环体内外的节点不可互相移动)
    c.输出配置:循环结束后,可将循环体内某个节点的输出作为循环节点的最终输出。系统会自动将每轮迭代的该输出key汇总为数组
    •输出格式:[key]*n,其中n是循环的总次数。
    3.调试循环节点:配置完成后,可对循环节点进行试运行,查看输入输出是否符合预期。循环节点的调试结果将展示所有迭代后的整体输出;循环体中每个节点会显示各轮循环的输入、输出及变量变化情况,便于排查逻辑问题
变量聚合
对多个分支的输出结果进行聚合处理,默认返回每个分组中第一个非空的值
    1.分组配置说明:
    a.变量类型选择:默认类型为string,可选择的类型与开始节点一致
    b.来源支持:可使用输入参数或上游节点的输出参数
    c.类型约束:仅支持聚合同一种数据类型的变量。若第一个添加的变量为string,后续可选的变量会自动按string类型过滤
异步任务
异步触发一个工作流,并返回 task_id
    1.异步任务:在「异步任务」下拉框中选择需要异步触发的目标工作流。
    2.输入变量:自动展示目标工作流开始节点定义的入参(变量名、变量类型),逐个填写变量值,可引用上游节点的输出;可勾选「必填」约束入参。
    3.输出变量:触发成功后返回 task_id(string 类型),可用于后续查询该任务的执行状态与结果
    4.执行逻辑:节点仅负责触发目标工作流,不等待其执行完成,主流程继续向下运行

数据处理

节点
节点功能
功能示意
文本处理
使用模板拼接文本或按分隔符拆分文本
    1.选择应用:支持字符串拼接/字符串分隔两种方式
    2.输入变量:添加待处理的文本变量(默认 input,string 类型),变量值引用前序节点输出,关联变量不能为空,支持添加多个变量
    3.字符串拼接配置:在编辑框中编写拼接模板,输入 @ 或使用 {{.变量名}} 引用整个输入变量;点击「连接符」设置多个变量之间的连接符号
    a.Array:引用整个数组,按设置的连接符拼接每一项。例如Story=["我的故事","很有趣","也不有趣"],使用{{.Story}},连接符为逗号时得到“我的故事,很有趣,也不有趣”。
    b.Object:引用整个对象,返回JSON字符串。例如obj={"name":"小红","age":10},使用{{.obj}}得到{"name":"小红","age":10}。
    4.字符串分隔配置:选择分隔符。
    a.是否过滤空片:开启后,自动剔除因连续分隔符、首尾分隔符产生的空字符串片段,仅保留有效内容
    5.输出:默认输出变量 output(string 类型),即拼接或分隔后的处理结果,可修改变量名与变量类型
​
JSON序列化
将输入数据转换为 JSON 字符串
    1.输入:添加需要转换的输入变量(默认 input),变量值引用前序节点输出,关联变量不能为空。
    2.输出:默认输出变量 output(string 类型),即转换后的 JSON 字符串,可直接用于 HTTP 请求体组装、文本拼接等后续处理。
JSON反序列化
将 JSON 字符串解析为指定的数据结构
    1.输入:添加待解析的 JSON 字符串变量(默认 input,string 类型),变量值引用前序节点输出,关联变量不能为空。
    2.输出:默认输出变量 output(object 类型)。点击「JSON 导入」可粘贴 JSON 样例,系统自动解析并生成对应的数据结构与字段,后续节点即可按字段引用其中内容。

基础节点

节点
节点功能
功能示意
知识库
从知识库中检索与输入问题相关的参考内容,并将检索结果作为后续节点的输入
    1.选择知识库:通过知识库下拉框选择需要检索的知识库
    2.配置检索query:将变量作为检索输入,用于触发知识库匹配
    3.文件知识库/结构化知识库配置
    a.语义检索:查相似度最高的知识
    1.最大返回结果数:返回知识条数上限;最小匹配度:仅返回相似度高于该阈值的内容(0–1)
    b.全文检索:查关键词重复的内容
    1.最大返回结果数:返回知识条数上限;最小匹配度:仅返回相似度高于该阈值的内容(0–1)
    c.混合检索:语义检索和全文检索综合排序
    1.混合权重:设置排序侧重方向;最大返回结果数:返回知识条数上限;最小匹配度:仅返回相似度高于该阈值的内容(0–1)
    d.精准检索:召回与查询文本完全一致的内容
    1.最大返回结果数:返回知识条数上限
    4.数据知识库配置:支持通过数据查询和数据写入两种方式进行配置,编辑模式均支持SQL、自然语音和配置化
    a.数据查询:编辑器内调试运行时,可选择查询线上数据或测试数据,实际运行时默认查询线上数据
    b.数据写入:编辑器内调试运行时,仅支持写入测试数据;实际运行时写入线上数据
    5.卡片配置(部分):可以通过卡片配置查看相关视频/图片的预览效果
    6.标准知识库使用方式
    a.支持SQL查询:可直接编写SQL语句从标准知识库中检索内容。
    b.支持结构化查询配置:无需写SQL,通过配置查询字段、查询条件、排序方式、查询上限的方式完成检索。
文件知识库/结构化知识库配置
数据知识库配置
代码节点
通过编写代码对输入变量进行处理,支持使用AI辅助生成代码。可在内置IDE中编写自定义Go代码或基于Inkgo语法的Python代码,处理输入参数并返回结果
    1.输入参数:在代码中声明所需的变量。
    a.在添加输入参数时,指定参数名称和变量值。
    b.变量值可以引用先前节点的输出参数。
    2.代码编辑:在代码节点内编写要执行的代码片段。
    a.引用变量:直接在代码中将输入参数引用为变量,以处理并返回结果作为对象。
    b.函数限制:仅支持单个函数代码。即使仅返回一个输出值,输出也必须作为对象返回。
    3.输出参数:定义代码成功运行后将输出的参数。根据实际需求,可以仅保留输出结构中的所需参数。
    a.如果取的内容是一个图片URL并且期望大模型识别这个图片,则这个URL的变量类型选择image;
    b.同理如果是一个图片URL的list,则将变量类型选择image。
​
HTTP
支持调用内网HTTP接口并获取返回结果。该节点用于自定义外部调用,通常与RPC节点一样,用于外部通知和特征补齐
    1.注意事项:
    a.HTTP请求存在安全管控风险,若需要使用,请提交oncall工单将域名加白;
    b.HTTP请求无法实现安全降级,无法处理如流量切换等场景,当机房故障时,可能导致请求失败。
​
RPC
支持泛化调用服务RPC接口并获取返回结果。不仅支持进行RPC调用,还可以配置PSM调用方法,实现灵活的泛化调用能力
    1.请求配置:需要配置PSM、method、集群、环境和IDL版本信息。
    a.IDL版本配置:点击overpass进行配置,搜索对应的psm,鼠标hover到Hash。
    2.其他配置:稳定性保证配置。
    a.超时时间:RPC请求超时配置,默认1s;
    b.重试次数:失败后重试次数,建议1~3次。
    3.变量配置:可以在字节云根据接口服务查询要请求的PSM接口介绍。查询对应的入参和响应参数。
注意:输入变量对应「请求参数」;输出变量对应「响应参数」

其他节点

节点
节点功能
功能示意
工具
添加官方/个人/空间内已发布的工具,支持能力扩展与复用
​
Agent
调用智能体来处理具体任务
    1.附件配置:支持上传图片、视频、音频等多模态附件。
    a.支持选择变量值作为附件输入,变量类型支持image、video、audio
​
工作流
​
调用工作流来处理具体任务
    1.工作流编排:支持直接跳转至具体工作流项目进行工作流编排修改

节点异常

处理方式
详情描述
功能示意
中断流程
    •系统默认选项。代表节点运行失败时,中断当前任务整体运行直接退出,标识这个节点是整个工作流的强依赖;
​
返回设定内容
    •代表节点运行失败时,返回自定义返回内容,标识这个节点是可降级为指定内容返回
执行异常流程
    •代表节点运行失败时,流向异常处理流程
​

预览与测试

对话调试

工作流完成节点配置后,需要针对整个工作流串连情况进行试运行,检查是否有配置错误一级测试其表现是否符合预期。如效果不满意,可持续通过AI对话或工作流画布进行调整,预览效果即时更新,直至符合需求。
如有批量测试运行需求,可参考效果优化。

对话轨迹

针对AI Coding生成过程,支持查看对话轮次与具体节点,还原工作流运行全流程:
    1.对话轮次:在对话轮次详情页,支持快速切换上一轮次和下一轮次,在每一个对话轮次下,展示该轮次整体的耗时火焰图、用户query和各节点运行详情;
    2.具体节点:通过AI对话运行过程或耗时分布图点击具体节点,可快速定位至该节点卡片详情。支持查看节点类型、耗时、事件描述与调用结果,便于用户快速定位异常环节。

异常排查

画布处点击日志。如出现调用异常或失败,可点击 ID 旁的【复制】获取 Trace ID,自行优化或反馈至技术同学排查。

发布工作流

工作流配置完成并通过试运行后,即可发布到线上渠道正式投入使用。

检查清单

配置过程中,系统会实时校验各项内容。所有校验项通过后,才能执行「试运行」「发布」或「更新线上版本」,以确保工作流配置完整、可用。

变更管理

变更管理面向智能体的编排内容本身,记录编辑过程中各版草稿配置的变化,与是否发布到线上无关。在【变更管理】tab 中可查看、对比并回退编排版本。

变更详情

支持选择任一历史版本与当前版本进行diff对比。AI会自动总结变更内容,并在下方展示具体差异——绿色表示新增,红色表示删减。

恢复到版本

支持选择任一历史版本回退编排内容;回退后会自动生成一条新的变更记录。

发布

发布是将工作流正式同步到线上使用的动作。点击「发布」只会确认当前配置版本,不会自动上线到具体渠道;需在「发布配置」中完成渠道设置,审核通过后才会在线上生效。首次发布后若再次修改编排,可通过「更新线上版本」将最新配置同步到线上。

发布配置

    1.发布内容
    a.支持查看当前草稿和发布版本的版本对比情况
    b.支持修改该工作流的名称和简介
    2.应用渠道
    a.选择目标发布渠道,进入渠道详情页完成相关配置
    b.返回「发布配置」点击确认发布,审核通过后即可在线上使用

发布历史

发布历史记录的是每次实际发布到线上的版本,用于追踪线上版本迭代。
    1.配置对比:可选择任一历史线上版本与当前草稿对比,查看变更摘要与具体差异;
    2.对话调试:支持用同一 query同时查看两个版本的回复,便于对比对话效果。

管理工作流

增加协作人

    1.仅支持搜索并添加同一空间内的飞书账号作为协作者,且被添加用户必须具备该空间访问权限,才能进行内容编辑。
※异常情况:如果在团队空间为工作流添加协作者时,搜索不到某人,说明对方不在该空间内,需先将其加入空间后再添加。
    2.多人协作编辑:默认同一时间仅允许一人编辑,其他人处于锁定状态;支持抢占编辑权限。

导入/导出工作流

    1.导入:在工作流编排页面上方点击「导入」,支持上传文本;
    2.导出:可以点击工作流编排页面上方的「导出」按钮,将当前工作流以文本或者文本文件形式导出。

复制/删除工作流

    1.单个复制/删除:选择需操作的节点,点击节点卡片右侧“…”即可进行复制或删除;
    2.批量复制/删除:用鼠标圈选需操作的多个节点,选中后进行“Ctrl+C”或“delete”即可批量操作;
    3.仅支持创建者删除工作流,目前不支持批量删除工作流;
    4.已在线上正式使用的工作流,需先解除线上关系才能够操作删除。