82 lines
2.2 KiB
Python
82 lines
2.2 KiB
Python
# src/api/routes/knowledge.py
|
||
"""知识库检索接口"""
|
||
|
||
from fastapi import APIRouter, HTTPException
|
||
from loguru import logger
|
||
|
||
from ..models import SearchRequest, SearchResponse, SearchResultItem, ErrorResponse
|
||
from app.services.document_processor import DocumentProcessor
|
||
|
||
router = APIRouter(prefix="/knowledge", tags=["knowledge"])
|
||
|
||
|
||
@router.post("/search", response_model=SearchResponse)
|
||
async def search_knowledge(request: SearchRequest):
|
||
"""
|
||
检索法规知识库
|
||
|
||
使用混合检索：Dense向量 + Sparse向量 + RRF融合
|
||
|
||
Args:
|
||
request: 检索请求参数
|
||
"""
|
||
if not request.query or len(request.query.strip()) == 0:
|
||
raise HTTPException(
|
||
status_code=400,
|
||
detail="查询文本不能为空"
|
||
)
|
||
|
||
logger.info(f"收到检索请求: {request.query}")
|
||
|
||
try:
|
||
# 执行检索
|
||
processor = DocumentProcessor()
|
||
results = processor.search(
|
||
query=request.query,
|
||
top_k=request.top_k,
|
||
filters=request.filters
|
||
)
|
||
processor.close()
|
||
|
||
# 转换结果格式
|
||
result_items = []
|
||
for r in results:
|
||
item = SearchResultItem(
|
||
id=r.get("id", 0),
|
||
content=r.get("content", ""),
|
||
score=r.get("score", 0.0),
|
||
metadata=r.get("metadata", {})
|
||
)
|
||
result_items.append(item)
|
||
|
||
return SearchResponse(
|
||
query=request.query,
|
||
total=len(result_items),
|
||
results=result_items
|
||
)
|
||
|
||
except Exception as e:
|
||
logger.error(f"检索失败: {e}")
|
||
raise HTTPException(
|
||
status_code=500,
|
||
detail=f"检索失败: {str(e)}"
|
||
)
|
||
|
||
|
||
@router.post("/retrieval", response_model=SearchResponse)
|
||
async def knowledge_retrieval(request: SearchRequest):
|
||
"""
|
||
知识检索接口（与架构文档对齐）
|
||
|
||
该接口实现完整的检索流程：
|
||
1. 意图识别
|
||
2. BM25关键词检索 + 向量语义检索（双路召回）
|
||
3. Cross-Encoder精排
|
||
4. 返回结果
|
||
|
||
Args:
|
||
request: 检索请求
|
||
"""
|
||
# 当前版本使用混合检索，后续可添加精排步骤
|
||
return await search_knowledge(request)
|