# Agent 能做什么

工作台里的「助手」按你的权限读取数据并起草变更；所有数据写入必须经你人工确认（在对话中确认、在已打开的表单中检查后保存，或前往「Agent」应用审阅草稿后点击「应用」）。助手不会自动打开应用，也不会替你点击保存。

## 谁能用

组织中能够进入 [工作台](/guide/workspace) 的成员均可使用助手（包括组织管理员、普通成员、分析员、审计员等角色）。

使用助手时需满足以下权限与环境条件：
- **操作权限受限**：助手能做的事不超过你本人在各业务应用中的实际权限。你无权查看的记录，助手无法读取；你无权发起的修改，助手无法提议。
- **模型可用性**：组织必须配置可用模型。若组织没有可用模型，输入框将被禁用，并提示「你的组织还没有可用的模型，请联系管理员（「我的组织」→ 模型与额度）」。
- **运行时环境**：当前运行环境必须已部署助手运行时。若未部署，输入框将被禁用，并提示「助手还没有在这个环境中部署」。
- **工作台账号限制**：工作台仅供组织成员使用。平台运营员与开发者账号无权进入工作台，会话列表加载失败时显示标题「这个账号不能使用工作台」，并说明「工作台只给租户成员使用。平台运营员、开发者账号请用运营台、开发者门户，或换一个租户成员账号登录。」。
- **管理权限差异**：管理员可在「我的组织」中修改助手显示名、页脚、建议问法，以及在「Skill 与连接」中配置「允许助手生成组件」与「允许助手联网搜索」。普通成员无法修改上述配置。非管理员打开「我的组织」时，助手看不到该应用的管理操作（应用目录中可能仍有应用，但不会提议任何写操作）。

## 怎么打开

1. 在浏览器中访问 `https://app.{组织域名}/` 打开 [工作台](/guide/workspace)。在宽屏界面下，助手栏与对话区域并列展示；在窄屏界面下，助手显示为底部抽屉。
2. 在窄屏设备上，当业务应用全屏覆盖对话时，点击屏幕底栏的问助手条（「问」加上助手显示名，默认为「助手」）拉起助手抽屉。
3. 在工作台左侧导航点击「新会话」开启新的一轮对话，或在「会话」列表中点击已有会话进行切换。
4. 在工作台中打开系统应用「Agent」（系统自带预装应用，不能卸载）。进入后左侧提供「定时任务」「草稿」「自动应用」「Session」四个页签，应用说明为「管理定时任务；审阅、修改并应用助手起草的变更；管理自动应用；查看和整理会话」。
5. 通过对象链接跳转：
   - 在对话的草稿卡片中点击「审阅」或「查看」，系统打开「Agent」应用对应的草稿详情页。
   - 通过定时任务的对象链接（如新建或查看任务详情）直接打开「Agent」应用对应页面。

## 界面一览

### 助手栏布局

助手栏承载与助手的日常对话交互，顶部不显示名为「助手」的栏目标题：

| 区域 | 显示内容与交互说明 |
|---|---|
| 顶栏 | 显示当前使用的模型名称，提供「选择模型」下拉菜单和会话管理菜单。 |
| 空态欢迎区 | 未开始对话时展示欢迎标题：「今天想做什么？」或带有用户名的「……，今天想做什么？」；副文本显示「随时向……提问，或描述你需要处理的业务任务。」（包含助手显示名，默认助手名「助手」，组织可改）。 |
| 建议芯片区 | 无障碍标签为「试试这样问」。展示快捷问法芯片，空屏最多展示 4 条。已安装应用时默认展示：「我现在能用哪些应用？分别能做什么？」、引导查看应用内容的「帮我看看……里有什么」（带第一个已装应用的中文名）以及「总结一下最近有什么需要我处理的」；未安装应用时默认展示：「你能帮我做什么？」。组织管理员可自定义配置。 |
| 对话内容区 | 展示对话消息流、思考折叠（「思考中…」或「思考过程」）、工具执行标签行（如「提议修改」「读取应用数据」）、提议修改结果卡片，以及可点击的链接芯片。 |
| 输入框与页脚 | 底部输入框占位提示「输入问题或任务…」。输入框底部页脚默认显示：「……仅具备读取与起草权限，修改需由人工确认后生效。」（默认助手名为「助手」，组织可自定义最多 200 字的内容）。 |

### 助手能访问的应用范围

助手能触达的应用必须已在组织中安装且当前对你开启：

| 应用类别 | 应用名称 / 说明 | 助手操作范围 |
|---|---|---|
| 一方业务应用 | 「站点」「活动」「分销」「触达」「会员」「客户」「订单」「工单」「经营」「合同」「费用」「人力资源」「绩效」「审批」「资源管理」「知识库」「文档」「云盘」、[「资料库」](/apps/library)、[「分析」](/apps/analysis) | 凡界面支持的写操作，助手一般均可起草或发起动作确认；数据读取、预览、导出、连接测试等只读环节不生成写操作。在「分析」中可查询、绘图与提供探索链接，看板关注走草稿；在「资料库」中检索指定目录文本，指定目录与重新索引支持提议。 |
| 系统应用 | 「我的组织」（说明：「通讯录与权限、应用、助手、数据、品牌、安全与审计」） | 仅管理员有权让助手提议配置修改；普通成员无写操作。 |
| 系统应用 | 「消息中心」（说明：「站内信、平台通知和系统提醒」） | 仅供通知展示，助手无任何写操作。 |
| 系统应用 | 「Agent」（包含「定时任务」「草稿」「自动应用」「Session」） | 供人工审阅和管理，助手不操作该应用的界面按钮，无写操作。 |
| 系统应用 | 「数据」（对象引擎上的业务记录） | 支持新建记录、修改记录与删除记录类写操作。 |
| 第三方应用 | 市场中安装的各类第三方应用 | 遵循相同规则：只要应用声明了实体与操作，助手即可提议写入，统一进入「Agent」应用的「草稿」中审阅。 |

### 助手执行能力与标签说明

在对话过程中，展开执行过程可看到助手调用的具体能力标签：

| 对话中显示的标签 | 能力说明 | 签发与交付方式 |
|---|---|---|
| 「查看已安装的应用」 | 列出组织中已安装且对你开启的应用列表 | 只读 |
| 「生成页面链接」 | 生成特定业务页面的跳转链接，助手不会自动为你打开 | 只读（生成链接芯片） |
| 「读取应用数据」 | 按你的权限读取业务应用的列表或详情数据 | 只读 |
| 「查看数据模型」 | 检索对象引擎的数据模型定义 | 只读 |
| 「搜索记录」 | 检索对象引擎中的业务记录列表 | 只读 |
| 「读取记录」 | 获取对象引擎中特定记录的详细内容 | 只读 |
| 「解析引用」 | 解析对话中提到的业务对象并建立关联 | 只读 |
| 「生成链接」 | 把提到的业务对象转换成可点击的界面链接 | 只读 |
| 「运行分析查询」 | 已安装「分析」应用时，按你的权限执行数据分析计算，单次最多返回 200 行 | 只读；可在对话中绘制图表或提供临时探索页链接 |
| 「提议修改」 | 唯一的写操作入口：负责向表单填入未保存输入、生成动作确认卡或创建业务草稿 | 人工确认 |
| 「查看草稿」 | 读取你本人的草稿列表与内容 | 只读 |
| 「向你提问」 | 在对话流中弹出提问卡片澄清需求（仅在在线聊天中生效，定时任务不触发） | 等待你回答 |
| 「画一个组件」 | 在组织开启「允许助手生成组件」时，以可视化卡片展示内容 | 只读展示 |
| `search_knowledge` | 检索知识库、文档、知识包或资料库中的内容 | 只读（无中文标签，显示英文工具名） |
| `web_search` | 在组织开启「允许助手联网搜索」且平台配置了外部搜索服务时检索互联网 | 只读；默认关闭（无中文标签，显示英文工具名） |

> **历史标签说明**
>
> 在早期的历史会话记录中，可能会看到「起草修改」「修改草稿」「填写表单」「执行动作」等旧标签。当前系统已统一通过「提议修改」执行所有写操作提议。

## 常用操作

### 发起对话并提问

1. 在工作台中定位到助手对话栏。若当前为空会话，查看欢迎语与「试试这样问」区域的推荐芯片。
2. 点击任意一条建议问法芯片（例如「我现在能用哪些应用？分别能做什么？」），或在底部的「输入问题或任务…」输入框中输入你的业务要求。
3. 点击右下角「发送」按钮，或按键盘 Enter 键发送。
4. 助手开始处理，界面展示「思考中…」或「思考过程」折叠块，并展示调用的能力标签。
5. 助手完成查询后输出回答内容。若给出了链接芯片，点击链接可在右侧应用面板中打开对应页面。

### 查看当前能操作的应用

1. 在输入框中输入「我现在能用哪些应用？分别能做什么？」，或直接点击空会话中的对应建议芯片。
2. 按 Enter 键发送消息。
3. 助手调用「查看已安装的应用」工具。
4. 查看助手回复，获取当前组织中已为你开启的应用列表及其主要功能。

### 让助手修改业务数据

1. 在输入框中用清晰明确的一句话描述操作对象与具体任务（例如说明需要修改的应用名称、记录编号与目标字段值，详见 [常用说法示例](/agent/prompts)）。
2. 点击「发送」提交指令，观察对话中出现的「思考过程」与「提议修改」工具行。
3. 平台根据你当前所在的界面场景，自动以三种形式之一交由你把关：
   - **写入已打开的表单**：若你当前在右侧面板正开着同一应用、同一操作的表单（编辑记录时还需为同一条记录），助手会将内容填入表单中作为未保存输入。表单顶部显示提示条「助手填入了……项，还没有保存，请检查后再保存。」。核对无误后，由你自行点击应用表单自带的「保存」按钮生效；若不满意，可点击提示条中的「撤销」按钮恢复。
   - **动作确认卡**：若操作被系统声明为动作类型（包含各类删除操作），对话中将弹出确认卡。高风险与删除类操作会标注「需要谨慎」。阅读卡片中的「执行后将会」说明，确认后点击「确认」或「确认：……」（如确认具体操作标题）执行；若放弃操作，点击「取消」。
   - **生成草稿**：其余表单类写操作将生成业务草稿。对话中弹出草稿卡片，标题默认为「助手起草了一份修改」。点击卡片上的「审阅」按钮进入「Agent」应用进一步核对。

### 审阅与应用草稿

1. 在对话中的草稿卡片上点击「审阅」（已结束的草稿显示为「查看」），或在左侧导航打开「Agent」应用并切换到「草稿」页签。
2. 在草稿列表中点击目标草稿，打开草稿详情页。
3. 逐项核对拟修改字段与数值。若涉及敏感信息或密钥类字段，界面展示为 `[redacted]` 或「已填写（不显示）」，需由你本人在审阅页面中手动输入。
4. 确认所有字段无误后，点击右上角「应用」，变更正式写入业务系统；若不采纳该修改，点击「放弃」。详细审阅流程与自动规则请参阅 [草稿：审阅与应用](/agent/drafts)。

### 切换与管理会话

1. 在工作台侧栏点击「新会话」，开启全新的对话流。
2. 在侧栏「会话」列表中点击历史会话项，切换并查看先前的对话记录与执行过程。
3. 若需要清理历史记录，在对应会话菜单中执行删除会话或回退消息操作。

> **操作不可恢复**
>
> 删除会话与回退消息属于不可撤销的高风险操作，一旦执行无法恢复。但删除会话不会影响此前已经生成的业务草稿与生效的数据。

## 状态说明

助手的核心原则是读取与起草分开，写入必须由人把关。助手提出的所有写操作均不会直接生效，流转过程如下：

```
助手提议修改 ──┬──> 命中当前打开的表单 ──> 填入未保存输入 ──> 人工检查 ──> 人工点击应用「保存」
               ├──> 声明为动作（含删除） ──> 对话弹出确认卡 ──> 人工核对「执行后将会」 ──> 人工点击「确认」
               └──> 其他表单类写入 ────> 生成业务草稿 ───> 在业务应用自己的页面里审阅 ──> 人工点击「接受」
```

三种交付形式的对照如下：

| 交付形式 | 触发场景 | 界面表现 | 最终生效方式 | 可逆性 |
|---|---|---|---|---|
| 打开的表单 | 当前正开着同一应用、同一操作的表单（编辑记录时需为同一条记录） | 表单顶部出现提示条：「助手填入了……项，还没有保存，请检查后再保存。」 | 人工核对各项字段，自行点击表单中的「保存」按钮 | 可点击提示条中的「撤销」还原 |
| 动作确认卡 | 操作被声明为动作（含删除类操作） | 对话内弹出确认卡，高风险或删除类带有「需要谨慎」提示，详细列出「执行后将会」 | 人工在卡片上点击「确认」或「确认：……」 | 点击「取消」即可终止执行 |
| 草稿 | 其余表单类写操作 | 对话内展示草稿卡片，缺省标题「助手起草了一份修改」，提供「审阅」按钮 | 点击「审阅」前往「Agent」应用，人工检查后点击「应用」或「放弃」 | 命中已签署的自动应用规则且校验通过时可自动应用；人工可随时点击「放弃」 |

## 让助手帮你做

你可以通过日常对话向助手提出各类查询或起草任务。例如：

> 我现在能用哪些应用？分别能做什么？

> 帮我看看「文档」里有什么

> 总结一下最近有什么需要我处理的

> 帮我查询一下本月的销售订单总额和未结款项

> 帮我把客户张三的联系电话修改为 13800138000

> 帮我起草一份新的请假审批申请，事由为年假

**哪些操作必须经你确认：**
- **所有数据写入**：助手不能直接替你点击「应用」「保存」「提交」或「放弃」。所有数据的创建、修改与删除必须由你通过表单保存、动作确认卡或草稿审阅后手动确认生效。
- **界面导航与打开**：助手给出的对象链接与草稿卡片不会自动在右侧面板打开，必须由你手动点击链接芯片后才会展开。

## 设置

组织管理员可在「我的组织」应用中配置助手的各项参数：

| 设置项 | 作用 | 取值与默认值 | 谁能改 |
|---|---|---|---|
| 助手显示名 | 影响欢迎语、输入框页脚、移动端底栏中展示的助手名称 | 留空或填写「助手」时，界面默认显示为「助手」 | 管理员（「我的组织」→ 助手设置） |
| 页脚 | 输入框底部的能力声明与免责提示 | 默认显示为「……仅具备读取与起草权限，修改需由人工确认后生效。」（助手名随设置调整）；支持自定义文本，最多 200 字 | 管理员（「我的组织」→ 助手设置） |
| 建议问法 | 空会话中展示的引导问法芯片 | 管理端最多配置 6 条，每条最多 80 字；空屏界面最多展示 4 条 | 管理员（「我的组织」→ 助手设置） |
| 「允许助手生成组件」 | 控制助手在回复时是否可以使用「画一个组件」功能 | 默认开启。开启时说明「开：必要时画图。」；关闭时说明「关：只用文字和表格回答。」 | 管理员（「我的组织」→「Skill 与连接」，需管理员写权限） |
| 「允许助手联网搜索」 | 控制助手是否可以使用 `web_search` 检索外部互联网 | 默认关闭。开启时说明「开：需要时联网搜索，并给出来源链接。」；关闭时说明「关：只用你们自己的数据和已有知识回答。」；若平台未配置搜索服务，说明「平台未配置搜索服务，开启暂不生效。」。配置说明：「搜索词会发送到外部搜索服务，每次搜索记入审计日志。默认关闭。」 | 管理员（「我的组织」→「Skill 与连接」，需管理员写权限） |
| [模型与额度](/admin/models) | 配置组织所接入的模型服务、可用额度以及开放使用的模型列表 | 若组织未配置任何可用模型，工作台输入框将被禁用 | 管理员（「我的组织」→「模型与额度」） |

> **保存生效提示**
>
> 管理员在「我的组织」中修改并保存「Skill 与连接」设置后，系统会弹出提示「已保存，新的对话马上用上」。

## 注意事项

- **正文字数上限**：单条消息的正文内容最多 8000 字。
- **附件数量与大小限制**：单条消息默认最多添加 6 个附件；单张图片最大 5 MiB；单个文本文件（包含文本、Markdown、CSV、JSON）最大 512 KiB；附件格式仅支持 png、jpeg、webp、gif 及文本类；单条会话累计最多添加 12 个附件。
- **引用链接上限**：单条消息中最多包含 20 个对象链接引用。
- **并发消息排队**：当助手正在处理当前任务时，新发送的消息将进入队列排队，排队上限为 20 条，新消息不会打断助手当前轮次的执行。
- **单轮步数上限**：助手单轮处理存在最大步数限制。当复杂任务达到步数限制时，界面提示：「已达到单次处理的最大步数，可以继续对话让助手接着做。」，你可以发送新消息让助手继续完成后续步骤。
- **数据保密与安全过滤**：敏感字段、限定仅本人填写的字段、未在应用中声明的表单字段均不会发送给模型；界面中敏感内容按 `[redacted]` 或「已填写（不显示）」展示；密钥类敏感配置必须由你本人在草稿审阅页面手动填写。
- **防伪造草稿链接**：若助手在回答中编造了不存在的草稿对象链接，系统会自动将其替换显示为「（草稿链接无效：这次没有真正创建草稿）」。
- **移动端适配特性**：在屏幕宽度小于 700 的移动设备上，工作台采用单栏展示，助手呈现为底部抽屉；触屏点击不会自动弹出虚拟键盘；底栏提供包含助手名的按钮以供拉起助手抽屉。
- **无人值守场景限制**：在 [定时任务](/agent/tasks) 或外部客户端会话中，由于没有人工在对话中交互，助手不会弹出动作确认卡或提问卡；在定时任务中，助手无法直接修改「定时任务」本身，若需要创建任务，会提供预填链接供你在表单中手动保存。
- **系统应用写操作限制**：「消息中心」和「Agent」系统应用未向助手暴露任何写操作能力，助手无法代为点击或操作这两个应用的任何按钮。
- **不可恢复操作**：删除会话与回退消息无法撤销恢复（但业务草稿不受影响）。

## 目前不支持

- 助手无法直接执行二进制文件上传操作（例如上传头像、组织 Logo、扫描件、直接将图片上传到知识库等；草稿仅支持携带结构化数据字段）。
- 助手无法自动为你打开右侧应用面板、页面或草稿链接，所有链接必须由你手动点击后展开。
- 助手无法替你点击「应用」「保存」「提交」或「放弃」按钮。
- 助手无法代为执行修改密码、通行密钥、本人 MFA 等针对用户本人身份安全的操作。
- 界面中不存在标注为「即将支持」的功能，且工作台界面中没有叫问助手的按钮（应用内现统一使用「引用」按钮；仅在窄屏底栏显示带助手名的提问按钮）。

## 常见问题

### 为什么输入框被禁用，无法输入消息？
请检查输入框中的禁用提示文案：
- 若显示「你的组织还没有可用的模型，请联系管理员（「我的组织」→ 模型与额度）」，说明组织尚未配置可用的大模型或模型额度已耗尽，需联系管理员前往配置。
- 若显示「助手还没有在这个环境中部署」，说明当前的部署环境未安装助手运行时服务。
- 若账号属于平台运营员或开发者，访问工作台会提示「这个账号不能使用工作台」及「工作台只给租户成员使用。平台运营员、开发者账号请用运营台、开发者门户，或换一个租户成员账号登录。」，需切换为组织成员账号登录。

### 助手可以直接帮我保存数据或提交修改吗？
不能。助手仅具备读取与起草权限。所有的业务修改必须经过人工确认：若表单已打开，助手填入未保存输入，由你核对后亲自点击保存；若属于动作类操作，需在对话中的确认卡上点击「确认」；若属于其他表单修改，需前往「Agent」应用的草稿页面核对后点击「应用」。

### 为什么点击助手回复中的链接没有自动打开应用？
助手给出的所有页面链接与草稿链接均以芯片形式呈现，系统严格禁止助手自动打开页面或进行页面导航。只有当你主动点击对应的链接芯片时，工作台才会在右侧面板中打开对应应用或记录。

### 对话提示「已达到单次处理的最大步数」该怎么处理？
为了保证执行稳定，助手的单轮执行步数设有上限。当任务较长触达上限时，界面会提示「已达到单次处理的最大步数，可以继续对话让助手接着做。」。此时当前轮次已结束，你只需在输入框中发送新消息（如「继续」），助手便会接着上一轮的进度继续执行。

### 助手可以帮我修改个人密码或上传头像吗？
不能。出于安全考虑，助手不能执行修改密码、通行密钥、本人 MFA 等针对用户本人身份认证的操作。此外，草稿系统仅支持结构化字段，助手无法直接上传头像、Logo、扫描件或图片等二进制文件。