協作元件

協作元件用於把可複用的能力沉澱為元件，供全平台的應用呼叫。當一段業務邏輯在多個應用中反覆出現時，你可以把它封裝為協作元件統一維護，各應用直接呼叫，無需重複搭建。本篇介紹 LanSphere 協作元件的三個標籤頁，以及片段的建立、編輯、發佈、權限與呼叫方法，適合負責搭建和維護公共能力的開發人員閱讀。

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

為什麼需要協作元件

在團隊搭建應用的過程中，常常會出現這樣的情況：多個應用都要做同一件事——比如都要把查詢結果整理成統一格式的通知、都要走同一段資料校驗邏輯。如果每個應用各自搭建一遍，不僅浪費精力，業務規則調整時還要逐個應用修改，容易出現口徑不一致。

協作元件正是為解決這個問題而設計的：把這類通用邏輯封裝為元件並發佈後，全平台的應用都可以直接呼叫它。邏輯只在元件裡維護一份，呼叫方始終獲得一致的處理結果。

三個標籤頁

協作元件包含「片段」「工作流」「智慧體」三個標籤頁，各標籤頁支援獨立的搜尋、篩選與新增。

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

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

片段

什麼是片段

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

建立與編輯

建立片段的基本步驟：

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

編排時請注意以下特點：

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

發佈

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

在片段編輯介面完成編排；
執行發佈操作，發佈後片段才可被其他工作流呼叫；
未發佈的草稿僅本人可見、可編輯，且不可被呼叫。

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

權限

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

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

在工作流中呼叫片段

已發佈的片段可被其他工作流呼叫。編排工作流時，透過畫布的元件入口選擇需要呼叫的已發佈片段，即可把片段的處理能力嵌入目前流程，片段的處理結果可作為變數被下游節點引用。呼叫方無需關心片段內部的實現細節，只需關注輸入與輸出。

工作流標籤頁

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

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

使用時請注意：

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

智慧體標籤頁

已發佈的智慧體會自動同步到「協作元件 → 智慧體」標籤頁，無需額外操作。

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

關於智慧體的建立與發佈，請參閱《智慧體》。

複用價值與治理建議

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

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

建議團隊統一規劃元件的建設與維護：

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