首页/新闻资讯/正文详情

5 分钟跑通 Deep-Research:从零搭建 AI 深度研究助手的实操笔记

发布时间:2026/11/21 6:43:41 来源:云帆数科 栏目:资讯中心
5 分钟跑通 Deep-Research:从零搭建 AI 深度研究助手的实操笔记
5 分钟跑通 Deep-Research从零搭建 AI 深度研究助手的实操笔记【免费下载链接】deep-researchAn AI-powered research assistant that performs iterative, deep research on any topic by combining search engines, web scraping, and large language models. The goal of this repo is to provide the simplest implementation of a deep research agent - e.g. an agent that can refine its research direction overtime and deep dive into a topic.项目地址: https://gitcode.com/gh_mirrors/deeprese/deep-research做深度调研时最磨人的是查资料搜一圈、读十页、换关键词再搜循环几轮仍凑不齐脉络。Deep-Research 把这套循环交给代码——它结合搜索引擎、网页抓取和大语言模型对任意主题做迭代式深度研究最后输出一份带来源链接的 Markdown 报告。整个仓库刻意压在 500 行以内读完源码比读一篇长文还快是理解深度研究 agent怎么运转的最短路径。下面从零开始装环境、跑第一次研究、调参数、避坑。初见装好环境跑通第一条研究 准备只有两样Node.js 22.xpackage.json 的 engines 里写死和两把 API key——Firecrawl 负责搜索与抓取网页OpenAI 提供大语言模型想换 DeepSeek R1 则改用 Fireworks 的 key。按编号走一遍即可拉代码git clone https://gitcode.com/gh_mirrors/deeprese/deep-research cd deep-research装依赖npm install写配置根目录新建.env.local填入两把 keyFIRECRAWL_KEYyour_firecrawl_key OPENAI_KEYyour_openai_key首次运行npm start终端会依次问你要研究的问题、breadth广度、depth深度和输出形式直接输入即可。习惯容器就走 docker-compose.yml 那条路docker compose up -d起服务后用docker exec -it deep-research npm run docker进入容器执行。背后机制研究循环是怎么转起来的 ⚙️别被agent吓到整个流程就是输入、处理、输出三段式。输入你的问题加两个旋钮。breadth 控制每轮放几个并行搜索词depth 控制递归轮数。选报告模式时系统会先追问两三个澄清问题你的回答会拼进问题里当背景。处理每轮三步。先由大模型把问题拆成一组互不重复的 SERP query专指搜索引擎结果页的搜索词再让 Firecrawl 按词搜索、抓取头部页面统一转成 Markdown最后模型读完这些 Markdown提炼出学习点——带实体、数字和日期的关键结论——以及下一轮的追问方向。递归只要 depth 大于 0追问方向就变成下一轮的问题已有学习点一路当背景传下去breadth 每轮减半研究从撒网逐渐收拢到聚焦。输出所有轮次跑完学习点去重汇总模型把它扩写成报告末尾附上全部访问过的 URL 作为 Sources存成report.md。主循环在 src/deep-research.ts模型怎么选在 src/ai/providers.ts。上手实操一条研究从提问到报告 ️以固态电池的量产进展为例完整走一遍启动 CLI回答四个问题npm startWhat would you like to research? 固态电池的量产进展 Enter research breadth (recommended 2-10, default 4): 4 Enter research depth (recommended 1-5, default 2): 2 Do you want to generate a long report or a specific answer? report报告模式下接着答几个澄清问题尽量写具体时间范围、关注哪些厂商。等它跑。breadth 4、depth 2 意味着第一轮 4 个搜索词第二轮每支减半为 2 个共 12 次搜索控制台会边跑边打印每轮的 query、学习点和链接。结束后工作目录多出report.md正文按学习点展开末尾是来源列表想只要一句短答案第 4 个问题时选answer产物是answer.md。不想敲键盘就用 API 模式npm run api起一个默认 3051 端口的 HTTP 服务见 src/api.ts然后curl -X POST http://localhost:3051/api/research -H Content-Type: application/json -d {query:固态电池量产,breadth:3,depth:2}返回的 JSON 里直接带answer、learnings和visitedUrls三个字段。调优速查参数与配置对照表 可调项都来自源码里的交互参数或环境变量对照着用参数默认作用何时调整breadth4每轮并行搜索词数量主题宽、想覆盖多视角时调大赶时间调小depth2递归研究轮数结论太浅时调到 3~5要快答案就保持 1FIRECRAWL_CONCURRENCY2抓取请求的并发数免费额度被限流就设 1付费或自建可加大CONTEXT_SIZE128000单次提示的 token 预算换小参数本地模型时同步调小FIREWORKS_KEY空设置后自动切到 DeepSeek R1想试 R1 的推理能力时OPENAI_ENDPOINT/CUSTOM_MODELOpenAI 官方模型服务端点与模型名接 OpenRouter、Gemini 或本地服务时FIRECRAWL_BASE_URL官方Firecrawl 服务地址自建 Firecrawl 时PORT3051API 服务端口端口被占用时踩坑实录四个高频问题 ⚠️1. 启动就报 No model found症状npm start后立刻抛出这个错误。原因.env.local里既没有OPENAI_KEY也没有FIREWORKS_KEYgetModel()没有兜底。解决补写其中任意一把 key 再启动前者走 o3-mini后者走 DeepSeek R1。2. 中途刷出一条 rate limit 错误症状某个 query 跑到一半报限流。原因Firecrawl 免费档限流严格默认并发 2 很容易打满。解决设FIRECRAWL_CONCURRENCY1。单条查询失败会被捕获、不会崩掉整体研究但那一条的数据就缺了报告会偏薄。3. 报告很浅没答到点子上症状结论泛泛关键信息缺失。原因问题太模糊或澄清问题敷衍作答——追问是唯一定向研究方向的输入。解决把问题写具体加时间范围、对标产品、对比口径同时把 depth 调高。4. 按文档设置并发却不生效症状改了CONCURRENCY_LIMIT速度没变化。原因代码实际读取的是FIRECRAWL_CONCURRENCY文档与实现不一致。解决把变量名改成FIRECRAWL_CONCURRENCY。项目地图目录一眼看懂 ️deep-research/ ├── src/ # 研究主循环、CLI 入口、API 服务、系统提示 └── src/ai/ # 模型提供商选择、超长文本切分仓库根目录其余是package.json、Dockerfile、docker-compose.yml等工程文件分别管脚本命令和容器部署不用逐一看。Deep-Research 把深度研究拆成搜索、抓取、提炼、递归四步每步都短到一眼能看懂合起来却足以支撑一次完整调研。代码量小、依赖清晰既能当学习 agent 架构的起点也适合改造成你自己的研究工具。下一步不妨顺着递归结构动手换个检索源或给报告加一层结构化模板。【免费下载链接】deep-researchAn AI-powered research assistant that performs iterative, deep research on any topic by combining search engines, web scraping, and large language models. The goal of this repo is to provide the simplest implementation of a deep research agent - e.g. an agent that can refine its research direction overtime and deep dive into a topic.项目地址: https://gitcode.com/gh_mirrors/deeprese/deep-research创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

转:决定组织执行力的,是对话沟通的质量
转:决定组织执行力的,是对话沟通的质量

个人理解: 挖掘真相、激发创意 表达出自己真实的观点 要想做到坦白,谈话就不能过于正式 开放式的对话能够引导出那些也许让人感到不舒服的实际情况 决定组织执行力的,是对话沟通的质量 https://mp.weixin.qq.com/s/kpRNFQWcxVWTXF1EdJTywg … · 2026/11/11 11:30:54

RocketMQ Proxy 性能测试完整指南:集群模式与本地模式怎么选
RocketMQ Proxy 性能测试完整指南:集群模式与本地模式怎么选

RocketMQ Proxy 性能测试完整指南:集群模式与本地模式怎么选 【免费下载链接】rocketmq Apache RocketMQ is a cloud native messaging and streaming platform, making it simple to build event-driven applications. 项目地址: https://gitcode.com/gh_mirrors… · 2026/11/21 6:13:25

沐曦股份率先完成中国电信Xing4.0-29B-A4B大模型Day 0适配
沐曦股份率先完成中国电信Xing4.0-29B-A4B大模型Day 0适配

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 8:29:27

市二宫电工证年审官方回应:证书过期了不知道怎么复审延期怎么办?
市二宫电工证年审官方回应:证书过期了不知道怎么复审延期怎么办?

市二宫电工证年审官方回应:证书过期了不知道怎么复审延期怎么办? 证书过期了不知道怎么复审延期,这事儿可不轻松。尤其是像市二宫电工证这种需要定期年审的特种作业操作证,要是错过时间,不仅影响日常工作,还可能面临停工、罚款甚至法律责任。很多人在遇… · 2026/11/21 6:43:38

电工证过期了五六年还有含金量吗?工地太忙根本没时间复习考试
电工证过期了五六年还有含金量吗?工地太忙根本没时间复习考试

电工证过期了五六年还有含金量吗?工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,这是很多特种作业人员的真实写照。尤其是电工证这类高含金量证书,一旦过期五六年,很多人开始怀疑: 这证还有用吗?能不能补办?补办流程是怎样的?… · 2026/11/21 6:43:38

有电工证做什么工官方回应:考前必看备考攻略助你一次性通过
有电工证做什么工官方回应:考前必看备考攻略助你一次性通过

有电工证做什么工官方回应:考前必看备考攻略助你一次性通过 怕考不过白交培训费?你不是一个人。每年都有不少准备报考电工证的学员,担心花了钱却考不过,白白浪费时间和精力。尤其是第一次报考的新人,对考试流程、题型分布、复习重点一无所知,导致复习效… · 2026/11/21 6:43:38

河南特种工补贴申请怎么搞?全国通用证书别浪费了
河南特种工补贴申请怎么搞?全国通用证书别浪费了

河南特种工补贴申请怎么搞?全国通用证书别浪费了 工地太忙根本没时间复习考试,这事儿我懂。每天早出晚归,连吃饭都得赶时间,更别说抽出空来备考特种作业操作证了。但你知道吗? 河南特种工补贴申请 不是你想申请就能申请的, 全国通用… · 2026/11/21 6:43:38

浙江电工证办理官方回应:学历不高怕报不上名?这些真相你要知道
浙江电工证办理官方回应:学历不高怕报不上名?这些真相你要知道

浙江电工证办理官方回应:学历不高怕报不上名?这些真相你要知道 你是不是也这样想, 学历不高怕报不上名 ,怕自己连最基本的电工证都拿不到?别急,今天我就从 浙江电工证办理 的真实流程说起,告诉你 官方回应… · 2026/11/21 6:43:38

兰州哪里考电工证好 内部消息揭秘实操考试避坑经验
兰州哪里考电工证好 内部消息揭秘实操考试避坑经验

兰州哪里考电工证好 内部消息揭秘实操考试避坑经验 实操考试心里没底怕挂科,这是很多准备考电工证的人最真实的感受。尤其是像兰州这样的城市,考证流程复杂、培训机构鱼龙混杂,很多人一上来就踩坑,钱花了、时间浪费了,最后还是一无所获。今天我就从一个… · 2026/11/21 6:42:38

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

电工证征求意见2026河南最新政策怎么应对?学历不高也能考!
电工证征求意见2026河南最新政策怎么应对?学历不高也能考!

电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17

房建企业特种工考前押题怎么找?别让培训费打了水漂
房建企业特种工考前押题怎么找?别让培训费打了水漂

房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码