Gemini CLI subagents icon

Gemini CLI subagents

Gemini CLI subagents 是专为复杂或重复任务设计的辅助代理,在独立上下文窗口中工作,让主会话保持专注。支持自动或显式调用,并可通过 Markdown 和 YAML 自定义代理。

Gemini CLI subagents

Gemini CLI 的子代理

Gemini CLI 中的子代理是专门的代理,用于代表主 CLI 会话处理复杂、重复或高频任务。该功能旨在让主代理专注于编排、决策和最终回复,而子代理则在各自独立的上下文窗口中处理更具体的工作。

根据公告,子代理可以使用自己的工具、MCP 服务器和系统指令,并将输出汇总回主会话。Gemini CLI 在判断它们是最有效路径时可自动调度它们,也可以使用 `@agent` 语法显式请求一个子代理。

主要功能

隔离执行

子代理在各自独立的上下文窗口中工作,因此中间步骤不会占用主 Gemini CLI 会话的空间。

专用指令和工具

每个子代理都可以拥有自己的系统指令和精选工具集,包括 MCP 服务器,这使其表现得像一个专门的专家。

并行委派

当任务可以拆分时,Gemini CLI 可以同时运行多个子代理,用于研究、分析、代码探索或测试。

汇总交接

主 Gemini CLI 会话会将子代理的工作整合为单一回复,从而让主对话始终聚焦于更大的任务。

自定义代理定义

用户可以使用 Markdown 文件和 YAML frontmatter 定义自定义代理,适用于个人工作流、团队仓库或扩展。

内置子代理

CLI 内置了 `generalist`、`cli_help` 和 `codebase_investigator` 等子代理,用于常见工作流。

实用场景

  • 拆解复杂工作

    将一个大任务拆分成更小的专业任务,让研究、代码探索、分析或测试可以进行,而不会让主会话充满中间步骤。

  • 并行研究与审查

    当你需要多个相关调查比单次线性执行更快完成时,同时运行多个子代理。

  • 落实本地标准

    创建遵循团队约定、指令或角色设定的项目专用代理,以处理重复性工作流。

  • 将工作路由给专家

    当你需要用于 Gemini CLI 问题或仓库探索的专门助手时,使用 `cli_help` 或 `codebase_investigator` 等内置子代理。

  • 随扩展分发代理

    把子代理定义打包到 Gemini CLI 扩展中,使同样的代理行为可以随可复用分发包一起携带。

Pros and Cons

Pros

  • 通过把具体工作移到独立上下文窗口中,保持主 Gemini CLI 会话专注。
  • 支持研究、分析、代码探索和测试的并行执行。
  • 允许使用简单的 Markdown 和 YAML 定义自定义子代理。
  • 可将代理定义打包进 Gemini CLI 扩展或项目级仓库,供团队使用。

Cons

  • 公告对设置、限制和价格信息着墨不多,因此读者仍需查阅官方 Gemini CLI 文档以获得更完整的产品评估。
  • 并行子代理可能更快消耗用量,文中也指出当任务拆分到多个代理时需要注意这一点。

FAQ

Gemini CLI 中的子代理是什么?

Gemini CLI 使用子代理,将复杂或重复的工作委派给在独立上下文窗口中运行的专门代理,这些代理拥有各自的工具和指令。主会话则专注于编排和最终决策。

如何在 Gemini CLI 中使用子代理?

公告说明,子代理可以在合适时由 Gemini CLI 自动调用,也可以使用 `@agent` 语法显式调用。你可以在 Gemini CLI 中运行 `/agents` 查看已配置的子代理。

团队可以创建自定义子代理吗?

可以。文中说明,自定义子代理可以使用 Markdown 文件和 YAML frontmatter 定义,既可以全局存放在 `~/.gemini/agents`,也可以提交到项目中的 `.gemini/agents`,或者随 Gemini CLI 扩展一起打包。

子代理适合处理哪些类型的任务?

文中将子代理描述为适用于研究、代码探索、分析、测试以及其他高吞吐量任务,尤其是在并行执行能够缩短总耗时的情况下。

Quick Facts

类别
开发者工具
产品
Gemini CLI subagents
平台
Gemini CLI
来源域名
developers.googleblog.com
配置格式
带 YAML frontmatter 的 Markdown
内置代理
generalist, cli_help, codebase_investigator
Gemini CLI subagents - AI Tool, Features, Use Cases & Alternatives | UStack