Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
Improve FastAPI service clarity (#670)
Vishal Dsouza8a0e67e3c5db
diff --git a/openviking/storage/vectordb/service/server_fastapi.py b/openviking/storage/vectordb/service/server_fastapi.pyindex f737ef3af..34574e603 100644--- a/openviking/storage/vectordb/service/server_fastapi.py+++ b/openviking/storage/vectordb/service/server_fastapi.py@@ -1,9 +1,17 @@# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.# SPDX-License-Identifier: Apache-2.0++"""FastAPI server for VikingDB vector database service.++This module provides a REST API server for VikingDB operations including+collection management, data operations, indexing, and vector search.+"""+import asyncioimport randomimport timefrom contextlib import asynccontextmanager+from typing import Dict, Anyimport uvicornfrom fastapi import FastAPI, Request@@ -13,67 +21,94 @@ from openviking.storage.vectordb.service import api_fastapifrom openviking.storage.vectordb.service.api_fastapi import VikingDBException, error_responsefrom openviking_cli.utils.logger import default_logger as logger-# Active requests counter-active_requests = 0+# Global counter for tracking active requests+_active_requests = 0@asynccontextmanagerasync def lifespan(app: FastAPI):- """Handle startup and shutdown events"""+ """Handle application startup and shutdown events.++ Manages resource initialization and cleanup, ensuring graceful shutdown+ by waiting for all active requests to complete.++ Args:+ app: The FastAPI application instance+ """# Startup- logger.info("============ start =============")+ logger.info("============ VikingDB Server Starting =============")random.seed(time.time_ns())+yield+# Shutdownlogger.info("Waiting for active requests to complete...")- while active_requests > 0:+ while _active_requests > 0:await asyncio.sleep(0.1)api_fastapi.clear_resource()- logger.info("============ exit =============")+ logger.info("============ VikingDB Server Stopped =============")-# Create FastAPI app+# Create FastAPI application instanceapp = FastAPI(title="VikingDB API",- description="Vector database service API",+ description="Vector database service API for managing collections, data, indexes, and search operations",version="1.0.0",lifespan=lifespan,)-# Exception handler@app.exception_handler(VikingDBException)-async def vikingdb_exception_handler(request: Request, exc: VikingDBException):+async def vikingdb_exception_handler(request: Request, exc: VikingDBException) -> JSONResponse:+ """Handle VikingDB-specific exceptions.++ Args:+ request: The incoming HTTP request+ exc: The VikingDBException that was raised++ Returns:+ JSONResponse with error details+ """return JSONResponse(- status_code=200, content=error_response(exc.message, exc.code.value, request=request)+ status_code=200,+ content=error_response(exc.message, exc.code.value, request=request))-# Middleware to track request time and active requests@app.middleware("http")-async def add_process_time_header(request: Request, call_next):- global active_requests- active_requests += 1+async def request_tracking_middleware(request: Request, call_next):+ """Middleware to track request processing time and active request count.++ Increments active request counter, measures processing time,+ and adds processing time header to response.++ Args:+ request: The incoming HTTP request+ call_next: The next middleware/handler in the chain++ Returns:+ Response with added X-Process-Time header+ """+ global _active_requests+ _active_requests += 1start_time = time.time()- # Store start time in request state+ # Store start time in request state for potential future userequest.state.start_time = start_timetry:response = await call_next(request)- # Calculate time cost+ # Calculate and add processing time headertime_cost = time.time() - start_time-- # Add time cost headerresponse.headers["X-Process-Time"] = str(round(time_cost, 6))return responsefinally:- active_requests -= 1+ _active_requests -= 1-# Register routers+# Register API routers for different operation typesapp.include_router(api_fastapi.collection_router)app.include_router(api_fastapi.data_router)app.include_router(api_fastapi.index_router)@@ -81,19 +116,28 @@ app.include_router(api_fastapi.search_router)@app.get("/")-async def root():- """Root endpoint"""+async def root() -> Dict[str, str]:+ """Root endpoint providing basic server information.++ Returns:+ Dict containing server name and version+ """return {"message": "VikingDB API Server", "version": "1.0.0"}@app.get("/health")-async def health():- """Health check endpoint"""- return {"status": "healthy", "active_requests": active_requests}+async def health() -> Dict[str, Any]:+ """Health check endpoint for monitoring server status.++ Returns:+ Dict containing health status and current active request count+ """+ return {"status": "healthy", "active_requests": _active_requests}if __name__ == "__main__":try:+ logger.info("Starting VikingDB server on 0.0.0.0:5000")uvicorn.run(app, host="0.0.0.0", port=5000, log_level="info")except Exception as e:- logger.error(f"Failed to start server: {e}")+ logger.error(f"Failed to start VikingDB server: {e}")\ No newline at end of file