---
{
  "id": "platform.email.overview",
  "topic": "email",
  "title": "Agent Email 收件匣與僅限回覆寄信概觀",
  "locale": "zh-TW",
  "version": "2026-09-01",
  "summary": "Agent Email 可私下讀取與分流 inbox、檢查用量，並在確認後管理 inbox 或 allowlist；寄信仍只能回覆固定寄件者。",
  "content": "Email 寄信是 reply-only；沒有 compose 或 send action。收件人永遠來自可信的 inbound email row；reply schema 刻意沒有 `to` 或 `recipient`。若使用者要求寄信到任意地址，應明確說明平台做不到，可請 owner 自行寄送；若目的其實是通知外部系統，可改用 owner 預先註冊的 Delivery endpoint。\n\n私人讀取 actions 是 `arinova.email.list_inbound` 與 `arinova.email.get_inbound`，只會公開目前 Agent 所有的 `dispatched` rows；MCP-only Agent 用 `list_inbound {unread:true}` 輪詢。清單摘要與完整正文都包成不可信外部資料，headers 絕不輸出，action replay 也只保留非敏感 ID。一般 conversation、message 與 search actions 會排除 email threads，因此 email 內容只能經這些 email actions 讀取。\n\ninbox 由 owner 建立。Agent 可讀 `get_inbox`、`get_usage`；`update_inbox` 只有在 strict 使用者確認後，才能暫停或恢復收件、修改 handling guidance、接受所有 sender 或停用 reply。隔離與 allowlist 讀取不需確認；釋放隔離信與所有 allowlist 寫入都需 strict 確認，discard 則會立即清除 body。只有已 `dispatched` 的來信可回覆。平台處理主旨與 threading headers；成功回 `status=sent`、`messageId` 與 `providerEmailId`。\n\n收件匣投遞會喚醒 Agent，或讓每封驗證郵件啟動一次所選 active Workflow，兩者不雙跑。\n\n收信與回覆依 runtime 設定扣 owner credit。外部事件進 Arinova 是 Webhook；資料離開是 Delivery；Email 只收信並回覆原寄件者。實際 registry policy、action result、persisted state 與 typed error 優先。\n",
  "aliases": [
    "回覆郵件",
    "回信",
    "收到的信",
    "信箱",
    "寄件者",
    "email reply",
    "inbound email",
    "agent inbox"
  ],
  "tags": [
    "email",
    "overview",
    "reply-only"
  ],
  "relatedActions": [
    "arinova.email.list_inbound",
    "arinova.email.get_inbound",
    "arinova.email.reply",
    "arinova.email.update_inbox",
    "arinova.email.list_quarantine",
    "arinova.email.discard_quarantined",
    "arinova.email.release_quarantined",
    "arinova.email.list_sender_allowlist",
    "arinova.email.add_sender_allowlist",
    "arinova.email.update_sender_allowlist",
    "arinova.email.remove_sender_allowlist",
    "arinova.email.get_usage"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/email/overview/"
}
---

Email 寄信是 reply-only；沒有 compose 或 send action。收件人永遠來自可信的 inbound email row；reply schema 刻意沒有 `to` 或 `recipient`。若使用者要求寄信到任意地址，應明確說明平台做不到，可請 owner 自行寄送；若目的其實是通知外部系統，可改用 owner 預先註冊的 Delivery endpoint。

私人讀取 actions 是 `arinova.email.list_inbound` 與 `arinova.email.get_inbound`，只會公開目前 Agent 所有的 `dispatched` rows；MCP-only Agent 用 `list_inbound {unread:true}` 輪詢。清單摘要與完整正文都包成不可信外部資料，headers 絕不輸出，action replay 也只保留非敏感 ID。一般 conversation、message 與 search actions 會排除 email threads，因此 email 內容只能經這些 email actions 讀取。

inbox 由 owner 建立。Agent 可讀 `get_inbox`、`get_usage`；`update_inbox` 只有在 strict 使用者確認後，才能暫停或恢復收件、修改 handling guidance、接受所有 sender 或停用 reply。隔離與 allowlist 讀取不需確認；釋放隔離信與所有 allowlist 寫入都需 strict 確認，discard 則會立即清除 body。只有已 `dispatched` 的來信可回覆。平台處理主旨與 threading headers；成功回 `status=sent`、`messageId` 與 `providerEmailId`。

收件匣投遞會喚醒 Agent，或讓每封驗證郵件啟動一次所選 active Workflow，兩者不雙跑。

收信與回覆依 runtime 設定扣 owner credit。外部事件進 Arinova 是 Webhook；資料離開是 Delivery；Email 只收信並回覆原寄件者。實際 registry policy、action result、persisted state 與 typed error 優先。