3.0 KiB
@deepseek-ai/dsh-tool-subagent-control
English | 中文
可选的全局具名 send_message 工具：ctx.subagents.followup() 之上的轻量适配器。绑定提供方的 @deepseek-ai/dsh-tool-subagent 实例会为每种传输注册不同的委派工具；这个单独加载的包（package）只注册一个共享后续操作工具，因此多个委派工具绝不会重复注册全局控制工具。是否加载本工具不会决定委派工具是否启动可继续工作。
本工具不执行生命周期路由——驻留与冷恢复归 subagent 服务所有。它将 exec.agent 作为授权投递的准确实时父级传入，并把每条消息的来源标记为持久化来源 { kind: 'coordinator', senderSessionId: parent.id }；服务会保留该来源，但绝不将其视为权限。每条消息都会通过 Agent.followup() 成为子 agent（智能体）的下一个 FIFO 轮次：如果子 agent 仍在工作，该消息会等待其当前轮次结束，因此无法重定向已经在进行的工作。本工具会转发其执行信号，该信号只在 inbox 接受之前掌管准入；一旦子 agent 接受消息，已接受的轮次便无法再通过本工具取消。子 agent 不会回复发送方——通过该 id 查看其 transcript 即是其所做工作的来源。投递失败会变为出错的工具结果，并明确说明消息未送达。
模型体验
工具 schema
模型看到的内容
已生成的 send_message schema：包含 subagent_id 和 message，说明消息会成为子 agent 的下一个轮次、子 agent 不会回复，以及失败即表示消息未送达。
Token 影响
每个父级请求支付固定的 schema 成本。
KV Cache 影响
前缀保持稳定；schema 不会在运行时改变。
投递结果
模型看到的内容
接受时返回 message queued as the next turn for subagent <subagent_id>；规范输出携带被接受的 messageId。失败，包括未授权或未知的子 agent、缺少描述符而无法恢复的子 agent，或准入被拒绝，都会成为出错的结果，其消息说明该消息未送达。
Token 影响
每次调用产生一条简短确认消息；子 agent 的响应绝不会通过本工具返回，因此只有当调用方读取子 agent transcript 并转达时，其输出才会进入父级历史。
KV Cache 影响
仅追加；新增可见内容位于可复用请求前缀之后，不会使现有 KV-cache 条目失效。
已知限制与延期工作
- 已排队的消息没有独立结果：接受时只返回其 inbox
messageId；子 agent 在该轮次的工作会落入持久化子 agent Session，按其 subagent id 读取，既不会回传，也不会通过本工具收集。 - 不对当前轮次进行 steering：每条消息都会开启后续 FIFO 轮次，因此在子 agent 工作时发送的消息只会在其当前轮次结束后运行，无法将其重定向。