Merge branch 'develop' into hs/1010_dev

Author: Mermaid97

.github/workflows/deploy-docs.yml

@@ -7,7 +7,7 @@ on:
   push:
     branches: [develop]
     # Only trigger when files in the doc directory change
-    paths: 
+    paths:
       - 'doc/**'
 
   # Allow manual running of this workflow from the Actions tab
@@ -36,39 +36,30 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
         with:
-          fetch-depth: 0 # Not needed if lastUpdated is not enabled
-      
+          fetch-depth: 0
+
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
           node-version: 20
           cache: npm
           cache-dependency-path: ./doc/package-lock.json
-      
+
       - name: Setup Pages
         uses: actions/configure-pages@v4
-      
+
       - name: Install dependencies
         run: npm ci
-      
-      - name: Temporarily modify base path for GitHub Pages
-        run: |
-          # Create a temporary config file, changing base from '/doc/' to '/nexent/' for GitHub Pages
-          sed 's|base: '"'"'/doc/'"'"'|base: '"'"'/nexent/'"'"'|g' docs/.vitepress/config.mts > docs/.vitepress/config.github.mts
-          mv docs/.vitepress/config.mts docs/.vitepress/config.original.mts
-          mv docs/.vitepress/config.github.mts docs/.vitepress/config.mts
-      
+
       - name: Build with VitePress
         run: npm run docs:build
-        
-      - name: Restore original config
-        run: |
-          mv docs/.vitepress/config.original.mts docs/.vitepress/config.mts
-      
+        env:
+          GITHUB_PAGES: true
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: doc/docs/.vitepress/dist
+          path: ./doc/docs/.vitepress/dist
 
   # Deploy job
   deploy:

backend/apps/tool_config_app.py

@@ -5,14 +5,15 @@
 from fastapi import APIRouter, Header, HTTPException
 from fastapi.responses import JSONResponse
 
-from consts.exceptions import MCPConnectionError
-from consts.model import ToolInstanceInfoRequest, ToolInstanceSearchRequest
+from consts.exceptions import MCPConnectionError, TimeoutException, NotFoundException
+from consts.model import ToolInstanceInfoRequest, ToolInstanceSearchRequest, ToolValidateRequest
 from services.tool_configuration_service import (
     search_tool_info_impl,
     update_tool_info_impl,
     update_tool_list,
     list_all_tools,
     load_last_tool_config_impl,
+    validate_tool_impl,
 )
 from utils.auth_utils import get_current_user_id
 
@@ -81,6 +82,7 @@ async def scan_and_update_tool(
         raise HTTPException(
             status_code=HTTPStatus.INTERNAL_SERVER_ERROR, detail="Failed to update tool")
 
+
 @router.get("/load_config/{tool_id}")
 async def load_last_tool_config(tool_id: int, authorization: Optional[str] = Header(None)):
     try:
@@ -97,4 +99,38 @@ async def load_last_tool_config(tool_id: int, authorization: Optional[str] = Hea
     except Exception as e:
         logger.error(f"Failed to load tool config: {e}")
         raise HTTPException(
-            status_code=HTTPStatus.INTERNAL_SERVER_ERROR, detail="Failed to load tool config")
+            status_code=HTTPStatus.INTERNAL_SERVER_ERROR, detail="Failed to load tool config")
+
+
+@router.post("/validate")
+async def validate_tool(
+    request: ToolValidateRequest,
+    authorization: Optional[str] = Header(None)
+):
+    """Validate specific tool based on source type"""
+    try:
+        _, tenant_id = get_current_user_id(authorization)
+        result = await validate_tool_impl(request, tenant_id)
+
+        return JSONResponse(
+            status_code=HTTPStatus.OK,
+            content=result
+        )
+    except MCPConnectionError as e:
+        logger.error(f"MCP connection failed: {e}")
+        raise HTTPException(
+            status_code=HTTPStatus.SERVICE_UNAVAILABLE,
+            detail=str(e)
+        )
+    except NotFoundException as e:
+        logger.error(f"Tool not found: {e}")
+        raise HTTPException(
+            status_code=HTTPStatus.NOT_FOUND,
+            detail=str(e)
+        )
+    except Exception as e:
+        logger.error(f"Failed to validate tool: {e}")
+        raise HTTPException(
+            status_code=HTTPStatus.INTERNAL_SERVER_ERROR,
+            detail=f"Failed to validate tool: {str(e)}"
+        )

backend/consts/const.py

@@ -66,8 +66,8 @@
 # Deployment Version Configuration
 DEPLOYMENT_VERSION = os.getenv("DEPLOYMENT_VERSION", "speed")
 IS_SPEED_MODE = DEPLOYMENT_VERSION == "speed"
-DEFAULT_APP_DESCRIPTION_ZH = "Nexent 是一个开源智能体SDK和平台，能够将单一提示词转化为完整的多模态服务 —— 无需编排，无需复杂拖拉拽。基于 MCP 工具生态系统构建，Nexent 提供灵活的模型集成、可扩展的数据处理和强大的知识库管理。我们的目标很简单：将数据、模型和工具整合到一个智能中心中，让任何人都能轻松地将 Nexent 集成到项目中，使日常工作流程更智能、更互联。"
-DEFAULT_APP_DESCRIPTION_EN = "Nexent is an open-source agent SDK and platform, which can convert a single prompt into a complete multi-modal service - without orchestration, without complex drag-and-drop. Built on the MCP tool ecosystem, Nexent provides flexible model integration, scalable data processing, and powerful knowledge base management. Our goal is simple: to integrate data, models, and tools into a central intelligence hub, allowing anyone to easily integrate Nexent into their projects, making daily workflows smarter and more interconnected."
+DEFAULT_APP_DESCRIPTION_ZH = "Nexent 是一个开源智能体平台，基于 MCP 工具生态系统，提供灵活的多模态问答、检索、数据分析、处理等能力。"
+DEFAULT_APP_DESCRIPTION_EN = "Nexent is an open-source agent platform built on the MCP tool ecosystem, providing flexible multi-modal Q&A, retrieval, data analysis, and processing capabilities."
 DEFAULT_APP_NAME_ZH = "Nexent 智能体"
 DEFAULT_APP_NAME_EN = "Nexent Agent"
 

backend/consts/exceptions.py

@@ -85,4 +85,9 @@ class TTSConnectionException(Exception):
 
 class VoiceConfigException(Exception):
     """Raised when voice configuration is invalid."""
+    pass
+
+
+class ToolExecutionException(Exception):
+    """Raised when mcp tool execution failed."""
     pass

backend/consts/model.py

@@ -244,6 +244,7 @@ class ToolInfo(BaseModel):
     output_type: str
     class_name: str
     usage: Optional[str]
+    origin_name: Optional[str] = None
 
 
 # used in Knowledge Summary request
@@ -340,3 +341,14 @@ class TTSResponse(BaseModel):
     """Response model for TTS conversion"""
     status: str = Field(..., description="Status of the TTS conversion")
     message: Optional[str] = Field(None, description="Additional message")
+
+
+class ToolValidateRequest(BaseModel):
+    """Request model for tool validation"""
+    name: str = Field(..., description="Tool name to validate")
+    source: str = Field(..., description="Tool source (local, mcp, langchain)")
+    usage: Optional[str] = Field(None, description="Tool usage information")
+    inputs: Optional[Dict[str, Any]] = Field(
+        None, description="Tool inputs")
+    params: Optional[Dict[str, Any]] = Field(
+        None, description="Tool configuration parameters")

backend/database/db_models.py

@@ -167,6 +167,7 @@ class ToolInfo(TableBase):
 
     tool_id = Column(Integer, primary_key=True, nullable=False, doc="ID")
     name = Column(String(100), doc="Unique key name")
+    origin_name = Column(String(100), doc="Original name")
     class_name = Column(
         String(100), doc="Tool class name, used when the tool is instantiated")
     description = Column(String(2048), doc="Prompt tool description")

backend/pyproject.toml

@@ -14,9 +14,11 @@ dependencies = [
     "pyyaml>=6.0.2",
     "redis>=5.0.0",
     "fastmcp==2.12.0",
+
     "langchain>=0.3.26",
     "scikit-learn>=1.3.0"
-]
+
+
 
 [project.optional-dependencies]
 data-process = [