協作組件

協作組件用於將可重用嘅能力沉澱為組件，供全平台嘅應用調用。當一段業務邏輯喺多個應用中反覆出現嗰陣，你可以將其封裝為協作組件統一維護，各應用直接調用，唔使重複搭建。本篇介紹 LanSphere 協作組件嘅三個頁籤，以及片段嘅建立、編輯、發佈、權限同調用方法，適合負責搭建同維護公共能力嘅開發人員閱讀。

注意：「協作組件」入口僅開發人員及以上角色可見。

點解需要協作組件

喺團隊搭建應用嘅過程中，經常會出現咁嘅情況：多個應用都要做同一件事——例如都要將查詢結果整理成統一格式嘅通知、都要行同一段數據驗證邏輯。如果每個應用各自搭建一次，唔單止嘥精力，業務規則調整嗰陣仲要逐個應用修改，容易出現口徑唔一致。

協作組件正係為咗解決呢個問題而設計嘅：將呢類通用邏輯封裝為組件並發佈後，全平台嘅應用都可以直接調用佢。邏輯淨係喺組件入面維護一份，調用方始終獲得一致嘅處理結果。

三個頁籤

協作組件包含「片段」「工作流」「智能體」三個頁籤，各頁籤支援獨立嘅搜尋、篩選同新增。

頁籤	來源	用途
片段	喺協作組件中直接建立並發佈	封裝標準化通用業務邏輯，供各類工作流調用
工作流	工作流透過「發佈為組件」發佈後自動同步至此	供其他應用透過「工作流」節點調用
智能體	已發佈嘅智能體自動同步至此	供其他應用透過「智能體」節點調用

三個頁籤嘅分工各有側重：片段面向通用嘅業務邏輯單元；工作流頁籤匯集嘅係完整嘅工作流應用沉澱出嘅組件；智能體頁籤就匯集平台中已發佈嘅智能體。

片段

咩係片段

片段係封裝標準化通用業務邏輯嘅獨立單元。凡係跨應用反覆使用嘅處理邏輯——例如統一格式嘅文案生成、標準化嘅數據清洗規則、固定嘅資料驗證流程——都適合沉澱為片段，供各類工作流直接調用。邏輯集中維護喺一處，調用方始終獲得一致嘅處理結果。

建立與編輯

建立片段嘅基本步驟：

進入左側選單「協作組件」，切換到「片段」頁籤；
點擊新增，按頁面提示填寫片段資料並完成建立；
進入編輯介面編排片段邏輯。

編排嗰陣請留意以下特點：

片段嘅編輯介面與工作流一致，編排方式相同，唔使額外學習；
片段中嘅開始、結束節點非必選，你可按實際需要組織內部邏輯；
編輯過程自動儲存，唔使手動儲存。

發佈

片段必須手動發佈先對外生效：

喺片段編輯介面完成編排；
執行發佈操作，發佈後片段先可以被其他工作流調用；
未發佈嘅草稿僅本人可見、可編輯，且唔可以被調用。

提示：草稿唔會被任何應用調用。團隊協作中，請確認片段已發佈後再通知其他成員使用。

權限

片段嘅權限邏輯與應用一致：

預設僅本人可見、可用；
可開放為部分團隊成員，成員支援多選同全選；
設定入口為片段更多操作中嘅「權限」；
權限設定同刪除僅限本人建立嘅片段。

喺工作流中調用片段

已發佈嘅片段可被其他工作流調用。編排工作流嗰陣，透過畫布嘅組件入口選擇需要調用嘅已發佈片段，即可將片段嘅處理能力嵌入當前流程，片段嘅處理結果可作為變數被下游節點引用。調用方唔使關心片段內部嘅實現細節，淨係需要關注輸入同輸出。

工作流頁籤

工作流應用可以發佈為組件，供全平台應用調用。發佈步驟：

喺工作流應用嘅「應用開發」頁面完成編排，並儲存最新內容；
點擊「儲存」按鈕下拉，選擇「發佈為組件」；
按頁面提示設定組件資料並確認發佈；
發佈後，該工作流會自動同步到「協作組件 → 工作流」頁籤，成為工作流組件。

使用嗰陣請留意：

其他應用喺工作流畫布中新增「工作流」節點，即可由工作流組件列表中選擇調用，被調用工作流嘅輸出結果會返回畀調用方；
「發佈為組件」僅工作流類型嘅應用可見，且與「發佈到應用廣場」互斥；透過該入口發佈嘅組件唔會上架應用廣場；
基於工作流發佈嘅組件，其擁有權隨源工作流嘅擁有權轉移同步轉移。

智能體頁籤

已發佈嘅智能體會自動同步到「協作組件 → 智能體」頁籤，唔使額外操作。

其他應用喺工作流畫布中新增「智能體」節點，即可由已發佈智能體列表中單選一個掛載調用，由智能體喺流程中自主統籌調度插件、工作流、知識庫、MCP 服務等能力完成任務。與「工作流」節點調用固定流程唔同，「智能體」節點更適合需要模型自主決策、靈活調度資源嘅複雜任務。

關於智能體嘅建立同發佈，請參閱《智能體》。

重用價值與治理建議

協作組件嘅核心價值，在於將分散喺各應用中嘅重複建設收斂為統一嘅公共能力：

統一業務口徑：同一類業務邏輯淨係維護一份，各應用調用同一組件，輸出標準一致，避免各建各嘅、口徑唔一；
避免重複建設：通用能力沉澱為組件後，新應用直接調用即可，顯著縮短搭建週期；
集中維護：業務規則變化嗰陣淨係需要更新組件本身，調用方隨之獲得最新能力，降低全平台嘅維護成本。

建議團隊統一規劃組件嘅建設同維護：

明確各類通用能力嘅歸屬負責人，避免同類組件重複出現；
優先將高頻重用嘅業務邏輯沉澱為片段，形成團隊嘅公共能力庫；
結合權限設定控制組件嘅可見範圍，保障核心組件嘅品質同穩定性；
刪除組件前先確認其引用情況，避免影響正在調用嘅應用。