节点参考 | LanSphere 使用手册

节点参考

节点是编排工作流与对话流的基本单元。在「应用开发」画布中,你可以通过点击的方式把节点加入画布,并按业务逻辑把它们连接起来,组成完整的应用流程。本篇按功能分组逐一介绍蓝域(LanSphere)提供的全部节点,说明每个节点的用途、关键配置项与输出内容,适合在编排过程中随时查阅。

阅读本篇前,建议你先了解两个基本概念:

  • 节点分组:画布中的节点列表按功能分为开始、AI 能力、逻辑控制、数据处理、外部调用、输出六组。节点列表可展开、收缩,并支持按名称模糊搜索,方便你快速定位所需节点。
  • 变量引用:上游节点的输出变量可以被下游节点引用。例如「输入」节点收集的用户问题,可以在「大模型」节点的提示词中作为上下文变量引用;「知识库」节点召回的片段,也可以传入下游节点参与后续处理。发布前,建议借助变量检查确认变量定义、类型匹配与引用有效性,确保流程配置完整。

开始

输入

接收用户输入的入口节点,对话输入与表单输入都从这里进入流程。

  • 关键配置:定义需要向用户收集的输入内容。
  • 输出内容:用户提交的输入,作为变量供下游节点引用。
  • 使用提示:「输入」节点全局唯一,一个应用只能有一个;画布中已存在该节点时,节点列表会自动隐藏它。

定时执行

按设定的周期规则自动触发应用运行,无需人工操作。

  • 关键配置:设定触发的周期规则。
  • 输出内容:按周期自动启动一次流程运行。
  • 使用提示:适用于定时报表、定时数据采集等周期性自动化场景。

Webhook 回调

生成一个回调地址,供外部系统调用该地址来触发应用运行。

  • 关键配置:按页面提示完成回调配置。
  • 输出内容:外部系统调用回调地址时传入的内容,供下游节点使用。
  • 使用提示:适用于由业务系统事件驱动的场景,例如外部系统产生新数据后自动触发处理流程。

AI 能力

大模型

调用大模型生成文本,是智能问答、内容生成、摘要提取等场景的核心节点。

  • 关键配置:选择要使用的模型;编写提示词,规范模型的应答规则;在提示词中引用上游节点的上下文变量。
  • 输出内容:模型生成的文本结果。
  • 使用提示:提示词质量直接决定输出质量,建议在提示词中明确任务目标、输出格式与约束条件。可用模型取决于「系统设置 → 模型列表」中已接入的模型。

知识库

在关联的知识库中检索与输入相关的内容,输出召回的知识片段。

  • 关键配置:关联一个或多个知识库;设置召回参数——Top K(默认 3)、Score 阈值(默认关闭)与检索方式(向量检索 / 全文检索 / 混合检索)。
  • 输出内容:召回的知识片段,供下游「大模型」等节点引用。
  • 使用提示:通常与「大模型」节点搭配使用,构成知识库问答链路;召回精度可通过调整 Top K、Score 阈值与检索方式逐步优化。

智能体

在流程中挂载一个已发布的智能体,由其自主统筹调度资源完成任务。

  • 关键配置:从已发布的智能体列表中单选一个挂载。
  • 输出内容:智能体的执行结果。
  • 使用提示:仅可挂载已发布的智能体;已发布的智能体可在「协作组件 → 智能体」标签页中查看。

意图识别

按语义把用户输入分类到不同分支,让流程根据用户意图走向不同的处理路径。

  • 关键配置:定义各意图分类及其说明。
  • 输出内容:识别出的意图分类结果,用于驱动后续分支走向。
  • 使用提示:典型场景如客服应用——先把用户提问按「咨询」「投诉」「售后」等意图分类,再分别进入对应的处理流程,让每类问题都得到针对性响应。

参数提取

从自然语言中提取结构化参数,把用户的口语化表达转换为流程可直接使用的字段。

  • 关键配置:定义需要从输入中提取的参数。
  • 输出内容:提取出的结构化参数,供下游节点引用。
  • 使用提示:适用于表单填写、查询条件解析等场景,例如从「帮我查一下下周的部门会议安排」中提取时间范围等参数。

逻辑控制

条件判断

按条件把流程拆分为多个分支,相当于 if / elif / else 结构。

  • 关键配置:配置各分支的判断条件。
  • 输出内容:根据条件成立情况,流程进入对应分支继续执行。
  • 使用提示:按 if / elif / else 结构组织分支时,请注意安排条件的先后顺序,确保每种情况都有明确的去向。

循环

按设定的条件重复执行一段流程,直到条件不再满足为止。

  • 关键配置:配置循环的执行逻辑与终止条件。
  • 输出内容:循环执行产生的最终结果。
  • 使用提示:请确保设置了可终止的条件,避免流程陷入无限循环。

批处理

对数组中的每一项并行执行相同的处理,一次性完成批量任务。

  • 关键配置:指定要处理的数组,以及针对每一项的处理逻辑。
  • 输出内容:各项处理结果组成的集合。
  • 使用提示:适用于批量处理同类数据的场景,例如对一批文档逐份生成摘要。

数据处理

脚本执行

使用 Python 或 JavaScript 编写自定义处理逻辑,完成内置节点无法直接实现的数据加工。

  • 关键配置:选择脚本语言并编写脚本,按页面提示完成配置。
  • 输出内容:脚本的执行结果。
  • 使用提示:适合格式转换、数据计算等个性化处理场景。

变量赋值

给变量写入或更新值,在流程中保存中间状态或构造新变量。

  • 关键配置:选择目标变量并设定要写入的值。
  • 输出内容:更新后的变量值。
  • 使用提示:常用于流程中对变量进行初始化或阶段性更新。

变量聚合

把多个分支的输出聚合成一个变量,供后续节点统一引用。

  • 关键配置:选择需要聚合的各分支输出变量。
  • 输出内容:聚合后的单一变量。
  • 使用提示:在多分支汇合的场景下,用变量聚合可以避免下游节点分别引用多个分支的输出,让流程结构更清晰。

变量格式化

按模板把多个变量拼接成一段文本。

  • 关键配置:编写文本模板,并在模板中引用需要拼接的变量。
  • 输出内容:拼接完成的文本。
  • 使用提示:适合生成结构固定的通知文案、报告段落等内容。

文档解析

从上传的文档文件中提取文本内容,供下游节点处理。

  • 关键配置:指定要解析的文档文件来源。
  • 输出内容:从文档中提取的文本。
  • 使用提示:常作为文档类应用的预处理环节,先解析文档,再交由大模型分析内容或生成摘要。

数组处理

对数组执行筛选、排序、取值等操作。

  • 关键配置:指定目标数组与处理方式。
  • 输出内容:处理后的数组或取出的元素。
  • 使用提示:适用于对上游输出的列表型结果做二次加工,例如筛选出符合条件的条目后再逐一处理。

外部调用

外部调用类节点把平台内外的工具能力接入流程。添加系统插件、工作流、MCP、自定义工具这四类节点时,点击后会弹出对应的工具列表供你选择。

HTTP 请求

调用外部 REST API,与开放接口的外部系统对接。

  • 关键配置:配置请求地址、请求方式、请求头、请求体与鉴权方式,并完成参数映射。
  • 输出内容:接口返回的响应内容。
  • 使用提示:服务地址、密钥等参数建议通过环境变量管理,避免在流程配置中明文暴露;设为保密变量后,变量值会以星号隐藏。

系统插件

调用平台内置的插件能力。

  • 关键配置:从系统插件列表中选择要调用的插件。
  • 输出内容:插件的执行结果。
  • 使用提示:可用插件取决于「插件管理」中已安装并启用的插件。

工作流

调用「协作组件」中已发布的工作流组件,实现流程复用。

  • 关键配置:从工作流组件列表中选择要调用的组件。
  • 输出内容:被调用工作流的输出结果。
  • 使用提示:工作流应用通过「发布为组件」沉淀为组件后,即可供全平台应用调用,详见《协作组件》。

MCP

调用 MCP 服务提供的工具。

  • 关键配置:从 MCP 服务列表中选择要调用的工具。
  • 输出内容:MCP 工具的执行结果。
  • 使用提示:平台预置蓝信 MCP 工具集,覆盖消息、群组、通讯录、日程、视频会议、媒体文件等能力;更多 MCP 服务可在「MCP 服务」菜单中添加。

自定义工具

调用团队自建的工具。

  • 关键配置:从自定义工具列表中选择要调用的工具。
  • 输出内容:自定义工具的执行结果。
  • 使用提示:自定义工具在「插件管理」中创建,需测试通过并保存后才可被调用。

输出

回复

在对话流中向用户输出消息,可在流程中途多次输出。

  • 关键配置:编写要发送给用户的消息内容,可引用上游变量。
  • 输出内容:向用户展示的消息。
  • 使用提示:仅用于对话流。借助多次输出,可以在较长的流程中及时向用户反馈阶段性进展。

输出

在工作流结束时返回最终结果。

  • 关键配置:定义需要返回的结果内容。
  • 输出内容:工作流的最终结果。
  • 使用提示:用于工作流。工作流接收输入直达输出、全程无交互,最终结果通过该节点交付。

节点速查表

节点 所属分组 一句话用途 典型场景
输入 开始 接收用户的对话或表单输入 各类应用的入口
定时执行 开始 按周期自动触发运行 定时报表、定时数据采集
Webhook 回调 开始 生成回调地址供外部系统触发 业务系统事件驱动
大模型 AI 能力 调用大模型生成文本 智能问答、内容生成
知识库 AI 能力 检索知识库并输出召回片段 知识库问答
智能体 AI 能力 挂载已发布的智能体 复杂任务自主执行
意图识别 AI 能力 把用户输入分类到不同分支 客服意图分流
参数提取 AI 能力 从自然语言提取结构化参数 查询条件解析
条件判断 逻辑控制 按条件走不同分支 多路径流程控制
循环 逻辑控制 按条件重复执行 反复处理直至满足条件
批处理 逻辑控制 对数组逐项并行处理 批量生成、批量处理
脚本执行 数据处理 Python/JavaScript 自定义逻辑 个性化数据加工
变量赋值 数据处理 写入或更新变量值 保存中间状态
变量聚合 数据处理 聚合多分支输出为一个变量 多分支结果汇合
变量格式化 数据处理 按模板拼接文本 通知文案生成
文档解析 数据处理 从文档中提取文本 文档内容预处理
数组处理 数据处理 数组筛选、排序、取值 列表结果二次加工
HTTP 请求 外部调用 调用外部 REST API 系统间数据对接
系统插件 外部调用 调用平台内置插件 使用内置工具能力
工作流 外部调用 调用工作流组件 跨应用流程复用
MCP 外部调用 调用 MCP 服务工具 蓝信消息、日程等操作
自定义工具 外部调用 调用自建工具 团队专属能力
回复 输出 对话流中向用户输出消息 多轮对话应答
输出 输出 工作流结束时返回结果 单轮自动化交付