"""Deep Agent - 基于create_deep_agent的深度分析智能体""" from deepagents.backends import CompositeBackend, FilesystemBackend, StateBackend from deepagents.middleware.filesystem import FilesystemMiddleware from deepagents.middleware.patch_tool_calls import PatchToolCallsMiddleware from deepagents.middleware.subagents import SubAgentMiddleware from langchain.agents import create_agent from langchain.agents.middleware import ( TodoListMiddleware, ) from src.agents.common import BaseAgent, load_chat_model from src.agents.common.middlewares import ( RuntimeConfigMiddleware, SummaryOffloadMiddleware, save_attachments_to_fs, ) from src.agents.common.tools import get_tavily_search from src.services.mcp_service import get_tools_from_all_servers from .context import DeepContext def _create_filesystem_backend_factory() -> CompositeBackend: """创建混合文件存储后端工厂函数。 /attachments/* 路由到真实文件系统(供附件中间件使用) 其他路径使用 StateBackend(内存存储,用于临时文件和大结果卸载) 返回 CompositeBackend 实例,供 FilesystemMiddleware 使用。 注意:StateBackend 会在 middleware 初始化时由 runtime 注入。 """ return CompositeBackend( default=StateBackend, # 使用类而非实例,FilesystemMiddleware 会自动注入 runtime routes={ "/attachments/": FilesystemBackend(root_dir=".", virtual_mode=False), }, ) def _get_research_sub_agent(search_tools: list) -> dict: """Get research sub-agent config with search tools.""" return { "name": "research-agent", "description": ("利用搜索工具,用于研究更深入的问题。将调研结果写入到主题研究文件中。"), "system_prompt": ( "你是一位专注的研究员。你的工作是根据用户的问题进行研究。" "进行彻底的研究,然后用详细的答案回复用户的问题,只有你的最终答案会被传递给用户。" "除了你的最终信息,他们不会知道任何其他事情,所以你的最终报告应该就是你的最终信息!" "将调研结果保存到主题研究文件中 /sub_research/xxx.md 中。" ), "tools": search_tools, } critique_sub_agent = { "name": "critique-agent", "description": "用于评论最终报告。给这个代理一些关于你希望它如何评论报告的信息。", "system_prompt": ( "你是一位专注的编辑。你的任务是评论一份报告。\n\n" "你可以在 `final_report.md` 找到这份报告。\n\n" "你可以在 `question.txt` 找到这份报告的问题/主题。\n\n" "用户可能会要求评论报告的特定方面。请用详细的评论回复用户,指出报告中可以改进的地方。\n\n" "如果有助于你评论报告,你可以使用搜索工具来搜索信息\n\n" "不要自己写入 `final_report.md`。\n\n" "需要检查的事项:\n" "- 检查每个部分的标题是否恰当\n" "- 检查报告的写法是否像论文或教科书——它应该是以文本为主,不要只是一个项目符号列表!\n" "- 检查报告是否全面。如果任何段落或部分过短,或缺少重要细节,请指出来。\n" "- 检查文章是否涵盖了行业的关键领域,确保了整体理解,并且没有遗漏重要部分。\n" "- 检查文章是否深入分析了原因、影响和趋势,提供了有价值的见解\n" "- 检查文章是否紧扣研究主题并直接回答问题\n" "- 检查文章是否结构清晰、语言流畅、易于理解。" ), } class DeepAgent(BaseAgent): name = "深度分析智能体" description = "具备规划、深度分析和子智能体协作能力的智能体,可以处理复杂的多步骤任务" context_schema = DeepContext capabilities = [ "file_upload", "todo", "files", ] def __init__(self, **kwargs): super().__init__(**kwargs) self.graph = None self.checkpointer = None async def get_tools(self): """返回 Deep Agent 的专用工具""" tools = [] tavily_search = get_tavily_search() if tavily_search: tools.append(tavily_search) # Assert that search tool is available for DeepAgent assert tools, ( "DeepAgent requires at least one search tool. " "Please configure TAVILY_API_KEY environment variable to enable web search." ) return tools async def get_graph(self, **kwargs): """构建 Deep Agent 的图""" # 获取上下文配置 context = self.context_schema.from_file(module_name=self.module_name) model = load_chat_model(context.model) sub_model = load_chat_model(context.subagents_model) search_tools = await self.get_tools() all_mcp_tools = await get_tools_from_all_servers() # 合并搜索工具和 MCP 工具 # Build subagents with search tools research_sub_agent = _get_research_sub_agent(search_tools) # 使用 create_deep_agent 创建深度智能体 fs_backend_factory = _create_filesystem_backend_factory() graph = create_agent( model=model, system_prompt=context.system_prompt, middleware=[ save_attachments_to_fs, # 附件保存到文件系统 RuntimeConfigMiddleware(extra_tools=all_mcp_tools), TodoListMiddleware(), FilesystemMiddleware(backend=fs_backend_factory, tool_token_limit_before_evict=5000), SubAgentMiddleware( default_model=sub_model, default_tools=search_tools, subagents=[critique_sub_agent, research_sub_agent], default_middleware=[ FilesystemMiddleware(backend=fs_backend_factory), RuntimeConfigMiddleware( model_context_name="subagents_model", enable_model_override=True, enable_system_prompt_override=False, enable_tools_override=False, ), SummaryOffloadMiddleware( model=sub_model, trigger=("tokens", 120000), trim_tokens_to_summarize=None, immediate_offload_threshold=4000, summary_offload_threshold=1000, max_retention_ratio=0.6, ), PatchToolCallsMiddleware(), ], general_purpose_agent=True, ), SummaryOffloadMiddleware( model=model, trigger=("tokens", 120000), trim_tokens_to_summarize=None, immediate_offload_threshold=4000, summary_offload_threshold=1000, max_retention_ratio=0.6, ), PatchToolCallsMiddleware(), ], checkpointer=await self._get_checkpointer(), ) return graph