通义 DeepResearch（深度研究 Agent 项目）

项目类型说明

本资源是通义深度研究 Agent 模型、推理与评测源码项目，未发现标准 SKILL.md。按本批四项资源统一入库，不表示能够像标准 Skill 一样直接安装。

它能做什么

Tongyi DeepResearch：面向长程、深度信息检索任务的 Agent 模型与研究代码。此句是对 README Introduction 的中文整理，不冒充作者中文原话。

面向深度信息检索的通义 Agent 模型、ReAct 推理脚本和基准评测代码，不是直接安装的 Skill。

主要能力

• 提供 ReAct 推理及多问题并行运行脚本。
• 工具覆盖搜索、网页访问/摘要、学术检索、文件处理与 Python sandbox，依赖相应服务。
• JSON / JSONL 问答数据输入与评测脚本；answer 字段是参考答案，非要求用户预写模型回答。
• README 链接模型权重、在线演示、ModelScope、Hugging Face 和百炼服务。模型权重不包含在 Git 仓库 ZIP 内。
• FAQ 明确训练数据不计划发布、Heavy Mode 尚未完整开源。

工作流程

准备 Python 环境 → 安装 requirements.txt → 配置 .env 中模型路径/工具服务 → 准备含 question 与 answer 的 JSON/JSONL → 按实际部署调整 inference/run_react_infer.sh → 启动 vLLM 服务与 ReAct 推理 → 输出结果并按评测脚本核验。

安装与调用

以下来自 README，但实际启动脚本位于 inference/，从仓库根目录调用需使用真实相对路径。

conda create -n react_infer_env python=3.10.0
conda activate react_infer_env
pip install -r requirements.txt
cp .env.example .env

先按 .env.example 填入真实配置并审阅脚本，再运行：

bash inference/run_react_infer.sh

最后一条是对 README 的 bash run_react_infer.sh 按仓库实际文件路径严格等价整理，非 README 原文命令。不要未改配置直接执行：当前脚本默认 CUDA 0–7 启动 8 个 vLLM 服务。远程 OpenRouter 方案 README 要求调整 inference/react_agent.py 的 call_server、模型名与内容拼接；不能只填 Key 就声称零 GPU 脚本原样可跑。

使用条件

推荐 Python 3.10.0；本地推理依赖 torch==2.7.1、vllm==0.10.1、transformers==4.56.1、qwen-agent==0.0.26 等大量固定依赖，完整清单 requirements.txt。源码示例是 Linux/Bash + CUDA/vLLM 路线，未声明通用最低显存或完整跨平台支持表，不能宣称普通电脑无门槛运行。需模型权重（另下载）或按 README 改造为远端模型 API。按启用工具配置 SERPER_KEY_ID、JINA_API_KEYS、API_KEY/API_BASE、DASHSCOPE_API_KEY、SANDBOX_FUSION_ENDPOINT；IDP 凭据为可选增强。标准浏览器不是批量推理脚本必需前置，在线演示需浏览器。

未明确说明的版本、操作系统和依赖不补猜；根据具体服务和功能实际配置。

安全与限制

搜索、Jina、摘要模型、DashScope/IDP 与 SandboxFusion 都可能联网并传输查询、网页内容、文档片段或代码，不是全本地零上传。run_react_infer.sh 从 .env 执行 shell source，需只使用可信配置；默认 --host 0.0.0.0 在 6001–6008 开放模型服务，须按实际网络环境限制。工具可执行生成的 Python，隔离与端点应自行配置。密钥样例仅占位符，本包未加入真实密钥。安装大量依赖、下载权重和运行推理都可能耗时、占显存并产生服务费用。

没有 SKILL.md、标准 Skill frontmatter 或 Claude/Codex Skill 安装入口，本批按用户要求纳入资源导入表，并明确其实际类型。Heavy 不是完整开源实现；训练数据未发布。在线演示 README 自述可能受模型延迟与工具 QPS 影响间歇失败。论文/图表结果依赖原提示词、工具和评测设置，不等于本次复现。

README 报告模型 30.5B 总参数、3.3B 每 token 激活、128K 上下文，属于作者模型说明。未把激活参数误写成总权重仅 3B，也未宣称当前最新模型排名。基准图表缺少本次独立复现，不复制榜单数字为本次实测。