---
{
  "id": "platform.sheet.overview",
  "topic": "sheet",
  "title": "Sheet 與 workbook 總覽",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "22 個 Sheet Actions 涵蓋私有 workbook、File Center 匯入、有序分頁、儲存格、生命週期、匯出與耐久歷史。",
  "content": "Sheet 的 workbook 包含有序 sheets，分頁包含 cells。22 個 registry Actions 涵蓋 workbook 與分頁建立、File Center 匯入、探索、有限讀取、原子分頁／儲存格批次（`apply_workbook_changes`）、個別寫入、生命週期、匯出與私有歷史。`create_workbook` 建立含 `Sheet1` 的個人 workbook，name 上限 500 字元；workbook 與分頁 rename 接受 1–255 字元。dry-run 不建檔、不修改 workbook。\n\n寫入前先用 `get_workbook_summary` 取得 `version`、有序分頁、`usedRange` 與最多 20 列 preview。省略 `workbookId` 時，`conversationId` 或目前對話會解析 triggering user 在該對話選定的 workbook。未選定回 `resource_not_found: no workbook selected for this conversation`；用 `list_workbooks` 選擇，或明給 ID。list 帶 conversation 時會回 `isSelectedForConversation`。\n\n`import_workbook` 從有權讀取的 File Center xlsx、xls 或 csv 建立新 workbook；`import_into_workbook` 會取代既有 workbook，需 `baseVersion` 與 UserConfirm，並拒絕 stale version。`create_sheet` 可新增 100 列、26 欄的空白分頁，每本最多 50 個；`rename_sheet` 可改分頁名稱，兩者都需要目前 `baseVersion`、write grant 與不重複的非空名稱。Action 仍不提供列欄增刪、格式、排序、篩選、member／Agent permission 或 conversation preference 管理。永久 `delete_workbook` 只接受已 archived workbook，且需要 UserConfirm。匯出只寫 personal File Center。所有 Sheet Actions 都是 `allow_in_public: false`；runtime 為準。\n",
  "aliases": [
    "試算表",
    "工作表",
    "活頁簿",
    "儲存格",
    "表格資料",
    "sheet",
    "spreadsheet",
    "workbook",
    "worksheet",
    "cells"
  ],
  "tags": [
    "sheet",
    "workbook",
    "overview",
    "routing"
  ],
  "relatedActions": [
    "arinova.sheet.create_workbook",
    "arinova.sheet.import_workbook",
    "arinova.sheet.import_into_workbook",
    "arinova.sheet.apply_workbook_changes",
    "arinova.sheet.create_sheet",
    "arinova.sheet.rename_sheet",
    "arinova.sheet.list_workbooks",
    "arinova.sheet.list_sheets",
    "arinova.sheet.get_workbook_summary",
    "arinova.sheet.read_range",
    "arinova.sheet.update_cells",
    "arinova.sheet.append_rows",
    "arinova.sheet.rename_workbook",
    "arinova.sheet.archive_workbook",
    "arinova.sheet.unarchive_workbook",
    "arinova.sheet.delete_workbook",
    "arinova.sheet.export_workbook",
    "arinova.sheet.list_versions",
    "arinova.sheet.get_version",
    "arinova.sheet.create_named_version",
    "arinova.sheet.restore_version",
    "arinova.sheet.copy_version"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/sheet/overview/"
}
---

Sheet 的 workbook 包含有序 sheets，分頁包含 cells。22 個 registry Actions 涵蓋 workbook 與分頁建立、File Center 匯入、探索、有限讀取、原子分頁／儲存格批次（`apply_workbook_changes`）、個別寫入、生命週期、匯出與私有歷史。`create_workbook` 建立含 `Sheet1` 的個人 workbook，name 上限 500 字元；workbook 與分頁 rename 接受 1–255 字元。dry-run 不建檔、不修改 workbook。

寫入前先用 `get_workbook_summary` 取得 `version`、有序分頁、`usedRange` 與最多 20 列 preview。省略 `workbookId` 時，`conversationId` 或目前對話會解析 triggering user 在該對話選定的 workbook。未選定回 `resource_not_found: no workbook selected for this conversation`；用 `list_workbooks` 選擇，或明給 ID。list 帶 conversation 時會回 `isSelectedForConversation`。

`import_workbook` 從有權讀取的 File Center xlsx、xls 或 csv 建立新 workbook；`import_into_workbook` 會取代既有 workbook，需 `baseVersion` 與 UserConfirm，並拒絕 stale version。`create_sheet` 可新增 100 列、26 欄的空白分頁，每本最多 50 個；`rename_sheet` 可改分頁名稱，兩者都需要目前 `baseVersion`、write grant 與不重複的非空名稱。Action 仍不提供列欄增刪、格式、排序、篩選、member／Agent permission 或 conversation preference 管理。永久 `delete_workbook` 只接受已 archived workbook，且需要 UserConfirm。匯出只寫 personal File Center。所有 Sheet Actions 都是 `allow_in_public: false`；runtime 為準。