Skip to main content

asgard.message.start

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

事件特性​

  • 觸發時機：當 AI 開始生成回應時
  • 作用：初始化前端顯示，可能包含初始文字
  • 頻率：每個訊息回應只會觸發一次

關鍵欄位​

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

完整範例​

{
    "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
    }
}