文本替換節點

文本替換節點屬於「文本處理」類組件，用於在工作流中將目標字符串批量替換為新的內容。它常用於模板渲染、變量佔位符清洗、輸出後處理等場景。

節點配置

基礎設置

1. 節點名稱

   • 為節點指定一個易於識別的名稱，例如“替換客戶稱呼”
   • 輸出變量將以該名稱作為前綴（例如 $替換客戶稱呼.text）

2. 文本來源

   • 從上游節點選擇需要處理的文本變量
   • 支持直接引用如 $輸入.content、$LLM.output 等上下文變量

3. 要替換的字符串

   • 指定需要查找並替換的原始內容
   • 僅支持純文本輸入，不解析上下文變量

4. 替換為

   • 填入新的文本內容
   • 僅支持純文本輸入，留空時表示替換為空字符串

5. 輸出變量

   • 默認為 text
   • 在後續節點中通過 $節點名稱.text 引用處理結果

工作原理

• 工作節點只會對“文本來源”字段展開上下文變量，形如 $節點.字段 的佔位符會被替換為實際文本；“要替換的字符串”和“替換為”始終按字面量處理。會一次性替換文本內所有匹配的字符串。
• 若“要替換的字符串”為空，節點會報錯並終止執行，以避免誤刪原文。

使用示例

以下示例展示如何移除模型輸出中的多餘標籤：

1. LLM 節點輸出的內容中包含固定的簽名信息，例如：

   【免責聲明】本回復僅供參考。

2. 添加文本替換節點並配置：

   文本：$LLM.output
   要替換的字符串：【免責聲明】
   替換為：[空格]

3. 在內容拼接器或輸出節點中引用 $文本替換.text，即可得到已去除標籤的回覆。

高級用法

批量清理模型輸出

在 LLM 回覆後使用文本替換節點，可以統一替換錯別字、移除不需要的提示語，或把敏感信息替換為佔位符。

結合循環或分支

在循環中對列表元素進行替換，或在條件節點之後針對不同分支的文本執行個性化替換，能夠提升工作流的靈活度。

模板佔位符處理

配合內容拼接器或模板節點，先輸出帶有固定佔位符的文本，再通過文本替換節點將其替換為既定文案，保持模板結構清晰。

最佳實踐

• 命名清晰：節點名稱使用“動作 + 對象”格式，例如“替換產品編碼”，便於後續引用。
• 校驗輸入：調試時檢查目標文本確實包含待替換字符串，可通過內容拼接器快速預覽。
• 逐步調試：需要替換多處內容時，建議拆分為多個文本替換節點，確保每一步輸出可控。
• 保持冪等：對於可能重複執行的工作流，配置替換規則時避免增加重複的後綴或標記。

常見問題

警告

• 目標字符串為空：節點會直接報錯，請檢查“要替換的字符串”是否正確填寫或引用。
• 變量寫入無效：請注意“要替換的字符串”和“替換為”字段不解析變量，佔位符會按原樣保留。
• 正則匹配需求：當前節點僅支持純文本替換，暫不支持正則表達式，可結合代碼執行節點實現複雜需求。