主用例说明：知识更新与反馈

背景概述

随着知识空间持续演进，企业需要在海量文档、实时数据源与用户互动之间保持一致性。若更新不及时，RAG 检索会引用过期或错误的内容，影响智能问答、工作流自动化与决策可靠性。本主用例聚焦“知识更新与反馈”，梳理增量同步、质量回溯、反馈处理与治理策略，确保知识库在变化频繁的业务环境中保持高可用与可追溯。

目标与价值

• 持续可用：保证知识库在文档迭代、业务策略调整后能快速更新，减少知识陈旧导致的回答偏差。
• 可感知反馈：把用户提问、评分、纠错等反馈转化为知识改进信号，驱动再加工。
• 稳健治理：在更新过程中提供版本管理、血缘追踪与审批机制，防止错误内容影响生产。
• 自动化协同：通过任务调度、Agent 自动归类与质量评估，实现自动化的知识更新流水线。
• 全渠道融合：支持文档、API、数据库、实时事件等多源更新，维持知识空间的统一视图。

参与角色

• 知识工程师：配置更新策略、审批内容变更并监控质量指标。
• 业务专家：提供最新业务规则、确认敏感内容的准确性。
• 平台管理员：维护存储、版本与访问策略，确保合规。
• 智能体（Agent）：收集用户反馈、触发质量检查或自动补充知识。
• 任务调度 / ETL 服务：执行定时同步、增量抓取与重试。
• 质量评估服务：计算文档质量分、回答准确率、引用完整性。
• 审计 / 安全服务：记录知识更新操作，识别潜在风险。

主场景 User Story

作为 知识工程师，我希望 能够自动接收多渠道的知识变更与用户反馈，并在审批与验证后快速更新知识空间，从而 确保智能问答与业务自动化一直引用最新、可靠且合规的知识。

子场景详解

子场景 A：增量同步与版本管理

• 角色与触发：任务调度服务检测到外部知识源有新版本或新数据。
• 主要流程：
  1. 调度服务根据策略（定时/事件）抓取增量数据并生成变更包。
  2. 系统对比已有版本，生成差异报告（新增/修改/删除），并自动标注影响的知识节点。
  3. 知识工程师在审批中心查看差异、验证敏感字段，并选择“发布”或“退回”。
  4. 通过审批后，系统生成新版本索引、向量与图谱节点，同时保留旧版本以便回溯。
• 成功标准：增量包处理 SLA ≤ 30 分钟；版本对比准确率≥ 98%；审批记录完整。
• 异常与风控：若增量包冲突或数据源异常，流程中止并告警；系统提供“部分发布”与回滚按钮。
• 指标建议：增量成功率、平均审批时长、版本回滚次数。

子场景 B：用户反馈驱动的知识再加工

• 角色与触发：用户在对话或工作流结果中标记回答错误、缺少引用或不完整。
• 主要流程：
  1. Agent 收集反馈并关联对话上下文、引用的 chunk 与检索轨迹。
  2. 质量评估服务对相关知识片段打分，判断是否需要再加工（如重新切分、补充摘要、替换来源）。
  3. 系统自动生成“再加工任务”，分配给知识工程师或触发自动脚本处理。
  4. 处理完成后重新生成向量索引、关键词倒排与图谱关系，更新质量评分并通知反馈者。
• 成功标准：反馈处理 SLA ≤ 24 小时；处理后相同问题准确率提升≥ 25%。
• 异常与风控：若反馈量异常激增，系统需触发质量巡检；处理失败需自动回滚并标记为“需人工复核”。
• 指标建议：反馈闭环率、再加工成功率、回答满意度提升。

子场景 C：实时事件驱动的知识刷新

• 角色与触发：业务事件（如法规变更、API 推送）触发即时知识更新。
• 主要流程：
  1. 事件总线接收变更事件（如“法规版本更新”、“价格策略调整”）。
  2. 系统根据事件类型调用对应的更新工作流（重新抓取文档、更新表格、刷新图谱节点）。
  3. 同步完成后触发在线索引热更新，并通知相关 Agent 调整检索权重或回答模板。
  4. 审计服务记录事件来源、处理耗时与影响范围。
• 成功标准：关键事件处理延迟 ≤ 5 分钟；相关 Agent 在下一次回答中引用更新内容。
• 异常与风控：事件处理失败需自动重试并升级；防止重复事件导致循环更新，通过幂等策略控制。
• 指标建议：事件处理延迟、实时更新成功率、Agent 响应一致性。

子场景 D：知识衰减与空白检测

• 角色与触发：质量评估服务定期巡检知识库，发现低质量或过期内容。
• 主要流程：
  1. 定期运行指标监控（引用频次、反馈评分、引用失败率）。
  2. 对低评分内容发起“衰减处理”：标记为“待验证”或建议下架。
  3. 同步识别知识空白（例如某领域问题频繁触发外部搜索），生成补齐任务。
  4. 业务专家或内容供应方补充文档后进入审批流程，再次发布。
• 成功标准：衰减识别准确率≥ 90%；空白补齐在 SLA（例如 7 天）内完成；下架内容可追溯。
• 异常与风控：误判导致关键知识被下架时，可一键恢复旧版本；对高风险内容需双人审批。
• 指标建议：衰减处理率、知识空白补齐率、低质量内容占比趋势。

子场景 E：跨租户 / 部门的差异化更新

• 角色与触发：平台管理员需要为不同租户或部门提供定制化更新节奏。
• 主要流程：
  1. 配置租户级更新策略（同步频次、审批流程、敏感分类）。
  2. 发布更新时根据策略进行差异化推送（如先灰度到试点部门，再全量发布）。
  3. 监控各租户知识库健康度，结合权限策略控制访问。
  4. 收集跨租户反馈，统一进入知识改进看板。
• 成功标准：策略配置正确生效；灰度发布指标达标后自动扩散；不同租户的知识版本可追溯。
• 异常与风控：若灰度指标不达标，自动暂停扩散并回滚；防止跨租户数据泄露。
• 指标建议：租户覆盖率、灰度成功率、跨租户反馈数量。

功能边界 & 非目标场景

• 不直接提供知识源采集与初次构建（由“知识空间构建”主用例负责）。
• 不涉及模型微调或回答模板生成，仅关注知识本身的更新与质量治理。
• 不覆盖面向外部客户的知识付费或分发策略。
• 不处理离线备份与归档，交由底层存储与灾备系统。

依赖与接口

• 知识空间与索引服务：支持版本化、热更新与回滚。
• 反馈管理服务：收集对话评分、纠错、业务工单，并提供 API。
• 事件总线：接入法规更新、运营公告、插件事件等实时信号。
• 任务调度 / ETL 平台：执行增量抓取、批处理、重试。
• 质量评估服务：提供质量评分、异常检测、衰减分析。
• 权限与安全服务：保障更新过程中的访问控制、审计与敏感信息保护。
• 通知与协作工具：向相关角色推送审批、告警与结果。

验收要点

1. 支持对至少三类知识源（文档、表格、API）执行增量更新，并保留版本记录。
2. 用户反馈能够在 SLA 内触发再加工流程并更新索引，反馈状态可跟踪。
3. 关键业务事件触发的知识更新延迟可控，且更新后回答使用最新内容。
4. 提供知识衰减检测与空白提示机制，并能生成补齐任务。
5. 支持租户/部门差异化的更新策略，灰度发布与回滚可操作。
6. 全流程具备审计日志、血缘追踪与质量指标看板。
7. 更新失败时可自动或手动回滚，保证生产知识库稳定。

场景级测试用例示例

测试准备：在沙箱租户 demo-corp 的知识空间 finance-compliance 中预置 PDF《财务合规白皮书》、Excel expense-2024.xlsx、API /api/expense-limit；启用反馈中心、事件总线与质量评分服务。准备增量文档 finance-policy-v2.pdf、模拟错误文档 finance-policy-error.pdf、实时事件 policy-update-event、批量反馈数据以及跨租户 demo-retail 作为对比。

用例 A-1：增量包发布成功（正向）

• 前置条件：增量包 finance-policy-v2.pdf 已生成，审批人在线。
• 操作步骤：
  1. 导入增量包并查看差异报告。
  2. 审批通过并发布。
• 预期结果：新版本索引生效；旧版本可回溯；审计日志记录审批详情。

用例 A-2：增量包冲突回滚（逆向）

• 前置条件：增量包 finance-policy-error.pdf 与现有数据冲突。
• 操作步骤：
  1. 尝试发布增量包。
• 预期结果：系统检测冲突并阻断发布；提示冲突字段；支持一键回滚。

用例 B-1：反馈触发再加工（正向）

• 前置条件：用户对问答结果标记“引用过期”；反馈中心记录 issue #123。
• 操作步骤：
  1. 知识工程师在反馈中心确认并启动再加工。
  2. 系统重新切分并更新索引。
• 预期结果：反馈状态变为“已解决”；回答引用最新内容；质量评分提升。

用例 B-2：再加工失败自动回滚（逆向）

• 前置条件：再加工脚本缺失依赖导致失败。
• 操作步骤：
  1. 启动再加工任务。
• 预期结果：系统检测失败并回滚至旧版本；告警通知工程师；反馈状态标记为“需人工处理”。

用例 C-1：实时事件触发更新（正向）

• 前置条件：事件总线接收 policy-update-event。
• 操作步骤：
  1. 推送事件并观察处理流程。
• 预期结果：更新工作流在 5 分钟内完成；相关 Agent 回答引用更新条款；审计记录事件详情。

用例 C-2：重复事件幂等控制（逆向）

• 前置条件：同一事件被重复推送三次。
• 操作步骤：
  1. 连续推送重复事件。
• 预期结果：系统识别重复并仅处理一次；其余记录为“已忽略”。

用例 D-1：知识衰减巡检（正向）

• 前置条件：质量评估服务开启，存在 90 天未更新的知识。
• 操作步骤：
  1. 执行定期巡检任务。
• 预期结果：生成衰减报告；自动创建补齐任务；低质量内容被标记。

用例 D-2：误判恢复（逆向）

• 前置条件：关键知识被误标为低质量。
• 操作步骤：
  1. 知识工程师在看板中选择“恢复”。
• 预期结果：内容状态恢复；审计记录恢复原因；质量指标回滚。

用例 E-1：租户灰度发布（正向）

• 前置条件：租户 demo-retail 设置为灰度试点。
• 操作步骤：
  1. 发布新知识版本至试点租户。
  2. 指标达标后扩散到全量租户。
• 预期结果：灰度监控指标正常；全量发布成功；两个租户版本号一致且可追溯。

用例 E-2：灰度失败回滚（逆向）

• 前置条件：灰度监控指标不达标。
• 操作步骤：
  1. 触发灰度发布并监控。
• 预期结果：系统自动暂停扩散；回滚到旧版本；风险告警发送至管理员。