父智能体派出子智能体后,对方却说「没有这个工具」,或拿到的内容停留在上一次对话。 这类问题几乎都不是 bug,而是把「继承」误当成了单一机制。
实际涉及至少三种彼此独立的继承,各自由不同因素决定:
- 对话历史——由后端决定:spawn 从空对话开始,fork 只获取创建时已经完成的轮次;
- 工具与服务——由
agentPreset和实际生效的组合决定; - 权限范围——在子智能体启动时固定,子会话内无法扩大。
三者可以完全不同步。fork 了不等于权限一致;进程相同不等于工具一致;有历史也不等于能改文件。
本文依次介绍后端、上下文、工具与权限,以及委派和结果收取,最后给出一套排查顺序。
一、三种后端,决定的不只是历史
官方子代理参考介绍了共享管理器,以及本地后端和外部后端的区别。具体行为如下:
| 选择 | 初始对话 | 后续消息与结果 |
|---|---|---|
| 进程内 spawn | 全新空对话 | 本地 Session 支持后续消息;父级投递提供完成通知 |
| 进程内 fork | fork 时父级已完成的轮次 | 本地 Session 支持后续消息;不含当前未完成和后续轮次 |
| 外部后端 | 执行和上下文取决于后端 | 参考将其描述为一次执行,不接受后续消息 |
这张表里有三个不同的「不」:spawn 不带历史,fork 不带当前未完成的轮次,外部后端不接受后续消息。逐格看清楚,再根据任务需要选择后端;如果先选后端、再考虑怎么用,很容易碰上其中一个限制。
二、子智能体到底看得到什么
spawn:从空对话开始
进程内 spawn 出来的子智能体从空对话开始。因此,委派提示词必须能够独立说明任务:必要的路径、约束和预期结果都要写清楚。
还要留意一个默认值:未指定 cwd 时,子智能体会继承父级当前有效目录;模型选项也默认继承父级的(可用后端支持的覆盖改掉)。不过,目录和模型选项的继承,与对话历史的继承是两回事——子智能体能拿到目录,却看不到你刚才那三轮讨论。
fork:只拿「已完成」的轮次
fork 会在创建时一次性获取父级已完成轮次作为种子。
有三个边界需要记住:
- 当前尚未完成的轮次不在其中;
- 父级后续轮次不会自动进入子会话;
- 如果此前没有任何完成轮次,种子就是空的。
所以,「我明明 fork 了,它怎么不知道我刚刚说的?」通常不是 fork 失效,而是那句话还在未完成轮次里。当前轮次的关键指令要明确写进委派提示词,不能假设子智能体已经看到。
目录语义只说明「在哪」,不说明「能碰什么」。
本地子智能体未指定 cwd 时,会在接纳时捕获父级当前有效目录;显式给出的相对路径会相对该目录解析。子 Session 保留父级原始项目,冷恢复时则保留自身记录的目录状态。
这不意味着子智能体会被限制在该目录内。目录语义只说明目录如何选定,并不说明目录本身会限制文件访问。访问边界要看下一节的权限。
三、工具和权限:最容易被误判的一层
不要把对话继承等同于权限继承。 这是本节要记住的核心。
未指定 preset 时会加入父级组合。
没有单独选择 preset 时,进程内 spawn 和 fork 通常会加入父级当前组合。只有 spawn 支持独立选择 agentPreset,而实际的 persona 和工具由选定的 preset定义。
spawn 包还说明,子智能体有自己的注册作用域,不会导入父智能体的本地工具限制。因此,「父级有这个工具,子级应该也有」并不成立——要看实际生效的组合。
权限在启动时固定
子代理包参考说明,管理器会在创建时捕获委派权限,进程内子智能体会保留父级来源元数据与权限根。运行时声明进一步指出:
权限范围在启动时固定,不能在子会话内扩大;需要审批的操作会自动拒绝。
这可以解释一种常见情况:子智能体反复重试某个操作,每次都被拒绝。它不是在「尝试说服审批者」,而是该操作原本就不在被委派的范围内,重试不会改变结果。
正确做法是向父智能体报告限制,由父级(或用户)决定如何处理。
外部 provider 的 inheritsParentContext 是个容易误读的名字。
外部 provider 保留各自的权限系统。子系统明确说明:后端的 inheritsParentContext 能力不代表工具注册、注入服务或权限的继承。
因此,fork 出来的历史或共享的同一个进程,都不能证明权限相同。需要核对部署实际使用的 provider、preset 和生效策略。
四、按顺序委派,并收好结果
- 写清任务边界和可核对的交付物:说明检查范围、允许修改的内容,以及需要返回的证据。
- 选择后端:提示词能独立成立时,用全新子会话;确实需要且适合共享已完成历史时,再考虑 fork。无论选哪种,当前轮次的重要事实都要写进提示词。
- 核对 provider、preset、工作目录、可用工具和权限边界。如果任务需要范围之外的操作,就交回父智能体处理,不要让子智能体扩大权限。
- 让子智能体执行任务,并通过该后端支持的消息方式进行澄清。
- 父智能体整合前核对结果与证据。
第 5 步还要区分一件事:完成与清理是两回事。管理器会在资源释放和通知之后结算 activation 结果;清理失败会另行报告。因此,收到完成通知不等于相关资源已经清理干净。
这一分工与 agent 生命周期一致:每个 agent 都有自己的轮次与步骤;Session 事件提供持久回放事实,agent/* 提供实时协调。子智能体不是父级回复中的另一段文字,它有独立的 Session 和生命周期。
五、什么样的任务适合交出去
写清「父级要做的判断」,不要只给一个主题。
调查类任务应要求具体证据、相关位置和不确定项;实现类任务应说明允许改动的文件或效果、预期行为和验证方式。
原因很直接:全新子会话无法从父级对话中补回遗漏的细节,fork 也拿不到当前尚未结束的轮次。交接越清楚,父级越能依据原始要求核对返回结果。
让每个子任务都能独立评估。
如果两个子智能体可能修改同一文件,要事先协调各自负责的范围,并在整合前审查变更。
这里有个容易忽略的地方:本地子智能体虽然有独立 Session,仍可能访问有效环境中的共享资源。会话分离不会自动复制文件,也不会消除修改冲突。独立 Session 是组织手段,不是隔离手段。
要求子智能体标明「不确定」。
对子任务来说,明确说明「不确定」和给出结论一样有价值。要求它区分已观察的事实与推断,并说明哪些部分无法访问或没有验证,父级收到后才能判断哪些结论可以直接采用。
涉及文件修改时,要求返回具体变更和验证结果,会比只说「完成了」更容易审查。
六、继续执行和结果投递是两件事
- 本地子智能体拥有持久 Session,可以继续执行;管理器负责输入接纳和冷恢复。
- 外部执行是一次性的,不接受后续消息。
- 父级投递提供完成通知;调用者投递会把结果返回调用者,但不会向父级注入该通知。
即使两种执行都可能出现在子项目录里,也不能推断它们具有相同的消息能力。
共享参考将子项成员关系、结果收集和活动状态分开处理:目录条目标识父子关系,本身不是当前执行状态;一次 activation 结束后,子项仍可能留下持久记录。
因此,排查工作流时要分别检查创建、当前活动、完成和清理,不能只看一个标签。
七、审批结果不只有「允许」和「拒绝」
通用审批服务按具体操作作出决定。封闭结果除了单次允许,还包括拒绝、取消和不可用;结果不是授权时,调用方会拒绝执行。
理解这一点,才能正确解读子智能体「无法访问」的报告:父智能体应依据用户的实际指令和生效环境判断缺少哪项权限,而不是让子智能体无限制重试。
还有一点容易忽略:对于进程内子智能体已被委派范围拒绝的需审批操作,不应假设一定会弹出审批。范围之外的操作可能在到达审批之前就已经不成立。
八、安全边界
把边界集中列在这里:
- 新对话不等于沙箱。 spawn 是空对话,但它仍可能拥有配置中的工具和服务。
- fork 可能复制不适合共享的已完成对话。 带入历史之前,先判断这些历史是否适合当前任务。
- 子智能体可能通过实际组合访问共享服务和文件。
- 权限范围在子智能体启动时固定,子会话内不能扩大。
inheritsParentContext不代表工具注册、注入服务或权限继承。- 来源没有承诺所有安装都提供相同的委派选项;并发、工具和后端能力取决于组合。
- 应只提供任务需要的信息和权限,审查输出与变更,并核对实际 provider 的约束。
相关概念可参阅权限预设。
九、装完之后子智能体说没工具?按这个顺序查
可以按下面的顺序排查:
- 先确认子智能体是否真的创建成功——子项存在,不等于当前有活动执行。参考 agent 生命周期各阶段,区分创建、活动、完成与清理。
- 再检查 preset——没有独立选择
agentPreset时,它会加入父级组合;但 spawn 有自己的注册作用域,不要假设工具列表和父级一致。 - 然后核对工具名——比较父级调用名称和子级实际注册名称;如果名称对不上,查看内置工具的参数比猜更快。
- 最后检查权限——如果操作需要审批,却被委派范围拒绝,它会在到达审批前就失败,重试没有意义。
如果确实需要在父级之外独立选择 persona 和工具,可参考安装 Codex/Claude 子代理 provider和查找可用的 agent 工具。同类现象的另一条排查线见装完子智能体插件却找不到工具——那篇讨论的是「包在不在」和「这一层选没选」的区别。
十、相关术语
- 父级 / 主 agent:委派子任务并整合结果的 agent。
- Spawn:启动全新子对话的进程内后端。
- Fork:在创建时以父级已完成轮次为种子的进程内后端。
- Preset:控制 agent persona 与工具的组合。
- 委派权限范围:子智能体启动时捕获的权限,不等同于继承的对话历史。
- Activation:包含结果与资源清理的一次受管理子任务执行。
理解「后端」「preset」「权限范围」各自负责什么,比记住某个具体行为更有用——它们分别对应三个会独立失败的关卡。
十一、边界说明
- 本文依据 DeepSeek Harness 官方子代理参考、spawn / fork 包说明、审批参考与 agent 生命周期参考整理,不是官方支持文档;具体行为可能随版本变化,动手前以你所在版本的官方文档为准。
- 子会话隔离不等于沙箱隔离,独立 Session 不会自动复制文件,也不会消除修改冲突。
inheritsParentContext不是权限继承的证明,需核对实际 provider、preset 与生效策略。- 权限范围启动时固定,子会话内不能扩大;需要范围外操作时应交回父级。
- 完成通知只是 activation 的结果,不自动证明结论正确,也不代表资源清理成功。
相关阅读
本文依据 DeepSeek Harness 官方子代理参考与相关知识库整理,由 DSH Plugin 社区(dsh-plugin.com)维护者撰写,首发于阿里云开发者社区。
插件与文档收录于:https://dsh-plugin.com/zh/blog