Files
common_agent/后端实现文档/2.知识资产与文件解析模块后端实现.md

1.2 KiB

知识资产与文件解析模块后端实现

1. 当前实现落点

当前实现位于 com.bruce.rag,包含知识库、文档、解析、切片和向量实体。

2. Controller

已落地接口继续保留:

  • /api/rag/store/list
  • /api/rag/store/query
  • /api/rag/store/detail
  • /api/rag/store/overview
  • /api/rag/store/documentOverview
  • /api/rag/documents/query
  • /api/rag/documents/batchUpload
  • /api/rag/documents/parse
  • /api/rag/documents/chunk

Studio 聚合接口后续新增在知识资产模块,不替代旧接口。

3. Service

Service 职责
IRagStoreService 知识库 CRUD、概览统计
IRagDocumentService 文档 CRUD、批量上传
IRagDocumentParseService 解析状态流转和解析快照
IRagDocumentChunkService 根据解析快照生成切片
IRagChunkEmbeddingService 向量写入和召回

4. 校验规则

  • 知识库编码唯一。
  • 文档必须绑定存在的知识库和附件。
  • 只有解析成功的文档允许切片。
  • 向量化必须读取知识库生效模型配置。
  • 重新切片或模型变更后,索引状态必须回到待索引或索引中。