跳至主要内容

REFERENCE

開發者參考

認證、API、SDK、Flow Agent 處理節點與參數取值的完整參考。

asgard.message.start

asgard.message.start 事件是對話的起始點,用於通知客戶端一個新的訊息回應即將開始。這個事件可能包含初始文字內容。

  1. 事件特性​

    • 觸發時機:當 AI 開始生成回應時
    • 作用:初始化前端顯示,可能包含初始文字
    • 頻率:每個訊息回應只會觸發一次
  2. 關鍵欄位​

    欄位說明
    messageStart.message.text可能包含初始文字,或為空字串等待後續 delta 事件
    messageStart.message.idx通常為 null,在 delta 事件中才會有值
    messageStart.message.template通常為 null,在 complete 事件中才有值
  3. 完整範例​

    {
    "eventType": "asgard.message.start",
    "requestId": "6939c5a6c590d90c401e3850a1ff44f3",
    "namespace": "qa-7e301310-a594-4a7b-aa2a-xxxxxxxxxxxx",
    "botProviderName": "bpapi-d97c512f-f8dc-46f6-82f0-xxxxxxxxxxxx",
    "customChannelId": "ch-6xxxxxxxxxxxx",
    "fact": {
    "runInit": null,
    "runDone": null,
    "runError": null,
    "messageStart": {
    "message": {
    "messageId": "1834828082242916352",
    "replyToCustomMessageId": "",
    "text": "", // ← 可能為空或包含初始文字
    "payload": {},
    "isDebug": false,
    "idx": null, // ← 注意:初始為 null
    "template": {
    "type": "TEXT",
    "text": ""
    }
    }
    },
    "messageDelta": null, // ← 其他事件為 null
    "messageComplete": null
    }
    }

準備好開始了嗎?

想知道 Asgard 怎麼用在你的團隊?跟我們聊聊。

聯絡我們