工作流是一系列可执行指令的集合，用于实现业务逻辑或完成特定任务。你可以在智能体和应用搭建中通过工作流实现特定的任务或指令。 ## 搭建工作流 无论是在智能体还是应用中使用工作流，都需要先创建一个可运行的工作流。 ### 步骤一：创建工作流 1. 登录[扣子平台](https://www.coze.cn/)。 2. 在左侧导航栏中选择**工作空间**，并在页面顶部空间列表中选择目标工作空间。 3. 在**资源库**页面右上角单击 **+资源**，并选择**工作流**。 4. 设置工作流的名称与描述，并单击**确认**。 清晰明确的工作流名称和描述，有助于大语言模型更好地理解工作流的功能。 创建后页面会自动跳转至工作流的编辑页面，初始状态下工作流包含**开始**节点和**结束**节点。 * **开始**节点用于启动工作流。 * **结束**节点用于返回工作流的运行结果。 ### 步骤二：编排工作流 创建工作流后，你在画布中添加节点，并按照任务执行顺序连接节点。 工作流内置了多种基础节点供你使用，同时你还可以添加插件节点来执行特定任务。如果你在[插件商店](https://www.coze.cn/store/plugin?cate_type=recommend&cate_value=recommend)中收藏了某些插件，则**添加节点**面板中将自动展示你所收藏的插件，便于你直接调用。 1. 在底部面板中选择要使用的节点。  2. 将各个节点相连接。 3. 配置节点的输入和输出参数。 ### 步骤三：测试并发布工作流 要想在智能体内使用该工作流，则需要发布工作流。 1. 单击**试运行**。 如果输入参数包含图片、视频等文件类型，试运行时可以上传文件或输入文件 URL。  运行成功的节点边框会显示绿色，在各节点的右上角可查看节点的输入和输出。 2. 单击**发布**。 发布时你可以选择之前试运行阶段已保存的测试集作为默认测试集，发布后，该空间内的其他用户使用该工作流时，可以使用该测试集进行试运行和测试。 ## 在智能体中添加工作流 ### 添加工作流 1. 前往当前工作空间的智能体页面，选择进入指定智能体。 2. 在智能体编排页面的**工作流**区域，单击右侧的加号图标。 3. 在**添加工作流**对话框，在**我创建的**页面选择自建的工作流。  4. 在智能体的**人设与回复逻辑**区域，引用工作流的名称来调用工作流。  ### 设置工作流异步运行 工作流默认为同步运行，即智能体必须在工作流运行完毕后才会将工作流的输出传递给智能体用户。如果工作流复杂，或包含一些运行耗时长的节点，可能会导致工作流整体运行耗超过 10 分钟，智能体判断为工作流运行超时，在其运行完毕前就结束对话。例如包含图像流节点、多个大模型节点，或编排逻辑复杂的工作流节点。 在这种场景下，你可以设置工作流为异步运行，设置后，智能体对话不依赖工作流的运行结果，工作流超时时间延长至 24 小时。工作流异步运行时会默认返回一条预设的回复内容，用户可以继续与智能体对话，工作流运行完毕后智能体会针对触发工作流的指令做出最终回复。 * 如果工作流或节点运行超时，智能体可能无法提供符合预期的回复。各场景的超时时间可参考[工作流使用限制](https://www.coze.cn/open/docs/guides/workflow_limits)。 * 工作流异步运行，仅在调试智能体或与商店中的智能体对话时生效，飞书、豆包等渠道暂不支持工作流异步运行。 * 工作流开启异步运行后，模型节点无法查看对话历史。 开启异步运行： 1. 在指定工作流右侧单击**设置**。  2. 开启**异步运行**，并设置**回复内容**。 回复内容是工作流在异步运行时，智能体回复用户的默认文案。  异步运行效果：  ## 在应用中添加工作流 扣子支持在项目中创建一个新的工作流或复制一个已有的工作流使用。 在资源列表中，找到工作流，然后选择一种添加方式。 * **新建工作流**：在该项目中创建一个新的工作流。 新创建的工作流只能在项目中使用，无法共享给其他项目使用。 * **引入资源库文件**：复制一个项目所属的工作空间内已发布的工作流到该项目中使用。 复制后，你可以对这个工作流进行修改。在项目中对工作流的修改不影响资源库中的工作流。  添加工作流后，你可以根据实际需求修改节点配置，或新增新的节点。 ## 查看引用资源 扣子工作提供资源引用页面，帮助你快速查看扣子应用中已添加的工作流、插件、数据库等资源，以便理解扣子应用中各项资源的引用关系，从而更高效地管理资源、定位问题。 在工作流编排页面右上角单击引用关系图标，页面将自动跳转到资源引用页面。  资源引用页面展示扣子工作流引用的子工作流、插件、数据库、知识库等资源，箭头从 A 指向 B 表示 A 引用了 B。例如在下图中，gen\_zhuzhu\_image 工作流直接引用了 test 知识库、头条搜索插件和 search 工作流。你还可以单击资源卡片，在新标签页中查看资源详情。 资源库中的工作流支持查看引用的资源版本，例如子工作流的版本、插件版本等。  ## 复制工作流 * 在某一工作流的编辑页面，单击右上角的**创建副本**图标，可以将该工作流复制到你的工作流列表中。 * 支持跨画布复制节点。 在画布中选择并复制已配置好的节点，然后切换到目标画布，直接粘贴即可。 ## 删除工作流 对于不再需要使用的工作流，你可以在**工作流**列表内找到该工作流，并在**操作**列单击删除图标。 如果工作流已添加至智能体，在删除时会同步删除智能体中的工作流。  ## 导出与导入工作流 工作流（包含对话流）支持导出为 Zip 格式的压缩包，该压缩包可灵活导入至任意工作空间来创建一个新的工作流，适用于历史版本管理或跨空间、跨账号复制工作流等场景需求。 * 历史版本管理：能够基于历史版本创建新的工作流，即导出某个历史版本的工作流，通过导入创建一个新的工作流。 * 跨空间、跨账号复制工作流：直接将导出的压缩包导入至目标账号的工作空间中，就能完成完整的工作流复制。 ### 注意事项 在导出与导入工作流前，请先阅读如下注意事项： | **注意事项** | **说明** | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 支持的套餐版本 | 个人进阶版、团队版、企业版套餐支持工作流导出、导入操作。 | | 导出工作流 | * 导出的 Zip 压缩包为加密格式，不支持解压查看或编辑。* 支持修改压缩包名称，但请勿修改压缩包后缀，否则会导入失败。* 扣子应用专属的工作流不支持导出、导入。 | | 工作流配置 | 当工作流中添加了知识库、数据库、私有插件、子工作流等资源时：* 同空间内导出后再导入，配置不受影响，工作流可正常运行。* 跨空间导入后，上述添加的资源将失效，需重新选择所在空间内的资源。 | | 敏感信息处理 | 导出工作流时，系统会自动检测工作流中的敏感信息（如 HTTP 节点的鉴权信息），并提示是否同步导出。如果工作流中包含鉴权信息，请谨慎选择，避免泄露。 * 如果选中鉴权信息，那么系统会将鉴权信息导出到压缩包中。导入时，系统会同步导入鉴权信息。* 如果未选中鉴权信息，系统会将自动清除鉴权信息。导入时，你需要重新配置鉴权信息。 | ### 导出操作 你可以在资源库列表页面、工作流编排页面或发布历史列表页面，单击**导出**，导出工作流。 在导出过程中，请勿删除任务，删除任务将导致导出失败。 ### 导入操作 你可以在资源库列表页面、智能体编排页面，单击**导入**，导入工作流。导入时，你需要上传已导出的工作流 Zip 压缩包，系统将自动读取压缩包内的信息，预填工作流的名称和描述。导入完成后，即可实现工作流的完整复制。 导入后的工作流，默认为草稿状态。