# 引用页面与链接

「引用」是 Raise 工作台连接当前操作界面与助手的上下文传递机制。只有你在界面上主动点击「引用」，当前页面、选中项或弹窗表单才会放入对话输入框；助手会据此为你解答疑问或代填表单，点击后不会自动发送消息。在对话中出现的对象链接由平台根据真实数据解析并显示名称，点击后即可在应用面板中打开对应内容，带有定位标记的链接还可直接定位并滚动到指定的区块、分区或标签页。

## 谁能用

「引用」功能仅在[工作台](/guide/workspace)内嵌的一方应用或已接入协议的应用中提供，且该应用需要向平台正常上报当前页面信息。

- **适用范围**：在[工作台](/guide/workspace)内嵌打开的应用页面、文档、以及带有表单的弹窗或抽屉可以使用「引用」。
- **不可用界面**：在浏览器中独立打开的应用、管理控制台以及工作台自身的部分弹窗（如确认框）不会显示「引用」按钮。
- **无障碍与读屏**：仅供屏幕阅读器读取的标题不提供「引用」按钮。
- **组织支持**：如果「我的组织」尚未接入页面感知能力，你在界面中可能看不到「引用」按钮。第三方应用必须自行接入协议才会显示该按钮。
- **未接入页面**：分析看板、账户页等未接入按钮的页面，不提供「引用」功能。
- **链接查看权限**：对于对话中生成的对象链接，如果内容不存在、你缺少查看权限或组织未安装对应应用，链接将显示为不可点击状态；平台不会向你区分该内容是不存在还是没有权限。

## 怎么打开

你可以在以下几处入口找到并使用「引用」功能，或通过链接快速打开界面：

- **应用页面**：在应用页面顶部标题右侧，点击「引用」按钮。
- **文档页面**：在文档页面标题正下方，点击「引用」按钮。
- **弹窗与抽屉**：在带有表单的弹窗或抽屉标题右侧，点击「引用」按钮，可将弹窗连同里面的表单一起交给助手。
- **外部链接打开**：在浏览器中直接访问带打开参数的工作台外链地址。该地址必须指向合法的对象链接，不能包含空格或反斜杠，且长度不能超过 1024 个字符。页面成功打开后，浏览器地址栏中的打开参数会被自动去除。
- **窄屏模式**：在窄屏设备上，点击「引用」后，系统会自动将底栏的助手抽屉拉起至半屏，展开至底栏问助手的输入层级。

> **提示**
>
> 输入框中的「+」按钮用于从知识库、文档、云盘、资料库或成员中另附记录与文件。这属于附带文件操作，不是页面引用，具体操作可参考[对话](/agent/chat)。

## 界面一览

### 「引用」按钮形态

![应用页标题旁的「引用」](/shots/agent-quote-button.webp)

图：应用页标题旁的「引用」

1. 当前页标题（Agent 的「Session」）
2. 标题旁「引用」：把当前页交给助手，不会自动发送
3. 点「引用」后芯片出现在这支输入框上方

| 状态 / 场景 | 界面文字 | 悬停提示语 |
|---|---|---|
| 默认状态 | 「引用」 | 「把这个页面引用到对话里，助手据此回答；不会自动发送」 |
| 页面上有选中项 | 「引用……项」（例如引用 1 项） | 「把选中的……项引用到对话里；不会自动发送」 |
| 刚点击后约 1.5 秒 | 「已引用」（带对勾图标） | - |
| 弹窗或抽屉标题旁 | 「引用」 | 「把这个弹窗（和里面的表单）引用到对话里，助手据此回答或代填；不会自动发送」 |

### 输入框芯片

点击「引用」后，输入框上方会生成对应的可关闭芯片：

| 属性 | 表现说明 |
|---|---|
| 文案格式 | 基础格式为“应用名 · 页面或弹窗标题”；包含选中项时追加“选中……项”；包含表单时追加「（含表单）」。 |
| 弹窗标题回退 | 弹窗若无标题，依次取表单标题、页面名；若均无则回退为「当前界面」。文案中绝对不会出现「弹窗」二字。 |
| 示例样式 | 「会员 · 张三」「会员 · 张三 · 选中 1 项」「会员 · 新建会员（含表单）」「会员 · 编辑会员 张三（含表单）」「会员 · 当前界面」。 |
| 移除按钮 | 点击芯片上的叉号可将其移除，屏幕阅读器提示为「不引用这个」。 |
| 发送行为 | 支持只带引用芯片、不输入任何文字直接发送。 |
| 引用快照 | 引用成功后，若你在右侧切换到其他页面，输入框中已添加的芯片不会改变，保留点击时的快照。 |
| 重复限制 | 相同的页面（相同应用、路径与种类）不会重复添加。 |
| 数量上限 | 单条消息最多添加 20 个引用。超出时系统弹出提示「一条消息最多带……个引用」。 |

### 对话中的链接展示

消息发出后，对话中的对象链接与卡片遵循以下规则展示：

| 展示形态 | 规则与说明 |
|---|---|
| 消息末尾链接 | 用户消息末尾每个链接单独占一行，下方展示对应的芯片。 |
| 标签命名来源 | 链接芯片上的名称由平台根据真实数据解析得出，不会使用助手自己起的名字。 |
| 解析成功 | 显示对象的真实标题；若对象种类与标题不同，会额外标出种类。带有深链定位时，芯片标题会组合为“记录名 · 位置名”格式（例如「张三 · 合同」）。 |
| 句中提及 | 正文语句中提到对象时只显示记录名称，不显示图标。 |
| 草稿链接 | 指向草稿的对象链接在界面中固定显示为「草稿」，不走普通链接解析。详情可参考[草稿：审阅与应用](/agent/drafts)。 |
| 加载中状态 | 链接正在解析加载时，正文中显示省略号「…」，芯片显示骨架占位效果。 |
| 失败或无权 | 内容不存在、无权或未安装应用时，链接显示为不可点击的种类词。种类词支持：「页面」「文档」「文件」「记录」「列表」「文件夹」「空间」「看板」；若均对不上则显示类型原文；知识包可回退显示为「知识包」。 |
| 下方相关内容 | 助手回答下方会以横向滑动条展示卡片，其屏幕阅读器标签为「相关内容 · ……」，界面无可见大标题。对于无权限或未安装应用的引用，系统直接不显示卡片。 |
| 外部网页链接 | 对话中的普通 `https://` 链接会在浏览器新标签页中打开。 |

## 常用操作

### 引用当前页面或选中项

![点「引用」后输入框上的芯片](/shots/agent-quote-chip.webp)

图：点「引用」后输入框上的芯片

1. 刚点过约 1.5 秒显示「已引用」，随后恢复「引用」
2. 芯片：「应用名 · 页面标题」；叉掉即「不引用这个」
3. 点击不会自动发送，仍可改字
4. 「发送」：可只带芯片、不打字就发出

1. 在[工作台](/guide/workspace)中打开内嵌的应用页面或文档。
2. 若需要引用特定记录，先在列表勾选数据项；若需要引用整页，保持无选中状态。
3. 在页面标题右侧（文档在标题正下方）找到「引用」按钮（有选中项时显示为「引用……项」）。
4. 点击「引用」。按钮变为「已引用」并显示对勾图标，持续约 1.5 秒。
5. 观察底部的对话输入框。输入框上方出现对应的卡片芯片，此时消息不会自动发出。
6. 在输入框输入你想让助手协助的内容，或直接保持空白。
7. 点击「发送」。发送后会带上当前页面的对象链接（页面内的定位标记会被自动去除）。若包含选中项，会同时带上选中的对象。

> **提示**
>
> 如果你不点击「引用」，助手无法获知你当前正在浏览哪一个页面，焦点处于完全空白状态。

### 引用弹窗与表单

1. 在应用中打开需要填写或咨询的弹窗或抽屉。
2. 在弹窗或抽屉标题右侧找到「引用」按钮。
3. 点击「引用」。按钮变为「已引用」约 1.5 秒，输入框生成带有「（含表单）」的芯片。
4. 输入你的代填或咨询要求，然后点击「发送」。
5. 发送时若该弹窗表单依然处于打开状态，系统会将发送**此刻**的表单填写值（包括尚未保存的修改）完整带给助手。

> **注意**
>
> - 页面上的「引用」按钮在弹窗打开时**不会**把弹窗内的表单带入对话；若要带入表单，必须点击弹窗或抽屉标题旁的「引用」按钮。
> - 若单条消息中引用了多个带有表单的界面，系统仅提取**最后一个**处于打开状态的表单数值。
> - 如果当前界面既没有浮层也没有表单，点击弹窗引用不会生成芯片。

### 打开对话中的链接

1. 在助手回答中，找到句中提到的记录名、末尾的链接芯片，或回答下方的相关内容卡片。
2. 点击该链接或芯片。
3. 解析成功时，右侧应用面板会自动打开对应的页面，并保留查询参数与锚点。
4. 若打开失败，系统会弹出提示「这个链接打不开：内容可能已删除、你没有权限，或者对应的应用没有安装」。
5. 若链接已进入应用但在应用内部二次打开失败，系统会提示「无法打开这个引用」。

### 使用深链定位到区块或标签页

1. 助手在对话中可以生成带定位标记的对象链接，用来指向区块、分区或标签页。
2. 点击该链接，工作台会把定位标记原样交给目标应用。
3. 应用会自动寻找带有该标记的区块，将该区块滚动到视口中部并聚焦，同时添加描边高亮约 2.2 秒。系统等待应用响应的最长超时时间为 6 秒。
4. 若链接指向标签页，应用会自动切换到对应页签。
5. 成功定位时，解析出的芯片标题会组合为“记录名 · 位置名”格式（例如「张三 · 合同」）。
6. 若定位标记未在应用中声明或格式不对，系统仍会正常打开记录或页面本身，但不会在芯片标题中追加位置名。

> **提示**
>
> 在页面上主动点击「引用」按钮发出的链接会自动去掉定位标记，不会把你当前页面滚动到的具体区块当作引用目标。

### 通过外部链接打开工作台页面

1. 在浏览器地址栏中输入带打开参数的工作台对象链接并访问。
2. 系统尝试解析并打开对应的应用与页面。
3. 若链接指向的应用未安装或你缺少权限，系统提示「这个链接指向的应用没有安装，或你没有权限打开。请联系组织管理员。」。
4. 若组织已安装该应用但目标页面不存在，系统提示「……里没有这个页面，可能已被删除。」（例如提示会员应用里没有这个页面）。
5. 页面打开成功后，浏览器地址栏中的打开参数会自动清除。

## 状态说明

### 「引用」按钮状态流转

「引用」按钮在操作过程中的状态变化如下：

```
「引用」或「引用……项」 → 点击后变为「已引用」（约 1.5 秒） → 恢复为「引用」或「引用……项」
```

| 状态 | 按钮显示 | 触发时机与行为 |
|---|---|---|
| 默认状态 | 「引用」 | 页面或弹窗处于正常浏览状态，当前无选中项。 |
| 选中状态 | 「引用……项」 | 页面勾选了数据项（如勾选 2 项时显示为引用 2 项），点击后将当前页及选中项一起加入输入框。 |
| 点击反馈 | 「已引用」 | 点击按钮后立刻切换，带有对勾图标，持续约 1.5 秒后自动恢复为原文字。 |

### 链接解析状态

| 链接状态 | 界面表现 | 说明 |
|---|---|---|
| 解析中 | 句中显示「…」，芯片显示骨架占位 | 系统正在向平台请求解析真实对象数据。 |
| 解析成功 | 显示真实标题及分类，支持点击打开 | 平台成功解析对象，点击可在右侧应用面板打开。 |
| 解析失败 / 无权 / 未安装 | 显示不可点击的灰色种类词（如「页面」「记录」） | 内容已删除、无权查看或应用未安装，系统不会区分具体原因，且回答下方不展示对应卡片。 |

## 让助手帮你做

当你把页面、选中项或弹窗表单引用到对话后，助手可以基于上下文为你解答或执行任务。你可以这样对助手说：

> 结合我引用的这份文档，总结主要修改点并列出后续待办。
> 请根据我选中的这几条记录，对比它们的到期时间与金额差异。
> 我引用的弹窗里有一张新建表单，请参考客户信息帮我代填未保存的内容。
> 帮我生成一个指向当前引用记录的页面链接，方便发给同事。

> **提示**
>
> - 助手只能在你点击「引用」后才能感知到当前页面、选中项与表单，助手不能在你未点「引用」时假装知道你在看哪一页。
> - 助手生成页面链接时只会产出链接芯片，不会声称已经为你打开该页面。
> - 助手不能代替你点击对话中的链接，也不能自动切换你右侧的应用面板。
> - 涉及表单代填时，助手代填的内容需要你在界面上核对并保存，具体代填规则可参考[让助手帮你填表](/agent/forms)。

## 设置

本功能无需单独配置，也没有设置项开关。

系统已取消以往的引用开关配置，对话输入框中也不再提供「带上当前页面」等旧选项。所有引用操作完全由你在界面中主动点击「引用」触发。

## 注意事项

- **引用数量上限**：单条消息最多附带 20 个引用。超出上限时，系统会弹出提示「一条消息最多带……个引用」。
- **防重复添加**：针对同一个页面（相同的应用、路径与种类），系统不会在单条消息中重复添加多个相同的芯片。
- **路径长度限制**：当页面的焦点路径过长（超过 512 个字）时，助手可能只能读取到路径字符串，而无法获取完整的页面上下文现场。
- **点击才发送**：点击「引用」仅将芯片放入输入框，绝对不会自动发送消息。你可以随意编辑文字，或随时点击芯片上的叉号取消引用。
- **表单提取时机**：若引用了表单，系统是在你点击「发送」消息的瞬间读取表单值。如果发送前你关闭了弹窗，助手将无法获取该表单内容。如果一条消息附带了多个表单引用，系统仅取最后一个处于打开状态的表单。

## 目前不支持

- **快捷键引用**：目前没有提供用于触发「引用」的键盘快捷键。
- **部分管理与看板页**：管理控制台的部分页面、分析看板以及个人账户设置页等尚未接入「引用」按钮。
- **未接入协议的第三方应用**：未接入协议的第三方应用无法使用页面引用与上下文感知功能。
- **引用时保留区块定位**：从页面点击「引用」发出的链接会自动去掉定位标记，不支持直接将页面当前滚动到的具体区块记录为引用目标。

## 常见问题

### 为什么我在某些页面或弹窗上看不到「引用」按钮？
「引用」按钮仅出现在工作台内嵌的一方应用或已接入协议的应用中，且要求应用正常上报了当前页面。独立打开应用、管理控制台、分析看板、账户页，以及确认框和仅供读屏的标题，均不提供「引用」按钮。此外，若「我的组织」未接入页面感知能力，也可能看不到该按钮。

### 为什么对话里的链接是灰色的不可点击，也没有显示具体名字？
当链接指向的内容已删除、你没有对应权限，或者你的组织尚未安装该应用时，平台无法解析出真实对象名称。此时链接会以不可点击的种类词（如「页面」「记录」）显示，系统不区分内容是不存在还是缺少权限，点击时会弹出提示「这个链接打不开：内容可能已删除、你没有权限，或者对应的应用没有安装」。

### 引用了弹窗表单后，如果我继续修改了表单内容，需要重新点「引用」吗？
不需要。点击「引用」只是在输入框中建立了表单关联。在你最终点击「发送」消息时，只要该弹窗依然处于打开状态，系统会自动读取你发送**此刻**填写的最新表单数值（包括尚未保存的草稿修改）一并提交给助手。

### 为什么在弹窗打开时点击背后页面的「引用」，助手看不到弹窗里的表单？
页面标题旁的「引用」只会引用底层的页面本身。要想让助手获取弹窗和里面的表单内容，必须点击弹窗或抽屉标题右侧的「引用」按钮。

### 引用页面后如果我切换了右侧页面，输入框里的芯片会变吗？
不会变。输入框中的芯片采用快照机制，记录的是你点击「引用」那一刻的界面信息。即使你随后在右侧面板切换到其他页面，已添加的芯片依然保持原样。