3.9 KiB

Raw Blame History

feature_id

title

status

version

owners

last_updated

source

AISVC-RES

检索与嵌入策略化改造

draft

0.1.0

product

backend

search

ml

2026-03-10

type	ref
conversation

检索与嵌入策略化改造（AISVC-RES）

1. 背景与目标

背景：当前检索与嵌入流程为单一路径，缺少可配置策略切换与灰度控制。
目标：在不破坏默认线上逻辑的前提下，引入“策略层”实现可配置的端到端检索与嵌入增强方案，并支持 ReAct / 非 ReAct 两种模式。
非目标（Out of Scope）：
- 新增或替换底层向量数据库/搜索引擎
- 大规模重构现有元数据推断体系

2. 模块边界（Scope）

覆盖：
- 策略配置管理（默认策略与增强策略）
- 检索与嵌入端到端流程的策略化封装
- 元数据推断与过滤在策略中的统一位置
- 运行时灰度切换与回退
不覆盖：
- 上游文档采集系统
- 对外 API 的业务语义变更

3. 依赖盘点（Dependencies）

依赖模块/第三方：
- 知识库索引与检索服务（向量检索/关键词检索）
- 现有元数据推断智能体/规则引擎
- 配置中心或本地配置存储

4. 用户故事（User Stories）

[US-AISVC-RES-01] 作为平台运维，我希望能在不影响线上默认逻辑的情况下启用增强策略，以便进行灰度验证。
[US-AISVC-RES-02] 作为检索工程师，我希望能在配置中切换 ReAct 与非 ReAct 模式的检索流程，以便适配不同调用场景。
[US-AISVC-RES-03] 作为业务方，我希望元数据驱动检索在新旧策略中保持一致，以便结果可解释且向后兼容。
[US-AISVC-RES-04] 作为系统维护者，我希望能验证策略配置的完整性与一致性，以便避免错误配置上线。

5. 验收标准（Acceptance Criteria, EARS）

[AC-AISVC-RES-01] WHEN 系统未启用增强策略 THEN 系统 SHALL 保持现有检索与嵌入逻辑不变。
[AC-AISVC-RES-02] WHEN 配置启用增强策略 THEN 系统 SHALL 按新端到端流程执行并保留可回退能力。
[AC-AISVC-RES-03] WHEN 运行时切换策略 THEN 系统 SHALL 不影响正在运行的默认策略请求，并支持灰度比例配置。
[AC-AISVC-RES-04] WHEN 进入检索流程 THEN 系统 SHALL 在策略层统一执行元数据推断与过滤，并与现有元数据驱动检索保持一致。
[AC-AISVC-RES-05] WHEN 选择 ReAct 模式 THEN 系统 SHALL 采用多步检索链路并保留非 ReAct 的直接检索路径。
[AC-AISVC-RES-06] WHEN 执行策略验证接口 THEN 系统 SHALL 返回策略配置完整性与一致性校验结果。
[AC-AISVC-RES-07] WHEN 检索与嵌入策略发生异常 THEN 系统 SHALL 支持回退到默认策略并记录审计信息。
[AC-AISVC-RES-08] WHEN 启用增强策略 THEN 系统 SHALL 保证关键指标性能退化不超过可配置阈值并提供降级选项。

6. 追踪映射（Traceability）

AC ID	Endpoint	方法	operationId（可选）	备注
AC-AISVC-RES-01	/strategy/retrieval/current	GET	getCurrentRetrievalStrategy	读取当前策略
AC-AISVC-RES-02	/strategy/retrieval/switch	POST	switchRetrievalStrategy	切换策略
AC-AISVC-RES-03	/strategy/retrieval/switch	POST	switchRetrievalStrategy	灰度配置
AC-AISVC-RES-04	/strategy/retrieval/validate	POST	validateRetrievalStrategy	一致性校验
AC-AISVC-RES-05	/strategy/retrieval/switch	POST	switchRetrievalStrategy	ReAct/非 ReAct
AC-AISVC-RES-06	/strategy/retrieval/validate	POST	validateRetrievalStrategy	校验结果
AC-AISVC-RES-07	/strategy/retrieval/rollback	POST	rollbackRetrievalStrategy	回退
AC-AISVC-RES-08	/strategy/retrieval/validate	POST	validateRetrievalStrategy	性能阈值