管理工作流

Agentarts平台致力于提供高效、灵活的工作流管理解决方案。除了支持Agentarts工作流的导入导出，为了提升用户体验，Agentarts现支持Dify工作流的导入功能。用户可以轻松将现有的Dify工作流文件导入平台，在导入工作流时，将同步导入与工作流关联的插件等配置，实现无缝对接和高效管理。无论是复杂业务流程还是简单任务自动化，Agentarts都能快速导入、配置和执行Dify工作流，显著提高工作效率和操作便捷性。

导入、导出工作流

导入工作流。
- 导入Agentarts DSL文件
  1. 单击页面左上角“导入”下拉框，并选择“导入Agentarts工作流”。
    图1 导入Agentarts工作流
  2. 在“导入”页面，单击“选择文件”选择需要导入的jsonl文件，并单击“导入”。
    图2 导入工作流
    
    图3 导入状态
    如果应用关联的资源（如插件、MCP、知识库）导入失败，应用仍会正常导入，但这些资源将不会被导入。
    
    如果导入失败，可在操作列查看原因。
    
    如果导入的工作流中存在资源未配置鉴权，系统会标注“未配置鉴权”，单击操作列中的“配置鉴权”后可在配置鉴权窗口中进行操作。
  3. 选择导入文件后，选择解析内容。
    平台将自动解析jsonl文件。如果解析的文件已存在，勾选该文件将自动覆盖平台现有文件。
    
    仅支持上传jsonl格式文件，工作流文件的最大导入大小为128MB。
  4. 单击“导入”，导入成功的工作流将在“开发中心 > 应用管理 > 工作流应用”页面中展示。
- 导入Dify DSL文件
  1. 单击页面左上角“导入”下拉框，并选择“导入Dify DSL文件”。
  2. 在“导入Dify DSL文件”页面，单击“选择文件”选择需要导入的yml文件，并单击“导入”按钮。
    图4 导入Dify DSL文件
    
    仅支持上传.yml格式文件，最大支持128MB。
    
    为了更好的兼容，建议迁移之前将依赖的知识库/插件等资源同步到平台。
  3. 在Dify DSL文件迁移界面确认迁移结果，单击确定后工作流成功导入，可在工作流配置界面对需要调整和不兼容的节点或模型等进行修改。
    图5 Dify DSL文件迁移
    对于不兼容的节点新增空白节点（保留Dify工作流中的输入和输出参数），可在同步数据完成后在工作流编排页面进行节点替换。
    
    针对引用插件、MCP、模型等可根据需要重新配置鉴权。
导出工作流。平台支持导出工作流。导出工作流时，将同步导出工作流关联的插件等配置。
1. 单击页面右上角“导出”，选择目标工作流，导出工作流。或鼠标移动到目标工作流，单击“更多 > 导出”。
2. 在“导出工作流”页面选择工作流，单击“导出”。单击“下载”，工作流将以一个JSONL格式的文件下载至本地。
  图6 导出工作流
  - 如果应用关联的资源（如插件、MCP、知识库）导出失败，则导出的文件中将不包含对应资源。
  - 如果导出失败，可在操作列查看原因。
  - 如果导出的工作流中包含代码节点及其依赖包，导出的FunctionGraph资源将不包含这些依赖包。若需在不同租户对应的环境中导入该工作流，用户需在FunctionGraph中手动创建对应依赖包，私有依赖包上传方法请参见私有依赖包上传示例。

注意事项

Dify不支持知识库和自定义插件导出。如果Dify工作流中包含这些资源，用户需要手动在AgentArts中创建相应的知识库和自定义插件。详细操作请参见创建知识库和创建插件。
Dify的迁移功能基于Dify DSL 0.6.0版本（产品版本1.12.0）开发。请注意以下几点：
- 版本兼容性：不同DSL版本之间可能存在较大的结构差异，这可能导致存量数据在迁移过程中出现不兼容问题。
- 节点处理：不在节点列表中的Dify节点将默认转换为空白节点。
- 未来升级：Dify未来的DSL版本升级可能会影响迁移功能的兼容性。如果发现严重的兼容性问题，我们将在后续版本中进行调整和优化。

表1 Dify工作流转换支持情况说明
Dify	AgentArts	AgentArts兼容性
系统变量	系统参数	以下系统参数在导入AgentArts时暂不支持：会话次数：dialog_count。应用ID：app_id。工作流ID：workflow_id。工作流运行ID：workflow_run_id。运行开始时间戳：timestamp。
环境变量	无	AgentArts暂不支持环境变量，因此在转换过程中，Dify引用的环境变量将被转换为对应的环境变量值。
对话型工作流	全局配置	内容审查：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退出条件不支持选择循环内部节点。
代码执行	代码	代码执行：使用FunctionGraph替换，用户需要根据提供的模板重新适配代码。
模板转换	无	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组件库中进行创建，详细步骤请参见创建插件或创建MCP。
注释	注释	基本兼容
条件分支	判断	环境变量参数：AgentArts不支持使用环境变量参数作为条件左值。判断条件子项：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 工作流相关操作
类型	操作
复制	鼠标移动到目标工作流，单击“复制”，在“复制到”下拉框中选择已创建的目标空间，可复制当前工作流到目标空间。在复制到目标空间时，应用的配置参数、大模型、节点等数据将一并复制，且复制后的应用需要单独发布。图7 复制应用
获取工作流ID	工作流应用除了具有页面操作的能力之外，还具有Chat API调用能力，对于AppID获取就十分必要。该ID为调用Agent应用接口的agent_id字段。鼠标移动到目标工作流，单击“更多 > 复制ID”，可获取当前工作流ID。弹出复制成功对话框，用于填写调用Agent应用接口的agent_id字段。图8 复制ID
调用路径	鼠标移动到目标工作流，单击“调用路径”，调用路径为工作流的API接口。详细API调用过程请参见通过API调用工作流。图9 获取调用路径
删除	注意：如果工作流版本已被引用，删除后引用将被自动取消，可能会导致工作流或智能体无法运行，且该操作不可撤回。若该工作流应用已经共享，则用户无法直接删除，必须先手动完成“取消共享”操作后，才能在工作流应用界面删除应用。鼠标移动到目标工作流，单击“更多 > 删除”，在弹出的对话框中单击“确定”。如果工作流未被引用在弹窗中单击“确定”即可。图10 工作流未被引用如果工作流被引用则删除后引用将自动取消，可能会导致工作流或应用无法运行，且该操作不可撤回。图11 工作流被引用
渠道管理	鼠标移动到目标应用，单击应用下方的“渠道管理”。图12 渠道管理跳转至“发布管理”页面。详细操作可参见发布工作流节点。