AI 搜索中心完整指南
AI 搜索中心提供 跨知识库、应用元数据与平台资源 的统一检索入口,结合 Agent 分析返回自然语言答案、引用依据与可跳转操作按钮。 典型场景:查找制度文档、定位应用/表单/流程资源、根据搜索结果一键打开目标页。
AI 搜索中心提供 跨知识库、应用元数据与平台资源 的统一检索入口,结合 Agent 分析返回自然语言答案、引用依据与可跳转操作按钮。 典型场景:查找制度文档、定位应用/表单/流程资源、根据搜索结果一键打开目标页。 完成本页后,你应能够理解功能边界,并按步骤完成配置和验证。
开始前检查
- 已登录 DSP 平台并进入正确组织
- 已选择目标应用和当前开发版本
- 账号拥有当前功能的查看或编辑权限

概述
AI 搜索中心提供 跨知识库、应用元数据与平台资源 的统一检索入口,结合 Agent 分析返回自然语言答案、引用依据与可跳转操作按钮。
典型场景:查找制度文档、定位应用/表单/流程资源、根据搜索结果一键打开目标页。
入口与使用前准备
| 入口 | 路径 |
|---|---|
| AI 搜索中心 | /dsp/ai-search |
| 开发者中心 | /dsp/DevCenter 快捷入口 |
准备:已登录;租户上下文正确;后端检索与 Agent 分析服务可用(界面显示 backendOk / backendMessage)。
界面总览

| 区域 | 说明 |
|---|---|
| ① 顶栏 | 返回工作台按钮、标题「AI 搜索中心」、租户标签、GlobalAiSearch 搜索框 |
| ② 左侧筛选 | 资源类型按钮 + 检索策略标签(HYBRID / CURRENT_USER / Tenant Guard) |
| ③ 主区 | 当前问题、Agent 分析答案、快捷操作、引用依据、搜索结果列表 |
功能分节
顶栏搜索

操作步骤:
- 在顶栏搜索组件输入自然语言或关键词。
- 触发搜索(
runSearch/@search)。 - 主区标题更新为「当前问题」文案。
资源类型筛选

操作步骤:
- 左侧点击各 资源类型 按钮(
tabs配置,含 label 与 count)。 activeType切换后,下方结果列表按类型过滤展示。
预期结果:按钮高亮 active;列表条数与类型一致。
Agent 分析答案区

界面元素:
| 元素 | 说明 |
|---|---|
| Agent 分析徽章 | 标识 AI 生成答案 |
| Trace | result.traceId 链路追踪号 |
| 答案正文 | result.answer,无结果时显示 emptyAnswer |
| 元信息 | 意图 intent、置信度 confidencePercent、后端状态 backendMessage |
操作步骤:
- 搜索完成后阅读 Agent 分析段落。
- 若加载中显示骨架屏
ai-search-skeleton。 - 点击 重新分析(
fetchSearchResult,需已有submittedKeyword)。
快捷操作按钮

说明:visibleActions 根据答案动态展示,点击 openAction(action) 跳转 action.url。
引用依据
操作步骤:
- 查看「引用依据」区块条数。
- 点击单条
source卡片,openItem(source)打开详情。
显示字段:title、source 或 summary。
搜索结果列表
操作步骤:
- 查看「搜索结果」总条数
totalVisibleCount。 - 在加载态等待
ai-search-result-loading结束。 - 点击结果项进入资源(与引用类似,受权限过滤)。
端到端场景
场景 A:查找制度并打开文档
- 输入「员工请假制度」→ 搜索。
- 阅读 Agent 分析 → 在引用依据中点击目标文档。
- 若无权限则提示 403,联系管理员分配知识库 ACL。
场景 B:定位应用内表单
- 筛选资源类型为应用/页面类。
- 在搜索结果中点击跳转至对应
/dsp/page/...或应用详情。
权限与可见性
检索结果按 租户与用户权限 过滤;左侧策略区标明 HYBRID 与 CURRENT_USER。
字段与控件说明
字段名称以当前页面显示为准。不同版本或权限下,可选项可能有所差异。
| 字段名称 | 位置 | 用途 | 填写规则 | 可选值 | 影响结果 | 常见错误 |
|---|---|---|---|---|---|---|
| 搜索 | 入口 | 打开 /dsp/ai-search | 输入关键词后执行查询,支持按页面当前数据范围过滤。 | 无固定枚举;按业务规则或页面格式要求填写。 | 打开 /dsp/ai-search | 若没有结果,检查关键词、筛选条件、应用范围和当前账号数据权限。 |
| 刷新 | 统一检索 | 列表/数据重新加载 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 列表/数据重新加载 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 统一检索 | 统一检索 | 跨知识、元数据检索。 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 跨知识、元数据检索。 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 保存 | 高级配置 | 持久化配置 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 持久化配置 | 若无法保存,优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 高级配置 | 高级配置 | 高级配置相关能力,详见界面实际 Tab/按钮。 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 高级配置相关能力,详见界面实际 Tab/按钮。 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 保存 | 运维监控 | 持久化配置 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 持久化配置 | 若无法保存,优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 运维监控 | 运维监控 | 运维监控相关能力,详见界面实际 Tab/按钮。 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 运维监控相关能力,详见界面实际 Tab/按钮。 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
| 保存 | 与其他模块联调 | 持久化配置 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 持久化配置 | 若无法保存,优先检查必填项、格式校验、权限和网络请求返回信息。 |
| 与其他模块联调 | 与其他模块联调 | 与其他模块联调相关能力,详见界面实际 Tab/按钮。 | 按页面提示填写或选择,保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举;按业务规则或页面格式要求填写。 | 与其他模块联调相关能力,详见界面实际 Tab/按钮。 | 若操作无响应,刷新页面后重试,并检查当前账号是否具备该模块操作权限。 |
完成标准
不要只以“按钮点击成功”作为完成依据,请至少核对以下结果。
- 打开 /dsp/ai-search
- 列表/数据重新加载
- 跨知识、元数据检索。
- 查找制度文档、定位应用/表单/流程资源、根据搜索结果一键打开目标页。
- 保存或提交后页面没有错误提示,刷新后配置仍可正确回显。
常见问题
Q1:结果空
现象结果空。
处理索引任务
Q2:403
现象403。
处理资源权限
Q3:打开模块页面空白或 404
现象打开模块页面空白或 404。
处理确认 URL 含 /dsp 前缀;检查路由参数(如 appCode);重新登录。
Q4:提示无权限或 403
现象提示无权限或 403。
处理联系管理员在权限管理分配角色资源;重新登录生效。
Q5:保存失败无明确提示
现象保存失败无明确提示。
处理F12 查看接口响应 message;补全必填项;确认后端服务可用。
Q6:列表一直加载
现象列表一直加载。
处理检查网络与企业 ID 请求头;点击刷新;联系管理员查服务日志。
Q7:菜单中找不到入口
现象菜单中找不到入口。
处理getMyMenuTree 未配置资源;URL 与路由表不一致。
Q8:多标签页登录状态异常
现象多标签页登录状态异常。
处理关闭多余标签重新登录;避免 Token 刷新冲突。
Q9:开发环境正常生产异常
现象开发环境正常生产异常。
处理核对环境变量 VITE_WEB_ROOT;网关与租户配置。
登录过期或 401
处理检查前置条件、权限与当前配置,修正后重新执行。
截图与界面不一致
处理检查前置条件、权限与当前配置,修正后重新执行。
