BroadRouter
开始使用

子智能体(subagent)

更新于

子智能体是主智能体为处理一项明确任务而启动的独立智能体。它有自己的上下文窗口、系统提示词和工具权限,完成工作后只把结果或摘要返回给主智能体,从而让主对话保持精简。

又称: 子代理、子 Agent、子智能体、子 agent、subagent、sub-agent、child agent

子智能体就是智能体之间的委派:把一项工作交给一个全新的执行者,只拿回答案。

工作原理

主智能体判断某个任务可以独立完成,比如“找出这个函数的所有调用方”或“跑一遍测试并报告失败项”,就带着任务描述启动一个子智能体。子智能体运行自己的智能体循环,然后返回结果。

Claude Code 的文档是这样说的:“Each subagent runs in its own context window with a custom system prompt, specific tool access, and independent permissions.”(译文:每个子智能体都在自己的上下文窗口中运行,拥有自定义的系统提示词、特定的工具权限和独立的授权。)子智能体用带 YAML frontmatter 的 Markdown 文件定义,项目级的放在 .claude/agents/ 中:

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

文档列出的好处包括:让探索过程不进入主对话、限制子智能体能用哪些工具,以及把任务分派给成本更低的模型。

其他框架也有类似的思路。OpenAI Agents SDK 说 “Handoffs allow an agent to delegate tasks to another agent,“(译文:交接让一个智能体可以把任务委派给另一个智能体),并且把每次交接作为一个工具呈现给模型。

Anthropic 关于上下文工程的文章从上下文的角度描述了这种模式:每个子智能体在干净的上下文窗口中工作,并且 “returns only a condensed, distilled summary of its work,“(译文:只返回一份经过压缩提炼的工作摘要),通常为 1,000 到 2,000 个 token。

为什么重要

  • 上下文。 一次测试运行可能输出几万个 token。放在子智能体里,这些输出就不会进入主上下文窗口,回来的只有摘要。这是上下文工程的核心工具之一。
  • 成本。 总 token 通常会增加,因为每个子智能体都要加载自己的提示词和工具。多智能体成本一文估算了这个倍数。
  • 并行。 同时运行的子智能体就是并行请求。能同时跑多少个,取决于服务商的并发限制。

在 BroadNet Inference 上

BroadNet 负责提供模型,子智能体的逻辑在你的智能体工具里。任何能填写 OpenAI 兼容 base URL 的工具,都可以把主智能体和子智能体都指向 BroadNet,并为它们分别使用不同的模型。

在按量付费下,一个密钥允许同时进行 4 个请求。在 DeepSeek V4.1 Flash 的固定价格套餐上,每个会话同一时间只运行一个请求,所以要数清楚同一时刻可能有多少个模型请求在进行:三个同时运行的子智能体需要三个会话,如果编排者在它们运行时也调用模型,就需要四个。在固定价格 API 上并行运行编程智能体详细讲解了会话数的计算。

常见问题

子智能体能省 token 吗?

它省的是主对话的上下文,而不是总 token。子智能体自己的请求照样消耗 token。Claude Code 的文档提醒,子智能体的请求同样计入你的用量,并建议简单的子智能体任务用更小的模型。

子智能体还能再启动子智能体吗?

取决于工具。Claude Code 的文档说,子智能体默认可以启动自己的子智能体,最多到主对话下方三层,而且这一点可以限制。

子智能体和交接(handoff)有什么区别?

子智能体处理任务后,向调用它的智能体汇报。在 OpenAI Agents SDK 中,交接让一个智能体把任务委派给另一个智能体,handoff() 辅助函数会把控制权转给对方。

以 Markdown 格式阅读问 ChatGPT问 Claude问 Perplexity