跳至主要内容

Push Message Processor

Push Message Processor 用於輸出訊息回應給使用者。

基本用法​

Push Message Processor 用於將文字訊息、檔案或結構化內容發送給使用者。當工作流程執行到此 processor 時，會立即將設定的訊息內容輸出到聊天介面，然後繼續執行下一個 processor。這是工作流程中最常用的輸出 processor 之一，適用於各種回應場景，從簡單的文字回覆到複雜的互動式訊息。

配置參數​

Name​

  • 顯示在畫布上的名稱，用於在工作流程中識別此 processor

Description​

  • 用於補充此 processor 的用途，提升工作流程的可讀性與可維護性

Properties​

Message（必填）​

  • 說明：要發送給使用者的文字訊息內容
  • 設定類型：
    • Literal：直接輸入固定文字內容
    • Expression：使用 JavaScript 表達式動態產生訊息
    • Template：使用範本語法組合訊息內容
    • Template (Advance)：進階範本模式

isDebug​

  • 說明：標記此訊息是否為除錯用途
  • 預設值：false
  • 用途：在開發階段用於區分正式訊息與除錯訊息

Template​

  • 說明：訊息範本設定，用於定義訊息的呈現格式
  • 設定類型：支援 Literal、Expression、Template 等模式
  • 用途：可設定按鈕、圖片、快速回覆等豐富的訊息格式

Flush​

  • 說明：是否立即清空回覆緩衝區
  • 預設值：false
  • 用途：控制訊息的發送時機

Payload​

  • 說明：附加的資料內容或元資料
  • 用途：可包含額外的結構化資料供前端使用

連接關係​

Success​

當訊息成功發送後，工作流程會從此連接點繼續執行下一個 processor。

Failure​

當訊息發送失敗時，工作流程會從此連接點繼續執行，並產生 prevError 變數儲存錯誤資訊。

使用範例​

固定文字回應​

Message 設定：

  • 設定類型：選擇 Literal
  • 編輯器：輸入 歡迎使用客服系統！

動態內容回應​

Message 設定：

  • 設定類型：選擇 Expression
  • 編輯器：
"您剛才說：" + prevMessage

結合 LLM 輸出​

Message 設定：

  • 設定類型：選擇 Template (Advance)
  • 編輯器：
{{answer}}

這個範例假設 LLM Completion 產生了 answer 變數。

注意事項​

  1. 訊息內容：Message 欄位為必填，確保提供有意義的訊息內容

  2. 變數引用：在 Expression 或 Template 模式中，可以引用工作流程中的任何變數

  3. 錯誤處理：建議連接 Failure 分支，處理訊息發送失敗的情況

  4. 訊息格式：透過 Template 設定可以建立豐富的訊息格式，如按鈕、圖片等