---
{
  "id": "platform.form.overview",
  "topic": "form",
  "title": "Form 資料收集總覽",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Form 用公開分享連結收集報名、問卷、意見與 intake 資料，並把可編輯草稿和已發布快照分開。",
  "content": "Form 是 Arinova 的結構化資料收集產品，適合報名、問卷、意見回饋、調查與 intake，發布後透過公開 share link 收 responses。核心模型有兩個工作面：Actions 編輯 draft；公開連結永遠提供最近一次成功 `publish_form` 的 snapshot。已發布後再編輯時，`hasUnpublishedChanges: true` 表示填表者仍看到舊快照，必須再次發布才會更新。\n\nCanonical 入口是只驗證預計 title 與 fields、絕不建立暫時 Form 的 `validate_schema`，可一次建立初始 fields 的 `create_form`、回傳 active fields、`responseCount` 與發布狀態的 `get_form`，以及只列出執行 Agent 有 grant 之表單的 `list_forms`。權限依 `form_agent_permissions` read/write grants，不以 owner id 直接放行；建立後 owner 的 Agents 自動取得 grant，缺少 grant 時為 `permission_denied`。\n\n24 個 Actions 分為：驗證（`validate_schema`）、CRUD（`list_forms`、`get_form`、`create_form`、`update_form`）、欄位（`add_field`、`update_field`、`archive_field`）、發布（`publish_form`、`close_form`、`reopen_form`、`regenerate_share_token`）、回覆（`list_responses`、`export_responses`、`delete_response`）、blank output（`export_blank_pdf`）、生命週期（`archive_form`、`unarchive_form`、`delete_form`）、私有版本（`list_versions`、`get_version`、`create_named_version`、`restore_version`、`copy_version`）。`publish_form`、`delete_response`、`regenerate_share_token`、`delete_form`、`restore_version` 需要 UserConfirm。參數以 `arinova.action.get_schema` 為準，registry policy、action result、DB status 與 typed runtime error 永遠高於本卡。\n",
  "aliases": [
    "表單",
    "問卷",
    "報名表",
    "調查",
    "意見回饋",
    "資料收集",
    "intake",
    "form",
    "survey",
    "questionnaire",
    "registration",
    "signup form"
  ],
  "tags": [
    "form",
    "overview",
    "grants",
    "draft",
    "published"
  ],
  "relatedActions": [
    "arinova.form.validate_schema",
    "arinova.form.create_form",
    "arinova.form.get_form",
    "arinova.form.list_forms",
    "arinova.form.publish_form",
    "arinova.form.list_responses",
    "arinova.form.reopen_form",
    "arinova.form.export_responses",
    "arinova.form.export_blank_pdf",
    "arinova.form.delete_response",
    "arinova.form.regenerate_share_token",
    "arinova.form.restore_version",
    "arinova.form.copy_version",
    "arinova.form.delete_form"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/form/overview/"
}
---

Form 是 Arinova 的結構化資料收集產品，適合報名、問卷、意見回饋、調查與 intake，發布後透過公開 share link 收 responses。核心模型有兩個工作面：Actions 編輯 draft；公開連結永遠提供最近一次成功 `publish_form` 的 snapshot。已發布後再編輯時，`hasUnpublishedChanges: true` 表示填表者仍看到舊快照，必須再次發布才會更新。

Canonical 入口是只驗證預計 title 與 fields、絕不建立暫時 Form 的 `validate_schema`，可一次建立初始 fields 的 `create_form`、回傳 active fields、`responseCount` 與發布狀態的 `get_form`，以及只列出執行 Agent 有 grant 之表單的 `list_forms`。權限依 `form_agent_permissions` read/write grants，不以 owner id 直接放行；建立後 owner 的 Agents 自動取得 grant，缺少 grant 時為 `permission_denied`。

24 個 Actions 分為：驗證（`validate_schema`）、CRUD（`list_forms`、`get_form`、`create_form`、`update_form`）、欄位（`add_field`、`update_field`、`archive_field`）、發布（`publish_form`、`close_form`、`reopen_form`、`regenerate_share_token`）、回覆（`list_responses`、`export_responses`、`delete_response`）、blank output（`export_blank_pdf`）、生命週期（`archive_form`、`unarchive_form`、`delete_form`）、私有版本（`list_versions`、`get_version`、`create_named_version`、`restore_version`、`copy_version`）。`publish_form`、`delete_response`、`regenerate_share_token`、`delete_form`、`restore_version` 需要 UserConfirm。參數以 `arinova.action.get_schema` 為準，registry policy、action result、DB status 與 typed runtime error 永遠高於本卡。