Merge remote-tracking branch 'origin/develop' into pyh/feat_runtime_isolation_develop

Author: YehongPan

backend/apps/vectordatabase_app.py

@@ -5,7 +5,7 @@
 from fastapi import APIRouter, Body, Depends, Header, HTTPException, Path, Query
 from fastapi.responses import JSONResponse
 
-from consts.model import IndexingResponse
+from consts.model import HybridSearchRequest, IndexingResponse
 from nexent.vector_database.base import VectorDatabaseCore
 from services.vectordatabase_service import (
     ElasticSearchService,
@@ -226,3 +226,32 @@ def get_index_chunks(
             f"Error getting chunks for index '{index_name}': {error_msg}")
         raise HTTPException(
             status_code=HTTPStatus.INTERNAL_SERVER_ERROR, detail=f"Error getting chunks: {error_msg}")
+
+
+@router.post("/search/hybrid")
+async def hybrid_search(
+        payload: HybridSearchRequest,
+        vdb_core: VectorDatabaseCore = Depends(get_vector_db_core),
+        authorization: Optional[str] = Header(None),
+):
+    """Run a hybrid (accurate + semantic) search across indices."""
+    try:
+        _, tenant_id = get_current_user_id(authorization)
+        result = ElasticSearchService.search_hybrid(
+            index_names=payload.index_names,
+            query=payload.query,
+            tenant_id=tenant_id,
+            top_k=payload.top_k,
+            weight_accurate=payload.weight_accurate,
+            vdb_core=vdb_core,
+        )
+        return JSONResponse(status_code=HTTPStatus.OK, content=result)
+    except ValueError as exc:
+        raise HTTPException(status_code=HTTPStatus.BAD_REQUEST,
+                            detail=str(exc))
+    except Exception as exc:
+        logger.error(f"Hybrid search failed: {exc}", exc_info=True)
+        raise HTTPException(
+            status_code=HTTPStatus.INTERNAL_SERVER_ERROR,
+            detail=f"Error executing hybrid search: {str(exc)}",
+        )

backend/consts/model.py

@@ -175,6 +175,18 @@ class IndexingResponse(BaseModel):
     total_submitted: int
 
 
+class HybridSearchRequest(BaseModel):
+    """Request payload for hybrid knowledge-base searches."""
+    query: str = Field(..., min_length=1,
+                       description="Search query text")
+    index_names: List[str] = Field(..., min_items=1,
+                                   description="List of index names to search")
+    top_k: int = Field(10, ge=1, le=100,
+                       description="Number of results to return")
+    weight_accurate: float = Field(0.5, ge=0.0, le=1.0,
+                                   description="Weight applied to accurate search scores")
+
+
 # Request models
 class ProcessParams(BaseModel):
     chunking_strategy: Optional[str] = "basic"

backend/services/vectordatabase_service.py

@@ -996,3 +996,66 @@ def get_index_chunks(
             error_msg = f"Error retrieving chunks from index {index_name}: {str(e)}"
             logger.error(error_msg)
             raise Exception(error_msg)
+
+    @staticmethod
+    def search_hybrid(
+            *,
+            index_names: List[str],
+            query: str,
+            tenant_id: str,
+            top_k: int = 10,
+            weight_accurate: float = 0.5,
+            vdb_core: VectorDatabaseCore = Depends(get_vector_db_core),
+    ):
+        """
+        Execute a hybrid search that blends accurate and semantic scoring.
+        """
+        try:
+            if not tenant_id:
+                raise ValueError("Tenant ID is required for hybrid search")
+            if not query or not query.strip():
+                raise ValueError("Query text is required for hybrid search")
+            if not index_names:
+                raise ValueError("At least one index name is required")
+            if top_k <= 0:
+                raise ValueError("top_k must be greater than 0")
+            if weight_accurate < 0 or weight_accurate > 1:
+                raise ValueError("weight_accurate must be between 0 and 1")
+
+            embedding_model = get_embedding_model(tenant_id)
+            if not embedding_model:
+                raise ValueError(
+                    "No embedding model configured for the current tenant")
+
+            start_time = time.perf_counter()
+            raw_results = vdb_core.hybrid_search(
+                index_names=index_names,
+                query_text=query,
+                embedding_model=embedding_model,
+                top_k=top_k,
+                weight_accurate=weight_accurate,
+            )
+            elapsed_ms = int((time.perf_counter() - start_time) * 1000)
+
+            formatted_results = []
+            for item in raw_results:
+                document = dict(item.get("document", {}))
+                document["score"] = item.get("score")
+                document["index"] = item.get("index")
+                if "scores" in item:
+                    document["score_details"] = item["scores"]
+                formatted_results.append(document)
+
+            return {
+                "results": formatted_results,
+                "total": len(formatted_results),
+                "query_time_ms": elapsed_ms,
+            }
+        except ValueError:
+            raise
+        except Exception as exc:
+            logger.error(
+                f"Hybrid search failed for indices {index_names}: {exc}",
+                exc_info=True,
+            )
+            raise Exception(f"Error executing hybrid search: {str(exc)}")

doc/docs/zh/opensource-memorial-wall.md

@@ -16,26 +16,6 @@
 请保持消息的礼貌和尊重，符合我们的行为准则。
 -->
 
-::: info happyzhang - 2025-11-13
-也许我们正见证着未来的“后起之秀”😀
-:::
-
-::: info KevinLeeNJ - 2025-11-13
-来参加华为ICT大赛的，nexent很不错，希望后续能有更多功能！
-:::
-
-::: info lzysleep - 2025-11-7
-非常不错的项目，很适合快速上手搭建自己的Agent，赞赞赞！
-:::
-
-::: info fishcat - 2025-10-31
-很好的项目，希望蒸蒸日上
-:::
-
-::: tip xiaomi250 - 2025-10-18
-打算冲一波 ICT 大赛！正好借着这个机会多捣鼓捣鼓，把我的技术再升个级，想想还挺有意思的～
-:::
-
 ::: tip aibito - 某创业公司后端开发 - 2025-05-18
 我们是一家只有 15 人的小公司，之前一直想做智能客服但技术门槛太高。发现 Nexent 后如获至宝！20+ 文件格式支持让我们轻松处理用户上传的各种文档，多模态对话功能完美解决了语音客服需求。最重要的是，我们的产品经理现在也能直接用自然语言调整智能体逻辑，开发效率提升了好几倍！
 :::
@@ -180,6 +160,10 @@ Nexent的自然语言生成Agent以及多智能体协同是我一直在研究的
 第一次接触智能体编排，是为了参加华为ICT大赛而了解 Nexent 的。  没想到入门比想象中容易，文档也写得很清晰。  
 :::
 
+::: tip xiaomi250 - 2025-10-18
+打算冲一波 ICT 大赛！正好借着这个机会多捣鼓捣鼓，把我的技术再升个级，想想还挺有意思的～
+:::
+
 ::: tip YuXiaoLoong - 2025-10-27
 Nexent是一个十分便利的开发平台，文档清晰，工具齐全，有幸能用上这么好用的平台，希望能在这个平台上学到更多技术和思想。
 :::
@@ -238,6 +222,8 @@ Nexent功能如此之强大，给我很多帮助，感谢开发者！厉害
 
 ::: info y-dq - 2025-10-28 
 想要自己尝试搭建智能体，感叹Nexent的功能如此强大！
+:::
+
 ::: tip cai7777 - 2025-10 23
 参加ICT大赛来了解 Nexent
 :::
@@ -314,6 +300,10 @@ Nexent功能如此之强大，给我很多帮助，感谢开发者！厉害
 感谢 Nexent 让我踏上了开源之旅!希望能参加ict大赛长长见识。项目不错，给个star~ 
 :::
 
+::: info fishcat - 2025-10-31
+很好的项目，希望蒸蒸日上
+:::
+
 ::：info XxHosxX - 2025-11-5
 希望参与ICT大赛以及Nexent平台提升自己的能力:)
 :::
@@ -330,6 +320,10 @@ Nexent功能如此之强大，给我很多帮助，感谢开发者！厉害
 期待能使用Nexent成为智能体开发大佬
 :::
 
+::: info lzysleep - 2025-11-7
+非常不错的项目，很适合快速上手搭建自己的Agent，赞赞赞！
+:::
+
 ::: info xiaochenIpter - 2025-11-08
 希望能参加ict大赛可以学习到更多知识,感谢 Nexent 让我踏上了开源之旅！平台开发智能体的能力十分强大，希望能够学习到更多东西！
 :::
@@ -398,6 +392,14 @@ Nexent功能如此之强大，给我很多帮助，感谢开发者！厉害
 我又来了，通过华为ICT了解到nexent，正在学习中...
 :::
 
+::: info happyzhang - 2025-11-13
+也许我们正见证着未来的“后起之秀”😀
+:::
+
+::: info KevinLeeNJ - 2025-11-13
+来参加华为ICT大赛的，nexent很不错，希望后续能有更多功能！
+:::
+
 ::: info user - 2025-11-14
 我要参加华为ICT
 :::
@@ -434,3 +436,66 @@ Nexent功能如此之强大，给我很多帮助，感谢开发者！厉害
 感谢 Nexent 让我踏上了开源之旅！给我一个机会制作智能体
 :::
 
+::: info 开源小白 - 2025-11-19
+感谢 Nexent 让我踏上了开源之旅！这个项目的文档真的很棒，帮助我快速上手。
+:::
+
+::: info chengyudan - 2025-10-20 
+感谢 Nexent 让我踏上了开源之旅！ 
+:::
+
+::: info user - 2025-11-20
+学习ai - agent非常好的项目，后面会持续输出贡献！
+:::
+
+::: china-king-hs - 2025-11-20
+希望能正常使用nexent
+:::
+
+::: info user - 2025-11-22
+感谢nexent这个开源项目
+:::
+
+::: tip xiaofu-2025-11-23
+xiaofu到此一游，感谢 Nexent 让我踏上了开源之旅！
+:::
+
+::: info DUTBenjamin - 2025-11-23
+来参加华为ICT大赛的,正好借着这个机会多捣鼓捣鼓,学到更多东西，加油！
+:::
+
+::: dean-stock - 2025-11-23
+感谢nexent让我第一次接触到了智能体，让我从使用到创作智能体的转变。
+:::
+
+::: user - 2025-11-23
+学习到ai了，很好用
+:::
+
+::: info chao - 2025-11-23
+使用 Nexent 开发了项目，MCP 工具集成特别强大，节省了大量开发时间！
+:::
+
+::: adasibi - 2025-11-23
+学习ai很好用，感谢 Nexent 让我踏上了开源之旅！
+:::
+
+::: user - 2025-11-23
+Nexent越来越好！
+:::
+
+::: info DUTBenjamin - 2025-11-23
+来参加华为ICT大赛的,正好借着这个机会学到更多东西，加油！
+:::
+
+::: info aurorahashcat - 2025-11-23
+nexent看起来超棒的自动化智能体构建平台，祝越来越好😀
+:::
+
+::: williamllk from SJTU - 2025-11-23
+感谢 Nexent 让我第一次制作智能体，尝试将AI4Science的理念付诸实践
+:::
+
+::: tip lostlight530 - 2025-11-24
+通过 Nexent 实现了 Router-Worker 架构的完美落地。无论是构建高情商的拟人化伴侣，还是处理严苛的结构化数据约束，这套框架都游刃有余。多智能体编排体验极佳！
+:::

docker/docker-compose.prod.yml

@@ -250,7 +250,7 @@ services:
       MINIO_ROOT_USER: ${MINIO_ROOT_USER}
       MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD}
     volumes:
-      - ${ROOT_DIR}/minio/data:/data
+      - ${ROOT_DIR}/minio/data:/etc/minio/data
     networks:
       - nexent
     restart: always

docker/docker-compose.yml

@@ -271,7 +271,7 @@ services:
       MINIO_ROOT_USER: ${MINIO_ROOT_USER}
       MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD}
     volumes:
-      - ${ROOT_DIR}/minio/data:/data
+      - ${ROOT_DIR}/minio/data:/etc/minio/data
     networks:
       - nexent
     restart: always