Push Message
Push Message 是用於輸出訊息回應給使用者的 processor。
基本用法
執行 Push Message 時,會立即將設定的訊息內容發送給使用者,然後繼續執行下一個 processor。
配置參數
Name
顯示在畫布上的名稱,用於在工作流程中識別此 processor。
Description
用於補充此 processor 的用途,提升工作流程的可讀性。
Properties
Message(必填)
要發送給使用者的文字訊息內容。支援 Literal、Expression、Template、Template (Advance) 等設定類型,詳細說明請參考:Expression 介紹 - 取值方式。
isDebug
標記此訊息是否為除錯用途,預設值為 false
。
Template
Message template 設定,用於定義訊息的呈現格式,可設定按鈕、圖片、快速回覆等豐富的訊息格式。
Flush
是否立即清空回覆緩衝區,預設值為 false
。
回覆緩衝區的行為,就是將多個 Push Message 的訊息累積起來,例如 Push Message 1、Push Message 2、Push Message 3 等,直到對話完成後才清空。如下流程圖所示:
設定值 | 行為 | 適用場景 |
---|---|---|
false | 累積所有階段訊息直到對話結束才清空 | 預設對話行為或是第三方聊天平台(LINE、Discord 等) |
true | 每則階段訊息立即清空緩衝區 | SDK 需要即時視覺效果的客製化介面 |
注意: 第三方聊天平台的 reply token 機制差異,開啟 true
可能會造成功能異常,請參考各聊天平台官方技術文件。
Payload
附加的資料內容(如元資料)要推送的額外結構化資料,可包含額外的結構化資料供前端使用。
連接關係
Success
當訊息成功發送後,工作流程會從此連接點繼續執行下一個 processor。
Failure
當訊息發送失敗時,工作流程會從此連接點繼續執行,並產生 prevError
變數儲存錯誤資訊。
使用範例
發送歡迎訊息
當使用者進入系統時發送「歡迎使用客服系統!」訊息,然後等待使用者回應。這是最常見的客服機器人開場方式。
AI 聊天機器人
完整的 AI 對話流程。使用者提問後,LLM 產生智能回應,再透過 Push Message 發送給使用者。這是典型的 AI 聊天機器人工作流程。
注意事項
-
Message 欄位為必填,確保提供有意義的訊息內容。
-
在 Expression 或 Template 模式中,可以引用工作流程中的任何變數。
-
建議連接 Failure 分支,處理訊息發送失敗的情況。
-
透過 Template 設定可以建立豐富的訊息格式,如按鈕、圖片等。