模块指南预览能力
企业知识库（AKB）完整指南
增强型企业知识库（AKB）支持知识库管理、文档全生命周期、全局检索、智能问答 RAG 与治理安全。 典型场景： 制度入库
增强型企业知识库（AKB）支持知识库管理、文档全生命周期、全局检索、智能问答 RAG 与治理安全。 典型场景： 制度入库 完成本页后，你应能够理解功能边界，并按步骤完成配置和验证。
开始前检查
- 已登录 DSP 平台并进入正确组织
- 已选择目标应用和当前开发版本
- 账号拥有当前功能的查看或编辑权限
概述
增强型企业知识库（AKB）支持知识库管理、文档全生命周期、全局检索、智能问答 RAG 与治理安全。
典型场景：
- 制度入库
入口与使用前准备
访问入口
| 入口 | 路径 |
|---|---|
| 主页 | /dsp/akb |
使用前准备
向量/AKB 服务已配置。
界面总览
功能分节
工作台
功能说明：知识库列表、画像、推荐、运营指标。
操作步骤：
- 查看 collections 表格
- 进入/编辑/同步/删除知识库
工具栏/按钮：
- 进入：selectCollection
- 同步：handleSyncCollection
文档中心
功能说明：上传、索引、重建、切片预览。
操作步骤：
- 选择知识库
- 上传知识素材
- 管理文档状态
预期结果：文档状态标签正确。
全局检索
功能说明：跨库检索验证。
操作步骤：
- 输入关键词
- 查看命中
预期结果：结果按权限过滤。
智能问答
功能说明：RAG 问答与引用。
操作步骤：
- 提问
- 查看答案与引用块
预期结果：引用可溯源。
治理安全
功能说明：权限模式、访问主体、合规策略。
操作步骤：
- 配置 permissionMode
- 审计访问
预期结果：无权限用户不可见。
端到端场景
场景 A：制度入库
上传 PDF→等待入库→AI 搜索验证
权限与可见性
租户 ACL。
字段与控件说明
字段名称以当前页面显示为准。不同版本或权限下，可选项可能有所差异。
| 字段名称 | 位置 | 用途 | 填写规则 | 可选值 | 影响结果 | 常见错误 |
|---|---|---|---|---|---|---|
| 主页 | 入口 | 打开 /dsp/akb | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 打开 /dsp/akb | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 进入 | 工作台 | selectCollection | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | selectCollection | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 同步 | 工作台 | handleSyncCollection | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | handleSyncCollection | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 删除 | 工作台 | 记录从列表移除 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 会移除当前配置或数据，执行前确认没有被其他模块依赖。 | 若无法删除，通常是存在引用关系、权限不足或当前状态不允许删除。 |
| 工作台 | 工作台 | 知识库列表、画像、推荐、运营指标。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 知识库列表、画像、推荐、运营指标。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 文档中心 | 文档中心 | 上传、索引、重建、切片预览。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 上传、索引、重建、切片预览。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 全局检索 | 全局检索 | 跨库检索验证。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 跨库检索验证。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 智能问答 | 智能问答 | RAG 问答与引用。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | RAG 问答与引用。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
| 治理安全 | 治理安全 | 权限模式、访问主体、合规策略。 | 按页面提示填写或选择，保存前检查必填项、格式和关联数据是否完整。 | 无固定枚举；按业务规则或页面格式要求填写。 | 会影响用户可访问的菜单、按钮、数据范围或审批操作。 | 若操作无响应，刷新页面后重试，并检查当前账号是否具备该模块操作权限。 |
完成标准
不要只以“按钮点击成功”作为完成依据，请至少核对以下结果。
- 打开 /dsp/akb
- selectCollection
- handleSyncCollection
- 制度入库
- 保存或提交后页面没有错误提示，刷新后配置仍可正确回显。
常见问题
Q1：检索不到
现象检索不到。
原因见处理步骤。
处理等待入库
Q2：接口失败
现象接口失败。
原因见处理步骤。
处理多候选端点需管理员统一
Q3：页面白屏或路由 404
现象页面白屏或路由 404。
原因见处理步骤。
处理检查 /dsp 前缀与路径参数；重新登录。
Q4：无权限 403
现象无权限 403。
原因见处理步骤。
处理权限管理分配角色资源后重新登录。
Q5：保存或提交失败
现象保存或提交失败。
原因见处理步骤。
处理F12 查看接口 message；补全必填项。
Q6：列表无数据
现象列表无数据。
原因见处理步骤。
处理确认后端服务与租户；点击刷新。
Q7：菜单无入口
现象菜单无入口。
原因见处理步骤。
处理getMyMenuTree 资源配置。
截图与文档不一致
处理检查前置条件、权限与当前配置，修正后重新执行。