DeepSeek Harness 智能体、子代理与团队怎么分:配置、并发与适用场景完整对比
智能体、子代理与团队是三个层级,不是三个同义词。 主代理做决策,子代理做分工,团队做协作;混着用,最常见的结果是并发过高、任务互相等待。
三层对象
先看清谁负责什么,再谈怎么配。
| 层级 | 角色 | 典型用途 | 上下文 |
|---|---|---|---|
| 智能体 | 主执行者 | 理解任务、调用工具、给结果 | 与你会话共享 |
| 子代理 | 分工执行单元 | 并行检索、审阅、独立子任务 | 相对隔离 |
| 团队 | 多角色协作 | 评审、分阶段实施 | 按角色分配 |
主代理是决策中心,子代理是执行单元,团队是组织方式。 主代理理解你的目标,决定要不要派子代理、派几个、什么时候收结果(来源);子代理拿一个明确子任务,在自己的上下文里跑,最后把结果交回主代理,隔离带来并行,也带来汇总成本;团队定义角色、任务与推进顺序,适合需要分工与依赖的复杂任务(来源)。
子代理:分工与隔离
子代理的价值是「并行」和「隔离」,不是「更聪明」。
- 把任务拆成互不依赖的子任务:检索、审阅、生成、校验。
- 为每个子任务写清输入、输出与完成标准。
- 由主代理派发,等待结果并汇总。
- 检查子代理是否越界:改了不该改的文件、调了不该调的工具。
- 结果冲突时,回主代理裁决,不要让子代理互相协商。
隔离是双刃剑,子代理也不适合强依赖任务。 子代理看不到主会话全部上下文,减少干扰,也可能缺少关键约束;任务说明要自带前提。后一步依赖前一步结果时,串行更快;并行只会增加等待与合并成本。
团队:角色、并发与协调
团队解决「多角色怎么一起干」,核心是分工与顺序。
- 定义角色:谁负责方案、谁负责实现、谁负责审阅。
- 定义任务与依赖:哪些能并行,哪些必须等前置完成。
- 设置并发上限:按模型配额与机器能力定,不要一次拉满。
- 定义交接物:每个角色交付什么格式,下一角色才能接。
- 设置终止条件:什么情况下停止、回退或交给人。
团队的成本在协调,并发也不是越高越好。 角色越多,交接与等待越多;两三个角色能解决的任务,不要上五个。并发高会排队、超时、互相等待;先串行跑通,再逐步提高。
agent 预设:把配置固定下来
预设解决「每次配置都不一样」。 它把模型、提示词与工具固定成模板。
- 选一个稳定可用的配置作为基线。
- 固定模型与关键参数,避免每次漂移。
- 写清适用场景与不适用场景。
- 给预设起可识别的名字,团队与子代理引用它。
- 变更预设时记录版本,避免历史任务无法复现。
预设是「怎么配」,团队是「怎么协作」,预设也不要频繁改。 两者一起用,才能既一致又可控。改一次,所有引用它的任务行为都会变;需要试验时新建一个,而不是改基线。
对照表
按任务形态选层级,比按习惯选更稳。
| 任务形态 | 选这个 | 理由 |
|---|---|---|
| 单步问答、简单工具调用 | 主智能体 | 不需要拆分 |
| 可并行的独立子任务 | 子代理 | 隔离与并行收益明显 |
| 有角色与依赖的复杂任务 | 团队 | 需要分工与顺序 |
| 重复执行的固定流程 | 预设 + 团队 | 配置一致、可复用 |
能用主代理解决就不要拆,团队也不是「更高级」,是「更重」。 拆分带来上下文隔离、汇总与协调成本;收益不明确时,单代理更快。只有在分工与依赖确实存在时才用团队。
配置入口
三层配置的位置不同,先找对入口。
- 主智能体: 会话级配置,模型、工具与提示词在会话或设置里。
- 子代理: 由主代理派发,任务说明与工具范围在派发时确定。
- 团队: 团队类插件或配置定义角色、任务与并发。
- 预设: agent 预设管理入口,固定模型与提示词模板。
- 并发: 在团队或运行配置里设置上限,不在单个任务里硬编码。
配置分散时先画一张关系图,并记录生效版本。 谁引用谁、哪个配置生效,写清楚再改;否则改了一个地方,另一个地方仍用旧值。团队与预设都可能有多个版本,出问题先确认实际用的是哪一个。
常见失败
多代理任务的失败,集中在四类。
- 并发过高: 排队、超时、配额耗尽;先降并发,再谈优化。
- 任务互相等待: 设计成环,A 等 B、B 等 A;画依赖图,打破环。
- 子代理缺上下文: 任务说明没带前提,结果跑偏;把约束写进派发说明。
- 汇总丢失: 子代理结果没交接物,主代理无法合并;统一输出格式。
四类的共同点是「协调没设计好」。 不是模型能力问题,是任务结构问题;先改结构,再换模型。
选型建议
从轻到重,按需升级。
- 先试主代理,确认单代理能否完成。
- 有明确可并行的子任务,再加子代理。
- 有角色与依赖,再上团队。
- 任务重复出现,再抽成预设。
- 每次升级都保留回退路径。
升级的判据是「收益大于协调成本」,不要为了用而用。 并行节省的时间,要大于拆分与汇总的成本;否则不如串行。多代理是工具,不是目标;能简单解决的,保持简单。
下一步
先分清层级,再按任务形态选。 想看团队编排的上手流程,看《DSH plugin 多智能体团队怎么用》;想看 agent 预设,看《dsh agent 预设是什么》;想区分工作流、定时与子代理,看《工作流、定时与子代理怎么分》。
常见问题
智能体、子代理和团队不是同一个层级。智能体是会话里的主执行者,子代理是主代理派出去的分工单元,团队是多角色协作的组织方式;三者都叫 agent,但职责与配置入口不同。
子代理适合可拆分、互不依赖的子任务,例如并行检索与审阅;团队适合有角色分工与流程依赖的任务,例如方案评审与多阶段实施。简单任务直接用主代理。
多智能体并发变慢或卡住,先看并发上限与模型配额,再看任务之间是否互相等待。并发过高会排队与超时,任务设计成环会互相阻塞;先降到串行验证链路。
DeepSeek Harness 的 agent 预设是把一组 agent 配置固定下来,方便复用;团队配置定义角色、任务与协作方式。预设解决「怎么配」,团队解决「怎么一起干」。
相关术语
- 智能体
- 智能体是会话中负责理解任务、调用工具并给出结果的主执行者,通常对应一轮对话的决策中心。— DeepSeek Harness 官方文档
- 子代理
- 子代理是主智能体派生的执行单元,拥有相对独立的上下文与任务范围,用于并行或隔离处理子任务。— DeepSeek Harness 官方文档
- 团队
- 团队是多智能体协作的组织方式,定义角色、任务分配与推进顺序,适合有分工与依赖的复杂任务。— dsh-agent-teams 插件页
- agent 预设
- agent 预设是预先把模型、提示词与工具配置固定下来的模板,用于复用一致的智能体行为。— DeepSeek Harness 官方文档
来源
- DeepSeek Harness 官方文档· deepseek-harness
- dsh-agent-teams 插件页· dsh-plugin.org
- dsh CLI README· deepseek-ai