# AI 采集表

用对话创建表单，填报人用说话、点选或拍照提交，数据自动存入工作簿。

使用指南 · 模块: collection · 管理人员 / 使用者 · 部署形态：资料未说明 · 已确认产品版本：资料未说明 · 来源：编辑整理 · 按产品 4.2.76-1110（CLI 0.0.18）核对；私有部署的旧版本可能不包含近期变化。

AI 采集表用来收集结构化数据，例如各门店的采购需求、巡店记录。管理者用一句话描述要收集什么，AI 生成表单；填报人打开链接，用自然语言、语音、点选或拍照填写，AI 整理成待确认的记录，确认后存入[工作簿](https://docs.asktable.com/data/connect#%E5%B7%A5%E4%BD%9C%E7%B0%BF)，可以直接被智能体分析。

AI 采集表目前为 Beta。创建和管理需要项目负责人或项目管理员；填报人不需要加入项目。

入口：「更多」→「采集表」。

## 创建表单

**描述要收集的内容**

新建采集表后，在对话中描述需求，例如「帮我收集门店、商品、数量和需求日期」。AI 生成题目，你可以继续调整，例如「把需求日期设为必填」。也可以附上 Excel 或 CSV 作为参考资料。

题型包括文本、数字、日期、单选、多选、位置和图片等，并可以校验手机号和身份证号。选项可以引用已有工作表，全国地级市可以使用内置资料。

**选择填写范围**

| 范围        | 说明                |
| --------- | ----------------- |
| 仅组织成员     | 本组织成员登录后填写，无需加入项目 |
| 任何人（无需登录） | 拿到链接的人都可以填写       |

发布后填写范围不能修改。

**测试并发布**

点「测试填写」体验填报流程，测试数据不会写入正式数据表。确认后点「发布」，复制链接发给填报人。

## 填报

填报人打开链接，告诉 AI 要填写的内容，例如「人民路店需要采购苹果 20 箱，下周一到货」。AI 会整理成记录，缺项或格式不对时会提示。

- 手机端可以按住说话、拍照识别凭证、在地图上选点，选择题直接点选。
- 页面显示填写进度。填完后核对内容，点「确认提交」后写入数据表，并显示提交回执。
- 桌面端分栏显示题目、进度和对话。

## 管理采集

- **查看数据**：数据写入工作簿。单选、多选和引用资料分别保存为可查询的数据表及关联，可以按选项筛选。采集写入的工作表在工作簿中为只读。
- **暂停、恢复、结束**：暂停后不接受新的填写，已开始的可以继续。结束后不能再提交，已有数据和草稿保留；管理员可以重新开放，原链接继续有效。
- **修改已发布的表单**：在对话中提出修改，修改先保存为草稿，确认后「确认并应用」才生效。已提交的答案保留；改变题型时，旧记录在新题目下留空；未提交的填报人需要按新版重新填写。

## 怎样用好

- **一个采集表围绕一类记录。** 例如「一份采购需求」，每次填写产生一条主记录，不要把多种无关的记录放在一个表中。
- **能选就不填。** 门店、商品等用选项或引用已有工作表，比让填报人自由输入更准确，也便于后续分析。
- **先测试再发布。** 用「测试填写」以填报人的身份走一遍，检查提示是否清楚。

## 私有部署

- 位置题如需使用腾讯地图选点，为 API 配置 `AT_COLLECTION_TENCENT_MAP_KEY`。
- 从旧版 AI 采集升级时，旧的采集定义、会话和数据不会迁移。升级前备份所需数据，清理旧采集及其专属工作簿后重新创建；借用或共享的工作簿不要清理。

## 常见问题

| 现象          | 原因                      | 处理             |
| ----------- | ----------------------- | -------------- |
| 填报人提示链接不可访问 | 范围为仅组织成员，但填报人未登录或不是组织成员 | 让填报人以组织成员身份登录  |
| 提示请按最新版重新填写 | 表单已应用新版本                | 点「填写最新版」重新填写   |
| 提示采集已暂停或已结束 | 管理员暂停或结束了采集             | 联系管理员恢复或重新开放   |
| 模型处理失败      | 模型返回异常                  | 在原消息上重试，不会重复写入 |