
# 管理工作流
AgentArts平台致力于提供高效、灵活的工作流管理解决方案。除了支持**AgentArts工作流** 的导入导出，为了提升用户体验，AgentArts现支持**Dify工作流**的导入功能。用户可以轻松将现有的Dify工作流文件导入平台，在导入工作流时，将同步导入与工作流关联的插件等配置，实现无缝对接和高效管理。无论是复杂业务流程还是简单任务自动化，AgentArts都能快速导入、配置和执行Dify工作流，显著提高工作效率和操作便捷性。
#### 导入、导出工作流
1. 导入工作流。 
   - 导入AgentArts DSL文件
     1. 单击页面左上角"导入"下拉框，并选择"导入AgentArts工作流"。
        图1导入AgentArts工作流   
        ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950176.png) 
     
     2. 在"导入"页面，单击"选择文件"选择需要导入的jsonl文件，并单击"导入"。
        图2导入工作流   
        ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950168.png "点击放大")
        图3导入状态   
        ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389917.png "点击放大")
        ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
        - 如果工作流关联的资源（如插件、MCP、知识库）导入失败，应用仍会正常导入，但这些资源将不会被导入。 Dify不支持知识库和自定义插件导出：由于Dify DSL文件结构限制，不包含知识库向量数据及自定义插件源码，因此无法自动迁移，需用户在AgentArts平台手动重建。
          
        
        - 如果导入失败，可在操作列查看原因。
        
        - 如果导入的工作流中存在资源未配置鉴权，系统会标注"未配置鉴权"，单击操作列中的"配置鉴权"后可在配置鉴权窗口中进行操作。
          
     
     3. 选择导入文件后，选择解析内容。 平台将自动解析jsonl文件。如果解析的文件已存在，勾选该文件将自动覆盖平台现有文件。
        ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
        - 仅支持上传jsonl格式文件，工作流文件的最大导入大小为128MB。
        
        - 勾选已存在的文件将覆盖平台现有工作流配置，该操作不可恢复，请谨慎操作。
          
     
     4. 单击"导入"，导入成功的工作流将在"开发中心 \> 应用管理 \> 工作流应用"页面中展示。
      
   
   - 导入Dify DSL文件
     1. 单击页面左上角"导入"下拉框，并选择"导入Dify DSL文件"。
     
     2. 在"导入Dify DSL文件"页面，单击"选择文件"选择需要导入的yml文件，并单击"导入"按钮。
        图4导入Dify DSL文件   
        ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389935.png)
        ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
        仅支持上传.yml格式文件，最大支持128MB。
        为了更好地兼容，建议迁移之前将依赖的知识库/插件等资源同步到平台。
        
     
     3. 在Dify DSL文件迁移界面确认迁移结果，单击"确定"后工作流成功导入，可在工作流配置界面对需要调整和不兼容的节点或模型等进行修改。
        图5Dify DSL文件迁移   
        ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549809.png "点击放大")
        ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
        - 对于不兼容的节点新增空白节点（保留Dify工作流中的输入和输出参数），可在同步数据完成后在工作流编排页面进行节点替换。
        
        - 针对引用插件、MCP、模型等可根据需要重新配置鉴权。
          
      
   
   
   
   
2. 导出工作流。平台支持导出工作流。导出工作流时，将同步导出工作流关联的插件等配置。 
   1. 单击页面右上角"导出"，选择目标工作流，导出工作流。或鼠标移动到目标工作流，单击"更多 \> 导出"。
   
   2. 在"导出工作流"页面选择工作流，单击"导出"。单击"下载"，工作流将以一个jsonl格式的文件下载至本地。
      图6导出工作流   
      ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950160.png "点击放大")
      ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/note_3.0-zh-cn.png)
      - 如果应用关联的资源（如插件、MCP、知识库）导出失败，则导出的文件中将不包含对应资源。
      
      - 如果导出失败，可在操作列查看原因。
        
   
   
   
   
 
#### 注意事项
- Dify不支持知识库和自定义插件导出。如果Dify工作流中包含这些资源，用户需要手动在AgentArts中创建相应的知识库和自定义插件。详细操作请参见[创建知识库](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0152.html)和[创建插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0125.html)。
- Dify的迁移功能基于Dify DSL 0.6.0版本（产品版本1.12.0）开发。请注意以下几点：
  - **版本兼容性**：不同DSL版本之间可能存在较大的结构差异，这可能导致存量数据在迁移过程中出现不兼容问题。
  
  - **节点处理**：不在节点列表中的Dify节点将默认转换为空白节点。
  
  - **未来升级**：Dify未来的DSL版本升级可能会影响迁移功能的兼容性。如果发现严重的兼容性问题，将在后续版本中进行调整和优化。
   
表1Dify工作流转换支持情况说明 
| Dify      | AgentArts                                    | AgentArts兼容性                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|
| 系统变量      | 系统参数                                         | 以下系统参数在导入AgentArts时暂不支持： - **会话次数**：dialog_count。  - **应用ID**：app_id。  - **工作流ID**：workflow_id。  - **工作流运行ID**：workflow_run_id。  - **运行开始时间戳**：timestamp。                                                                                                                                                                                                                                                           |
| 对话型工作流    | 全局配置                                         | - **内容审查**：Dify对话型工作流导入AgentArts时，内容审查不支持API拓展。  - **语音转文字和文字转语音**：语音转文字和文字转语音功能在AgentArts中默认开启。  - **引用和归属配置**：AgentArts工作流不支持引用和归属配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 任务型工作流触发器 | 开始节点+触发器                                     | AgentArts任务型工作流不支持WebHook类型触发器。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 用户输入或开始   | 开始                                           | - **用户输入查询**：Dify的userinput.query对应AgentArts开始节点的query。  - **文件输入**：Dify的userinput.files在AgentArts的开始节点中新增一个sysFiles输入参数，类型为file/default。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| LLM       | 大模型                                          | - **模型选择**：转换后，模型将被置空，需要重新选择。  - **视觉输入参数**：视觉输入参数需要重新配置。  - **异常场景返回**：AgentArts不支持在未开启结构化输出时配置异常场景的预设返回内容。  - **记忆提示词和记忆窗口**：AgentArts不支持配置记忆提示词和记忆窗口。  - **失败重试**：AgentArts不支持失败时的重试功能。                                                                                                                                                                                                                                            |
| 知识检索      | 知识检索                                         | - **知识库迁移**：知识库不支持迁移，需要重新选择。  - **元数据过滤**：AgentArts不支持元数据过滤。  - **参数适配** ： - 分段标题title对应AgentArts的subtitle。  - 分段链接url、分段图标icon、其他元数据metadata以及files召回的文件参数AgentArts不支持。                                                                                                                                                                                                                |
| 对话型-直接回复  | 消息节点 结束节点 | 基本兼容                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Agent     | Agent                                        | AgentArts仅保留名称和描述，其余参数需要用户重新配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 问题分类器     | 意图识别                                         | - **模型选择**：转换后，模型将被置空，需要重新选择。  - **视觉输入参数**：AgentArts不支持视觉输入参数。  - **意图分类**：AgentArts意图分类不支持引用前置节点参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 迭代        | 循环                                           | - **错误响应方法**：AgentArts不支持错误响应方法。  - **扁平化输出**：AgentArts不支持扁平化输出。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 循环        | 循环                                           | - **终止条件**：AgentArts终止条件存在不兼容，不支持"开始是"和"结束是"。  - **退出循环节点**：AgentArts不支持退出循环节点。  - **退出条件**：AgentArts退出条件不支持选择循环内部节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 代码执行      | 代码                                           | **代码执行**：使用本地代码替换，用户需要根据提供的模板重新适配代码。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 模板转换      | 无                                            | AgentArts不支持模板转换，将转换为空白节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 变量聚合器     | 变量聚合                                         | 基本兼容                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 文档提取器     | 无                                            | AgentArts不支持文档提取器转换，将转换为空白节点。 可使用插件市场的文档解析工具替换。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 变量赋值      | 变量设置                                         | **运算符**：AgentArts不支持 +=、-=、\*= 、/=、追加、扩展和移除等运算符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 参数提取器     | 大模型节点                                        | - **模型选择**：转换后，模型将被置空，需要重新选择。  - **推理模式**：AgentArts不支持推理模式。  - **记忆窗口**：AgentArts不支持记忆窗口。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| HTTP请求    | HTTP请求                                       | - **SSL证书验证**：AgentArts不支持验证SSL证书配置。  - **超时设置**：AgentArts不支持超时设置。  - **输出变量**：AgentArts输出变量不支持files文件列表。  - **失败重试**：AgentArts不支持失败时重试。  - **异常分支**：AgentArts不支持配置异常分支。  - **请求体格式**：AgentArts中的body不支持form-data、x-www-form-urlencoded、raw和binary格式。  - **请求方法**：仅支持GET和POST请求方法。   |
| 列表操作      | 无                                            | AgentArts不支持列表操作转换，将转换为空白节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 工具        | 插件或MCP                                       | AgentArts不支持工具转换，将转换为空白节点。可根据业务需要在AgentArts组件库中进行创建，详细步骤请参见[创建插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0125.html)或[创建MCP](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0319.html)。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 注释        | 注释                                           | 基本兼容                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 条件分支      | 判断                                           | - **判断条件子项**：AgentArts不支持判断条件子项进行判断。  - **条件判断**：AgentArts不支持条件判断中的"开始是"和"结束是"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 结束        | 结束                                           | **多个结束节点**：当Dify中存在多个结束节点时，转换后只保留一个结束节点，该结束节点将包含所有结束节点的输出参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
表2规格约束 
| 规格               | Dify                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | AgentArts                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| 输入/输出参数（名称、值、描述） | 参数名称长度限制无，值长度限制无，描述限制无。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 参数名称长度限制64字符，值长度限制100000字符，描述长度限制100000字符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 系统变量             | - **user_id**：String，用户ID。  - **app_id**：String，应用ID。  - **workflow_id**：String，工作流ID。  - **workflow_run_id**：String，工作流运行ID。  - **timestamp**：Number，应用开始运行的时间戳。  - **conversation_id**：String，会话ID。  - **dialog_count**：Number，会话次数。   | - **conversation_history**：Array\<Object\>，会话历史。  - **current_time**：String，当前系统时间。  - **user_id**：String，用户ID。  - **conversation_id**：String，会话ID。  - **dialogue_count**：integer，会话轮次。   |
| 注释的长度限制          | 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 100000字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 工作流节点的数量限制       | 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 节点中输入/输出参数的个数限制  | 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 判断节点的分支数量        | 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 节点名称             | 无                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 100000字符                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
#### 工作流相关操作
AgentArts同时支持对工作流执行复制、获取工作流ID、调用路径、删除、渠道管理等操作。
表3工作流相关操作 
| 类型         | 操作                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|
| 复制         | 鼠标移动到目标工作流，单击"复制"，即可复制该工作流。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 获取工作流ID    | 工作流应用除了具有页面操作的能力之外，还具有Chat API调用能力，因此获取AppID十分必要。该ID为调用Agent应用接口的agent_id字段。 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790312.png "点击放大") 鼠标移动到目标工作流，单击"复制ID"，可获取当前工作流ID。 弹出复制成功对话框，用于填写调用Agent应用接口的agent_id字段。 图7复制ID ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549803.png "点击放大")                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 调用路径       | 鼠标移动到目标工作流，单击"调用路径"，调用路径为工作流的API接口。详细API调用过程请参见[通过API调用工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0055.html)。 图8获取调用路径 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549795.png "点击放大")                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 删除         | 注意： 如果工作流已被引用，删除后引用将被自动取消，可能会导致其他工作流或智能体无法运行，且该操作不可撤回，请谨慎操作。 鼠标移动到目标工作流，单击"更多 \> 删除"，在弹出的对话框中单击"确定"。 - 如果工作流未被引用在弹窗中单击"确定"即可。 图9工作流未被引用 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389919.png "点击放大")   - 如果工作流被引用则删除后引用将自动取消，可能会导致工作流或应用无法运行，且该操作不可撤回。 图10工作流被引用 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389927.png "点击放大")                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 渠道管理       | 鼠标移动到目标工作流，单击工作流下方的"渠道管理"。 跳转至"发布管理"页面。详细操作可参见[发布并部署工作流](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0053.html)节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 查看工作流运行时数据 | - 在"智能体运行时"页面，通过搜索智能体ID搜索查看工作流运行时数据。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。  2. 在左侧导航选择"部署运行 \> 智能体运行时"，在搜索框中输入上方已获取的ID进行搜索。  3. 单击搜索到的工作流名称，进入详情页面查看工作流运行时数据。    - 在"运营运维 \> 观测 \> 智能体运行分析"页面，通过搜索智能体ID查看工作流运行时数据。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。  2. 在左侧导航选择"运营运维 \> 观测 \> 智能体运行分析"，在搜索框中输入上方已获取的ID进行搜索。  3. 单击搜索到的工作流名称，进入详情页面查看工作流运行时数据。     |
   
