節點參考

節點係編排工作流同對話流嘅基本單元。喺「應用開發」畫布中，你可以透過點擊嘅方式將節點加入畫布，並按業務邏輯將其連接起嚟，組成完整嘅應用流程。本篇按功能分組逐一介紹 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 服務」選單中新增。

自訂工具

調用團隊自建嘅工具。

• 關鍵設定：由自訂工具列表中選擇要調用嘅工具。
• 輸出內容：自訂工具嘅執行結果。
• 使用提示：自訂工具喺「插件管理」中建立，需測試通過並儲存後先可以被調用。

輸出

回覆

喺對話流中向用戶輸出訊息，可喺流程中途多次輸出。

• 關鍵設定：編寫要發送畀用戶嘅訊息內容，可引用上游變數。
• 輸出內容：向用戶展示嘅訊息。
• 使用提示：僅用於對話流。借助多次輸出，可以喺較長嘅流程中及時向用戶回饋階段性進展。

輸出

喺工作流結束嗰陣返回最終結果。

• 關鍵設定：定義需要返回嘅結果內容。
• 輸出內容：工作流嘅最終結果。
• 使用提示：用於工作流。工作流接收輸入直達輸出、全程無互動，最終結果透過該節點交付。

節點速查表