部署deepresearchagent需三步：①用conda创建python 3.9环境；②安装指定版本langchain-core==0.3.1等依赖；③配置openai密钥或下载qwen3模型并确保transformers≥4.41.0。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
部署DeepResearchAgent前的环境准备
要在本地运行Skywork AI开源的DeepResearchAgent，必须先确保Python环境、依赖库和模型接入通道全部就位，缺一不可，否则后续所有操作都会卡在初始化阶段。
第一步：创建独立Python环境并激活，推荐使用conda避免包冲突：
conda create -n deepresearch python=3.9 → conda activate deepresearch
第二步：安装核心依赖，注意必须指定langchain-core>=0.3.0，旧版本会因API变更导致agent.run()方法不存在：
pip install langchain-core==0.3.1 langchain-openai faiss-cpu PyMuPDF beautifulsoup4
第三步：配置大模型访问凭证。若用OpenAI，需设置环境变量OPENAI_API_KEY；若用Qwen3本地部署，则必须提前将qwen2.5-7b-instruct模型权重下载至./models/目录，并确认transformers>=4.41.0，【低版本transformers加载Qwen3会静默失败，无报错但推理线程卡死】。
启动DeepResearchAgent并执行首个研究任务
这个环节不依赖Web界面，纯命令行驱动，适合快速验证基础能力是否正常。
方法一：直接调用main.py入口（推荐新手）
cd DeepResearchAgent → python main.py --topic "2025年中国光伏逆变器出口欧盟技术合规要求"
方法二：在Python交互环境中手动构建Agent实例
from agents.deep_research_agent import DeepResearchAgent
agent = DeepResearchAgent(model_name="qwen3", max_iter=8)
result = agent.run("锂电回收企业格林美2024年报关键财务指标分析")
print(result.summary)
注意：首次运行时会自动触发向量数据库初始化和网页解析器编译，耗时约90秒，期间终端无任何输出是正常现象，不要中断进程。
自定义研究流程：替换默认工具链
DeepResearchAgent默认使用arXiv+新闻RSS+财报PDF三源检索，如需聚焦行业数据库（例如Wind、同花顺iFinD），必须修改tools目录下的tool_registry.py。
① 打开./tools/tool_registry.py，定位到def get_default_tools()函数
② 注释掉原arxiv_search和rss_fetcher两行，新增一行：
if source == "wind": return WindAPIWrapper(api_key=os.getenv("WIND_API_KEY"))
③ 在./config.yaml中添加新字段：
data_source: wind
enable_pdf_parsing: false
这一步改完后必须重新运行python setup.py build，否则agent加载时仍调用旧工具列表，【跳过build步骤会导致工具热更新失效，且错误堆栈不提示具体缺失模块】。
调试Agent执行失败的三个关键日志位置
当research任务中途终止或返回空结果时，不要盲目重试，先查这三个文件：
第一处：./logs/plan_generation.log —— 查看Agent是否成功拆解出子任务，若此处为空，说明LLM未通过system_prompt校验，需检查config.yaml中model_provider字段是否拼写为"openai"而非"open_ai"
第二处：./logs/tool_execution.log —— 若看到"TimeoutError: HTTPConnectionPool(host='xxx', port=443): Read timed out"，代表目标网站启用了反爬，此时应立即停用该tool并在tool_registry.py中标记disabled=True
第三处：./logs/final_report.log —— 若存在"Validation failed: missing section 'Methodology'"，说明综合研判模块丢失了交叉验证逻辑，需回退到commit 2a7f1c3重新拉取core/reasoning.py
