mirror of
https://gitee.com/wanwujie/deer-flow
synced 2026-04-04 06:32:13 +08:00
83f1334db0
* feat: add comprehensive debug logging for issue #477 hanging/freezing diagnosis - Add debug logging to src/server/app.py for event streaming and message chunk processing - Track graph event flow with thread IDs for correlation - Add detailed logging in interrupt event processing - Add debug logging to src/agents/tool_interceptor.py for tool execution and interrupt handling - Log interrupt decision flow and user feedback processing - Add debug logging to src/graph/nodes.py for agent node execution - Track step execution progress and agent coordination in research_team_node - Add debug logging to src/agents/agents.py for agent creation and tool wrapping - Update server.py to enable debug logging when --log-level debug is specified - Add thread ID correlation throughout for better diagnostics - Helps diagnose hanging/freezing issues during workflow execution * Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
103 lines
3.2 KiB
Python
103 lines
3.2 KiB
Python
# Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
|
|
# SPDX-License-Identifier: MIT
|
|
|
|
"""
|
|
Server script for running the DeerFlow API.
|
|
"""
|
|
|
|
import argparse
|
|
import asyncio
|
|
import logging
|
|
import os
|
|
import signal
|
|
import sys
|
|
|
|
import uvicorn
|
|
|
|
# Configure logging
|
|
logging.basicConfig(
|
|
level=logging.INFO,
|
|
format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
|
|
)
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
# To ensure compatibility with Windows event loop issues when using Uvicorn and Asyncio Checkpointer,
|
|
# This is necessary because some libraries expect a selector-based event loop.
|
|
# This is a workaround for issues with Uvicorn and Watchdog on Windows.
|
|
# See:
|
|
# Since Python 3.8 the default on Windows is the Proactor event loop,
|
|
# which lacks add_reader/add_writer and can break libraries that expect selector-based I/O (e.g., some Uvicorn/Watchdog/stdio integrations).
|
|
# For compatibility, this forces the selector loop.
|
|
if os.name == "nt":
|
|
logger.info("Setting Windows event loop policy for asyncio")
|
|
asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
|
|
|
|
|
|
def handle_shutdown(signum, frame):
|
|
"""Handle graceful shutdown on SIGTERM/SIGINT"""
|
|
logger.info("Received shutdown signal. Starting graceful shutdown...")
|
|
sys.exit(0)
|
|
|
|
|
|
# Register signal handlers
|
|
signal.signal(signal.SIGTERM, handle_shutdown)
|
|
signal.signal(signal.SIGINT, handle_shutdown)
|
|
|
|
if __name__ == "__main__":
|
|
# Parse command line arguments
|
|
parser = argparse.ArgumentParser(description="Run the DeerFlow API server")
|
|
parser.add_argument(
|
|
"--reload",
|
|
action="store_true",
|
|
help="Enable auto-reload (default: True except on Windows)",
|
|
)
|
|
parser.add_argument(
|
|
"--host",
|
|
type=str,
|
|
default="localhost",
|
|
help="Host to bind the server to (default: localhost)",
|
|
)
|
|
parser.add_argument(
|
|
"--port",
|
|
type=int,
|
|
default=8000,
|
|
help="Port to bind the server to (default: 8000)",
|
|
)
|
|
parser.add_argument(
|
|
"--log-level",
|
|
type=str,
|
|
default="info",
|
|
choices=["debug", "info", "warning", "error", "critical"],
|
|
help="Log level (default: info)",
|
|
)
|
|
|
|
args = parser.parse_args()
|
|
|
|
# Determine reload setting
|
|
reload = False
|
|
if args.reload:
|
|
reload = True
|
|
|
|
try:
|
|
logger.info(f"Starting DeerFlow API server on {args.host}:{args.port}")
|
|
logger.info(f"Log level: {args.log_level.upper()}")
|
|
|
|
# Set the appropriate logging level for the src package if debug is enabled
|
|
if args.log_level.lower() == "debug":
|
|
logging.getLogger("src").setLevel(logging.DEBUG)
|
|
logging.getLogger("langchain").setLevel(logging.DEBUG)
|
|
logging.getLogger("langgraph").setLevel(logging.DEBUG)
|
|
logger.info("DEBUG logging enabled for src, langchain, and langgraph packages - detailed diagnostic information will be logged")
|
|
|
|
uvicorn.run(
|
|
"src.server:app",
|
|
host=args.host,
|
|
port=args.port,
|
|
reload=reload,
|
|
log_level=args.log_level,
|
|
)
|
|
except Exception as e:
|
|
logger.error(f"Failed to start server: {str(e)}")
|
|
sys.exit(1)
|