---
{
  "id": "platform.calendar.overview",
  "topic": "calendar",
  "title": "行事曆容器與事件操作總覽",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Calendar 用於讀寫獲授權行事曆內的事件，是資源操作 family，不是依時間喚醒 Agent 的自動化。",
  "content": "Calendar 管理 user-visible、Agent-authorized 日曆中的事件；排程 Agent 工作請用 Cron。行事曆 reminder 只是附在事件上的平台通知。\n\n`list_calendars`／`get_calendar` 只讀取「triggering user 可見性 ∩ executing Agent grants」；`create_calendar` 為 triggering user 建立 native calendar 並授予 executing Agent write，`update_calendar` 僅限 owner。`delete_calendar` 僅限 owner，且拒絕 default 或 device-mirrored calendar。`list_members` 可在 triggering user 為 admin 時讀取授權 calendar roster；成員寫入只留給 user／CLI v1。\n\n`list_events` 回傳 `events` 與唯讀的虛擬 `kanbanEvents`；`get_event` 讀取單一真正事件。`create_event`、`update_event`、`delete_event` 負責異動。`export_event` 為已授權事件或 recurring instance 回傳 RFC 5545 iCalendar。`create_event` 可保留 caller 提供的 `icalUid`，但仍會驗證授權。\n\n`import_ics` 從 raw VCALENDAR 匯入最多 500 事件至雙方可寫的日曆。bulk write 使用 UserConfirm + Strict；Action 上限 64 KiB，v1 上限 2 MiB。\n\nCalendar action 不會寄送邀請。`delete_calendar`、`delete_event`、`import_ics` 使用 UserConfirm + Strict；所有 Calendar actions 都不可在 public surface 執行。registry、live result 與 typed runtime error 為準。\n",
  "aliases": [
    "行事曆",
    "日曆",
    "會議",
    "活動",
    "行程",
    "安排會議",
    "新增事件",
    "calendar",
    "meeting",
    "appointment",
    "event"
  ],
  "tags": [
    "calendar",
    "overview",
    "routing"
  ],
  "relatedActions": [
    "arinova.calendar.list_calendars",
    "arinova.calendar.get_calendar",
    "arinova.calendar.create_calendar",
    "arinova.calendar.update_calendar",
    "arinova.calendar.delete_calendar",
    "arinova.calendar.list_events",
    "arinova.calendar.get_event",
    "arinova.calendar.create_event",
    "arinova.calendar.update_event",
    "arinova.calendar.delete_event",
    "arinova.calendar.import_ics",
    "arinova.calendar.export_event",
    "arinova.calendar.list_members"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/calendar/overview/"
}
---

Calendar 管理 user-visible、Agent-authorized 日曆中的事件；排程 Agent 工作請用 Cron。行事曆 reminder 只是附在事件上的平台通知。

`list_calendars`／`get_calendar` 只讀取「triggering user 可見性 ∩ executing Agent grants」；`create_calendar` 為 triggering user 建立 native calendar 並授予 executing Agent write，`update_calendar` 僅限 owner。`delete_calendar` 僅限 owner，且拒絕 default 或 device-mirrored calendar。`list_members` 可在 triggering user 為 admin 時讀取授權 calendar roster；成員寫入只留給 user／CLI v1。

`list_events` 回傳 `events` 與唯讀的虛擬 `kanbanEvents`；`get_event` 讀取單一真正事件。`create_event`、`update_event`、`delete_event` 負責異動。`export_event` 為已授權事件或 recurring instance 回傳 RFC 5545 iCalendar。`create_event` 可保留 caller 提供的 `icalUid`，但仍會驗證授權。

`import_ics` 從 raw VCALENDAR 匯入最多 500 事件至雙方可寫的日曆。bulk write 使用 UserConfirm + Strict；Action 上限 64 KiB，v1 上限 2 MiB。

Calendar action 不會寄送邀請。`delete_calendar`、`delete_event`、`import_ics` 使用 UserConfirm + Strict；所有 Calendar actions 都不可在 public surface 執行。registry、live result 與 typed runtime error 為準。