個人 Notebook 概觀、授權與建立流程

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。

Related actions

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

Also known as

筆記本, 記事本, 個人筆記本, 筆記容器, 列出筆記本, 建立筆記本, notebook, notebooks

---

Machine-readable Markdown · Knowledge index