云端大模型+本地小模型：用GPT-6编排MiniCPM构建研究智能体实战

面壁智能公开点赞GPT-6还把自家的MiniCPM5-2B交给GPT-6来编排组合成一个本地研究智能体这消息在Agent开发者圈子里传开后我看到最多的评论是GPT-6都强成那样了为什么还要在本地跑一个2B的小模型这不是多此一举吗说实话我一开始也有同样的疑问。但真在自己项目里把“云端大模型本地小模型”这套组合完整搭过一遍之后我反而觉得这可能是目前最务实的智能体架构之一。这篇文章想把这套组合的背后逻辑、框架选型、完整搭建步骤和实测中踩过的坑都摊开讲清楚适合正在做研究型Agent、想控制API成本、又不太愿意把本地数据全部交给云端的人参考。你可以把文中的GPT-6理解成任何一个能力足够强的云端模型把MiniCPM5-2B理解成任何一个适合本地部署的小参数模型思路完全一致。1. 上游大脑与本地双手GPT-6编排MiniCPM5-2B的分工逻辑先聊一个最基本的问题编排到底在解决什么很多人第一次接触Agent的时候习惯性地以为“只要把一个问题丢给大模型它就会自己完成一切”。实际跑过几次就知道复杂任务靠单次问答根本撑不起来真正能落地的Agent几乎都是多步循环理解目标、拆分任务、调用工具、读取结果、继续下一步。这套循环谁来控制、谁来执行就看你怎么编排了。1.1 编排的本质把“思考”和“做事”拆开我习惯把编排比作一个咨询项目组。云端大模型是项目经理本地小模型是执行员工。项目经理不会自己去跑每一个访谈、查每一份资料他负责的是理解客户需求、拆解部门任务、验收结果、决定下一步往哪走执行员工才是真正埋头读文档、整理数据、产出初稿的人。如果让项目经理把每个执行细节都干了项目成本会失控周期会拉长如果让执行员工去当项目经理多半会把项目方向带偏。这个类比直接对应技术选型GPT-6这样的大模型在意图理解、任务规划、结果评估上确实强但如果每个子任务都调它token消耗和响应延迟都会变成灾难MiniCPM5-2B这样的本地模型单看推理天花板不如大模型但它便宜、快、能离线跑特别适合做重复性高、上下文敏感的脏活累活。把两者用编排链路串起来才能做到各用所长。1.2 本地研究智能体的真实使用场景标题里“研究智能体”这几个字不是噱头。我理解的研究智能体是给它一个开放性问题它能自动去收集信息、整理素材、产出结构化结论。比如我最近在做的一个开源项目架构演进分析输入是一句话“帮我梳理一下这个项目从MVC转向微服务的过程中核心模块发生了哪些变化”。这个任务落在本地研究智能体上分工是这样的GPT-6先读一遍项目根目录和关键文档把“梳理架构变化”拆成子任务例如“扫描core模块的目录结构与职责”“提取service层接口变化”“总结数据库分库规则调整”“输出架构演进报告大纲”然后逐个派给本地模型MiniCPM5-2B负责真正进入项目目录读代码、抓关键注释、总结每个文件做了什么所有子任务结果汇总回来之后再由GPT-6组织成一份有逻辑层次的报告。整个过程里本地模型从不接触云端代码文件的全部内容都不会离开本机这对很多企业内部研究类需求非常关键。1.3 为什么是MiniCPM5-2B而不是其他本地模型我以前搭同类系统习惯用7B、8B甚至13B的本地模型总担心模型太小理解不了任务。换到MiniCPM5-2B之后最直观的感受是资源占用断崖式下降。2B参数量配合4比特量化模型体积大概只有1.2GB到1.6GB普通笔记本的核显甚至纯CPU都能跑单次推理延迟在可控范围内比7B模型动不动吃满8GB显存舒服太多。面壁智能在端侧模型上的积累也是选它的原因之一。MiniCPM系列本身很注重中文场景、工具调用和长下文能力我在实测中发现它对“从文本里抽取结构化字段”这类任务完成度很高回答风格也比较克制。当然它不是万能的复杂逻辑推理和长链条规划仍然搞不定但那本来就不是它的活。记住2B模型负责的是“读得懂、摘得出、说得清”不是“想得深、规划远”。如果你想本地部署优先考虑量化后的版本显存超过8GB可以试试更高精度量化效果会更稳。2. 骨架怎么选编排框架、工作流节点与本地模型接入方式聊完为什么接下来是怎么办。搭建本地研究智能体第一道门槛不是模型而是编排骨架选错了。市面上Agent框架一大堆动不动就上LangGraph、Dify、Coze每个都宣传得天花乱坠。我自己一圈用下来觉得关键不是“谁最火”而是“谁最贴合你的任务形态”。2.1 主流编排框架对比框架核心思路优点缺点适合场景LangGraph图结构定义节点与状态流转状态管理清晰、可处理复杂分支、社区生态大学习曲线陡、样板代码多需要复杂状态机与分支逻辑的研究AgentDify可视化工作流编排上手快、自带知识库和日志、可发布API黑盒程度较高、深度定制受限快速搭建MVP、团队协作、非重度开发Coze云端智能体平台插件丰富、模板多、低代码偏托管、本地数据处理能力薄弱聊天客服、营销助手、内容生成自研harnessplanner-executor循环轻量、完全可控、依赖少需要自己处理状态、重试、日志想在底层理解编排逻辑、做极致裁剪我最终采用的是“自研harness LangGraph思想”的折中方案。不是不信框架而是研究型Agent的流程往往一个月变一次今天要让模型先跑检索再总结明天又要在中间插一个评审节点用可视化平台反复拖拽反而麻烦。自己维护一个不到200行的planner-executor循环改起来最快。当然如果你的任务是高度标准化的比如固定从网页抓取数据生成日报直接用Dify就够了省时省力。这里顺带回应一个社区里常见问题Dify编排出来的应用能不能作为continue这类IDE工具的API来用答案是“可以但要加兼容层”。Dify可以将工作流发布为Service API但返回结构跟OpenAI的chat completion格式不完全一致你需要写一个适配器做字段转换才能让IDE插件直接消费。这种多一跳的做法适合团队里“编排能力复用”的场景个人项目没必要这么绕。2.2 工作流节点设计一个成熟的本地研究智能体工作流节点建议这么设计目标解析节点大模型、任务拆分节点大模型、本地执行节点小模型、结构化汇总节点小模型或规则、评估验收节点大模型。目标解析和任务拆分可以合并成一个planner步骤它输出的不是自然语言而是JSON数组每个元素至少包含任务ID、任务描述、输入来源、期望输出格式。本地执行节点拿到单条任务后由MiniCPM读取指定文件或文档片段返回结构化结果。关键在“结构化”这三个字——不要让本地模型自由发挥写一段话而是强制它按你定义的字段返回否则后续汇总阶段会非常痛苦。我做的一个真实例子是让智能体分析一个项目的代码变更记录。GPT-6拆出的子任务是“对比utils目录下两个版本的差异列出函数签名变化和调用方影响”。MiniCPM执行后返回的是{ task_id: task_003, conclusion: utils/helper.py 中 parse_config 函数新增了参数 strict_mode, evidence: [utils/helper.py:102, tests/test_helper.py:45], uncertainty: caller 影响范围需要人工确认 }这个JSON格式就是给下游汇总和验收用的。注意uncertainty字段非常重要它可以避免小模型强行下结论也能让评估节点知道哪些地方不可信。整个流程里每个节点只做一件事输入输出都有明确schema再复杂的项目也能被拆成一个个可控的小步骤。2.3 本地模型接入方式接入这一步很多人会卡住其实核心思路就一句话让本地模型对外暴露一个和OpenAI兼容的API编排层统一用同一个Client调用。推荐用Ollama它支持一条命令启动本地模型并暴露http://localhost:11434/v1这个地址可以直接被OpenAI SDK使用。先拉模型ollama pull minicpm5-2b ollama run minicpm5-2b然后在编排层配置两个Clientfrom openai import OpenAI cloud_client OpenAI( api_key你的api_key, base_urlhttps://api.openai.com/v1 ) local_client OpenAI( api_keyollama, base_urlhttp://localhost:11434/v1 )用同一个SDK接两个来源最大的好处是上层逻辑完全不用区分模型来源planner调用cloud_clientexecutor调用local_client代码里只改一个变量名就行。参数上本地模型建议temperature调低一点0.2到0.4因为研究任务需要稳定输出不需要创造性云端规划模型可以把temperature设在0到0.3保证任务拆分的确定性。3. 按这个步骤搭一个可复现的本地研究智能体我尽量把这套系统搭得简单目标是让没有大量Agent开发经验的人也能跟着跑通一个最小闭环。整个过程大概三十分钟装环境、写编排层、设计子任务提示词然后跑一个研究问题验证效果。3.1 环境准备先看硬件。我这里说的最低要求是16GB内存CPU为近五年主流型号即可如果你有NVIDIA显卡哪怕是6GB显存体验都会好很多。我已经在MacBook AirM2芯片上跑过MiniCPM5-2B的量化版完全能跑速度可以接受就是连续生成大批量摘要时笔记本风扇会比较响。软件栈只需要三件套Python 3.10以上、Ollama、OpenAI SDK。安装的事不展开按官方文档装就行。模型方面我的建议是刚开始别用最高质量的FP16原版先用4比特量化版跑通全流程等确认结果质量满足需求之后再考虑是否升级精度。模型文件可以从模型仓库或得到官方渠道下载下载后放到Ollama的模型目录里即可。3.2 编排层实现下面是一段精简版的核心逻辑你可以直接抄去改。它做的事情是planner接收研究问题并输出子任务列表executor在本地逐个执行并返回结构化结果最后聚合节点把结果组织成最终报告。import json from openai import OpenAI cloud_client OpenAI(...) local_client OpenAI(api_keyollama, base_urlhttp://localhost:11434/v1) PLANNER_SYSTEM_PROMPT 你是研究任务编排器。请把用户的研究问题拆成不超过5个子任务。 每个子任务必须包含 - task: 一句话描述要做什么 - input_hint: 从哪些路径/资料入手 - output_format: 期望输出JSON包含的字段 只输出JSON数组不要多余文字。 def planner(question: str) - list[dict]: resp cloud_client.chat.completions.create( modelgpt-6, messages[ {role: system, content: PLANNER_SYSTEM_PROMPT}, {role: user, content: question} ], temperature0, ) return json.loads(resp.choices[0].message.content) def executor(task: dict) - dict: prompt f 请完成以下研究子任务 {json.dumps(task, ensure_asciiFalse)} 要求 1. 只输出JSON对象。 2. 包含 conclusion、evidence、uncertainty 三个字段。 3. 不确定的信息必须在 uncertainty 中写明。 resp local_client.chat.completions.create( modelminicpm5-2b, messages[{role: user, content: prompt}], temperature0.2, response_format{type: json_object}, ) content resp.choices[0].message.content return json.loads(content) def run_research(question: str) - str: tasks planner(question) results [] for i, task in enumerate(tasks, 1): print(f[{i}/{len(tasks)}] 执行: {task[task]}) try: result executor(task) results.append(result) except Exception as e: results.append({ task: task[task], conclusion: f执行失败: {str(e)}, evidence: [], uncertainty: 需要人工重试 }) return json.dumps(results, ensure_asciiFalse, indent2)这段代码虽然简单但已经构成完整的planner-executor循环。它在很多项目里已经够用后续要加的反思、记忆、多智能体协作本质上都是在这个循环里插入新节点。3.3 让本地模型干“脏活累活”本地模型不擅长从头思考但非常适合做“给定素材、提取重点”的工作。我设计子任务提示词时会刻意把大段原文塞给MiniCPM要求它做摘要、字段抽取、情感判断或格式转换。这类任务的共同点是输入明确、输出schema清晰不太需要发散推理。要注意的是本地小模型的指令遵循能力不如大模型所以提示词里不要同时给太多要求。一个任务只做一件事。比如不要让模型“既总结这段文档又对比上一版差异再提出优化建议”它大概率会把三个任务搅在一起。正确做法是拆成三个独立步骤先总结、再抽取旧版本关键信息、最后单独让评估模型去对比。还有一个容易忽略的点给本地模型提供“能完成的任务”而不是“正确的任务”。这句话是什么意思如果你让MiniCPM分析“整个微服务改造过程中所有模块的耦合度变化趋势”它做不到因为任务太宽泛。但如果给它限定“只统计order-service模块在v1.2到v1.5版本之间import语句的变化”它就能完成得很好。任务拆细是编排层的责任不要推给执行层。4. 实测中最容易翻车的五个环节下面这些坑都是我实际跑出来的不是从文档里抄来的。研究型Agent和聊天机器人最大的不同在于它要跑很多步跑得越久越容易出错而且错误会累积。这五个环节只要你踩中一个整个研究结果都可能报废。4.1 上下文越滚越大最后彻底跑偏我最早做研究Agent时天真地把所有中间结果一路拼进prompt心想“模型能看到全部信息总结肯定更全面”。结果跑到第7个子任务时GPT-6的上下文里塞了好几万字的历史摘要模型输出的质量直线下降开始重复前几个任务的结论甚至把不同文件的内容混在一起。解决方案是分层压缩。每个子任务执行完后不要保留完整输出只保留结构化摘要。规划器每次决策时看到的是“之前的子任务得出过什么结论”不是“之前的子任务原文是什么”。另外如果研究过程跨度特别长可以在每完成一个阶段后让云端模型生成一份阶段小结把小结作为下一阶段的上下文。上下文永远只保留当前需要的层级。4.2 本地模型的工具调用经常“出口误”调用本地模型做工具选择时它经常“出口误”——比如让它返回工具名和参数它会在JSON里混进一句“好的我现在开始调用工具”之类的废话或者把参数名拼错。这个问题最隐蔽因为错误不会导致程序直接崩溃而是会静默执行一个错误的工具调用。我试过几种方案约束response_format、加少样本示例、在系统提示词里声明“只输出JSON”都不能完全杜绝。最后靠“失败重试枚举校验”解决了本地模型返回的JSON先交给一个校验函数检查工具名是否在预定义列表里、参数是否齐全校验失败就重新用上次的错误信息构造一个修正提示词最多重试两次。校验函数比模型更可靠这种“宁可让代码兜底也不要相信模型自觉”的思路建议直接焊进你的Agent架构。4.3 编排层把任务拆错了结果全盘皆输有一次我让智能体分析一个项目的性能瓶颈GPT-6拆出的任务里有这么一条“分析所有API接口的响应时间分布”。这个任务本身没问题但它没有指明数据来源和采集方式本地模型只能自己猜测结果从代码注释里“分析”出了一份响应时间报告还写得像模像样实际毫无依据。问题出在编排层只给了执行层“目标”没给“路径”。解决办法是PLANNER_SYSTEM_PROMPT里明确要求每个子任务必须包含input_hint字段指定从哪里获取资料。如果资料需要先运行某个脚本生成任务里就写清楚“运行python scripts/benchmark.py读取输出文件后再分析”。同时规划层要尽量把任务粒度控制在一个模型单次能完成的范围内既不要大到让本地模型无从下手也不要小到每读一个文件就来回调一次接口。4.4 本地模型幻觉与资料污染很多人觉得小模型幻觉一定比大模型严重其实不一定。MiniCPM5-2B在单文件摘要这类任务上的忠实度相当高问题出在跨文档总结时模型会把文档A的信息不经意间迁移到文档B的结论里形成“资料污染”。比如让MiniCPM分别总结两份提到“缓存策略”的文档第二份文档的总结里可能混入第一份文档里的Redis细节而这份细节在第二份文档中根本不存在。我的对策是摘除“原文本对比”的诱惑本地执行节点只被允许基于当前输入做摘要不要给它任何“补充背景知识”的提示。同时在输出schema里增加evidence字段强制模型指出结论来源于哪些文件哪几行。如果这个字段为空下游评估节点直接打回重试。这个机制不能完全消灭幻觉但会让幻觉从“悄悄发生”变成“显性暴露”。4.5 死循环与费用失控研究型Agent最容易出现的问题就是“停不下来”。一个子任务结果不理想模型认为自己应该再查一轮于是又拆出三个新子任务三个新子任务里又有两个失败重试后再衍生两个……如果不加限制API账单会滚到让你怀疑人生。解决办法有三层第一层planner输出子任务数量硬上限我一般限制在5个以内超过直接报错第二层每轮执行后增加一个“是否已经回答完研究问题”的判定节点由云端模型输出continue或stop只有continue才允许继续第三层整个流程设置总轮数上限比如10轮和总预算上限超了强制结束并把已有结果组织成“部分报告未决问题”输出。研究本身就是可以接受不完美的强制结束远比无限循环好。5. 进阶加入反思、记忆与多智能体协作当你的最小闭环跑通之后别急着上高大上的框架先考虑给智能体加“反思”和“记忆”这两个神经系统。它们提升效果比换更大的模型直观得多。5.1 反思与评审节点反思节点本质上是另一个模型调用它的输入是“研究问题已完成的所有子任务结果输出要求”输出是“当前报告存在的缺陷下一步应该补充的信息”。我在实际项目中会把反思节点放在所有子任务都完成之后让GPT-6扮演一个挑剔的导师指出报告里哪些结论证据不足、哪些子问题没有覆盖、哪些地方逻辑混乱。有了这些评审意见让智能体再针对缺口执行一轮补充子任务最终报告的可用性会高一个台阶。注意反思节点不要每轮都跑成本会翻倍。简单任务只在最后跑一次复杂任务阶段性地跑即可。5.2 记忆与长期知识管理研究智能体最大的浪费是“每次从零开始”。同一份资料今天研究甲问题读过一遍明天研究乙问题又读一遍。给系统加一个向量记忆层把每次本地模型处理过的文档摘要、关键事实写入本地向量库下一次再遇到相关任务时先检索记忆命中就直接复用之前结论大幅减少重复计算。MiniCPM5-2B在这里会扮演“记忆写入器”的角色每次执行完任务它同时产出一条短摘要供向量化存储。检索时用云端模型把用户问题向量化。这个方案不需要额外引入复杂数据库一个本地的SQLite加embedding文件就够了。对个人研究者来说比搭建完整知识库系统划算得多。5.3 从个人助手到多智能体团队再往深走一个编排中心配一个本地模型是不够的。真实研究场景经常同时涉及代码分析、论文检索、数据统计等多种任务用同一个2B模型处理所有类型效果会打折扣。更合理的形态是一个规划中心GPT-6多个专用执行模型。代码分析由一个针对代码调优过的模型负责文档摘要另一个数据处理再一个全部跑在本机。这些专用模型参数可以更小比如1B、2B因为职责越专一模型越容易把事做好。规划中心根据任务类型路由到对应执行模型结果再汇总回来。这种“中央规划边缘执行”的架构跟系统设计里的微服务理念很像。随着端侧模型越来越强、显存越来越大我相信本地研究智能体未来会成为每个开发者的标配工具。我在实际项目中跑下来的最大感受是这套组合真正的价值不在于省了那几十块钱API费用而在于它让我敢于把很多半私密的生产资料交给智能体去处理。当敏感数据全程不离开本地研究问题就可以更放开研究深度也就不一样了。如果你也想试我的建议是不要贪大先用“一个云端模型做规划一个小模型做执行”跑通最小闭环跑通之后再考虑反思、记忆和多模型路由。先动起来比什么都重要。