# 让助手帮你填表

当你打开一张表单时，助手可以将需要填写的值写入表单的未保存输入中；保存操作始终由你亲自点击应用原生的保存按钮完成。如果你没有在界面中打开对应的表单，助手则会生成草稿卡片和链接供你审阅。标记为敏感字段和「只有你能填」的字段不会发送给模型，助手也无法代填。

## 谁能用

在[工作台](/guide/workspace)中打开了已接入助手填表能力表单的组织成员。

权限与表单状态限制：
- **操作权限**：你在表单中的操作权限仍然严格遵循你对该业务操作的原生权限。
- **未接入表单**：尚未接入助手填表能力的表单，助手无法直接写入内容，系统可能会改走草稿流程。
- **表单已关闭**：若目标表单已经关闭，助手填写的内容无法放进表单，系统弹出提示「那个表单已经关闭，助手填写的内容没有放进去。」。
- **应用拒收**：若业务应用拒绝接收助手填写的内容，系统弹出提示「这个表单没能接收助手填写的内容。」。
- **受限字段**：标记为「只有你能填」、敏感、只读或系统生成的字段，助手无法代填。本人字段必须由你在表单或草稿中手动填写。

## 怎么打开

你可以通过以下方式使用助手填表或处理表单：

1. **打开表单并引用**：
   - 在应用中打开目标新建或编辑表单（弹窗、抽屉或页面表单）。
   - 点击表单标题旁的「引用」按钮（弹窗悬停提示中写明「代填」）。输入框上方会生成带有「（含表单）」后缀的引用芯片（详情参考 [引用页面与链接](/agent/quote)）。
   - 在对话输入框中向助手描述需要填写的内容并发送。
2. **未打开表单时直接对话**：
   - 若未在界面中打开对应表单，也未在对话中引用表单，直接向助手提出业务需求，助手会生成草稿卡片「助手起草了一份修改」。
   - 点击卡片上的「审阅」按钮，即可进入草稿审阅流程（详情参考 [草稿：审阅与应用](/agent/drafts)）。

## 界面一览

### 表单内提示条（未保存）

当助手成功将数据写入当前打开的表单后，表单顶部会出现未保存提示条：

| 界面元素 | 文案示例 | 说明 |
|---|---|---|
| 代填提示语 | 「助手填入了……项，还没有保存，请检查后再保存。」 | 助手成功为当前表单填入了数据项，显示具体填入的项数。内容尚未保存，提示你检查后再保存。 |
| 无差值提示语 | 「助手没有改动表单。」 | 助手保留了你已填写的内容，未产生需要修改的差值。 |
| 未覆盖提示语 | 「 另有……项你已填写，没有覆盖。」 | 助手填入部分项的同时，检测到你有已填写的字段并保留未覆盖（文案「另有」前后带空格，显示未覆盖的项数）。 |
| 操作按钮 | 「撤销」 | 点击仅撤回助手填入且你后续未手动修改过的字段与子项。 |

### 对话区域

| 界面元素 | 说明 |
|---|---|
| 「提议修改」 | 工具调用状态行。助手生成表单修改或起草修改时在消息中展示此工具状态行（旧对话中可能显示「填写表单」标签，模型已不再单独调用该标签）。 |
| 草稿卡片 | 未直接写入表单时出现，卡片包含文案「助手起草了一份修改」，并提供「审阅」按钮以及草稿对象链接。 |
| 确认卡 | 若操作属于动作类型（如删除、发布等），对话中会展示确认卡（详情参考 [提问卡与动作确认](/agent/confirm)）。已打开的同一张表单优先于动作。 |

## 常用操作

### 让助手填写当前打开的表单

1. 在工作台中打开目标应用的新建或编辑表单。
2. 点击表单标题旁的「引用」按钮（悬停提示标明「代填」）。对话输入框上方出现带有「（含表单）」的芯片。
3. 在对话输入框中描述要填写的内容或要求，点击「发送」。
4. 助手处理完成后，系统进行匹配校验：仅当当前焦点的表单与助手的提议属于同一应用、同一操作（编辑表单时必须是同一条记录），且单次仅有该单条记录时，才会将数据写入表单的未保存输入中。
5. 观察表单顶部的提示条，逐项核对助手填入的数据。如果不需要助手的修改，点击提示条中的「撤销」按钮。
6. 核对无误后，由你亲自点击表单底部的「保存」或「提交」按钮完成保存。助手不会自动保存。

### 撤销助手填写的内容

1. 在表单顶部提示条中，找到「撤销」按钮。
2. 点击「撤销」。系统仅会撤回由助手填入、且在此之后你未作二次修改的字段（包含子项）；你在助手填入后手动修改过的项不会被撤回。

### 未打开表单时通过草稿生成

1. 在助手对话框中直接描述创建需求（例如输入：帮我建一个……）。
2. 助手生成草稿卡片，卡片展示「助手起草了一份修改」，并给出草稿对象链接。助手无法自行应用草稿。
3. 点击草稿卡片上的「审阅」按钮，进入「Agent 草稿」页面。
4. 检查草稿中的字段内容。其中未填写的必填项会显示为「待填」。
5. 补充填写所需信息，确认无误后点击「应用」按钮完成创建。

### 字段覆盖与校验规则

- **已填内容保护**：你已经手动填写的内容默认不会被助手覆盖。
  - 新建表单：字段值与刚打开表单时的初始状态不同，即判定为你已填。
  - 编辑表单：字段值非空即判定为你已填。
  - 强制改写：只有你在对话中明确要求改写已填内容时，助手才会覆盖你已填写的字段。
  - 重复修改：助手上一次代填、且你之后未作修改的字段，助手可以再次调整。
- **服务端校验与过滤**：
  - 字段范围：仅接收表单声明中明确包含的字段；未声明的键会被直接拒绝。
  - 格式校验：字段类型、字符长度、枚举选项、日期格式等必须符合声明规范，不合格的值会被拒收。
  - 金额规范：金额类字段仅接收整数分。
  - 属性限制：只读字段和系统生成字段拒绝接收写入。

## 状态说明

表单代填的状态与流转逻辑如下：

```
打开表单并引用 → 助手提议修改 → 校验匹配（同应用/同操作/同记录/单条） → 写入未保存输入（显示提示条） → 人工核对 → 点击「保存」/「提交」或点击「撤销」
```

未打开表单时的流转逻辑如下：

```
对话中提出需求 → 助手生成草稿（附带草稿链接） → 点击「审阅」 → 检查并补齐「待填」项 → 点击「应用」
```

表单提示与状态对照：

| 状态场景 | 界面表现 / 提示语 | 说明 |
|---|---|---|
| 成功代填未保存 | 「助手填入了……项，还没有保存，请检查后再保存。」 | 数据已进入表单输入框，尚未提交保存。 |
| 未产生差值 | 「助手没有改动表单。」 | 助手保留了已有输入，没有新的修改建议。 |
| 存在未覆盖项 | 「 另有……项你已填写，没有覆盖。」 | 助手填入部分项，其余你已填写的项保持原样（「另有」前后带空格）。 |
| 表单已关闭 | 「那个表单已经关闭，助手填写的内容没有放进去。」 | 提议返回时目标表单已不在打开状态。 |
| 应用拒收 | 「这个表单没能接收助手填写的内容。」 | 提交的数据未通过应用校验或应用拒绝接收。 |
| 需审批/确认动作 | 弹出确认卡 | 涉及删除、发布等动作；若已打开同一张表单，则优先代填表单，不弹动作确认卡。 |

## 让助手帮你做

你可以在引用表单后，通过自然语言让助手协助填写：

> 按我刚才说的，把当前打开的表单填好。
> 把打开的报销表金额和事由填上。
> 只改当前表单里的备注，不要动其他字段。
> 帮我新建一条记录。

> **注意**
>
> - 助手填入内容后，数据仅保存在表单的未保存输入中。助手绝不会替你点击「保存」或「提交」，必须由你亲自点击完成保存。
> - 标记为「只有你能填」以及敏感字段，助手无法代填，需要你手动在表单中补充输入。

## 设置

系统没有提供单独的允许填表开关设置项。助手填表能力随工作台对话与表单「引用」操作自动提供。

## 注意事项

- **必须人工保存**：助手写入的只是未保存输入，助手无法点击保存或提交，必须由你核对后亲自点击应用的「保存」或「提交」按钮。
- **表单匹配限制**：仅当当前焦点的表单与助手的提议完全属于同一应用、同一操作（编辑时还需是同一条记录），且本次提议只有该单条记录时，才会写入未保存输入。若表单已被关闭，系统弹出提示「那个表单已经关闭，助手填写的内容没有放进去。」。若应用拒收，系统弹出提示「这个表单没能接收助手填写的内容。」。
- **动作与表单优先级**：若操作本身属于删除、发布等动作类型，通常会弹出确认卡（详情参考 [提问卡与动作确认](/agent/confirm)）；但若界面已打开了同一张表单，已打开的表单优先于动作，不弹动作确认卡。
- **数据大小与深度上限**：字符串长度、数组元素数量、对象嵌套深度以及总数据大小均设有上限，超出限制的内容会被直接拒收。
- **隐私与敏感数据脱敏**：
  - 数据发送给模型前，系统会自动剥离标记为敏感的字段、声明为只有本人填写的字段以及未声明的键。
  - 模型在接收数据时，敏感字段位置固定被标记为隐藏或不可见，模型无法获取或猜测其真实内容。
  - 若工作台无法识别该操作，发给模型的表单值为空。
- **撤销作用范围**：表单提示条中的「撤销」按钮仅撤回由助手填入且你后续未曾手动修改过的字段（包含子项）。
- **历史记录隔离**：历史消息中的旧填写结果不会再次灌入当前打开的表单中。系统仅实时处理当前这一轮对话的填写结果，且每条结果仅生效一次。
- **支持接入的应用**：人事、经营、资源管理、绩效、会员、云盘、分析、审批、「我的组织」、站点、知识库空间表单、工单、费用、合同、资料库文件夹、站点编辑器等。
- **文档应用说明**：文档应用没有空间对话框（知识库应用才有「新建知识库」和「知识库设置：……」表单）。
- **未接入或极少接入场景**：系统故意很少接入或未接入授权、凭据、支付、SSO、域名管理、多数审批过程动作、选项极多或异步搜索的选择器、复杂嵌套控件等。第三方应用必须自行接入协议才支持代填。具体以界面打开表单时是否出现提示条为准。

## 目前不支持

- 界面目前无「即将支持」标注。
- 目前并非所有表单都支持助手代填：未接入填表协议的应用与表单、授权/凭据/支付/SSO/域名等敏感配置表单、复杂嵌套控件及异步搜索选择器，目前不支持助手直接代填。
- 文档应用不支持空间对话框填表。

## 常见问题

### 为什么助手回答后，表单里没有任何变化？

可能由以下原因导致：
1. **表单不匹配**：当前打开的表单与助手的提议不是同一应用、同一操作或同一记录，或单次提议了多条记录。
2. **未引用表单**：在对话中没有带上「（含表单）」引用芯片，助手改为起草了草稿卡片「助手起草了一份修改」。
3. **表单已关闭**：提议返回时目标表单已被关闭，系统提示「那个表单已经关闭，助手填写的内容没有放进去。」。
4. **应用拒收或数据超限**：填写的数据类型不符、超出长度或嵌套深度上限，系统提示「这个表单没能接收助手填写的内容。」。
5. **内容无差值**：助手分析后保留了你已有的输入，表单提示「助手没有改动表单。」。

### 为什么表单里的部分敏感字段助手没有帮我填？

系统对隐私与敏感数据有严格保护：
- 标为「只有你能填」、敏感、只读或系统生成的字段，助手无法代填。
- 敏感字段在发送给模型时已转换为隐藏或不可见状态，模型无法获取也无法猜测。
- 属于你本人的专属字段，必须由你在表单或草稿中亲自输入。

### 点击「撤销」后，为什么我自己修改的内容还在？

「撤销」按钮仅用于撤回助手代填且你后续未手动修改过的字段。如果你在助手填入后又手动修改了某个字段，该字段被视为你的最终输入予以保留，不会被撤回。

### 助手能帮我直接保存或提交表单吗？

不能。助手只能将生成或提取的内容写入表单的未保存输入中。保存和提交操作始终需要由你亲自核对后，手动点击应用界面上的「保存」或「提交」按钮。

### 重新打开同一个表单，以前对话里的填写结果会再次填入吗？

不会。历史消息中的旧填写结果不会重复灌入当前表单。系统仅会处理当前实时对话轮次的结果，且每条结果仅生效一次。