欢迎来到 SuifengFlying!

1.1 介绍#

扣子提供以下两种类型的工作流：

工作流用于处理功能类的请求，可通过顺序执行一系列节点实现某个功能。对话流是基于对话场景的特殊工作流，专门用于处理对话类请求。在应用中添加对话流，将对话中的用户指令拆分为一个个步骤节点，并为其设计用户界面，你可以搭建出适用于移动端或网页端的对话式 AI 应用，实现自动化、智能化的对话流程。

• 工作流（Workflow）：用于处理功能类的请求，可通过顺序执行一系列节点实现某个功能。适合数据的自动化处理场景，例如生成行业调研报告、生成一张海报、制作绘本等。

• 对话流（Chatflow）：是基于对话场景的特殊工作流，更适合处理对话类请求。对话流通过对话的方式和用户交互，并完成复杂的业务逻辑。对话流适用于 Chatbot 等需要在响应请求时进行复杂逻辑处理的对话式应用程序，例如个人助手、智能客服、虚拟伴侣等。

1.2 区别#

相较于工作流而言，对话流更适合处理对话场景下的交互逻辑。每个对话流都绑定了一个会话，运行时可以从此会话中读取历史消息，同时将本次运行对话流产生的消息记录在这个会话中，相当于一个拥有了记忆的工作流。

• 你如果需要搭建一个智能体，智能体本身支持上下文和会话能力，那么可以随意选择工作流或对话流。

• 如果你需要搭建一个对话式的 AI 应用，例如 AI 助手、智能体客服等基于对话方式交互的 AI 应用，扣子推荐你使用对话流，对话流中的大模型可以读取会话上下文、管理会话，还可以搭建对话式的用户界面，发布到各种社交通讯软件中。

• 如果你需要搭建一个工具类的 AI 应用，批量处理数据、实现任务流程的自动化，可以选择工作流实现。

二者的详细具体区别如下：

1.3 常见问题#

• 对话流和工作流可以互转吗

对话流和工作流可以互转。

• 对话流转为工作流之后，大模型、意图识别等涉及模型处理的节点不支持读取对话历史，也无法绑定会话；开始节点的预置参数也会转为普通参数，可以删除或修改。

• 工作流转为对话流之后，开始节点会添加两个预置参数 USER_INPUT 和 CONVERSATION_NAME，不可删除或修改。

• 对话流和工作流的节点有什么区别

对话流和工作流均支持扣子提供的所有节点，但节点配置略有差异。对话流的开始节点中需要指定一个会话，对话流中添加的大模型、意图识别等涉及模型处理的节点支持读取对话历史。

详细差异如下：

步骤一：创建工作流#

1. 登录扣子平台。

2. 在左侧导航栏中选择工作空间，并在页面顶部空间列表中选择个人空间或团队空间。

   • 系统默认创建了一个个人空间，该空间内创建的资源例如智能体、插件、知识库是你的私有资源，其他用户不可见。你也可以创建团队或加入其他团队，团队内的资源可以和其他团队成员共享。更多信息，请参考工作空间概述。

3. 在资源库页面右上角单击**+资源**，并选择工作流。

4. 设置工作流的名称与描述，并单击确认。

   • 说明

清晰明确的工作流名称和描述，有助于大语言模型更好的理解工作流的功能。

• 创建后页面会自动跳转至工作流的编辑页面，初始状态下工作流包含开始节点和结束节点。

• 开始节点用于启动工作流。

• 结束节点用于返回工作流的运行结果。

步骤二：编排工作流#

创建工作流后，你在画布中添加节点，并按照任务执行顺序连接节点。

工作流内置了多种基础节点供你使用，同时你还可以添加插件节点来执行特定任务。如果你在插件商店中收藏了某些插件，则添加节点面板中将自动展示你所收藏的插件，便于你直接调用。

1. 在底部面板中选择要使用的节点

• 将各个节点相连接。

• 配置节点的输入和输出参数。

步骤三：测试并发布工作流#

要想在智能体内使用该工作流，则需要发布工作流。

1. 单击试运行。

   • 运行成功的节点边框会显示绿色，在各节点的右上角可查看节点的输入和输出。

2. 单击发布。

在智能体中添加工作流

添加工作流

1. 前往当前团队的智能体页面，选择进入指定智能体。

2. 在智能体编排页面的工作流区域，单击右侧的加号图标。

3. 在添加工作流对话框，在我创建的页面选择自建的工作流。

• 在智能体的人设与回复逻辑区域，引用工作流的名称来调用工作流。

设置工作流异步运行

工作流默认为同步运行，即智能体必须在工作流运行完毕后才会将工作流的输出传递给智能体用户。如果工作流复杂，或包含一些运行耗时长的节点，可能会导致工作流整体运行耗时长，智能体判断为工作流运行超时，在其运行完毕前就结束对话。例如包含图像流节点、多个大模型节点，或编排逻辑复杂的工作流节点。

说明

• 如果工作流或节点运行超时，智能体可能无法提供符合预期的回复。各场景的超时时间说明如下：

• 未开启工作流异步运行：

• 工作流整体超时时间为 3 分钟，模型节点 3 分钟，其他节点 1 分钟。部分插件节点超时时间可能 3分钟。

• 用户问题和智能体回复的时间间隔最长为 2 分钟，如果智能体回复耗时 2 分钟以上，智能体可能会判断工作流超时。如果工作流运行耗时大于 2 分钟，建议添加消息节点用于输出中间消息，或者结束节点开启流式输出，保持对话状态。

• 开启工作流异步运行后：工作流整体超时时间为 24 小时，模型节点 5 分钟，插件节点 3 分钟，其他节点 1 分钟。

• 工作流异步运行，仅在调试智能体或与商店中的智能体对话时生效，飞书、豆包等渠道暂不支持工作流异步运行。

• 工作流开启异步运行后，模型节点无法查看 Bot 对话历史。

在这种场景下，你可以设置工作流为异步运行，设置后，智能体对话不依赖工作流的运行结果。工作流异步运行时会默认返回一条预设的回复内容，用户可以继续与智能体对话，工作流运行完毕后智能体会针对触发工作流的指令做出最终回复。

开启异步运行：

1. 在指定工作流右侧单击设置。

• 开启异步运行，并设置回复内容。

  • 回复内容是工作流在异步运行时，智能体回复用户的默认文案。

异步运行效果：

在应用中添加工作流

扣子支持在项目中创建一个新的工作流或复制一个已有的工作流使用。

在资源列表中，找到工作流，然后选择一种添加方式。

• 新建工作流：在该项目中创建一个新的工作流。

• 新创建的工作流只能在项目中使用，无法共享给其他项目使用。

• 引入资源库文件：复制一个项目所属的团队空间内已发布的工作流到该项目中使用。

• 复制后，你可以对这个工作流进行修改。在项目中对工作流的修改不影响资源库中的工作流。

添加工作流后，你可以根据实际需求修改节点配置，或新增新的节点。

管理工作流

复制工作流

• 在某一工作流的编辑页面，单击右上角的创建副本图标，可以将该工作流复制到你的工作流列表中。

• 支持跨画布复制节点。

• 在画布中选择并复制已配置好的节点，然后切换到目标画布，直接粘贴即可。

删除工作流

对于不再需要使用的工作流，你可以在工作流列表内找到该工作流，并在操作列单击删除图标。

注意

如果工作流已添加至智能体，在删除时会同步删除智能体中的工作流。

1.1 开始节点#

开始节点是工作流的起始节点，用于设定启动工作流需要的输入信息。开始节点只有输入参数，没有输出等其他参数。开始节点中默认有一个输入参数 BOT_USER_INPUT，表示用户在本轮对话中输入的原始内容。你也可以按需添加其他参数。

开始节点配置说明如下：

• 数据类型：开始节点支持配置 String、Number 等多种类型的输入参数。其中 Object 类型的参数最多支持 3 层嵌套。

• 参数设置方式：支持直接添加参数并设置参数名称，也支持导入 JSON 数据，批量添加输入参数。

• 如下图所示，点击导入图标后，在展开的面板中输入 JSON 数据，然后单击同步JSON到节点就可以自动导入输入参数。

• 参数描述：参数的描述信息，帮助模型理解传入的参数含义。将工作流绑定到智能体中使用时，模型会自动分析用户的 Query，将 Query 中表达的信息填入对应的参数中。

• 是否必选：参数是否必选。如果未指定必选参数，无法开始执行工作流。将工作流绑定到智能体中使用时，用户 Query 中如果缺少必选参数，则不会触发工作流。

1.2 结束节点#

结束节点是工作流的最终节点，用于返回工作流运行后的结果。结束节点支持两种返回方式，即返回变量和返回文本。

返回变量

返回变量模式下，工作流运行结束后会以 JSON 格式输出所有返回参数，适用于工作流绑定卡片或作为子工作流的场景。如果工作流直接绑定了智能体，对话中触发了工作流时，大模型会自动总结 JSON 格式的内容，并以自然语言回复用户。

返回文本

返回文本模式下，工作流运行结束后，智能体中的模型将直接使用指定的内容回复对话。回答内容中支持引用输出参数，也可以设置流式输出。具体说明如下：

2.1 节点说明#

大模型节点可以调用大型语言模型，根据输入参数和提示词生成回复，通常用于执行文本生成任务，例如文案制作、文本总结、文章扩写等。

大模型节点依赖大语言模型的语言理解和生成能力，可以处理复杂的自然语言处理任务，你可以根据业务场景的需求选择不同的模型，并配置提示词来定义模型的人设和回复风格。为了更精准地控制模型生成的结果，你还可以在大模型节点中设置模型的参数，从而影响模型回复的文本长度、内容的多样性等。

2.2 配置大模型节点#

2.3 常见问题#

• 大模型节点配置技能，和直接使用插件等技能节点有什么区别？

区别如下：

• 大模型节点配置技能时，模型会根据用户的 Query 自动判断调用技能的时机与方式、判断执行技能时传递给技能的输入，整体流程更加灵活，是模型 Function call 能力的直接体现。

• 直接使用插件等技能节点时，工作流是开发者人工设计并配置的执行流程，调用技能的时机和方式是固定的，技能的输入也是开发者的指定输入内容，如果编排合理，相对于模型配置技能的场景整体效果更加稳定。

• 为什么模型输出和节点输出不一致，应如何处理？

参数的名称和描述有助于模型在参数中正确返回匹配的内容。当存在多个输出参数时，建议为输出参数指定有意义的名称，并设置描述信息。例如用于改写 Query 的模型节点，可以设置输出参数为 new_query，描述是改写后的 Query，另一个参数为 reason，描述是改写原因。

3.1 添加插件节点#

在工作流画布下方单击添加节点，在弹出的节点面板中单击插件节点，并选择希望调用的插件。

你也可以在节点面板中找到已收藏的插件，选择插件工具，快速添加一个插件节点。

3.2 配置插件节点#

3.3 常见问题#

• 如何批量执行插件？

插件节点默认单次运行，对于输入信息只做一次处理。可以使用批处理节点来一次性批量执行某个插件，支持设置每一批并行处理的数量和总处理次数，例如插件的功能是在知识库中上传文档，单次执行插件节点只能调用一次 API，批处理模式下可以批量调用 API 多次。

详细说明可参考批处理节点。

说明

批处理插件时需要注意，并行运行数量不应超过插件工具的调用频率限制，否则会导致部分任务处理失败

4.1 节点说明#

在一个工作流中，你可以将另一个工作流作为其中的一个步骤或节点，实现复杂任务的自动化。例如将常用的、标准化的任务处理流程封装为不同的子工作流，并在主工作流的不同分支内调用这些子工作流执行对应的操作。工作流嵌套可实现复杂任务的模块化拆分和处理，使工作流编排逻辑更加灵活、清晰、更易于管理。

4.2 输入与输出#

工作流节点的输入和输出结构取决于子工作流定义的输入输出结构，不支持自定义设置。在工作流节点中你需要为必选的输入参数指定数据来源，支持设置为固定值或引用上游节点的输出参数。

4.3 批处理#

工作流节点默认单次运行，对于输入信息只做一次处理。你也可以设置此节点使用Batch processing模式，按照配置多次运行。每次运行都会分配参数值，直到达到次数限制或者列表的最大长度。

工作流节点批处理模式通常用于批量执行一系列任务，支持同时处理多个输入，可显著提高海量数据的运行效率。例如子工作流的功能是在文生图，单次执行工作流节点只能生成一张图片，批处理模式下可以批量生成多张图片。

批处理模式下，还可以设置以下参数：

• 批处理次数上限：批处理运行的次数上限，默认为 100 次。

• 并行运行数量：批处理的并发限制，即同时处理的任务数量，设置为 1 表示串行执行所有任务。

4.4 异常设置#

工作流节点支持忽略异常功能。开启此功能后，如果试运行工作流时此节点运行失败，工作流不会中断，而是继续运行后续下游节点。如果下游节点引用了此节点的输出内容，则使用此节点预先配置的默认输出内容。

4.1 定时触发器#

单击+图标，添加一个触发器，并在创建触发器对话框，完成以下配置。

例如创建一个定时任务，每天8:00练习口语。

4.2 事件触发器#

在智能体的编排页面的技能区域，为智能体添加一个事件触发类型的触发器。成功添加后，如果你的服务端向触发器指定的 Webhook URL 发送 HTTPS 请求时，智能体会自动执行任务。

示例如下：