NL2Workflow 如何通过多轮对话生成 Mermaid 流程图和 DSL 代码？

华为云 AgentArts 的 NL2Workflow 可以把自然语言业务需求转换为 Mermaid 格式的工作流设计图和 DSL JSON 代码，并通过多轮对话持续补充节点、条件和异常路径。用户在思考结果满足要求后点击“确定生成”，平台才创建工作流应用。生成结果仍需进入编排画布配置节点输入输出、试运行并提交版本，不能把 Mermaid 预览或 DSL 草稿直接视为可上线工作流。

NL2Workflow 适用于什么场景

NL2Workflow 适合快速建立原型，尤其是业务目标明确但不想从空白画布逐个添加节点的场景。例如假期审批、简历初筛、智能天气决策和信贷分级审批。

官方文档同时给出三种创建方式：

• 从空白创建：可控性强，适合复杂且需要精细配置的逻辑。
• AI 辅助创建：自然语言快速生成原型，但可控性较弱且依赖输入数据。
• 使用预置应用：上手快，但定制能力有限。

AI 辅助创建当前只支持对话型工作流，不支持任务型工作流。需要定时触发器等任务型能力时，应改用常规创建方式。

开始前需要满足哪些条件

• 已经开通 AgentArts 服务。
• 目标模型已接入 AgentArts 并通过鉴权验证。
• 拥有目标空间和工作流创建权限。
• 明确应用是对话型工作流。
• 准备不含敏感凭据的业务需求。

模型状态为未验证或失败时不可使用。还应确认套餐允许创建的应用数量和模型调用费用。

从工作流管理页面开始创建

1. 登录 AgentArts 智能体平台。
2. 进入“开发中心 > 智能体管理”。
3. 打开“工作流”页签。
4. 点击右上角“创建工作流”。
5. 进入“创建对话型工作流”页面。
6. 点击“AI 辅助创建”。
7. 选择任务示例，或输入自己的任务。
8. 在输入框左下角选择模型和“工作流应用”。
9. 点击发送进入思考界面。

也可以从总览页的快速创建区域进入 AI 辅助创建。无论入口如何，最终都应确认选择的是工作流应用而不是其他生成类型。

第一轮需求应该怎样写

第一轮应描述业务目标、输入、步骤、条件、输出和失败处理。例如：

创建一个假期审批对话型工作流。
输入包括申请人、假期类型、开始日期、结束日期和原因。
先校验日期与剩余额度；校验失败时返回具体原因。
不超过3天由直属经理审批，超过3天增加部门负责人审批。
审批通过后写入休假记录并通知申请人；拒绝时返回拒绝意见。

不要只写“创建假期审批工作流”。没有输入字段、判断规则和输出约束时，系统只能自行补充假设。

多轮对话怎样补全需求

思考界面会展示工作流设计结果。如果不满足要求，可以继续输入指令，而不是立即确定生成。推荐按以下顺序迭代：

1. 确认主路径和节点顺序。
2. 补充判断条件与每个分支。
3. 补充失败、超时和重试。
4. 明确输入输出字段。
5. 统一节点名称和变量。
6. 最后确认是否生成。

每轮只修改一个主题，便于确认系统是否正确理解。

第二轮：补充条件

补充规则：跨年假期直接转人工审核；开始日期不得早于当前日期。不要改变其他流程。

第三轮：补充异常

额度查询失败时重试一次；仍失败则返回“系统繁忙”，不要进入审批节点。

第四轮：明确输出

结束节点统一输出 status、message 和 request_id。通过时 status 为 approved，拒绝时为 rejected。

“完善一下”“更智能”等指令缺少验收条件，容易引起大范围重写。

Mermaid 流程图起什么作用

Mermaid 用于把节点和连接可视化，方便在确认生成前检查主路径。示意结构可能如下：

flowchart TD
    A[接收假期申请] --> B{日期和额度有效}
    B -- 否 --> C[返回校验原因]
    B -- 是 --> D{假期超过3天}
    D -- 否 --> E[直属经理审批]
    D -- 是 --> F[部门负责人审批]
    E -- 通过 --> G[写入休假记录]
    F -- 通过 --> G
    E -- 拒绝 --> H[返回拒绝意见]
    F -- 拒绝 --> H

Mermaid 能帮助检查路径，但不包含平台节点的全部运行参数。图画正确不代表变量引用、模型配置和插件鉴权已经完成。

DSL JSON 起什么作用

DSL 是工作流的结构化机器表示，用 JSON 描述节点、连接、参数和配置，使平台可以据此创建可执行应用。它与 Mermaid 面向不同用途：

• Mermaid：便于人理解流程拓扑。
• DSL JSON：便于系统创建和配置工作流。

DSL 不应当作普通说明文字阅读后直接信任。应检查 JSON 结构、节点类型、变量名、引用关系和条件表达式。

如何检查生成的 DSL

1. 确认开始节点包含必要输入。
2. 确认每个节点类型符合用途。
3. 确认节点名称唯一。
4. 检查连接与 Mermaid 一致。
5. 检查输入引用来自已执行节点。
6. 检查输出类型与下游参数匹配。
7. 检查条件分支覆盖所有情况。
8. 确认结束节点返回所需字段。

同一个工作流画布不允许节点重名。对象类型还要关注嵌套层级和 JSON 结构。

什么时候点击“确定生成”

只有在思考结果同时满足以下条件时才应确认：

• 主路径与业务一致。
• 每个判断都有完整出口。
• 异常路径不会误入成功分支。
• 关键输入输出已经明确。
• 没有虚构插件或数据源。
• 节点命名便于后续配置。

点击确定生成后，AgentArts 根据工作流设计图创建应用并进入预览。

生成后的两个去向

预览界面提供“前往编辑”和“提交版本”：

• 前往编辑：进入工作流编排页面，扩展能力并配置参数。
• 提交版本：将已确认且测试通过的工作流提交发布。

首次 AI 生成后不建议直接提交版本。应先进入编辑页面检查节点配置和执行结果。

如何在画布中完善工作流

1. 检查开始、大模型和结束节点。
2. 按业务添加基础、逻辑、工具、消息或变量节点。
3. 按执行方向连接节点。
4. 配置每个节点的输入参数。
5. 配置输出并绑定到下游引用。
6. 检查问题清单。
7. 执行试运行和调试。

删除节点会永久清除该节点配置数据，应先确认引用关系。开始和结束节点不能删除。

怎样配置模型节点

大模型节点是可选的。需要模型处理文本时，应配置已部署模型、提示词、参数和输出；纯规则或插件流程可以删除不需要的大模型节点。

模型标签可能显示联网、思考和工具能力。选择时不仅看名称，还要确认鉴权状态、上下文限制、数据政策和费用。

全局配置需要检查什么

• 默认模型：影响新增节点的默认选择。
• 对话体验：开场白和推荐问题。
• 追问：是否自动生成后续问题。
• 记忆变量：会话级变量和默认值。
• 内容审核：输入、输出至少开启一项。

工作流发布后的版本是独立资源，不支持修改其全局配置。变更后需要形成新版本。

如何设计记忆变量

记忆变量支持 string、number、boolean、object、integer 和 array。名称只能包含字母、数字和下划线，且不能以数字开头。对象最多支持 5 层嵌套。

记忆变量是会话级的，会话结束后恢复默认值。不能用它替代持久数据库，也不要把长期敏感信息放入默认值。

如何配置内容审核

官方文档要求审查用户输入或审查应用输出至少开启一项。可以配置多条规则、关键词和处理策略：

• 输入命中时返回预设文案。
• 输出命中时替换内容。
• 输出命中时屏蔽内容。

关键词匹配只能覆盖明确模式，不能替代权限控制、数据脱敏和模型安全测试。

如何试运行与调试

1. 点击画布右上角“试运行”。
2. 输入正常业务请求。
3. 检查最终回复和变量值。
4. 进入“调试”查看运行结果与调用详情。
5. 再测试缺少字段、边界值和异常输入。
6. 修复后重复测试。

至少覆盖正常、拒绝、超时、插件失败和模型输出异常。只测一条成功路径不足以证明可执行。

Mermaid、DSL 与运行画布如何保持一致

多轮对话阶段的 Mermaid 和 DSL 是生成依据，最终执行以 AgentArts 编排画布中的实际节点配置为准。进入编辑页后手工变更可能使早期设计图不再完全代表当前版本。

建议在提交版本前重新记录：

• 最终节点清单。
• 关键连接和条件。
• 输入输出 Schema。
• 模型与插件依赖。
• 测试用例和结果。

如何处理版本发布

测试通过后点击“提交版本”，填写清晰的版本名称，再发布到目标渠道。发布历史支持查看和还原版本，但删除发布版本不可恢复，还可能影响现有渠道调用。

版本名称应表达变化，例如“v1.2-增加跨年假期人工审核”，而不是只写“最新版”。

费用和权限边界

不同套餐允许创建的应用数量不同，模型推理和插件调用也可能产生费用。生成前确认：

• 空间与 IAM 权限。
• 模型接入和鉴权状态。
• 模型调用计费。
• 插件访问的数据范围。
• 发布渠道权限。

不要在提示词、DSL 或默认变量中硬编码密钥。使用平台提供的凭据和权限机制。

常见问题如何排查

找不到 AI 辅助创建

确认选择的是对话型工作流，并检查服务、区域、套餐和权限。任务型工作流不支持该入口。

模型下拉框不可用

检查模型是否已接入 AgentArts，鉴权状态是否为成功。未验证和失败状态不可使用。

思考结果遗漏条件

不要立即生成。在下一轮明确条件、出口和不允许改变的其他流程，直到设计结果满足要求。

Mermaid 图正确但应用运行失败

检查 DSL 和画布节点的输入输出、变量引用、模型与插件配置。Mermaid 只表示拓扑，不能验证运行参数。

节点引用为空

确认上游节点一定执行并输出对应字段，检查字段类型和路径，避免引用条件分支中未执行节点。

发布后不能修改全局配置

已发布版本是独立资源。回到编辑态修改后提交新版本，不要尝试直接改变旧版本。

定时触发器不可用

触发器只支持任务型工作流，而 NL2Workflow AI 辅助创建当前只支持对话型工作流。应改用任务型常规创建。

最终验收清单

1. 应用确认为对话型工作流。
2. 模型已接入且鉴权成功。
3. 多轮对话已补齐主路径和异常。
4. Mermaid 节点和边符合业务。
5. DSL JSON 的类型、引用和分支正确。
6. 画布节点输入输出已配置。
7. 内容审核至少开启输入或输出之一。
8. 正常与异常用例均试运行通过。
9. 费用、权限和外部依赖已确认。
10. 提交版本名称能够说明变化。

总结

NL2Workflow 用多轮自然语言对话生成 Mermaid 设计图和 DSL JSON，可以快速建立 AgentArts 对话型工作流原型。正确流程是先描述业务，再逐轮补齐条件、异常和输入输出，确认设计后进入画布配置与调试，最后提交版本。Mermaid 负责可视化，DSL 负责结构化创建，真正运行仍取决于画布中的参数、模型和插件。只有三者一致并通过正常与异常测试，生成的工作流才具备发布条件。