RGA RGA 知识管理平台

用户使用手册

1 文档说明

1.1 编写目的

本文档说明 RGA 知识管理平台的主要功能、操作流程、处理结果和注意事项，帮助用户按照标准流程完成系统使用、知识库维护、问答验证、数据建设和系统配置。

1.2 适用范围

适用于后台管理端和智能问答相关页面。

适用于普通用户、运营人员、知识库维护人员、系统管理员和运维人员。

本文截图均可按实际演示环境替换，替换前应确认不暴露真实用户、内部地址或敏感配置。

1.3 使用约定

约定项说明
菜单路径使用“后台菜单：模块名称”描述系统入口。
按钮名称使用中文引号标识，例如“保存”“提交”“检索”。
权限说明若用户无菜单权限，页面可能不可见；直接访问时系统可能返回无权限提示。
结果说明每个功能列出常见成功、失败、空数据和权限不足等结果。

2 系统概述

2.1 平台定位

RGA 知识管理平台面向企业知识库建设、检索、问答和运营管理场景，支持知识文件入库、知识内容治理、智能问答、问答反馈、数据建设和系统配置。

2.2 功能模块总览

功能分组主要功能用途
工作台运营工作台、知识库检索查看平台运行概览，验证知识内容是否可被召回。
智能问答智能问答、流式输出、多轮对话、语音输入、问答反馈、问答清洗、自动问答面向用户提供知识问答能力，并形成质量反馈闭环。
数据建设数据建设中心、素材池、反馈采集、知识缺口、来源文件扫描、网页来源采集、知识草稿生命周期把分散资料转化为可审核、可发布、可入库的标准知识。
知识库管理文件上传、入库预检查、入库任务、文档管理、入库历史、检索评测、数据库清理、检索配置管理正式知识文件、检索效果、任务记录和知识库健康状态。
系统配置AI 模型配置、联网搜索配置、问答运行配置、用户管理、角色权限、操作日志配置模型与问答策略，管理账号权限，追踪关键操作。
运维检查健康检查、数据库检查、接口联调说明用于服务状态确认、故障定位和系统验收。

3 角色与权限说明

角色主要职责
普通用户使用智能问答、查看历史、提交反馈。
运营人员查看运营指标，处理问答反馈，维护素材、缺口和清洗任务。
知识库维护人员负责知识文件上传、入库、文档治理、检索评测和草稿发布。
系统管理员管理账号、角色、模型、联网、问答运行策略和审计记录。
运维/开发人员执行健康检查、数据库检查、接口联调和异常排查。

用户登录后，系统根据当前账号角色判断可访问菜单。

无权限的菜单通常不会展示；直接访问无权限功能时会返回无权限提示。

问答功能可受额度控制，额度达到上限后无法继续提交成功问答。

用户被禁用、会话过期或被管理员强制下线后，需要重新登录或联系管理员处理。

4 通用操作规范

页面区域说明
左侧菜单用于切换不同功能模块。
顶部栏显示当前用户、退出登录和部分全局操作。
筛选区按关键词、时间、状态、来源等条件查询数据。
列表区展示查询结果、任务记录或文档记录。
详情区/弹窗查看明细、编辑内容、确认操作或查看日志。
结果类型页面表现处理建议
操作成功页面出现成功提示，列表或详情刷新。确认数据是否符合预期。
参数错误页面提示必填项、格式或范围错误。按提示修改后重新提交。
暂无数据列表为空或显示空状态。调整筛选条件或确认是否已产生数据。
权限不足菜单不可见或页面禁止访问。联系管理员检查角色权限。
系统异常接口失败、服务异常或页面加载失败。刷新页面；仍失败时联系管理员或运维人员。

5 登录、退出与会话管理

5.1 登录、退出与会话管理

适用对象所有用户
功能入口系统登录页；页面右上角用户菜单
功能说明用于完成账号登录、进入后台、退出系统以及处理会话过期。

操作流程

打开系统登录页。

输入管理员分配的账号和密码。

点击“登录”，系统校验账号状态、密码和会话有效性。

登录成功后进入后台首页或原访问页面。

使用结束后点击右上角用户菜单，选择“退出登录”。

结果说明
登录成功进入系统并保存当前登录会话。
账号或密码错误页面提示登录失败，需要重新输入。
账号禁用无法登录，需要联系管理员启用账号。
会话过期或被下线再次访问功能时跳转登录页或返回未登录提示。

6 运营工作台

6.1 运营工作台

适用对象运营人员、管理员
功能入口后台菜单：运营工作台
功能说明用于查看系统核心运营数据，包括知识库、问答、任务、反馈等概览指标。

操作流程

登录后台后进入“运营工作台”。

查看顶部指标卡片，了解知识库、问答、反馈和任务情况。

查看待处理事项或异常提示。

点击指标卡片或快捷入口，跳转到具体处理页面。

结果说明
数据加载成功展示统计指标和快捷入口。
暂无数据对应卡片显示 0 或空状态。
接口异常页面提示加载失败，可刷新或联系运维检查。

7 知识库检索

7.1 知识库检索

适用对象运营人员、管理员、知识库维护人员
功能入口后台菜单：知识库检索
功能说明用于直接检索知识库内容，验证知识片段是否已入库、是否能被召回。

操作流程

进入“知识库检索”页面。

在检索框输入关键词、问题或业务语句。

根据需要调整数量、相似度、检索模式或过滤条件。

点击“检索”查看召回的知识片段。

检查召回内容、来源、相似度和命中情况。

结果说明
召回正常显示匹配的知识片段和来源信息。
无匹配结果知识可能未入库、关键词不匹配或阈值过高。
检索异常需要检查检索配置、模型服务和知识库状态。

8 智能问答相关功能

8.1 智能问答

适用对象普通用户、运营人员、管理员
功能入口后台菜单：智能问答 / 问答测试
功能说明用于基于企业知识库发起问答，验证模型回答质量、来源引用和检索效果。

操作流程

进入智能问答页面。

在输入框中输入业务问题。

点击发送，系统执行问题理解、知识检索、模型生成和结果整理。

等待回答完成，若启用流式输出，页面会逐步显示回答内容。

查看回答正文、引用来源、相关片段和命中情况。

结果说明
回答成功页面展示模型回答、来源和相关知识片段。
无可用知识可能提示依据不足或回答不确定。
模型调用失败提示模型服务异常、配置异常或网络异常。
问答额度超限返回额度限制提示，需要管理员调整额度。

8.2 多轮对话与历史记录

适用对象普通用户、运营人员、管理员
功能入口智能问答页面历史会话区域
功能说明用于保留上下文继续追问，并查看历史问答记录。

操作流程

进入智能问答页面。

发起第一轮问题，系统创建会话。

继续输入追问，系统结合当前会话上下文生成回答。

在历史记录中切换会话，查看过往问答内容。

必要时新建会话，避免不同主题互相干扰。

结果说明
上下文命中追问能够继承上一轮语义。
上下文不足回答可能要求补充问题背景。
历史为空当前账号未产生历史问答或筛选条件不匹配。

8.3 语音输入转文字

适用对象普通用户、运营人员、管理员
功能入口智能问答页面语音输入按钮
功能说明用于将用户语音转写成文字，再进入问答流程。

操作流程

在智能问答页面点击或按住语音输入入口。

按页面提示完成录音。

提交录音后等待系统转写。

检查转写文本，必要时手动修改。

确认后发送问题。

结果说明
转写成功输入框出现识别后的文本。
音频过大或格式不支持页面提示重新录制或更换格式。
识别不准确可手动修改后再提交。

8.4 问答反馈

适用对象普通用户、运营人员、管理员
功能入口智能问答回答结果区
功能说明用于收集回答是否有用、引用是否正确、是否需要补充资料等质量信息。

操作流程

在回答结果区查看答案和引用。

根据质量选择点赞、点踩或具体反馈类型。

填写补充说明。

提交反馈。

运营人员在反馈管理中继续处理。

结果说明
反馈提交成功反馈进入待处理列表。
重复反馈系统可能提示已提交或更新已有反馈。
需要补资料运营人员可转入数据建设流程。

8.5 问答清洗

适用对象运营人员、管理员
功能入口后台菜单：问答清洗
功能说明用于筛选低质量问答、污染内容、引用异常和需要补充资料的问题。

操作流程

进入问答清洗页面。

按时间、状态、反馈类型或关键词筛选。

查看问题、回答、引用和反馈明细。

选择禁用、标记、转缺口或补资料处理。

复核处理结果。

结果说明
处理成功低质量记录被标记或进入后续处理。
暂无待处理当前筛选条件下没有记录。
权限不足无法执行清洗操作。

8.6 自动问答

适用对象运营人员、知识库维护人员、管理员
功能入口后台菜单：自动问答
功能说明用于批量执行问题集问答，评估知识库和模型回答效果。

操作流程

准备或选择问题集。

配置问答范围、检索模式和执行参数。

启动自动问答任务。

等待任务完成。

查看批量结果、失败原因和改进建议。

结果说明
执行成功生成批量问答结果。
部分失败可查看失败问题和原因。
配置错误需要检查模型、检索或联网配置。

9 数据建设相关功能

9.1 数据建设中心

适用对象运营人员、知识库维护人员、管理员
功能入口后台菜单：数据建设中心
功能说明用于查看素材、草稿、缺口、来源采集和发布入库的整体进度。

操作流程

进入数据建设中心。

查看各入口数据量、待处理数量和异常提醒。

按快捷入口进入素材池、缺口任务、来源扫描或草稿列表。

根据待办状态推进处理。

结果说明
加载成功展示数据建设概览和待办。
暂无数据说明暂未产生素材或缺口。

9.2 素材池

适用对象运营人员、知识库维护人员
功能入口后台菜单：素材池
功能说明用于管理尚未成为正式知识的原始资料。

操作流程

进入素材池。

按来源、状态、分类或关键词筛选素材。

查看素材内容并判断是否有效。

选择忽略、编辑、生成草稿或关联缺口。

结果说明
生成草稿成功素材进入草稿处理流程。
素材被忽略不再进入后续知识生产。

9.3 反馈采集到数据建设

适用对象运营人员、管理员
功能入口后台菜单：问答反馈 / 数据建设
功能说明用于将高价值问答反馈转化为素材或知识缺口。

操作流程

进入问答反馈列表。

查看用户反馈、原问题、原答案和引用。

判断反馈是否有建设价值。

选择进入数据建设，生成素材或知识缺口任务。

继续在素材或缺口模块处理。

结果说明
转素材成功后续可生成草稿。
转缺口成功后续补充资料。

9.4 知识缺口任务

适用对象运营人员、知识库维护人员
功能入口后台菜单：知识缺口
功能说明用于记录未命中、不准确、引用错误或需要补充资料的问题。

操作流程

进入知识缺口任务列表。

查看缺口来源、问题描述和处理状态。

补充资料或关联已有素材。

将缺口转为素材或草稿。

完成后更新状态。

结果说明
处理完成缺口进入知识生产流程。
资料不足继续保持待补充状态。

9.5 来源文件扫描

适用对象知识库维护人员、管理员
功能入口后台菜单：来源文件扫描
功能说明用于批量发现和采集指定来源中的原始资料。

操作流程

进入来源文件扫描页面。

选择扫描范围或执行立即扫描。

查看扫描结果、重复项和异常项。

确认有效资料进入素材池。

结果说明
扫描成功新增素材或更新扫描历史。
重复或无效系统提示跳过原因。

9.6 网页来源采集

适用对象运营人员、知识库维护人员
功能入口后台菜单：网页来源采集
功能说明用于从网页内容中采集可治理资料。

操作流程

进入网页来源采集页面。

填写或导入待采集网页信息。

执行采集并查看解析结果。

确认有效内容进入素材池。

结果说明
采集成功网页内容进入素材处理流程。
解析失败检查网页可访问性和内容格式。

9.7 知识草稿生命周期

适用对象知识库维护人员、管理员
功能入口后台菜单：知识草稿
功能说明用于将素材加工为可审核、可发布的正式知识。

操作流程

从素材生成草稿。

编辑标题、分类、正文和来源说明。

执行质量检查。

提交人工审核。

审核通过后发布并进入正式入库。

结果说明
质检通过可进入人工审核。
审核驳回返回修改。
发布成功生成正式知识并进入入库流程。

10 知识库管理相关功能

10.1 知识文件上传、预检查与入库

适用对象知识库维护人员、管理员
功能入口后台菜单：知识库管理 / 文件入库
功能说明用于上传正式知识文件，检查后执行入库。

操作流程

上传知识文件。

执行入库预检查。

查看重复、格式、缺失和风险提示。

确认后创建入库任务。

任务完成后验证检索效果。

结果说明
入库成功知识可被检索和问答引用。
预检查失败按提示修复文件后重试。
任务失败查看任务日志定位原因。

10.2 文档管理

适用对象知识库维护人员、管理员
功能入口后台菜单：文档管理
功能说明用于管理正式知识文档状态和来源。

操作流程

进入文档管理。

按关键词、分类、状态筛选。

查看文档、片段数量和向量覆盖情况。

执行启用、禁用、恢复、删除或重建。

结果说明
启用成功文档参与检索。
禁用成功文档退出检索。
重建成功向量覆盖恢复正常。

10.3 入库任务历史

适用对象知识库维护人员、管理员
功能入口后台菜单：入库任务历史
功能说明用于追踪入库、重建、清理等后台任务。

操作流程

进入任务历史。

查看任务状态、进度和结果统计。

打开任务详情。

查看日志、文件明细和失败原因。

结果说明
任务成功显示成功统计。
任务失败根据失败原因处理。
运行中等待或刷新查看最新进度。

10.4 检索评测

适用对象运营人员、知识库维护人员、管理员
功能入口后台菜单：检索评测
功能说明用于批量验证检索召回效果。

操作流程

准备评测问题。

配置评测范围和检索参数。

执行评测。

查看命中、未命中和召回排序。

根据结果优化知识或配置。

结果说明
评测完成生成评测结果。
命中不足需要补充知识或调整配置。

10.5 知识库数据库清理

适用对象管理员、运维人员
功能入口后台菜单：知识库清理
功能说明用于清理无效、重复或残留数据。

操作流程

进入清理页面。

先执行扫描或预览。

确认清理范围和保护规则。

执行正式清理。

复核清理结果。

结果说明
清理成功无效数据被移除或禁用。
受保护数据系统阻止清理。

10.6 检索配置

适用对象管理员、知识库维护人员
功能入口后台菜单：检索配置
功能说明用于调整检索模式、权重、阈值和召回数量。

操作流程

进入检索配置页面。

查看当前配置。

调整参数并保存。

使用检索或问答测试验证效果。

结果说明
保存成功新配置对后续请求生效。
参数非法按提示修改范围。

11 系统配置相关功能

11.1 AI 模型配置

适用对象系统管理员
功能入口后台菜单：模型配置
功能说明用于维护问答模型和向量化模型的可用状态。

操作流程

进入模型配置页面。

新增或编辑模型配置。

设置默认模型和启用状态。

保存并执行连通性验证。

结果说明
配置成功问答或向量化可使用该模型。
验证失败检查服务、额度和网络。

11.2 联网搜索配置

适用对象系统管理员
功能入口后台菜单：联网配置
功能说明用于配置资料不足时的联网补充能力。

操作流程

进入联网配置页面。

填写搜索服务参数。

设置启用状态和运行策略。

保存并测试。

结果说明
配置成功问答可按策略使用联网补充。
搜索失败检查网络和服务配置。

11.3 问答运行配置

适用对象系统管理员
功能入口后台菜单：问答运行配置
功能说明用于控制回答来源、检索模式、召回数量、兜底策略和前端覆盖规则。

操作流程

进入问答运行配置。

设置回答来源和检索参数。

设置资料不足时的处理策略。

保存后进行问答测试。

结果说明
保存成功后续问答按新策略执行。
策略不合理可能导致无答案或引用不足，需要调整。

12 用户、角色与审计

12.1 用户管理

适用对象系统管理员
功能入口后台菜单：用户管理
功能说明用于维护账号、角色、状态、密码和问答额度。

操作流程

进入用户管理。

新增、编辑、禁用或启用用户。

重置密码或调整额度。

必要时强制下线异常会话。

结果说明
创建成功用户可按角色登录。
禁用成功用户无法继续访问。

12.2 角色菜单权限与问答额度

适用对象系统管理员
功能入口后台菜单：角色权限
功能说明用于配置不同角色可访问的菜单和操作范围。

操作流程

进入角色权限页面。

选择角色。

勾选允许访问的菜单。

设置相关问答额度策略。

保存后使用测试账号验证。

结果说明
保存成功权限对对应角色生效。
权限不足用户无法看到或访问对应菜单。

12.3 操作日志

适用对象系统管理员、运维人员
功能入口后台菜单：操作日志
功能说明用于审计关键操作和定位异常。

操作流程

进入操作日志。

按用户、时间、模块或结果筛选。

查看操作详情和结果。

必要时结合任务日志定位问题。

结果说明
查询成功展示符合条件的日志。
无数据当前条件下没有操作记录。

13 运维检查

13.1 健康检查、数据库检查与接口联调

适用对象系统管理员、运维/开发人员
功能入口后台菜单：运维检查
功能说明用于确认平台服务、数据库连接、模型调用、检索链路和接口联调状态。

进入运维检查页面。

查看服务健康、数据库连接、模型连通性和检索链路状态。

若存在异常，按页面提示定位依赖服务或配置问题。

必要时结合任务日志和操作日志进一步排查。

结果说明
检查通过相关服务和依赖处于可用状态。
检查失败需要检查服务、网络、配置或权限。
权限不足普通用户不可访问运维检查功能。

14 常见问题与处理建议

问题可能原因处理建议
登录失败账号密码错误、账号禁用或会话异常。确认账号状态，必要时联系管理员重置密码。
问答没有依据知识未入库、检索阈值过高或问题表达不匹配。先用知识库检索验证，再补充资料或调整检索配置。
引用不准确资料过旧、切片不合理或召回排序不佳。提交反馈，运营人员进入数据建设或检索评测处理。
入库失败文件格式、内容结构、模型服务或任务异常。查看入库任务历史和失败原因后处理。
看不到菜单当前角色无权限或账号状态异常。联系管理员检查角色菜单权限。