模块指南预览能力

AI 搜索中心完整指南

AI 搜索中心提供 跨知识库、应用元数据与平台资源 的统一检索入口,结合 Agent 分析返回自然语言答案、引用依据与可跳转操作按钮。 典型场景:查找制度文档、定位应用/表单/流程资源、根据搜索结果一键打开目标页。

阅读本页后,你可以

AI 搜索中心提供 跨知识库、应用元数据与平台资源 的统一检索入口,结合 Agent 分析返回自然语言答案、引用依据与可跳转操作按钮。 典型场景:查找制度文档、定位应用/表单/流程资源、根据搜索结果一键打开目标页。 完成本页后,你应能够理解功能边界,并按步骤完成配置和验证。

开始前检查

  • 已登录 DSP 平台并进入正确组织
  • 已选择目标应用和当前开发版本
  • 账号拥有当前功能的查看或编辑权限
界面总览界面示例
界面总览界面示例,点击可查看原图。

概述

AI 搜索中心提供 跨知识库、应用元数据与平台资源 的统一检索入口,结合 Agent 分析返回自然语言答案、引用依据与可跳转操作按钮。

典型场景:查找制度文档、定位应用/表单/流程资源、根据搜索结果一键打开目标页。

入口与使用前准备

入口路径
AI 搜索中心/dsp/ai-search
开发者中心/dsp/DevCenter 快捷入口

准备:已登录;租户上下文正确;后端检索与 Agent 分析服务可用(界面显示 backendOk / backendMessage)。

界面总览

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

功能分节

顶栏搜索

图4-1 顶栏搜索
图4-1 顶栏搜索

操作步骤:

  1. 在顶栏搜索组件输入自然语言或关键词。
  2. 触发搜索(runSearch / @search)。
  3. 主区标题更新为「当前问题」文案。

资源类型筛选

图4-2 资源类型
图4-2 资源类型

操作步骤:

  1. 左侧点击各 资源类型 按钮(tabs 配置,含 label 与 count)。
  2. activeType 切换后,下方结果列表按类型过滤展示。

预期结果:按钮高亮 active;列表条数与类型一致。

Agent 分析答案区

图4-3 Agent 分析
图4-3 Agent 分析

界面元素:

元素说明
Agent 分析徽章标识 AI 生成答案
Traceresult.traceId 链路追踪号
答案正文result.answer,无结果时显示 emptyAnswer
元信息意图 intent、置信度 confidencePercent、后端状态 backendMessage

操作步骤:

  1. 搜索完成后阅读 Agent 分析段落。
  2. 若加载中显示骨架屏 ai-search-skeleton
  3. 点击 重新分析(fetchSearchResult,需已有 submittedKeyword)。

快捷操作按钮

图4-4 快捷操作
图4-4 快捷操作

说明:visibleActions 根据答案动态展示,点击 openAction(action) 跳转 action.url

引用依据

操作步骤:

  1. 查看「引用依据」区块条数。
  2. 点击单条 source 卡片,openItem(source) 打开详情。

显示字段:titlesourcesummary

搜索结果列表

操作步骤:

  1. 查看「搜索结果」总条数 totalVisibleCount
  2. 在加载态等待 ai-search-result-loading 结束。
  3. 点击结果项进入资源(与引用类似,受权限过滤)。

端到端场景

场景 A:查找制度并打开文档

  1. 输入「员工请假制度」→ 搜索。
  2. 阅读 Agent 分析 → 在引用依据中点击目标文档。
  3. 若无权限则提示 403,联系管理员分配知识库 ACL。

场景 B:定位应用内表单

  1. 筛选资源类型为应用/页面类。
  2. 在搜索结果中点击跳转至对应 /dsp/page/... 或应用详情。

与周边模块协作

  • 企业知识库(AKB):文档类命中来源 AKB 索引。
  • 权限管理:CURRENT_USER + Tenant Guard 策略过滤不可见资源。
  • AI 工作台:可 complementary 使用,搜索偏检索聚合,工作台偏对话。

权限与可见性

检索结果按 租户与用户权限 过滤;左侧策略区标明 HYBRID 与 CURRENT_USER。

字段与控件说明

字段名称以当前页面显示为准。不同版本或权限下,可选项可能有所差异。

9 项
字段名称位置用途填写规则可选值影响结果常见错误
搜索入口打开 /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

处理检查前置条件、权限与当前配置,修正后重新执行。

截图与界面不一致

处理检查前置条件、权限与当前配置,修正后重新执行。

继续阅读