子智能体

子智能体是在你的主 Gemini CLI 会话里运行的专门智能体，设计用来处理特定的复杂任务（如深度代码库分析、文档查找或领域特定推理），而不会弄乱主智能体的上下文或工具集。官方把它们称为主智能体可以为某项具体工作「雇用」的「专家」：

• 聚焦的上下文：每个子智能体有自己的系统提示和角色
• 专门的工具：子智能体可以有受限的或专门的工具集
• 独立的上下文窗口：与子智能体的交互发生在单独的上下文循环里，节省你主对话历史里的 token

子智能体以同名工具的形式暴露给主智能体：主智能体调用该工具就是把任务委派给子智能体，子智能体完成任务后向主智能体汇报发现。该功能在官方文档里带有实验性标记。

如何使用

自动委派：Gemini CLI 的主智能体被指示在任务匹配专家的专长时使用专门的子智能体。例如你问「How does the auth system work?」，主智能体可能决定调用 codebase_investigator 子智能体来做研究。

用 @ 语法强制使用：在提示开头用 @ 加子智能体名字，显式把任务导向某个特定子智能体，这在你想绕过主智能体的决策、直接找专家时有用：

@codebase_investigator Map out the relationship between the AgentRegistry and the LocalAgentExecutor.

使用 @ 语法时，CLI 会注入一条系统提示，推动主模型立即使用那个特定的子智能体工具。

内置子智能体

Codebase Investigator（codebase_investigator）：用途是分析代码库、逆向工程并理解复杂依赖；适用于「How does the authentication system work?」「Map out the dependencies of the AgentRegistry class.」这类问题。默认启用，可以在 settings.json 的 agents.overrides 下覆盖它的设置，例如强制指定模型并增加回合数：

{
  "agents": {
    "overrides": {
      "codebase_investigator": {
        "modelConfig": { "model": "gemini-3-flash-preview" },
        "runConfig": { "maxTurns": 50 }
      }
    }
  }
}

注意

/model 命令（和 --model 标志）不会覆盖子智能体使用的模型，所以即使你指定了模型，在模型用量报告里仍可能看到其他模型。用 /agents reload 重新加载智能体注册表。官方文档还介绍了自定义子智能体（用 Markdown 文件定义）和远程子智能体（Remote subagents），这部分处于实验阶段，以官方原文为准。