协作组件

协作组件用于把可复用的能力沉淀为组件，供全平台的应用调用。当一段业务逻辑在多个应用中反复出现时，你可以把它封装为协作组件统一维护，各应用直接调用，无需重复搭建。本篇介绍蓝域（LanSphere）协作组件的三个标签页，以及片段的创建、编辑、发布、权限与调用方法，适合负责搭建和维护公共能力的开发人员阅读。

注意：「协作组件」入口仅开发人员及以上角色可见。

为什么需要协作组件

在团队搭建应用的过程中，常常会出现这样的情况：多个应用都要做同一件事——比如都要把查询结果整理成统一格式的通知、都要走同一段数据校验逻辑。如果每个应用各自搭建一遍，不仅浪费精力，业务规则调整时还要逐个应用修改，容易出现口径不一致。

协作组件正是为解决这个问题而设计的：把这类通用逻辑封装为组件并发布后，全平台的应用都可以直接调用它。逻辑只在组件里维护一份，调用方始终获得一致的处理结果。

三个标签页

协作组件包含「片段」「工作流」「智能体」三个标签页，各标签页支持独立的搜索、筛选与添加。

标签页	来源	用途
片段	在协作组件中直接创建并发布	封装标准化通用业务逻辑，供各类工作流调用
工作流	工作流通过「发布为组件」发布后自动同步至此	供其他应用通过「工作流」节点调用
智能体	已发布的智能体自动同步至此	供其他应用通过「智能体」节点调用

三个标签页的分工各有侧重：片段面向通用的业务逻辑单元；工作流标签页汇集的是完整的工作流应用沉淀出的组件；智能体标签页则汇集平台中已发布的智能体。

片段

什么是片段

片段是封装标准化通用业务逻辑的独立单元。凡是跨应用反复使用的处理逻辑——例如统一格式的文案生成、标准化的数据清洗规则、固定的信息校验流程——都适合沉淀为片段，供各类工作流直接调用。逻辑集中维护在一处，调用方始终获得一致的处理结果。

创建与编辑

创建片段的基本步骤：

进入左侧菜单「协作组件」，切换到「片段」标签页；
点击添加，按页面提示填写片段信息并完成创建；
进入编辑界面编排片段逻辑。

编排时请注意以下特点：

片段的编辑界面与工作流一致，编排方式相同，无需额外学习；
片段中的开始、结束节点非必选，你可按实际需要组织内部逻辑；
编辑过程自动保存，无需手动保存。

发布

片段必须手动发布才对外生效：

在片段编辑界面完成编排；
执行发布操作，发布后片段才可被其他工作流调用；
未发布的草稿仅本人可见、可编辑，且不可被调用。

提示：草稿不会被任何应用调用。团队协作中，请确认片段已发布后再通知其他成员使用。

权限

片段的权限逻辑与应用一致：

默认仅本人可见、可用；
可开放为部分团队成员，成员支持多选与全选；
设置入口为片段更多操作中的「权限」；
权限设置与删除仅限本人创建的片段。

在工作流中调用片段

已发布的片段可被其他工作流调用。编排工作流时，通过画布的组件入口选择需要调用的已发布片段，即可把片段的处理能力嵌入当前流程，片段的处理结果可作为变量被下游节点引用。调用方无需关心片段内部的实现细节，只需关注输入与输出。

工作流标签页

工作流应用可以发布为组件，供全平台应用调用。发布步骤：

在工作流应用的「应用开发」页面完成编排，并保存最新内容；
点击「保存」按钮下拉，选择「发布为组件」；
按页面提示配置组件信息并确认发布；
发布后，该工作流会自动同步到「协作组件 → 工作流」标签页，成为工作流组件。

使用时请注意：

其他应用在工作流画布中添加「工作流」节点，即可从工作流组件列表中选择调用，被调用工作流的输出结果会返回给调用方；
「发布为组件」仅工作流类型的应用可见，且与「发布到应用广场」互斥；通过该入口发布的组件不上架应用广场；
基于工作流发布的组件，其所有权随源工作流的所有权转移同步转移。

智能体标签页

已发布的智能体会自动同步到「协作组件 → 智能体」标签页，无需额外操作。

其他应用在工作流画布中添加「智能体」节点，即可从已发布智能体列表中单选一个挂载调用，由智能体在流程中自主统筹调度插件、工作流、知识库、MCP 服务等能力完成任务。与「工作流」节点调用固定流程不同，「智能体」节点更适合需要模型自主决策、灵活调度资源的复杂任务。

关于智能体的创建与发布，请参阅《智能体》。

复用价值与治理建议

协作组件的核心价值，在于把分散在各应用中的重复建设收敛为统一的公共能力：

统一业务口径：同一类业务逻辑只维护一份，各应用调用同一组件，输出标准一致，避免各建各的、口径不一；
避免重复建设：通用能力沉淀为组件后，新应用直接调用即可，显著缩短搭建周期；
集中维护：业务规则变化时只需更新组件本身，调用方随之获得最新能力，降低全平台的维护成本。

建议团队统一规划组件的建设与维护：

明确各类通用能力的归属负责人，避免同类组件重复出现；
优先把高频复用的业务逻辑沉淀为片段，形成团队的公共能力库；
结合权限设置控制组件的可见范围，保障核心组件的质量与稳定性；
删除组件前先确认其引用情况，避免影响正在调用的应用。