Gemini CLI subagents icon

Gemini CLI subagents

Gemini CLI subagents 是專門的輔助代理,可在獨立的上下文視窗中處理複雜或重複任務,讓主流程保持專注;可自動或手動啟用,並支援以 Markdown 和 YAML 定義自訂代理。

Gemini CLI subagents

Gemini CLI 的 Subagents

Gemini CLI 中的 subagents 是專門的代理,可代表主要的 CLI 工作階段處理複雜、重複或高頻率的任務。這項功能的設計目的是讓主代理專注於協調、決策與最終回應,而 subagents 則在各自獨立的上下文視窗中處理較窄的工作。

根據公告,subagents 可以使用自己的工具、MCP servers 和系統指令,且其輸出會整合回主工作階段。Gemini CLI 可以在判定它們是最有效率的路徑時自動派送,也可以透過 `@agent` 語法明確要求使用。

主要功能

隔離執行

Subagents 在各自獨立的上下文視窗中運作,因此中間步驟不會擠佔主 Gemini CLI 工作階段。

專門指令與工具

每個 subagent 都可以有自己的系統指令與精選工具組,包括 MCP servers,讓它表現得像一位專門的專家。

平行委派

當任務可拆分時,Gemini CLI 可以同時執行多個 subagents 來進行研究、分析、程式碼探索或測試。

摘要式交接

主 Gemini CLI 工作階段會將 subagent 的工作整合成單一回應,讓主要對話維持在更大的任務上。

自訂 agent 定義

使用者可透過 Markdown 檔案與 YAML frontmatter 定義自訂 agents,適用於個人工作流程、團隊儲存庫或 extensions。

內建 subagents

CLI 內建 `generalist`、`cli_help` 和 `codebase_investigator` 等 subagents,可應付常見工作流程。

實際使用情境

  • 拆解複雜工作

    將大型任務拆成較小的專門工作,讓研究、程式碼探索、分析或測試可以進行,而不會讓主工作階段塞滿中間步驟。

  • 平行研究與審查

    當你需要比單一路徑更快完成多項相關調查時,可同時執行多個 subagents。

  • 強制本地標準

    建立符合團隊慣例、指令或角色設定的專案專用 agent,以處理重複性工作流程。

  • 將工作路由給專家

    當你想要針對 Gemini CLI 問題或儲存庫探索使用專門助手時,可使用 `cli_help` 或 `codebase_investigator` 等內建 subagents。

  • 隨 extensions 發佈 agents

    將 subagent 定義封裝在 Gemini CLI extension 中,讓相同的 agent 行為可隨可重複使用的散佈套件一起提供。

Pros and Cons

Pros

  • 透過將狹窄工作移到獨立上下文視窗中,讓主要 Gemini CLI 工作階段保持專注。
  • 支援研究、分析、程式碼探索與測試的平行執行。
  • 可使用簡單的 Markdown 與 YAML 定義自訂 subagents。
  • 可將 agent 定義封裝到 Gemini CLI extensions 或專案層級儲存庫中,供團隊使用。

Cons

  • 公告對設定、限制與價格細節著墨不多,因此讀者若要做更完整的產品評估,仍需參考官方 Gemini CLI 文件。
  • 平行 subagents 可能會更快增加用量,而文章也提到,當任務分散到多個代理時,這是需要留意的考量。

FAQ

Gemini CLI 中的 subagents 是什麼?

Gemini CLI 會使用 subagents,將複雜或重複的工作委派給在獨立上下文視窗中執行、並擁有各自工具與指令的專門代理。主流程會專注於協調與最終決策。

如何在 Gemini CLI 中使用 subagent?

公告指出,subagents 可在適當時由 Gemini CLI 自動呼叫,也可以使用 `@agent` 語法明確指定。你也可以在 Gemini CLI 中執行 `/agents` 來查看已設定的 subagents。

團隊可以建立自訂 subagents 嗎?

可以。文章指出,自訂 subagents 可使用 Markdown 檔案與 YAML frontmatter 定義,並可全域儲存在 `~/.gemini/agents`、提交到專案內的 `.gemini/agents`,或隨 Gemini CLI extensions 一起封裝。

subagents 適合處理哪些類型的任務?

文章將 subagents 定位為適用於研究、程式碼探索、分析、測試,以及其他高工作量任務,尤其是在平行執行可縮短總時間時。

Quick Facts

Category
開發者工具
Product
Gemini CLI subagents
Platform
Gemini CLI
Source domain
developers.googleblog.com
Configuration format
Markdown 搭配 YAML frontmatter
Built-in agents
generalist, cli_help, codebase_investigator