---
{
  "id": "platform.notebook.overview",
  "topic": "notebook",
  "title": "個人 Notebook 概觀、授權與建立流程",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Notebook 是 Note 的個人容器；actions 提供經授權的建立、匯入匯出、查詢、更新、封存生命週期與受保護刪除。",
  "content": "Notebook 是 Notes 的個人容器；每位使用者有系統預設 notebook，容器另有排序與 archived state。`list_notebooks` 只回傳具有 executing Agent 明確授權列的 notebooks，不代表使用者擁有的全部 notebooks；`includeArchived` 可納入封存容器。`get_notebook` 回 metadata 與 `noteCount`，無授權 ID 會回 not found，避免揭露資源是否存在。\n\n`create_notebook` 受 owner plan 的 `max_notebooks` 限制；達上限時回 `PERMISSION_DENIED`，details reason 為 `PLAN_LIMIT`。應說明 quota，不可重試硬闖。建立成功後會自動給 executing Agent write access，因此可把回傳 `notebookId` 直接交給 `create_note`。Notebook reads 可在 public surface 執行，create 不可。\n\n若使用者要建立 Note 卻未指定 Notebook，先呼叫 `list_notebooks`。若仍有多個合適位置，應請使用者選擇，再以選定的 `notebookId` 呼叫 `create_note`；不可猜測隱藏或未授權容器。\n\n`update_notebook` 可改名稱或排序；`archive_notebook`／`unarchive_notebook` 管理可逆狀態。`delete_notebook` 使用 UserConfirm 與 Strict drift，只接受 triggering user 擁有、Agent 可寫、已封存、非 default 的 personal notebook，並先把 Notes 搬到 default。這些 mutations 不可在 public surfaces 執行。\n\n`import_notebook` 轉換已授權的 File Center 檔案。`export_notebook` 把已授權 Notebook 的 JSON、Markdown 或 PDF 存進觸發者的 personal File Center，回應含 `fileId` 與 content path，不接受 inline bytes。REST `/api/v1/notebooks/{id}/export` 提供 start、poll、download。\n",
  "aliases": [
    "筆記本",
    "記事本",
    "個人筆記本",
    "筆記容器",
    "列出筆記本",
    "建立筆記本",
    "notebook",
    "notebooks"
  ],
  "tags": [
    "notebook",
    "overview",
    "permission",
    "quota",
    "note-container"
  ],
  "relatedActions": [
    "arinova.notebook.create_notebook",
    "arinova.notebook.import_notebook",
    "arinova.notebook.export_notebook",
    "arinova.notebook.list_notebooks",
    "arinova.notebook.get_notebook",
    "arinova.notebook.update_notebook",
    "arinova.notebook.archive_notebook",
    "arinova.notebook.unarchive_notebook",
    "arinova.notebook.delete_notebook",
    "arinova.note.create_note"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/notebook/overview/"
}
---

Notebook 是 Notes 的個人容器；每位使用者有系統預設 notebook，容器另有排序與 archived state。`list_notebooks` 只回傳具有 executing Agent 明確授權列的 notebooks，不代表使用者擁有的全部 notebooks；`includeArchived` 可納入封存容器。`get_notebook` 回 metadata 與 `noteCount`，無授權 ID 會回 not found，避免揭露資源是否存在。

`create_notebook` 受 owner plan 的 `max_notebooks` 限制；達上限時回 `PERMISSION_DENIED`，details reason 為 `PLAN_LIMIT`。應說明 quota，不可重試硬闖。建立成功後會自動給 executing Agent write access，因此可把回傳 `notebookId` 直接交給 `create_note`。Notebook reads 可在 public surface 執行，create 不可。

若使用者要建立 Note 卻未指定 Notebook，先呼叫 `list_notebooks`。若仍有多個合適位置，應請使用者選擇，再以選定的 `notebookId` 呼叫 `create_note`；不可猜測隱藏或未授權容器。

`update_notebook` 可改名稱或排序；`archive_notebook`／`unarchive_notebook` 管理可逆狀態。`delete_notebook` 使用 UserConfirm 與 Strict drift，只接受 triggering user 擁有、Agent 可寫、已封存、非 default 的 personal notebook，並先把 Notes 搬到 default。這些 mutations 不可在 public surfaces 執行。

`import_notebook` 轉換已授權的 File Center 檔案。`export_notebook` 把已授權 Notebook 的 JSON、Markdown 或 PDF 存進觸發者的 personal File Center，回應含 `fileId` 與 content path，不接受 inline bytes。REST `/api/v1/notebooks/{id}/export` 提供 start、poll、download。