---
{
  "id": "platform.message.overview",
  "topic": "message",
  "title": "Message actions 與立即派送",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Message actions 可讀取與定位聊天記錄、傳送或轉寄訊息，並管理 reactions 與 pins；延遲派送屬於 Automation。",
  "content": "Live Message family 可讀取、搜尋並依位置定位歷史，讀附件，傳送、編輯或經確認 soft-delete Agent 訊息，新增／列出／移除 reactions，列出／pin／unpin 訊息，並在確認後轉寄來源訊息或帶 attribution 的文字。`list_messages` 可使用互斥的 before/after/around message cursor，或 local date 加 timezone offset。Pin 有一個重要可見副作用：會在對話插入 system message。\n\nAction send 是額外的主動貼文，runtime event 標記為 `action_send_message`；它不同於 Agent 正常 streamed reply，不應只為重複本回合正要回覆的內容而呼叫。成功的 live call 具有 action envelope `status: completed`；`send_message` 會回傳 `messageId` 與 conversation-local `seq`。每個 Message action 都把目標限於執行 Agent 可存取的非 email 對話；無權目標回 `resource_not_found`，不保證資源是否存在。\n\nDry-run 只回 `wouldSend`，不寫入，描述時必須與 live success 分開。`send_message` 只做立即動作。「之後幾點貼」應使用 Cron 的 `conversation_message` target；「資源事件發生後貼」應使用 Trigger。沒有相應 Automation action 與 runtime result 時，knowledge 不得承諾延遲執行。\n",
  "aliases": [
    "message",
    "聊天記錄",
    "傳訊息",
    "搜尋訊息",
    "貼到對話",
    "延遲訊息"
  ],
  "tags": [
    "message",
    "overview",
    "delivery"
  ],
  "relatedActions": [
    "arinova.message.list_messages",
    "arinova.message.get_message",
    "arinova.message.search_messages",
    "arinova.message.send_message"
  ],
  "relatedActionPrefixes": [
    "arinova.message."
  ],
  "url": "https://docs.arinova.ai/zh-tw/kb/message/overview/"
}
---

Live Message family 可讀取、搜尋並依位置定位歷史，讀附件，傳送、編輯或經確認 soft-delete Agent 訊息，新增／列出／移除 reactions，列出／pin／unpin 訊息，並在確認後轉寄來源訊息或帶 attribution 的文字。`list_messages` 可使用互斥的 before/after/around message cursor，或 local date 加 timezone offset。Pin 有一個重要可見副作用：會在對話插入 system message。

Action send 是額外的主動貼文，runtime event 標記為 `action_send_message`；它不同於 Agent 正常 streamed reply，不應只為重複本回合正要回覆的內容而呼叫。成功的 live call 具有 action envelope `status: completed`；`send_message` 會回傳 `messageId` 與 conversation-local `seq`。每個 Message action 都把目標限於執行 Agent 可存取的非 email 對話；無權目標回 `resource_not_found`，不保證資源是否存在。

Dry-run 只回 `wouldSend`，不寫入，描述時必須與 live success 分開。`send_message` 只做立即動作。「之後幾點貼」應使用 Cron 的 `conversation_message` target；「資源事件發生後貼」應使用 Trigger。沒有相應 Automation action 與 runtime result 時，knowledge 不得承諾延遲執行。