# 搜索与知识问答

工作台没有全局搜索框。组织内的知识库、文档、知识包和资料库由助手在对话中检索并回答，并在正文中用对象链接标明出处；公开网页搜索需要管理员在管理后台开启「允许助手联网搜索」。查找各类业务单据与记录时，仍使用各业务应用自带的列表搜索框，或在对话中让助手执行「搜索记录」。

## 谁能用

- **全体组织成员**：组织成员在 [工作台](/guide/workspace) 的助手对话中直接提问即可发起检索。检索结果会优先按照你在各个应用中的实际可见范围进行过滤；你无权查看的资料，助手检索不到。
- **管理员配置联网**：只有组织管理员可以配置联网搜索。查看「我的组织」中的「Skill 与连接」页面需要管理员读取权限，修改「允许助手联网搜索」开关需要管理员写入权限。普通成员无权查看或修改该配置。
- **平台配置前提**：如果平台未配置外部搜索服务，管理开关旁会显示「平台未配置搜索服务，开启暂不生效。」，开启该开关暂不生效，对话中也不会出现外部搜索工具。
- **知识检索常驻**：系统没有提供关闭内部知识检索的开关，知识检索能力随助手常驻，所有可以使用助手的成员均可使用。

## 怎么打开

- **对话输入框直接提问**：在 [工作台](/guide/workspace) 助手栏的对话输入框中直接输入问题（例如“制度里加班怎么报？”），发送后助手自动检索并回答。
- **管理员「Skill 与连接」设置页**：管理员在左侧导航进入「我的组织」，在菜单中点击「Skill 与连接」，进入后可找到「联网搜索」小节及「允许助手联网搜索」开关。
- **应用内列表搜索框**：在各个业务应用（如客户、订单、合同等）的列表页面顶部，使用应用自带的列表搜索框查找本应用的业务单据和对象记录。各应用自带的列表搜索框用于找本应用记录，不属于本页介绍的平台检索。
- **输入框手动添加材料**：在对话输入框点击「+」按钮，手动选择并附带「知识库」「文档」「云盘」「资料库」中的引用。这属于手动附带参考材料，不是助手的自动检索，具体规则可参考 [引用页面与链接](/agent/quote) 与 [对话](/agent/chat)。

## 界面一览

### 对话中的检索步骤与来源展示

在对话过程中，助手执行检索以及展示来源的具体界面形态如下：

| 界面元素 | 显示内容与形态 | 说明 |
|---|---|---|
| 知识检索步骤 | 显示英文 `search_knowledge`，带有书本图标 | 执行知识检索时的步骤标签，界面无中文折叠名。 |
| 联网搜索步骤 | 显示英文 `web_search`，带有地球图标 | 执行公开网页搜索时的步骤标签，界面无中文折叠名。 |
| 记录检索步骤 | 显示「搜索记录」 | 用于检索工作区对象或业务记录，不属于知识库全文检索。 |
| 正文引用链接 | 显示为可点击的真实名称 | 正文中的对象链接由系统解析为对象真实标题，点击后可在右侧应用面板打开查看。 |
| 消息下方横条 | 屏幕阅读器读作「相关内容」加数量 | 助手回答卡片下方的横向展示条，显示引用的相关内容条数，界面无单独的「来源」标题或脚注组件。 |
| 文档预览卡片 | 包含文档标题与摘录内容 | 针对文档类引用内容展示的预览卡片。 |
| 网页搜索结果 | 输出为标准的 `https://` 链接 | 助手在正文中输出为普通的超链接，点击在浏览器新标签页中打开，没有专用的网页芯片。 |
| 链接解析失败回退 | 显示为灰色的种类词 | 当内容不存在、你缺少权限或组织未安装对应应用时，链接显示为不可点击的种类词，包括：「页面」「文档」「文件」「记录」「列表」「文件夹」「空间」「看板」。 |

### 「Skill 与连接」管理页（管理员）

管理员打开「我的组织」下的「Skill 与连接」页面，包含以下内容：

| 区域 / 小节 | 界面文字与选项 | 功能与说明 |
|---|---|---|
| 页标题 | 「Skill 与连接」 | 技能与连接配置页面标题。 |
| 「图表与组件」 | 说明：「组件在隔离环境运行，无网络，读不到你们的数据。」<br>开关：「允许助手生成组件」 | 控制助手是否可以在对话中生成运行图表与交互组件。 |
| 「联网搜索」 | 说明：<br>- 开启时：「开：需要时联网搜索，并给出来源链接。」「搜索词会发送到外部搜索服务，每次搜索记入审计日志。默认关闭。」<br>- 关闭时：「关：只用你们自己的数据和已有知识回答。」<br>- 平台未配置时提示：「平台未配置搜索服务，开启暂不生效。」<br>开关：「允许助手联网搜索」 | 控制助手是否可以在对话中调用外部搜索服务检索公开网页。 |
| 保存操作 | 按钮：「保存」 | 点击后保存配置，保存成功后弹出提示「已保存，新的对话马上用上」。 |

### 检索能力分类对比

助手提供的各类检索能力对比如下：

| 种类 | 检索对象 | 默认状态 | 工作机制与说明 |
|---|---|---|---|
| 知识检索 | 「知识库」「文档」知识包「资料库」段落 | 一直开启 | 随助手常驻。包含向量索引时默认执行混合检索，自动丢弃相关度过低的段落。 |
| 联网搜索 | 公开网页的标题和摘要 | 默认关闭 | 需管理员开启「允许助手联网搜索」，且平台已配置外部搜索服务。 |
| 记录检索 | 工作区对象与业务单据记录 | 有对应实体类型时提供 | 用于查找应用内的具体业务数据，不进入知识库全文检索。 |

### 知识检索的范围与格式限制

并非所有组织数据都会进入知识检索，具体范围规则如下：

| 数据类别 | 是否进入知识检索 | 详细规则说明 |
|---|---|---|
| [「知识库」](/apps/wiki) | 是 | 组织安装知识库后，检索知识库页面内容，出处显示为可点击的页面名称。 |
| [「文档」](/apps/doc) | 是 | 组织安装文档后，检索文档页面内容，出处显示为可点击的文档名称。 |
| 知识包 | 是 | 组织已安装的知识包内容会被检索。 |
| [「资料库」](/apps/library) | 是（有条件） | 仅检索管理员指定目录下的文本文件块。单文件与抽取长度有上限，每个文件进入向量索引的段数有上限。 |
| 业务应用记录 | 否 | 审批、会员、客户、订单、工单、经营、合同、费用、人力资源、绩效、资源管理等结构化业务数据不进入知识检索。请在对应应用中查找或让助手「搜索记录」。 |
| [「云盘」](/apps/storage) | 否 | 云盘不是知识源，云盘文件名和文件内容均不进入知识检索。需在输入框点击「+」手动引用文件。 |
| 资料库未指定目录 | 否 | 未经管理员指定为知识目录的文件不参与检索。 |
| 扫描件 PDF | 否 | 没有文字层的扫描件 PDF 无法提取文本，不进入知识检索。 |
| 媒体与压缩包 | 否 | 表格、幻灯片、音频、视频、图片、压缩包不进入知识检索。 |
| 网页正文全文 | 否 | 联网搜索仅获取公开网页的标题和摘要，不跟重定向，不抓取网页正文全文。 |
| [「分析」](/apps/analysis) | 否 | 「分析」应用拥有独立的查询机制，不属于本页的平台检索。 |

> **资料库支持的文件格式**
>
> [「资料库」](/apps/library) 仅支持读取并索引以下格式的文本文件：`txt`、`md`、`csv`、`docx`、`html` 以及带有文字层的 `pdf`。

## 常用操作

### 检索组织内部资料

1. 在 [工作台](/guide/workspace) 助手栏底部的对话输入框中，输入你想查询的问题（例如“制度里加班怎么报？”），按回车键或点击发送按钮发送消息。
2. 在对话消息流中，查看助手的检索执行过程。助手调用知识检索工具（步骤可能显示带有书本图标的 `search_knowledge`），在组织已安装的知识库、文档、已装知识包及资料库指定目录中检索匹配段落。
3. 在助手生成的回答中，查阅结合组织资料整理的内容。正文中包含来源处会自动标注为可点击的真实名称，回答下方会展示相关内容横条，文档类内容还会附带标题与摘录预览卡片。
4. 在正文引用处或预览卡片中，点击资料名称。系统在右侧应用面板中打开对应的知识库页面、文档或资料库文件，供你阅读原文。

> **提示**
>
> 组织必须安装对应应用，助手才会检索其内容：只有组织安装了[「知识库」](/apps/wiki)、[「文档」](/apps/doc)、对应知识包或配置了[「资料库」](/apps/library)指定目录，相关资料才会被检索到。

### 开启与使用公开网页联网搜索

1. 在 [工作台](/guide/workspace) 左侧导航栏中，点击「我的组织」，进入组织管理控制台。
2. 在「我的组织」页面导航中，点击「Skill 与连接」，进入技能与连接配置页。
3. 在页面中的「联网搜索」小节中，点击「允许助手联网搜索」开关，将其切换为开启状态。若开关旁提示「平台未配置搜索服务，开启暂不生效。」，说明底层平台未配置搜索服务，此时开启暂不生效。
4. 在页面底部，点击「保存」按钮。保存成功后，系统弹出提示「已保存，新的对话马上用上」。
5. 在工作台左侧导航栏中，点击「新会话」按钮，开启一轮全新的对话。
6. 在新会话的对话输入框中，输入关于外部公开信息或时效性内容的问题并发送。助手执行联网搜索（步骤可能显示带有地球图标的 `web_search`），获取网页标题与摘要后生成回答，并在正文中给出可点击的 `https://` 链接。
7. 在回答正文中，点击 `https://` 链接。浏览器会在新标签页中打开目标网页，供你核对外链与原始内容。

> **注意**
>
> - 开启联网搜索后，你的搜索词会发送到外部搜索服务，每次搜索均会记入审计日志。向助手提问时，切勿在搜索词中包含组织机密信息。
> - 修改联网搜索开关后，必须新开一轮对话才能生效，已有会话不会中途变更为联网状态。

### 查找业务单据与记录

1. 在 [工作台](/guide/workspace) 左侧导航栏中，点击进入目标业务应用（例如客户、订单、合同或工单）。
2. 在业务应用顶部的列表搜索框中，输入单据名称或编号等关键词，按回车键进行筛选。系统在当前列表展示匹配的业务单据（此搜索属于应用自身功能，不进入知识检索）。
3. 若希望在对话中查找记录，在助手输入框中输入查询指令（例如要求助手「搜索记录」或「读取应用数据」）。助手通过对象检索工具查找业务记录并展示卡片，该操作不会进入知识库全文检索。

## 状态说明

### 联网搜索配置状态流转

联网搜索开关的配置状态与提示流转如下：

```
关闭状态（默认） ↔ 开启状态（已配置搜索服务并保存）
       ↓
未配置服务状态（开启暂不生效）
```

| 状态 | 界面表现与提示 | 行为说明 |
|---|---|---|
| 关闭（默认） | 开关处于关闭状态。<br>说明：「关：只用你们自己的数据和已有知识回答。」 | 助手不具备网页搜索能力，执行任务时只基于组织内部数据与已有知识回答。 |
| 开启 | 开关处于开启状态。<br>说明：「开：需要时联网搜索，并给出来源链接。」「搜索词会发送到外部搜索服务，每次搜索记入审计日志。默认关闭。」 | 助手在需要时会调用外部搜索服务检索公开网页，并在回答中给出 `https://` 来源链接。 |
| 平台未配置服务 | 开关旁显示提示「平台未配置搜索服务，开启暂不生效。」 | 底层平台未接入外部搜索服务，即使管理员开启开关，助手端也不会出现联网搜索工具。 |
| 保存生效 | 点击「保存」后弹出提示「已保存，新的对话马上用上」 | 设置已成功保存，新开启的会话将立即应用新配置。已有会话不受影响。 |

### 资料库索引建立过程

资料库指定目录中的文件上传或更新后，索引生效经历以下阶段：

```
文件上传 / 更新 → 关键词索引（立刻可搜） → 语义向量索引（约 1–2 分钟后建立完成）
```

| 阶段 | 生效时间 | 检索表现 |
|---|---|---|
| 关键词索引 | 文件保存或指定后立刻生效 | 助手可通过文件中的精确关键词匹配检索到相关段落。 |
| 语义向量索引 | 约 1–2 分钟后跟上 | 向量索引建立完毕后，助手支持基于语义理解的相似度检索与问答。 |

### 来源链接解析状态

正文中对象链接在界面中的解析状态如下：

| 解析状态 | 界面展示 | 行为说明 |
|---|---|---|
| 解析成功 | 显示为真实标题或名称（如知识库页、文档、资料库文件），支持点击 | 链接正常解析，点击后可在右侧应用面板打开查看对应内容；消息下方显示相关内容横条，文档类可展示标题与摘录预览卡片。 |
| 解析失败 / 无权 / 未安装 | 显示为不可点击的种类词，包括：「页面」「文档」「文件」「记录」「列表」「文件夹」「空间」「看板」 | 目标内容已不存在、你缺少对应查看权限，或组织未安装对应应用。系统不会向你区分具体失败原因。 |
| 网页链接 | 显示为标准的 `https://` 超链接 | 联网搜索结果直接以超链接形式呈现，点击在浏览器新标签页中打开，没有专用的网页芯片。 |

## 让助手帮你做

在对话中，你可以直接向助手提出关于内部制度、规程或公开信息的问题。你可以这样对助手说：

> 制度里加班怎么报？
> 帮我查一下差旅报销的标准和审批流程。
> 搜索关于年假折算的相关规定，并标出文档出处。
> 查一下最新的行业税收优惠政策，并给出来源链接。
> 搜索记录：找一下上周跟进过的意向客户。

> **提示**
>
> 知识检索与联网搜索属于只读查询操作，助手不会擅自修改或写入任何数据；若你需要助手根据检索到的内容起草单据或发起修改，助手提议的草稿或表单修改必须由你人工确认后方可生效。

## 设置

| 设置项 | 入口位置 | 作用 | 默认值 | 谁能修改 |
|---|---|---|---|---|
| 「允许助手联网搜索」 | 「我的组织」→「Skill 与连接」→「联网搜索」 | 控制助手在对话中是否能够联网搜索公开网页 | 关 | 组织管理员（需具备管理员写权限） |
| 平台外部搜索服务 | 平台部署环境配置 | 为联网搜索提供底层检索能力；未配置时开关旁提示「平台未配置搜索服务，开启暂不生效。」 | 视部署而定 | 平台运维人员 |

> **提示**
>
> 系统没有提供关闭内部知识检索的设置项。知识检索随助手常驻，组织成员无法也不需要手动关闭。

## 注意事项

- **字数与条数上限**：
  - 知识检索：查询词最长 200 字；每次检索最多返回 20 条结果，默认返回约 8 条。相关度过低的段落会被系统自动丢弃。
  - 联网搜索：查询词最长 300 字；每次最多返回 10 条结果（默认更少）。组织设有每分钟调用次数上限，超出频率限制时系统会提示「请求太频繁」。
- **模型上下文与截断**：返回给模型的工具检索结果有字数上限，长文内容会被截断处理。
- **资料极多时的查找策略**：当组织中可读的资料数量极多时，检索系统会优先在最近改动的文件中进行查找。
- **资料库向量段数限制**：资料库中每个文件进入向量索引的段数存在上限。
- **文件格式限制**：资料库仅支持解析 txt、md、csv、docx、html 以及带有文字层的 pdf 文件。没有文字层的扫描件 PDF，以及表格、幻灯片、音频、视频、图片、压缩包均不会被知识检索读取。
- **安全与审计合规**：开启联网搜索后，查询词会发送到外部搜索服务，每次联网搜索均会记入审计日志。严禁在搜索词中输入组织内部机密信息。
- **权限与可见范围隔离**：检索结果会严格遵循你在各个业务应用中的实际可见范围，你平时无权访问的文档和页面，检索时绝不会向你展示。

## 目前不支持

- **工作台全局搜索框**：工作台顶栏和全局界面未提供全局搜索框，无法直接在顶部进行跨应用一键全局搜索。
- **独立来源组件**：对话回答中没有单独的「来源」标题或独立脚注列表组件，出处均以内嵌链接、底部相关内容横条或预览卡片展示。
- **工具步骤中文名**：在对话中展示的知识检索与联网搜索步骤没有中文折叠名，可能直接显示英文标签 `search_knowledge`（书本图标）或 `web_search`（地球图标）。

## 常见问题

### 为什么在工作台顶部找不到搜索框？
工作台没有全局搜索框。如需查询规章制度、规范文档或知识资料，可以直接在助手对话中用自然语言提问，由助手检索知识库、文档或资料库后回答；如需查找具体业务单据或客户记录，请进入对应业务应用使用其列表搜索框，或在对话中让助手「搜索记录」。

### 为什么开启了「允许助手联网搜索」后，助手依然无法联网？
请检查以下两点：
1. **平台是否配置了搜索服务**：如果平台未配置外部搜索服务，开关旁会提示「平台未配置搜索服务，开启暂不生效。」，此时即使开启开关，联网工具也不会生效，需联系平台运维人员完成配置。
2. **是否新开了一轮会话**：修改联网开关后，系统提示「已保存，新的对话马上用上」，必须点击「新会话」开启新对话，已有会话不会中途切换联网能力。

### 为什么上传到云盘的文件助手检索不到？
[「云盘」](/apps/storage) 主要用于文件存储，云盘文件名和文件内容不是知识源，不会进入知识检索。如果需要让助手参考云盘文件，可以在输入框点击「+」手动添加引用。如果需要作为常驻知识供全体检索，请将其存放在[「知识库」](/apps/wiki)、[「文档」](/apps/doc)或[「资料库」](/apps/library)的指定目录中。

### 为什么资料库刚上传的文件，用关键词能搜到，但提问语义找不到？
[「资料库」](/apps/library) 文件被管理员指定为知识目录后，关键词索引立刻建立并生效，而语义向量索引通常需要大约 1–2 分钟建立完成。稍候片刻后再尝试提问即可。

### 为什么同一份资料同事能搜到，我提问却找不到？
助手的检索结果会严格按照你在各应用的实际可见范围进行过滤。如果你在对应的知识库空间、文档或资料库目录中没有查看权限，助手便不会为你检索该内容，正文引用出处也会因无权而显示为不可点击的种类词（如「页面」「文档」）。