當網站上有一批「格式相同、一筆一筆」的內容 - 例如補習班的師資與課程、設計公司的作品案例、連鎖品牌的門市據點、常見問題 - 把它們一個個塞進頁面文字框裡會非常難維護。
資料集合(Collections)就像是內建在網站裡的試算表與小型資料庫:先定義好這批資料有哪些欄位(例如姓名、頭像、專長、年資),再一筆一筆填入內容。管理與讀取分為兩條清楚的軌道:
https://{您的網站}/api/v1/collections/{key}/items),供您自建的前端、App 或外部網頁直接免金鑰讀取,並由全球邊緣快取加速(技術規格見 Content Delivery API)。資料集合的欄位結構(有哪些欄位、屬於什麼型別、是否必填)統一由 AI 透過 MCP 建立與修改,後台不提供手動拉表單改結構的畫面 - 因為直接用白話告訴 AI「我要存什麼」比自己逐一設定欄位型別快得多,而且 AI 會自動幫您選對型別並加上格式驗證。
先依將 ChatGPT、Claude、Cursor 或 Claude Code 連上 Kanorio。
在對話框複製貼上以下任一段指令(可換成您的業務需求):
範例一:建立師資集合
幫我的網站建一個「師資」(key: teachers)集合,欄位:姓名、職稱、科目(單選:數學/英文/物理)、教學年資(整數)、簡介(長文)、聯絡信箱、開放新生(是否)。先塞 3 位老師的範例資料並發布。
範例二:建立課程集合並關聯師資
幫我的網站建一個「課程」(key: courses)集合,欄位:課程名稱、授課老師(參照 teachers 集合)、程度(單選:入門/進階/高階)、學費(數字)、開課日(日期)、標籤(多選:線上/週末班/小班制)、報名連結(網址)。先塞 3 堂課並關聯剛才的老師。
回到後台「數據與資料 › 資料表」,即可看到建好的集合與資料。網站還沒有任何集合時,總覽畫面中央也備有「師資」「作品案例」「門市」三組現成提示可一鍵複製。
點進「數據與資料 › 資料表」,畫面採用專業資料庫工作台版面,分為左、中、右三區:
點選任一集合後,頂部工具列可切換三個分頁,且您設定的篩選條件、排序、頁碼與開啟的記錄都會保存在網址上,複製網址給團隊成員就能看到完全相同的畫面:
text、number、ref → teachers);第一欄固定為標題欄位,橫向捲動時不會消失;最右側灰色區塊為系統欄位(status、slug、published_at、updated_at、id)。NULL,空字串顯示 EMPTY。Enter 打開右側記錄面板、按 ⌘C(Windows 為 Ctrl+C)複製該格內容。id)、型別、必填、唯一、約束條件與給 AI 的填寫提示(aiHint)。fetch 與 curl 範例,點一下即可複製給工程師或前端專案使用。將滑鼠移到表格最左方列號按展開箭頭(或雙擊任一列),右側會停靠打開該筆資料的完整面板:
id、slug、發布時間與建立/更新時間,滑過即可單獨複製。每筆資料同時保有草稿(後台看到的)與已發布(公開 API 讀到的)兩份內容,狀態以圓點標示:
Enter 確認、Esc 取消)。圖片、圖庫、檔案、長文、多重選擇與參照等複合欄位,則在右側記錄面板修改。⌘S)」:寫入並立即更新公開 API 與清除邊緣快取。AI 寫入的預設行為:AI 透過 MCP 或 REST API 新增/修改資料時,預設
publish: true(直接發布上線);若您希望 AI 先存草稿等您檢查,只要在對話中說一句「先存成草稿」即可。
以下為資料集合支援的所有欄位型別。AI 建立結構或您準備匯入 JSON/CSV 時皆遵循此表:
| 分類 | 欄位類型(中文) | 技術代號(type) | 儲存與 API 格式 | 可設定的約束條件 |
|---|---|---|---|---|
| 文字 | 單行/一般文字 | text | 字串(自動去除首尾空白) | min、max(預設上限 5,000、最高 20,000)、pattern(正則表達式)、unique、default |
| 文字 | 長文(富文本) | rich_text | Markdown 字串(自動剝除內嵌 HTML 標籤) | max(最高 50,000 字) |
| 聯絡與連結 | 電子郵件 | email | 小寫 Email 字串(最長 254 字元) | unique、default |
標題欄位(
titleFieldId):每個集合都會指定一個text、url欄位作為標題欄位,用來顯示在表格第一欄、作為其他集合參照時的顯示名稱,並在未指定slug時自動產生網址代稱。
如果您的網站有使用,左側集合欄的「系統」分組會自動出現 4 個標有鎖頭的系統集合:
blog(網誌文章)blog_categories(網誌分類)blog_tags(網誌標籤)blog_authors(網誌作者)運作規則:
items.* 唯讀:為了確保文章編輯器、SEO 與版本紀錄的一致性,系統集合在資料集合工作台(及 Agent 的 items.* 工具)為唯讀;要改文章請到「網誌」頁(或請 AI 用 posts_* 工具)。collections.update 為 blog 加上自訂欄位(內建保留欄位不可刪改),您的外部前端也能用完全相同的 /api/v1/collections/blog/items?expand=authors,categories,tags 讀取已發布文章。點選工作台工具列右上角的「更多(⋯)」,即可執行「匯出 CSV」、「匯出 JSON」與「匯入」:
id、slug、status、publishedAt 四個系統欄(CSV 內的多選、多重參照與 JSON 欄位會以 JSON 字串表示)。id 且對得上既有記錄的列會執行更新;沒有 id 的列則會新增。勾選「匯入後直接發布」即可在匯入同時發布上線。當您或工程師(或 Cursor/Claude Code)自己寫了一個前端網站(例如 Next.js、Astro、Vue、React Native)想讀取資料集合時:
fetch/curl 範例。https://app.example.com 或 https://preview.vercel.app)並從瀏覽器直接呼叫 API,請前往後台「網站設定 › 開發者」,在「允許的來源」輸入該網址(僅限 https:// 開頭的網域,不含路徑與萬用字元,每站最多 20 個)。http://localhost/127.0.0.1(任意 port)免登記即可直接讀取。filter[欄位][op]=值、sort=-欄位、fields=欄位1,欄位2、expand=參照欄位、游標分頁與 ?preview=1 草稿預覽,完整規格請參閱 。資料集合只計算「全站所有自訂集合加總的資料筆數(含草稿)」,集合數量、欄位數量與 API 讀取次數皆不計費:
| 項目 | 免費版 | 專業版 | 商務版 |
|---|---|---|---|
| 全站自訂集合內含筆數(含草稿;網誌系統集合不計) | 50 筆 | 1,000 筆 | 10,000 筆 |
| 按月加購筆數 | 不提供加購 | 每 1,000 筆 US$1.50/月(依訂閱幣別計價) | 每 1,000 筆 US$1.50/月(依訂閱幣別計價) |
| 加購後最高總筆數上限 | 50 筆 | 20,000 筆(最多加購 19 級) | 200,000 筆(最多加購 190 級) |
| 集合數與欄位數技術上限 | 每站最多 100 個集合、每集合最多 50 個欄位 | 同左 | 同左 |
| Content Delivery API | 免費開放、不計流量費 | 免費開放、不計流量費 | 免費開放、不計流量費 |
資料集合定位為「網站內容庫(Headless CMS)」,適合存放讀多寫少、由站主或團隊維護的結構化內容。以下情境請使用對應的專屬功能或外部服務:
不行,集合的欄位結構統一由 AI 透過 MCP(或 REST API)管理。只要切到集合的「結構」分頁,點選右上角「用 AI 修改結構」複製提示貼給 ChatGPT、Claude 或 Cursor,告訴它要加什麼欄位即可。新增欄位、改顯示名稱、增加選項與放寬限制都會立即生效;刪除自訂欄位後舊資料會被忽略;若要將欄位改成不相容的型別(例如把文字改成數字),AI 會自動幫您新增欄位、搬移資料再移除舊欄位。
代表另一個集合裡有資料正透過「參照(reference/multi_reference)」欄位指向這筆資料(例如某堂課程的授課老師指向這位老師)。為避免前台出現斷掉的關聯,系統預設會攔下刪除;請先將那些課程改指派給其他老師,再執行刪除(透過 API 刪除時若帶入 force=true 則可強制刪除,讀取端會自動忽略失效的參照)。
網站的擁有者、管理員、成員與檢視者都能進入「數據與資料 › 資料表」瀏覽結構、資料與匯出 CSV/JSON(門市店員角色不會看到此項目)。新增、修改、發布、刪除與匯入資料需要「管理資料集合」權限(預設開放給擁有者、管理員與成員);管理「允許的來源(CORS)」需要「管理網站基本設定」權限;加購筆數則需要「管理訂閱計劃」權限。
會。當您在「網站設定 › 網站管理」建立網站備份時,ZIP 壓縮包內會自動包含 collections/schema.json(所有集合的欄位定義)與 collections/{key}.json(每個集合的完整草稿與已發布資料),集合內引用的媒體庫圖片與檔案也會一併打包。
有。無論是在後台工作台儲存、匯入 CSV,或是透過 AI 助理與 REST API 建立集合、寫入或發布資料,每一筆操作都會完整記錄在活動紀錄中,並清楚標示操作者與使用的工具名稱。
| 電話號碼 |
phone |
自動轉為 E.164 國際標準格式(如 +886912345678) |
defaultCountry(預設依網站營業地點解析) |
| 聯絡與連結 | 網址 | url | http:// 或 https:// 網址(最長 2,048 字元) | unique、default |
| 聯絡與連結 | 影片網址 | video_url | YouTube 或 Vimeo 網址 | - |
| 數值與邏輯 | 數字 | number | 數值(整數或小數) | integer(僅限整數)、min、max、unique、default |
| 數值與邏輯 | 是否(布林) | boolean | true 或 false | default |
| 日期與時間 | 日期 | date | YYYY-MM-DD 日曆日期(如 "2026-11-02",檢查真實曆法) | min、max、default |
| 日期與時間 | 日期時間 | datetime | ISO 8601 UTC 字串(如 "2026-10-30T15:59:00.000Z") | min、max、default |
| 選項與外觀 | 單選 | select | 選項的英文 id 字串 | options: [{ id, label, color? }](最多 100 個選項)、default |
| 選項與外觀 | 多選 | multi_select | 選項 id 字串陣列(自動去重) | options、min、max(最多 50 個)、default |
| 選項與外觀 | 顏色 | color | 小寫十六進位色碼(如 "#2563eb") | default |
| 媒體與檔案 | 圖片 | image | 網站的檔案 assetId | 自動納入媒體庫引用追蹤與空間保護 |
| 媒體與檔案 | 圖庫(多張圖片) | gallery | 媒體庫 assetId 陣列 | min、max(最多 50 張) |
| 媒體與檔案 | 檔案 | file | 媒體庫的檔案 assetId(PDF、音訊、文件等) | 自動納入媒體庫引用追蹤 |
| 關聯與進階 | 參照(單筆關聯) | reference | 目標集合項目的 id(寫入時驗證目標存在) | targetCollectionKey(目標集合的 key) |
| 關聯與進階 | 多重參照 | multi_reference | 目標項目 id 陣列(去重並驗證存在) | targetCollectionKey、min、max(最多 50 筆) |
| 關聯與進階 | JSON 結構 | json | 任意合法 JSON 值(物件、陣列等) | 深度最多 10 層、單欄上限 64 KB(不提供條件篩選與排序) |