跳至主要内容

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

回覆緩衝區的行為,就是將 p1、p2、p3 的訊息累積起來,直到對話完成後才清空。如下流程圖所示:


設定值行為適用場景
false累積所有階段訊息直到對話結束才清空預設對話行為或是第三方聊天平台(LINE、Discord 等)
true每則階段訊息立即清空緩衝區SDK 需要即時視覺效果的客製化介面

注意: 第三方聊天平台的 reply token 機制差異,開啟 true 可能會造成功能異常,請參考各聊天平台官方技術文件。

Payload

附加的資料內容(如元資料)要推送的額外結構化資料,可包含額外的結構化資料供前端使用。

連接關係

Success

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

Failure

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

使用範例

發送歡迎訊息


當使用者進入系統時發送「歡迎使用客服系統!」訊息,然後等待使用者回應。這是最常見的客服機器人開場方式。

AI 聊天機器人


完整的 AI 對話流程。使用者提問後,LLM 產生智能回應,再透過 Push Message 發送給使用者。這是典型的 AI 聊天機器人工作流程。

注意事項

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

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

  3. 建議連接 Failure 分支,處理訊息發送失敗的情況。

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