節點參考

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

自訂工具

呼叫團隊自建的工具。

• 關鍵設定：從自訂工具列表中選擇要呼叫的工具。
• 輸出內容：自訂工具的執行結果。
• 使用提示：自訂工具在「外掛管理」中建立，需測試通過並儲存後才可被呼叫。

輸出

回覆

在對話流中向使用者輸出訊息，可在流程中途多次輸出。

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

輸出

在工作流結束時返回最終結果。

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

節點速查表