""" Event Server - FastAPI version with native async support for MCP tools """ import os import logging from datetime import datetime, timedelta from typing import Dict, Any, Optional from contextlib import asynccontextmanager from fastapi import FastAPI, HTTPException, BackgroundTasks from pydantic import BaseModel from agent import EventTriggeredAgent, SystemHintConfig, resolve_provider_and_key from event_types import Event, EventType import threading import time import asyncio import argparse import uvicorn def _env_int(name: str, default: int) -> int: """Read an integer env var; fall back to default (with a warning) if malformed.""" raw = os.getenv(name) if raw is None: return default try: return int(raw) except ValueError: logger.warning(f"Invalid {name} value: {raw!r} (must be an integer); using default {default}") return default def _reasoning_safe_temperature(model, requested=1.0): """Reasoning models (Kimi K3, GPT-5, ...) only accept temperature=1. Return 1 for those; otherwise the requested value so non-reasoning providers (Doubao, DeepSeek, older Moonshot) are unchanged.""" m = str(model or "").lower().replace("/", "-") return 1 if ("kimi-k3" in m or "gpt-5" in m) else requested logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s') logger = logging.getLogger(__name__) # Global agent instance agent: Optional[EventTriggeredAgent] = None agent_lock = threading.Lock() # Monitoring state monitoring_enabled = False monitoring_thread: Optional[threading.Thread] = None # MCP loading status mcp_loading_status = { "loading": False, "loaded": False, "tools_count": 0, "error": None, "started_at": None, "completed_at": None } # ============================================================================ # FastAPI Lifecycle Events (Modern lifespan) # ============================================================================ @asynccontextmanager async def lifespan(app: FastAPI): """Lifespan context manager for startup and shutdown""" global agent, monitoring_enabled # Startup logger.info("🚀 Starting Event-Triggered Agent Server (FastAPI)") await init_agent() logger.info("✅ Server ready to receive events\n") yield # Shutdown logger.info("Shutting down server...") monitoring_enabled = False if agent and agent.mcp_manager: await agent.mcp_manager.disconnect_all() logger.info("✅ Server shutdown complete") # Initialize FastAPI app with lifespan app = FastAPI( title="Event-Triggered Agent Server", description="AI Agent with async MCP tools support", version="2.0.0", lifespan=lifespan ) # Pydantic models for requests class EventRequest(BaseModel): event_type: str content: str metadata: Optional[Dict[str, Any]] = None class ProcessRegister(BaseModel): process_id: str process_name: str metadata: Optional[Dict[str, Any]] = None class ProcessUnregister(BaseModel): process_id: str # ============================================================================ # Initialization # ============================================================================ async def init_agent(): """Initialize the agent with optional MCP tools""" global agent, mcp_loading_status # Determine provider from environment (universal OpenRouter fallback applied) requested_provider = os.getenv("LLM_PROVIDER", "kimi").lower() provider, api_key = resolve_provider_and_key(requested_provider) if not api_key: raise ValueError( f"API key not set for provider '{requested_provider}'. Set the appropriate " f"environment variable, or set OPENROUTER_API_KEY as a universal fallback." ) # Get model from environment if specified model = os.getenv("LLM_MODEL") if provider != requested_provider: logger.info( f"ℹ️ provider '{requested_provider}' has no key; falling back to OpenRouter." ) # Keep an explicit provider/model id; otherwise use OpenRouter's default. if not (model and "/" in model): model = None # Check if MCP should be enabled (default: true) enable_mcp = os.getenv("ENABLE_MCP_TOOLS", "true").lower() not in ["false", "0", "no"] config = SystemHintConfig( enable_timestamps=True, enable_tool_counter=True, enable_todo_list=True, enable_detailed_errors=True, enable_system_state=True, save_trajectory=True, trajectory_file="event_agent_trajectory.json", temperature=_reasoning_safe_temperature(model, 0.7), max_tokens=4096, use_mcp_servers=enable_mcp ) agent = EventTriggeredAgent( api_key=api_key, provider=provider, model=model, config=config, verbose=True ) logger.info(f"✅ Agent initialized with {provider} provider") if enable_mcp: logger.info("🔄 MCP tools enabled (default) - loading asynchronously...") await load_mcp_tools_async() else: logger.info(f"📦 Using built-in tools only (MCP disabled via ENABLE_MCP_TOOLS=false)") async def load_mcp_tools_async(): """Load MCP tools asynchronously""" global agent, mcp_loading_status mcp_loading_status["loading"] = True mcp_loading_status["started_at"] = datetime.now().isoformat() try: if agent: await agent.load_mcp_tools() tools_count = len(agent.mcp_manager.tools) mcp_loading_status["loaded"] = True mcp_loading_status["loading"] = False mcp_loading_status["tools_count"] = tools_count mcp_loading_status["completed_at"] = datetime.now().isoformat() logger.info(f"✅ MCP tools loaded: {tools_count} tools available") if tools_count > 0: sample_tools = list(agent.mcp_manager.tools.keys())[:5] logger.info(f" Sample: {sample_tools}") else: raise RuntimeError("Agent not initialized") except Exception as e: logger.error(f"❌ Failed to load MCP tools: {e}") mcp_loading_status["loading"] = False mcp_loading_status["loaded"] = False mcp_loading_status["error"] = str(e) mcp_loading_status["completed_at"] = datetime.now().isoformat() # ============================================================================ # API Endpoints # ============================================================================ @app.get("/") async def root(): """Root endpoint with API information""" return { "service": "Event-Triggered Agent Server", "version": "2.0.0", "status": "running", "docs": "/docs", "endpoints": { "health": "GET /health", "event": "POST /event", "mcp_status": "GET /mcp/status", "mcp_reload": "POST /mcp/reload", "agent_status": "GET /agent/status", "agent_reset": "POST /agent/reset" } } @app.get("/health") async def health_check(): """Health check endpoint""" return { "status": "healthy", "agent_initialized": agent is not None, "monitoring_enabled": monitoring_enabled, "mcp_enabled": agent.config.use_mcp_servers if agent else False, "mcp_loaded": mcp_loading_status["loaded"], "timestamp": datetime.now().isoformat() } @app.get("/mcp/status") async def get_mcp_status(): """Get MCP tools loading status""" status = mcp_loading_status.copy() # Add tool list if loaded if status["loaded"] and agent: status["tools"] = list(agent.mcp_manager.tools.keys()) # Group by server status["tools_by_server"] = {} for tool_name in agent.mcp_manager.tools.keys(): server = tool_name.split("_")[0] if server not in status["tools_by_server"]: status["tools_by_server"][server] = [] status["tools_by_server"][server].append(tool_name) return status @app.post("/mcp/reload") async def reload_mcp_tools(background_tasks: BackgroundTasks): """Manually trigger MCP tools reload""" if agent is None: raise HTTPException(status_code=500, detail="Agent not initialized") if mcp_loading_status["loading"]: raise HTTPException(status_code=409, detail="MCP tools are already loading") # Use FastAPI background tasks background_tasks.add_task(load_mcp_tools_async) return { "success": True, "message": "MCP tools reload started in background" } @app.post("/event") async def handle_event(event_req: EventRequest): """Handle incoming event""" if agent is None: raise HTTPException(status_code=500, detail="Agent not initialized") try: # Create event event_data = { "event_type": event_req.event_type, "content": event_req.content, "metadata": event_req.metadata or {} } event = Event.from_dict(event_data) # Handle the event with agent_lock: result = agent.handle_event(event, max_iterations=20) return { "success": True, "event_id": event.event_id, "result": { "final_answer": result.get('final_answer'), "iterations": result.get('iterations'), "tool_calls_count": len(result.get('tool_calls') or []), "todo_items": len(result.get('todo_list') or []), "success": result.get('success', False), "trajectory_file": result.get('trajectory_file') } } except Exception as e: logger.error(f"Error handling event: {e}") raise HTTPException(status_code=500, detail=str(e)) @app.get("/agent/status") async def get_agent_status(): """Get current agent status""" if agent is None: raise HTTPException(status_code=500, detail="Agent not initialized") with agent_lock: return { "provider": agent.provider, "model": agent.model, "tool_calls_count": len(agent.tool_calls), "todo_items": len(agent.todo_list), "current_directory": agent.current_directory, "mcp_tools_loaded": agent.mcp_tools_loaded, "mcp_tools_count": len(agent.mcp_manager.tools) if agent.mcp_tools_loaded else 0 } @app.post("/agent/reset") async def reset_agent(): """Reset agent state""" if agent is None: raise HTTPException(status_code=500, detail="Agent not initialized") with agent_lock: agent.reset() return { "success": True, "message": "Agent state reset successfully" } @app.post("/process/register") async def register_process(process: ProcessRegister): """Register a background process for monitoring""" if agent is None: raise HTTPException(status_code=500, detail="Agent not initialized") with agent_lock: agent.background_processes[process.process_id] = { "name": process.process_name, "start_time": datetime.now().isoformat(), "metadata": process.metadata or {}, "reminded": False } return { "success": True, "message": f"Process '{process.process_name}' registered" } @app.post("/process/unregister") async def unregister_process(process: ProcessUnregister): """Unregister a background process""" if agent is None: raise HTTPException(status_code=500, detail="Agent not initialized") with agent_lock: if process.process_id in agent.background_processes: del agent.background_processes[process.process_id] return { "success": True, "message": f"Process {process.process_id} unregistered" } else: return { "success": False, "message": f"Process {process.process_id} not found" } # ============================================================================ # Main Entry Point # ============================================================================ def build_parser() -> argparse.ArgumentParser: """构建命令行参数解析器(命令行参数优先级高于环境变量)。""" parser = argparse.ArgumentParser( description="事件驱动 Agent 的 HTTP 服务器(FastAPI):" "对外暴露 /event 等接口,把 Webhook 式的外部回调转成事件唤醒 Agent。", formatter_class=argparse.RawDescriptionHelpFormatter, epilog="""示例: python server.py # 使用默认配置(端口 8000,启用 MCP 工具) python server.py --port 9000 # 自定义端口 python server.py --provider doubao # 指定大模型提供商 python server.py --no-mcp # 只用内置工具,不加载 MCP 工具 之后用客户端发送事件:python client.py --mode test """, ) parser.add_argument( "--host", default=os.getenv("AGENT_HOST", "0.0.0.0"), help="监听地址(默认:0.0.0.0)", ) parser.add_argument( "--port", type=int, default=_env_int("AGENT_PORT", 8000), help="监听端口(默认:环境变量 AGENT_PORT 或 8000)", ) parser.add_argument( "--provider", default=None, choices=["dashscope", "qwen", "bailian", "siliconflow", "doubao", "kimi", "moonshot", "openrouter"], help="大模型提供商(默认:环境变量 LLM_PROVIDER 或 kimi)", ) parser.add_argument( "--model", default=None, help="模型名覆盖(默认:使用提供商默认模型)", ) parser.add_argument( "--no-mcp", action="store_true", help="禁用 MCP 工具,只使用内置工具(等价于 ENABLE_MCP_TOOLS=false)", ) return parser def main(): """Main entry point""" args = build_parser().parse_args() # 命令行参数覆盖环境变量:init_agent() 在 lifespan 中读取这些环境变量 if args.provider: os.environ["LLM_PROVIDER"] = args.provider if args.model: os.environ["LLM_MODEL"] = args.model if args.no_mcp: os.environ["ENABLE_MCP_TOOLS"] = "false" print("\n" + "="*80) print("🤖 EVENT-TRIGGERED AGENT SERVER (FastAPI)") print("="*80) print() print(f"✅ Starting server on {args.host}:{args.port}") print(f"📡 API Documentation: http://localhost:{args.port}/docs") print(f"📊 ReDoc: http://localhost:{args.port}/redoc") print() print("="*80 + "\n") # Run with uvicorn uvicorn.run( app, host=args.host, port=args.port, log_level="info" ) if __name__ == "__main__": main()