Nanbeige4.2-3B – 南北阁实验室推出的通用 Agent 小模型
导读摘要:
Nanbeige4.2-3B是BOSS直聘南北阁实验室推出的通用Agent小模型,仅3B参数却在代码智能体、办公工作流、复杂工具调用等Agent任务上超越Qwen3.5-9B与Gemma4-12B等更大模型。模型采用Looped Transformer架构提升有效容量,构建了代码、工具、办公三类Agent数据的闭环合成管线,经三阶段课程SFT与多阶段RL训练,在降低推理成本的同时保持强Agent能力,已开源并适配多种推理引擎。
1. Nanbeige4.2-3B是什么
Nanbeige4.2-3B是BOSS直聘南北阁实验室推出的通用Agent小模型,仅3B参数却在代码智能体、办公工作流、复杂工具调用等Agent任务上超越Qwen3.5-9B与Gemma4-12B等更大模型。模型采用Looped Transformer架构提升有效容量,构建了代码、工具、办公三类Agent数据的闭环合成管线,经三阶段课程SFT与多阶段RL训练,在降低推理成本的同时保持强Agent能力,已开源并适配多种推理引擎。
技术定位与领域: 属于自然语言处理与智能体领域,专注于通用Agent任务,包括代码智能体、办公工作流自动化、复杂工具调用等。其定位是在3B参数规模下实现超越更大模型的Agent性能,为本地部署和高频调用场景提供低成本方案。
研发背景: 由BOSS直聘南北阁实验室研发,团队在Agent数据合成和训练方法上拥有深厚积累。研发动机在于现有大模型在Agent任务上成本高、部署门槛高,而小模型普遍在Agent能力上不足,因此探索在极小参数下突破Agent性能瓶颈。
核心价值: 解决了小参数模型在Agent任务上能力不足的痛点,使开发者能够以极低成本获得高性能Agent能力。其价值在于大幅降低推理成本、支持本地部署、保持强Agent能力,适用于高频Agent系统和隐私敏感场景。
技术特点: 采用Looped Transformer架构,在不增加参数量的前提下提升有效计算深度,获得约75%的token efficiency收益;构建三类Agent数据的闭环合成管线,数据随模型能力演化;训练上采用三阶段课程SFT(64K→128K→256K)和多阶段RL(Think/Non-Think RLHF、Reasoning RL、Agentic RL),包括错误掩码和动作级奖励,显著提升Agent任务稳定性和准确性。
2. 主要功能
代码智能体: 基于仓库级上下文理解与工具调用链路,模型可在真实代码仓库中浏览目录、定位缺陷、生成补丁并运行测试验证,覆盖软件工程全流程。技术上依托Agent数据闭环合成与动作级强化学习,使模型学会「读代码—改代码—验结果」的闭环策略。开发者可将其接入IDE或CI流水线,在SWE-Bench Verified上达到63.6%通过率,显著降低人工排查成本。
办公智能体: 面向跨格式办公工作流,支持文档、表格、幻灯片、PDF等多文件依赖处理,能够完成数据整理、报告生成与格式转换等长流程任务。实现上通过办公类Agent轨迹训练与课程式上下文扩展,提升多步骤文件操作的稳定性。对企业自动化场景价值明显,在GDPval办公评测取得68.8分,可减少重复人工操作并缩短交付周期。
复杂工具调用: 支持MCP在线服务、本地Python工具及虚拟工具的链式调用与参数推断,模型可自主规划调用顺序并处理多步骤依赖。原理上结合工具调用轨迹合成与Agentic RL,强化参数正确性与错误恢复能力。适用于信息检索、数据分析与服务编排等场景,在PinchBench-V2上达到74.7分,便于构建可扩展的工具编排系统。
通用推理: 覆盖数学、代码与科学推理,在GPQA Diamond、HMMT等评测上取得同规模较优成绩。通过Think/Non-Think双模式与Reasoning RL训练,模型可在深度推理与快速响应间切换,兼顾准确率与时延。对需要逻辑推演的问答、科研辅助与算法分析任务具有实用价值,GPQA得分53.3,超越多数同参数量模型。
本地个人助手: 具备多轮规划、文件处理与错误历史修正能力,可低门槛部署为PC或NAS上的本地Agent助手。实现方式依托小参数量与主流推理引擎适配,FP16约需6GB显存即可运行,满足隐私与离线需求。适合日程管理、本地文件搜索与私有知识问答,降低对云端大模型的依赖。
多模式推理切换: 同一权重支持思考模式(Think)深度推理与非思考模式(Non-Think)快速响应,用户可按任务复杂度动态切换。技术上通过双模式RLHF与共享权重训练,避免维护两套模型。对延迟敏感的高频调用与需要深思的复杂任务都能复用同一部署,平衡性能与效率。
3. 如何使用
环境要求: 模型为3B参数,FP16推理约需6GB显存,推荐NVIDIA RTX 3060及以上GPU或Apple Silicon Mac。操作系统建议Linux或Windows,需安装Python 3.8+和PyTorch。CPU推理也可行但速度较慢。
获取模型权重: 从Hugging Face下载Nanbeige4.2-3B(Agent版)或Nanbeige4.2-3B-Base(基座版)权重。可使用
git clone https://huggingface.co/Nanbeige/Nanbeige4.2-3B或通过Hugging Face Hub API下载。选择推理引擎: 模型已适配Transformers、SGLang、vLLM、llama.cpp、Ollama等主流引擎。例如使用Transformers加载:
from transformers import AutoModelForCausalLM, AutoTokenizer; model = AutoModelForCausalLM.from_pretrained("Nanbeige/Nanbeige4.2-3B")。Ollama用户可直接ollama pull nanbeige4.2-3b。切换推理模式: 通过设置生成参数或添加特殊标记控制思考模式。例如在输入中添加
<think>标记触发深度推理,不加则默认快速响应。具体实现可参考官方示例代码,两种模式可动态切换。接入Agent框架: 将模型接入OpenClaw等Agent框架,配置外部工具(如MCP服务、Python执行器)和Scaffold。模型可执行多步代码、办公或研究任务,实现复杂工作流自动化。建议先测试单步工具调用,再扩展到多步骤。
4. 优缺点分析
| 优点 |
|---|
| 小参数大能力: 仅3B参数在Agent任务上超越9B/12B模型,大幅降低推理成本,适合高频调用场景和边缘部署,使中小团队也能负担得起仓库级代码与办公自动化。 |
| 架构创新: Looped Transformer在不增加参数下提升有效计算深度,获得约75%的token efficiency收益,同等算力下推理更高效,有利于端侧与消费级显卡部署。 |
| 数据飞轮: 三类Agent数据均构建闭环反馈与难度演化,训练数据随模型能力同步提升,避免数据静态导致的性能瓶颈,持续强化代码、工具与办公能力。 |
| 训练精细: SFT错误掩码保留错误上下文但不学习错误动作,RL多阶段兼顾准确率与输出长度,训练稳定性高,有助于降低Agent执行中的无效循环。 |
| 低门槛部署: 适配主流推理引擎,支持Think/Non-Think双模式,消费级显卡即可运行,降低硬件投入并便于私有化落地。 |
5. 同类工具对比
| 对比维度 | Nanbeige4.2-3B | Qwen3.5-4B | Qwen3.5-9B |
|---|---|---|---|
| 非Embedding参数量 | 3B,端侧友好,FP16约6GB显存 | 4B,略高但仍属小模型档 | 9B,需更高显存与带宽 |
| General Agent (PinchBench-V2) | 74.7,同对比组领先 | 63.9,通用Agent能力偏弱 | 官方未公布,据Nanbeige报告低于74.7 |
| Code Agent (SWE-Bench Verified) | 63.6%,仓库级修bug能力突出 | 38.8%,代码Agent差距明显 | 官方未公布,Nanbeige声称超越该模型 |
| 办公任务 (GDPval) | 68.8,跨格式办公工作流较强 | 37.0,办公自动化能力较弱 | 官方未公布,需自行评测验证 |
| 推理能力 (GPQA) | 53.3,同规模较优 | 43.1,科学推理偏弱 | 官方未公布,同规模9B通常更高 |
| 架构特色 | Looped Transformer,循环加深有效计算 | 标准Transformer,生态成熟 | 标准Transformer,通用能力更全面 |
| 部署门槛 | 更低,适配Transformers/SGLang/vLLM/Ollama等 | 标准部署,生态完善、文档丰富 | 标准部署,需更高显存与运维成本 |
选型建议: 对于成本敏感且需要高频Agent调用的场景(如代码辅助、办公自动化),Nanbeige4.2-3B凭借小参数和高性能是优先选项,尤其适合本地部署和边缘设备。若项目已深度依赖Qwen生态或需要更强通用推理能力,Qwen3.5-9B或Gemma4-12B可作为备选,但需接受更高的推理成本和硬件门槛。对于参数量要求不高的快速原型开发,Qwen3.5-4B也是稳定选择,但Agent能力明显弱于Nanbeige。
6. 编辑点评
Nanbeige4.2-3B在技术创新上路径清晰:Looped Transformer在不增加参数的前提下提升计算深度,为小模型突破性能瓶颈提供了可落地思路;数据闭环合成与三阶段课程SFT、多阶段RL的训练配方,使3B模型在Agent任务上能够挑战更大参数量对手。其实用价值突出——高频代码与办公自动化可从昂贵大模型下沉到可本地运行的小模型,同时满足隐私与离线需求。适用人群包括希望降低运营成本的AI应用开发者、需要私有化部署的企业团队,以及研究小模型Agent能力的学术机构。后续若能补齐多语言表现与社区生态,有望成为Agent小模型领域的重要参考实现。
推荐指数:★★★★☆(4/5)
依据:Agent评测数据亮眼、部署门槛低、开源可复现;扣分点在于中文能力与社区生态仍需验证,复杂推理上限受参数规模约束。
7. 应用场景
本地代码开发: 在开发者本地环境执行代码仓库浏览、Bug修复、补丁验证等软件工程任务。模型可集成到IDE插件或CI中,实现智能代码审查和自动修复,提升迭代效率。
办公工作流自动化: 自动处理跨格式文档、表格与幻灯片,完成数据整理、报告生成及格式转换。适用于企业日常办公自动化,减少重复人工操作并缩短交付时间。
智能工具编排服务: 通过MCP协议调用在线服务与本地工具,实现信息检索、数据分析与多步骤任务编排。例如自动从数据库提取数据、调用API处理并生成可视化报告。
边缘设备个人助手: 部署在PC或NAS等本地设备,作为低延迟、隐私可控的通用Agent助手。可执行日程管理、文件搜索、智能问答等任务,无需把敏感数据送上云。
高频Agent系统核心引擎: 在需数十至上百次模型调用的复杂Agent系统中替代大模型,显著降低运营成本。适用于客服机器人、自动化测试、工作流引擎等场景。
8. 常见问题FAQ
Q:Nanbeige4.2-3B是否完全开源?
A:模型权重已在Hugging Face开源,包括Agent版(Nanbeige4.2-3B)和Base版(Nanbeige4.2-3B-Base)。开发者可直接下载权重并用于研究或产品集成,具体许可证条款以官方仓库说明为准;上线前建议核对商用条款、署名要求与衍生模型限制,避免合规风险。
Q:运行该模型需要什么硬件配置?
A:3B参数模型在FP16推理下约需6GB显存,推荐NVIDIA RTX 3060及以上,或Apple Silicon Mac(M1/M2及更新机型)。CPU推理亦可运行但吞吐较低,建议至少16GB系统内存;若使用量化(如INT4/INT8)还可进一步降低显存占用,便于笔记本与边缘设备部署。
Q:如何切换Think和Non-Think模式?
A:一般通过输入中的特殊标记控制:在提示前添加<think>前缀可触发深度推理(Think)模式,不加则走Non-Think快速响应。不同推理引擎的具体参数名可能略有差异,建议先查阅官方示例与所选引擎文档,在同一部署上做A/B对比,按时延与准确率要求选择默认模式。
Q:模型支持中文吗?
A:模型训练语料以英文场景为主,中文代码、办公与工具调用能力尚未作为核心优化目标公开验证。若业务以中文为主,建议先用真实工单、文档与仓库样本做小规模评测,必要时结合检索增强或后续微调,再决定是否进入生产。
Q:如何将模型接入MCP工具?
A:模型支持MCP协议,可通过OpenClaw等Agent框架注册MCP服务端点,让模型在推理过程中按需调用外部工具并完成链式操作。实践上建议先验证单工具调用的参数正确性,再扩展到多工具编排,同时配置超时、重试与权限边界,保证生产可用性。
Q:模型上下文长度是多少?
A:官方称支持最长256K上下文,训练上通过三阶段课程SFT逐步扩展(64K→128K→256K),适合长文档处理与多轮Agent对话。实际使用中仍需结合显存、KV cache与引擎实现评估吞吐;超长输入建议分段摘要或检索后再送入模型,以平衡效果与成本。
9. 项目地址
- HuggingFace模型库(Agent版):https://huggingface.co/Nanbeige/Nanbeige4.2-3B
- HuggingFace模型库(Base版):https://huggingface.co/Nanbeige/Nanbeige4.2-3B-Base
- 技术论文(PDF):https://huggingface.co/Nanbeige/Nanbeige4.2-3B/blob/main/Nanbeige42_report.pdf
版权声明:本文部分内容由 AI 辅助生成并经人工校准,版权归本站所有,未经允许禁止任何形式的转载。



