工作流

一、什么是工作流？

工作流是一种更为灵活的智能体搭建方式。通过工作流，您可以像拼积木一样自由组合各类节点（应用、知识库、插件、数据库、逻辑判断等），让AI智能体具备更强的流程化处理能力。

它不仅能回答问题，还能按照预设流程执行任务、调用外部工具、自动发送消息、转人工，非常适合企业级复杂业务场景。

工作流的核心特点：

1. 可视化搭建：提供拖拽式界面，业务人员无需写代码，也能快速看懂并修改流程图
2. 场景化设计：支持十余种节点自由组合，覆盖咨询、客服、任务调度、运营推送等全流程
3. 多应用融合：可组合多个智能体，基于用户意图动态选择不同应用（如电商场景的选品、下单、售后）
4. 定时任务触发：支持自然语言配置时间规则（如"每天9点"），定时启动工作流
5. 主动消息推送：支持将结果发送到指定渠道，实现提醒、群发、运营通知等功能
6. 快速集成：支持自建部署、托管接入、API接入，快速连接微信公众号、企业微信、钉钉、飞书、Web端等渠道

工作流节点说明

工作流编排支持通过节点编排的形式决定工作流Agent每一步需要执行的任务，应用将会从开始节点起按照编排顺序执行。

如何接入和使用？

你精心搭建的工作流可以通过多种方式对外提供服务：

1. 渠道接入：一键授权，即可将工作流接入到微信公众号、企业微信、钉钉、飞书等平台，成为这些平台上的智能机器人。

2. API接入：通过标准的API接口，让你的任何现有业务系统都能调用工作流的强大能力，实现深度集成。

二、节点说明

2.1 开始节点

1. 新建工作流时，系统会自动生成开始节点，这是流程必备，无法删除。

2. 在开始节点中可预先定义需要的变量，方便后续节点使用。

当工作流接入渠道端时，用户的输入会作为开始节点的输入，作为回复返回给用户。

2.1.1 默认变量

文字输入

1. 用户提问时输入的文字。
2. 在发布时，可设置是否启用、是否必填。
3. 在渠道端接入时，该变量默认启用，用户发送的文字即为输入。

图片输入

1. 用户发送的图片。
2. 发布时，可设置是否启用、是否必填。
3. 渠道端接入时，只要启用该变量：
   • 用户直接发图即可触发工作流；
   • 或设置为"发图+文字"才触发。
4. 图片仅可在图像识别插件节点使用。

参数设置：

• 变量显示名称：默认图片
• 是否必填：可选
• 输入提示：请上传图片

渠道端运行条件：

文件上传

1. 用户发送的文件。
2. 广场发布时，可设置是否启用、是否必填。
3. 渠道端接入时，只要启用该变量，用户发文件即可触发工作流。
4. 文件可在内容总结插件、大模型、渠道发送等节点中使用。

参数设置：

• 变量显示名称：默认文件
• 是否必填：可选
• 输入提示：请上传文件

2.1.2 自定义变量

文本变量

1. 添加文本类型的自定义变量（以字符串存储），变量名在工作流内不可重复；

2. 变量显示名称可自定义，即发布时运行表单中用户看到的字段名称；设置是否必填能够控制工作流变量字段运行表单内的必填性。

新增变量：

参数设置：

• 变量显示名称：新变量
• 变量名：new_variable
• 是否必填：可选
• 输入提示：请输入内容

单选变量

1. 单选字段，可预设选项，至少包含一个。
2. 可设置默认值，用户提交表单时系统会默认选中。

2.1.3 系统变量

系统会在运行时自动生成以下变量，可在任意节点引用：

1. 当前时间：获取系统执行时的时间。

2. 发送人昵称：获取用户昵称（支持微信、企微、钉钉、飞书等渠道，规则因渠道不同而略有差异）。

3. 群名称：获取群聊名称（支持企微、微信、钉钉、飞书群聊）。

不同渠道下的昵称规则：

微信：

• chatgpt-on-wechat → 好友备注（无备注时取昵称）
• 元智启托管 → 微信昵称

企微：

• 与微信好友对话 → 微信昵称
• 与企微好友对话 → 企微账号姓名

微信客服：用户微信昵称

企微应用：企微账号姓名

钉钉：钉钉账号昵称

飞书：飞书账号姓名

2.1.4 变量引用

1. 所有变量（默认、自定义）都能在任意节点中引用，作为输入或输出。

2. 也可以通过API传参，动态赋值。

常见用法举例：

1. 在分支节点引用变量 → 用于判断分支条件。

2. 在大模型节点引用变量 → 作为动态上下文输入给模型。

3. 在插件节点引用变量 → 作为调用第三方服务的输入。

2.2 智能体节点

智能体节点用于在工作流中调用已经创建的知识库智能体或轻量智能体，让不同应用在同一流程中扮演不同"角色"。

可以将多个应用引入同一个工作流，例如：

1. 有人想了解产品 → 这时你应该请"售前咨询专家"来回答。
2. 有人想退换货 → 这时你应该请"售后服务专家"来处理。
3. 有人想查询技术问题 → 这时你应该请"技术支持专家"来解答。

支持上下文记忆，智能体可以结合之前的对话历史，更自然、连贯地进行推理和回复。通过灵活组合多个智能体节点，可以搭建出贴近真实业务的「数字员工团队」。

2.2.1 配置说明

2.3 大模型节点

大模型节点是工作流的"核心大脑"。在运行过程中，它会将前序节点的输出内容（或自定义文本）作为输入问题，并结合系统提示词进行推理，由所选的大语言模型生成回复。

在元智启平台中，大模型节点支持调用元智启全系列模型，覆盖市面主流大模型

包括：DeepSeek（深度求索）、文心一言（Baidu Wenxin）、通义千问（Qwen）、讯飞星火（Xunfei Spark）、智谱ChatGLM、Kimi（月之暗面）、豆包（Doubao）等

主要能力：

1. 支持选择任意大模型（可灵活切换）
2. 支持配置系统提示词，设定机器人身份、语气、能力
3. 支持引用其他节点输出作为输入问题（默认取上一节点）
4. 支持调整温度参数，控制回复的严谨性与创造性
5. 支持开启上下文记忆，保留多轮对话记录（最多10轮，默认保留30分钟）
6. 支持结构化输出，以JSON格式提取变量，传递给后续节点

2.3.1 配置说明

2.3.2 高级用法：结构化输出

大模型节点不仅能自然语言回复，还能进行参数提取：

1. 定义输出变量，让模型从输入问题中提取关键参数

2. 输出格式为JSON，后续节点可直接引用变量

3. 可与数据库、插件、API结合，实现自动化处理

示例：

1. 用户输入："帮我预约明天下午两点的心内科门诊"

2. 大模型结构化输出：

   { "科室":"心内科", "时间":"明天下午2点" }
   

3. 后续"医院预约插件节点"即可直接调用这些变量完成挂号。

2.4 知识库节点

知识库节点支持在工作流中调用已创建的知识库进行检索，输出与输入内容相关的知识片段。常与大模型节点搭配使用，由知识库提供素材，大模型进行总结与生成自然语言。

2.4.1 配置说明

2.5 数据库节点

数据库节点为大模型提供访问结构化数据的能力，可在工作流中实现数据查询与处理。通过该节点，用户无需编写复杂SQL，就能让模型结合业务语境访问数据库，从而满足数据分析、统计报表、业务逻辑控制等场景需求。

主要功能：

1. 支持数据库类型：可接入远程数据库（如MySQL、PostgreSQL等），也可使用平台托管的内置数据库。
2. 多样化操作：在权限范围内，支持查询、新增、更新、删除操作（远程数据库仅支持查询）。
3. 智能SQL生成：AI可根据节点输入（自然语言或结构化输入）提取关键信息，并自动生成SQL语句。
4. 灵活编排：可与大模型节点配合，对原始数据进行总结、统计或格式化；也可与分支节点配合，在不同业务场景下访问不同数据库。

2.5.1 配置说明

2.5.2 使用示例

数据查询：

1. 用户输入："查询上周新增客户数"
2. 数据库节点：将输入解析为SQL查询 → 输出结果
3. 大模型节点：将结果转换为自然语言 → 输出："上周共新增45位客户。"

最佳实践：

1. 对外部数据库需配置账号权限，建议采用只读账号以保证安全。

2. 对于统计、报表类任务，推荐数据库节点 + 大模型节点组合，数据库提供数据，大模型生成自然语言报告。

3. 在复杂业务流程中，可结合分支节点，实现基于条件的不同数据库操作。

2.6 插件节点

插件节点是元智启工作流中最具扩展性的能力之一，它允许用户将内置插件或自定义插件引入到工作流中，实现与外部系统或服务的交互，从而大幅度拓展工作流的应用边界。

2.6.1 配置说明

2.6.2 使用示例

信息检索插件：

1. 输入："帮我查最新的医疗政策"
2. 插件节点：调用内置搜索插件 → 返回搜索结果（文本列表）
3. 大模型节点：对搜索结果进行筛选和总结 → 输出自然语言答案

最佳实践：

1. 内置插件适合快速调用通用功能，自定义插件适合对接企业内部系统。
2. 插件节点的输出多为"原始结果"，建议在后续加大模型节点进行包装。
3. 在复杂场景中，插件节点可配合分支节点使用，实现条件判断 + 外部调用的组合逻辑。

2.7 意图分支节点

意图分支节点用于通过大语言模型的意图识别能力，对用户输入或上游节点输出进行语义理解，并根据识别结果自动选择不同的分支路径。

2.7.1 配置说明

2.7.2 使用示例

医疗导诊分流：

1. 输入："我头疼两天了，挂哪个科室？"

2. 意图分支节点：

   • 分支1：健康咨询（描述：涉及症状、病情咨询）
   • 分支2：挂号预约（描述：涉及挂号、预约、挂科）
   • 模型识别 → 命中分支2

3. 输出：进入"挂号预约"分支流程。

提示与最佳实践：

1. 分支描述越具体，意图判断越准确，避免过于模糊的分支规则。

2. 开启记忆功能适用于连续对话场景，但需注意历史内容可能包含与本节点无关的信息。

3. 默认分支是兜底保障，推荐始终配置，以避免流程断开。

2.8 逻辑分支节点

逻辑分支节点用于基于明确的变量值和逻辑条件来决定流程走向。与"意图分支节点"不同，逻辑分支更强调结构化规则，适合处理对数值、布尔值、文本匹配等有清晰判断标准的业务逻辑。

主要特性：

1. 规则驱动：通过"参数值 + 运算符 + 值"的方式定义条件。
2. 多条件支持：同一分支下支持多个条件，可使用 AND / OR 组合。
3. 多分支选择：可设置多个分支，系统根据条件依次判断并选择匹配的分支。
4. 默认分支：若所有条件都不满足，将自动进入默认分支，保证流程完整性。

2.8.1 配置说明

2.8.2 使用示例

医疗导诊逻辑分流：

条件设置：

1. 分支1：若"症状节点输出包含发烧"且"年龄>65" → 高风险挂号分支
2. 分支2：若"症状节点输出包含咳嗽" → 普通内科挂号分支
3. 默认分支：其他情况 → 健康咨询分支

流转结果：患者输入"我65岁，发烧两天" → 命中分支1。

提示与最佳实践：

1. 逻辑分支适合规则清晰的场景，如数值判断、布尔值判断、文本匹配。

2. 对模糊表达、自然语言类意图，推荐使用意图分支节点。

3. 为避免流程中断，建议始终配置默认分支。

4. 对复杂场景，可以逻辑分支+插件节点联合使用，例如：先通过插件获取外部系统的返回结果，再根据返回码进行逻辑判断。

2.9 固定内容节点

固定回复节点用于在工作流中输出固定内容，无需依赖任何输入。

主要特性：

1. 无输入依赖：该节点不读取前序节点输出作为必要输入，可独立输出固定文本。

2. 插入变量：可选择插入多个前序节点的输出或自定义文本，与固定内容组合后作为节点输出。

3. 易于使用：适合用于业务提示、标准回复、流程结束语等场景。

2.9.1 配置说明

2.9.2 使用示例

流程提示：

1. 固定内容："请根据提示完成下一步操作。"

2. 自定义文本可添加具体步骤说明

3. 流程：逻辑分支节点 → 固定回复节点

4. 最终输出："请根据提示完成下一步操作："

2.10 转人工节点

转人工节点用于在工作流中将对话交给人工处理，适用于专业版及以上版本。

主要特性：

1. 直接转人工：走到该节点时，自动触发对话转人工流程。

2. 人工提醒：可向指定人员发送消息通知，确保人工及时处理。

3. AI回复策略：转人工后可选择是否继续让AI回延迟回复或不回复。

2.10.1 配置说明

2.11 渠道发送节点

渠道发送节点用于将工作流中的内容主动发送到接入渠道，结合定时任务可实现定时推送，支持托管渠道与 Webhooks 两种方式。

2.11.1 托管渠道发送

版本要求：专业版及以上

2.11.2 Webhook推送

版本要求：全部版本可用

2.11.3 配置示例

钉钉：

1. 在钉钉群聊设置 → 添加机器人 → 自定义机器人 → 添加，在机器人命名页面选择安全设置为加密

2. 复制生成的Webhook地址与Secret填写到节点

飞书：

1. 在飞书群聊设置 → 群机器人 → 添加机器人 → 自定义机器人 → 在机器人添加页面复制生成的Webhook地址；选择安全设置为签名校验，复制生成的密钥，点击保存

2. 复制生成的Webhook地址与Secret填写到节点

企微：

1. 在企微群聊设置 → 添加群机器人 → 新建机器人 → 命名机器人，复制Webhook地址填写到节点

2.12 代码节点

代码块节点用于在工作流中执行自定义代码逻辑，支持 Python 和 JavaScript 两种语言，通过处理输入变量生成新的输出参数，供后续节点使用，实现工作流的高度灵活编排。

主要特性：

1. 语言支持：Python与JavaScript

2. 输入参数：可引用前序节点输出或开始节点定义的变量

3. 输出结果：支持将执行结果以结构化JSON格式输出，可被后置节点引用

4. 应用场景：逻辑计算、数据处理、接口调用、参数转换、复杂条件判断等

代码块节点能显著提升工作流智能体的扩展能力，使开发者可以自定义业务逻辑，灵活处理各类复杂场景。

2.12.1 配置说明

2.12.2 使用步骤

1. 选择输入变量：

在节点中选择前序节点输出或开始节点自定义变量作为代码块输入参数，系统会自动生成函数的入参列表，无需手动修改

2. 编写函数逻辑：

Python示例：

def run(input1, input2):
    total = input1 + input2
    return {"total": total}

JavaScript示例：

function run(input1, input2) {
    const total = input1 + input2;
    return { total };
}

可在函数中执行复杂逻辑、调用接口、进行数据计算等

3. 输出结果引用：

代码块执行后生成的JSON输出变量，可在后续节点直接引用

后续节点示例：

1. 大模型节点：将计算结果作为模型输入，并优化总结输出
2. 渠道发送节点：将处理结果推送给用户
3. 知识库/插件节点：作为进一步操作的输入参数

2.13 结束节点

1. 新建工作流时，系统会自动生成结束节点，这是流程必备，无法删除。

2. 所有流程分支必须最终回到结束节点，确保流程闭环。

系统会将结束节点前的输出作为回复返回给用户。

2.13.1 音色选择

在工作流中选择音色后：

1. 网页端对话：系统会将工作流的文字回复转成对应音色的语音播报。

2. 支持语音对话的渠道端（如企微、微信、企微应用、微信客服、钉钉、飞书、公众号）：可直接用所选音色进行语音回复，实现更自然的语音交互。

2.13.2 分段、合并与延迟回复

1. 分段回复：将较长的回复内容随机拆分为多段发送，避免一次性输出过长文本。

2. 合并回复：在设定的时间内，用户连续提出的问题会被合并为一个整体，再生成统一回复。

3. 延迟回复：可单独使用（延迟一段时间后再回复），也可与「合并回复」配合，系统会收集用户在延迟时间内的所有问题，一次性生成回复。

应用场景：

1. 分段回复：提升对话的自然感，模拟真人逐步回复。

2. 合并+延迟回复：适合需要等待用户补充信息的场景，如「多条件查询」「多轮收集信息」。

三、工作流调试

3.1 单节点调试

单节点调试允许你在工作流编排页面中，仅运行流程中的某一个节点，并基于手动输入或模拟的上游输出，快速查看该节点的执行结果与日志信息。

优势：

1. 更快定位问题：缩小排查范围，不必每次拉起整条流程。

2. 更高可重复性：固定输入 → 反复调试，直至结果稳定。

3. 更低风险：对有副作用的节点（如写库/发送消息），可使用Mock或沙箱环境先验证逻辑。

流程：选中节点 → 点击调试 → 输入测试文本（即该节点"输入"） → 点击开始调试 → 查看输出。运行成功显示绿色标识；失败显示红色标识。

3.2 整体调试

整体调试模块允许你在编排页面一次性运行整条工作流，无需逐节点单独调试。通过整体运行，可以同时观察：

1. 全流程节点的执行轨迹与结果（每个节点的输入、输出、状态）

2. 工作流的最终输出结果（整个流程的综合产出）

3. 历史运行记录（便于回溯、复现与问题排查）

这一能力帮助用户快速验证全链路逻辑，适用于上线前联调、回归测试以及实际运行效果检验。

3.2.1 使用说明

1. 进入【工作流编排】页面。

2. 点击右上角的【整体调试】按钮

3. 在弹出的运行面板中输入测试内容（即工作流的入口参数）。

4. 点击【开始调试】，系统会依次执行工作流中的所有节点。

5. 运行结果展示：

   • 页面下方按节点顺序展示各节点的输入、输出及运行状态。
   • 成功节点显示绿色标识；失败节点显示红色标识。
   • 流程若在某一节点失败，将终止后续执行。

3.2.2 查看调试历史记录

调试记录：

1. 点击页面顶部【历史记录】，可查看该流程单节点调试及整体调试的历史运行记录。

2. 每条记录均包含运行时间、运行结果（成功/失败）、各节点执行详情。

定时运行记录：

若该工作流设置了定时任务，可在编排页面顶部的【定时运行-历史记录】查看定时触发的执行情况。

广场对话运行记录：

当工作流在应用广场/对话场景中被调用时，可前往我的账户-积分消耗记录详情 ↗查看运行情况。

渠道调用运行记录：

若工作流被外部渠道（如微信公众号、企业微信、API接口）触发，同样可在我的账户-积分消耗记录详情 ↗中查看。

注意事项：

1. 真实执行：在网页端运行整体流程时，会真实调用工作流中的所有节点。如包含外部交互节点（如自定义插件、HTTP API、渠道发送、转人工等），将会真实触发。

2. 风险提示：若节点包含写数据库、发送消息、调用外部系统等操作，请先在测试环境或使用模拟数据进行调试，以免影响生产系统。

3. 调试与发布区分：建议上线前先通过整体调试验证逻辑正确性，再切换至生产环境。

常见问题速查：

1. 为什么流程中断？ 任意节点失败时，整体运行会终止。可进入历史记录查看失败节点的日志。

2. 能否跳过失败继续？ 当前版本默认失败即中断。如需跳过/兜底，可在编排时增加异常处理逻辑。

3. 记录保存多久？ 历史运行记录保存周期以平台策略为准，支持导出关键运行结果。

四、工作流发布

在完成工作流编排与调试后，你可以通过【发布】功能，将工作流投入实际使用。元智启平台提供了两类发布方式：

1. 发布到智能体广场 → 供他人搜索与体验

2. 发布到多种渠道 → 接入钉钉、飞书、微信、企微、API、网站等终端应用中

通过灵活的发布方式，你可以让工作流不仅仅停留在编排页，而是落地到真实业务场景中，为企业和个人提供高效的AI能力支撑。

4.1 发布方式

4.2 使用说明

4.2.1 发布到应用广场

1. 完善必要信息（头像、名称、描述、分类）。

2. 在【工作流编排】页面，开启【是否公开】，并点击顶部【发布到广场】按钮即可上架。

3. 发布成功后，工作流会出现在应用广场，其他用户可搜索并直接体验。

4. 修改工作流后需重新点击【发布到广场】，广场才会显示最新版本。

5. 关闭「是否公开」开关，工作流将从广场下架。

4.2.2 发布到渠道

完成调试后，可将工作流发布到各种渠道中，在终端应用中使用。目前支持将工作流发布到钉钉、飞书、微信、企业微信、微信客服、API接入、企微应用、微信公众号、网站集成多个渠道中，你可以根据个人需求和业务场景选择合适的渠道。

4.2.3 开放API接入

能力与适用场景：

工作流在调试通过后，可通过API接入被第三方系统直接调用，实现"后端一条接口，前端多端触达"的落地方式。

详见：开放API接入