Skywork AI Agent开发教程精选：智能体搭建实战指南

要把DeepResearchAgent跑起来，其实就三步：第一，用conda整个独立的Python 3.9环境；第二，装上langchain-core==0.3.1那几个指定版本的依赖；第三，配好OpenAI的密钥，或者把Qwen3模型下下来，再确认transformers版本不低于4.41.0。一步不对，后面全白搭。

部署DeepResearchAgent前的环境准备

在本地部署这个Skywork AI开源的DeepResearchAgent之前，得先把环境打点好——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并执行首个研究任务

这个环节没有图形界面，全靠命令行驱动，用来快速验证基础能力是否正常最合适不过。

方法一：直接用 main.py 入口，新手推荐这个。进到 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 字段是不是拼成了 "open_ai" 而不是 "openai"（常见低级错误）。

第二处：./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。

来源：互联网