99.3% 通过率背后的失败模式Multi-Agent-CAD 与单 Agent CAD 生成器的 3 类典型错误深度对比【免费下载链接】Multi-Agent-CADMAC (Multi-Agent CAD): A decoupled multi-agent framework for text-to-CAD generation via constrained test-time compute项目地址: https://gitcode.com/gh_mirrors/mu/Multi-Agent-CADMulti-Agent-CAD简称 MAC是一个开源的多智能体文本到 CAD 生成框架它把一句自然语言描述直接变成可 3D 打印的 STEP 模型在 10 零件、141 个几何特征的基准测试中实现了99.3% 的特征通过率。但这 0.7% 的不完美恰恰最有价值——本文逐条解剖 Multi-Agent-CAD 与单 Agent CAD 生成器的 3 类典型失败模式讲清楚错误到底出在哪一层、为什么单 Agent 会犯而 MAC 不会、以及哪些错误靠改提示词能救、哪些救不了。一、先搞懂 99.3% 通过率是怎么测出来的在讨论失败模式之前先看测量方法否则数字没有意义。测试集10 个 CAD 生成 promptP1–P10覆盖通孔阵列、法兰、L 形支架、阶梯轴、航空 U 形支架、径向气缸、离心叶轮、螺旋楼梯、行星齿轮组件等共提取141 个二元通过/失败特征如中心通孔直径 30 mm耳与底板交界处有较小圆角。公平性两种架构使用相同 prompt、相同测试集、相同几何评估标准甚至相同的大模型Qwen 3.7-max——唯一变量是 Agent 架构。单 Agent 基线是经典的对话式 CAD 生成器范式把建模文档 完整对话历史 错误栈反复塞进上下文由同一个模型边写边改。指标单 Agent CAD 生成器Multi-Agent-CADMAC差距特征通过率97.9%138/14199.3%140/141↑失败特征数313×总 token 消耗103,950,189896,340116× ↓API 调用次数1,3075026× ↓总成本CNY¥125.69¥9.6713× ↓完整原始数据见 docs/qwen3.7_token.md失败模式分析方法见 docs/quantified_quality_cn.md。关键结论MAC 不仅失败更少而且失败的类型完全不同。下面逐类拆解。二、失败模式一圆角范围错误——单 Agent CAD 生成器的高发区2.1 三个真实失败案例单 Agent 基线的 3 个失败**全部集中在圆角fillet范围**上分布在 2 个 prompt 中失败Prompt特征描述实际表现AP5 顶开式盒体内部垂直角、顶部边缘及支柱无圆角该倒圆角的 4 个外部垂直角没倒圆角却错加到底板下边缘BP6 航空 U 形支架耳与底板交界处有较小圆角耳-底板过渡圆角漏做CP6 航空 U 形支架其他部分无圆角本应保持尖锐的区域被多余地倒圆角注意 A 是双重错误该做的没做 不该做的做了。B 和 C 是一对镜像错误——同一零件上一处漏圆角、一处多加圆角。2.2 根因上下文膨胀导致注意力稀释这不是模型看不懂否定句。问题出在单 Agent 的工作方式它把 build123d 参考文档、完整对话历史、多轮错误栈堆在同一个大上下文里反复读取基线 96.2M token 中 94.5% 是缓存读取的同一份大上下文。当上下文膨胀到千万级 token仅外部垂直角加圆角内部角不加这类排他性约束就像大海捞针被注意力机制稀释遗忘——于是圆角被施加到错误的边上。这类错误还有一个重要特征3/3 都可以通过更明确地重写 prompt 来恢复因为本质是约束被读丢了而不是几何本身做不出来。三、失败模式二几何拓扑冲突——MAC 唯一的一个失败3.1 案例离心叶轮叶片根部圆角倒不出来MAC 在 P8离心叶轮 12 后弯叶片上失败了 1 个特征P8 第 13 条叶片根部有圆角与背板和轮毂交界处代码里确实写了这个圆角但 build123d 的圆角操作在该几何上发生冲突边选择/布尔运算冲突圆角实际未能倒出。更棘手的是MAC 的双引擎 QA 检测到了这个失败并连续 5 轮把 QA 错误报告喂给 Aider 修复代理重试上限MAX_RETRIES5但这是一个拓扑层面的死结——连续 5 轮都解决不了最终系统按达到最大重试上限放行留下这个失败。3.2 为什么这个失败救不了对比失败模式一这里的失败点不在理解需求而在几何内核做不出来重写 prompt 无效——需求理解完全正确代码也写了是 OpenCascade 内核在该曲面上拒绝圆角。MAC 为此设计了多层缓解_safe_fillet会按 R → R/2 → R/4 → R/8 自动降级半径重试失败时把边边界框诊断写入运行时诊断文件temp_missed_*.json分类为FILLET_FAILED让修复代理拿到哪里失败了、为什么的白盒证据而不是一句模糊的圆角失败。但降级到 R/8 仍失败时只能承认失败。这类错误需要修复圆角生成代码本身换边选择策略、调整布尔顺序属于几何引擎的能力边界问题。MAC 的失败模式分布揭示了多智能体架构的特性它几乎消灭了理解层错误剩下的失败集中在几何执行层——这是 LLM 生成 CAD 目前共同的能力天花板与用几个 Agent 无关。四、失败模式三物理不可行设计——打印时会断裂的悬空件4.1 单 Agent 的隐形失败看起来对了打印就断最隐蔽的一类错误是几何上通过、物理上必断的设计。以 P9 螺旋楼梯为例需求中踏步内端接近立柱的字面实现会导致踏步与立柱只在一点相切、没有任何实体连接——STEP 文件完美生成但 3D 打印时模型会从该处直接断裂。单 Agent 生成踏步与立柱断开MAC 生成安全重叠打印一体4.2 MAC 的防御性修正超越字面指令MAC 处理 P9 时基于物理常识主动修正了这个参数——让踏步内端与立柱保持安全重叠而不是忠实执行接近的字面含义。这正是质量报告中防御性修正的含义系统超越了原始指令的字面执行优先满足可制造性。这个差异来自架构MAC 的自主技能循环Autonomous Skill Loop内置双引擎 QA——Engine A 做 STEP 拓扑分析由 packages/cadpy 驱动Engine B 做 STL 网格分析并用 Union-Find 算法检测拓扑连通性legacy_refs/check_mesh.py。单点接触、悬空碎块这类打印必断结构在连通性检查中会触发致命错误路由强制 Aider 修复。单 Agent 基线没有这道白盒关卡只能靠模型自觉——而它的 16/16 特征全部通过恰恰说明特征检查测不出物理不可行性需要额外的制造性验证才能兜底。五、为什么架构差异能改写失败分布把三类失败并排看规律一目了然失败模式谁犯的出错层级重写 prompt 可恢复圆角范围错误排他性约束丢失单 Agent3 个特征需求理解层✅ 可能3/3几何拓扑冲突圆角内核报错MAC1 个特征几何执行层❌ 不能1/1物理不可行悬空断裂单 Agent1 个特征制造性验证层⚠️ 需制造性检查兜底背后的机制是结构化状态传递切断了幻觉传播链不传对话只传快照。MAC 的 4 个智能体Spec Planner → Geometric Architect → Python Coder → 自主技能循环之间只传递紧凑的结构化 JSONCADBrief、ArchitectPlan和 QA 报告任何 Agent 都不回读完整对话历史。单 Agent 里第 3 轮说的圆角约束和第 8 轮的错误栈会在同一上下文里互相干扰MAC 中每个 Agent 只看自己职责所需的小快照约束丢失的空间被结构性压缩。代码生成尽量不经过 LLM。确定性翻译器 multi_agent_cad/nodes.py 中的_plan_to_code直接把ArchitectPlan翻译成 build123d 代码零 token圆角边选择走语义化边过滤器而非硬编码坐标——这从源头减少了写错边的概率。失败证据白盒化。每次 QA 失败Aider 拿到的是分类好的错误报告MISSED_CUT/FILLET_FAILED/CHAMFER_FAILED 白盒特征测量数据 multi_agent_cad/build123d_reference.md 中的 API 陷阱清单修复是定向的而不是在千万 token 的上下文里凭印象再试一次。制造性验证独立于特征检查。双引擎 QA 的连通性/水密性检查是最终结果属性级别的硬关卡与141 个特征逐条比对互补——前者拦悬空件后者拦尺寸错。Web UI 中一轮完整流水线的运行过程含 3D 预览与产物下载六、上手验证10 分钟复现这个失败分布git clone https://gitcode.com/gh_mirrors/mu/Multi-Agent-CAD cd Multi-Agent-CAD conda env create -f environment.yml conda activate multi_agent_cad pip install --no-deps aider-chat0.82.3 python -m multi_agent_cad.graph每个 QA 轮次后有 10 秒人工检查点按2可注入修改需求、按3停止保留当前产物所有中间产物temp_measurements_*.json白盒测量、temp_missed_*.json运行时诊断、QA 报告都会落盘、可审计。四阶段流水线与双引擎 QA 的完整设计见 multi_agent_cad/WORKFLOW.md模型与阶段参数在 multi_agent_cad/config.py 中可按阶段独立配置。七、结论99.3% 通过率的含金量不在于那个数字本身而在于失败模式的分布单 Agent CAD 生成器的失败是理解层的——上下文膨胀稀释了排他性约束圆角做在错误的边上且改提示词可以救Multi-Agent-CAD的失败是执行层的——需求理解零失误败在几何内核的拓扑死结这已是 LLM 生成 CAD 的共同天花板最危险的物理不可行设计打印即断需要 MAC 这类带制造性 QA 关卡的系统才能拦截纯特征比对式的单 Agent 流程对此天然盲区。选型建议很直接如果你的痛点是复杂约束总是被模型忘掉多智能体 结构化状态传递的架构收益是即时的如果痛点是模型总是倒不出某些圆角那换什么架构都绕不过几何内核需要的是更好的边选择策略与修复工程。【免费下载链接】Multi-Agent-CADMAC (Multi-Agent CAD): A decoupled multi-agent framework for text-to-CAD generation via constrained test-time compute项目地址: https://gitcode.com/gh_mirrors/mu/Multi-Agent-CAD创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考