promptgarten 🌱

命令参考 · Antigravity CLI

agy agent / agy agents

列出可用的自定义 agent。

agy agent(或 agy agents)是 Antigravity CLI 的一个子命令(自 1.1.1 版本起提供),会在启动会话之前,在命令行中列出所有可用的自定义代理(Custom Agents)。自定义代理以带有 YAML frontmatter 的 Markdown 文件 agent.md 定义,可以是项目级的 .agents/agents/<name>/agent.md,也可以是全局的 ~/.gemini/config/agents/<name>/agent.md。用 agy agents 找到的名称可以直接传给启动选项 --agent,从而直接以该代理启动 CLI,例如 agy --agent code-reviewer。而在已经运行中的会话内,则由交互式的 /agents 面板来负责在多个代理之间切换,以及监控和终止正在运行的子代理。这两种方式相辅相成:子命令用于启动前的查询,面板用于会话期间的控制。需要将该命令与 agy models 区分开——后者列出的是可用模型,而不是代理。

什么时候用?

在启动前查询可用的自定义代理

执行 agy agents,找到 --agent 需要的确切名称

在启动时有针对性地选择一个全局定义的代理

agy agents 显示了 code-reviewer;随后执行 agy --agent code-reviewer 就会直接以该代理启动

什么时候不该用?

已经处于运行中的会话,想在代理之间切换或监控子代理

该子命令只在 TUI 之外提供一次性的列表,不具备选择或监控功能。

更好的选择: 在正在运行的 agy 中使用 /agents

想查找的是可用模型而不是代理

agy agent/agents 只列出自定义代理,不涉及模型。

更好的选择: 使用 agy models 列出可用的模型

来源

更多命令 · Antigravity CLI

agy --project <name>agy --new-project <name>agy --sandboxagy --mode <default|accept-edits|plan>agy --dangerously-skip-permissionsagy plugin listagy plugin install <path>agy plugin enable <name>agy plugin disable <name>agy plugin uninstall <name>agy plugin import geminiinstall.sh --skip-aliases

全部命令 · Antigravity CLI

分享:𝕏in💬