Google Agents CLI
让编程助手具备构建、评估并部署 Google Cloud ADK 智能体所需的 CLI 与技能。
这个 Agent 能做什么，适合哪些场景？
Google Agents CLI 是面向编程助手和终端用户的命令行工具及技能套件，用于构建 Gemini Enterprise Agent Platform 上的智能体。它以 ADK 为开发框架，并提供脚手架、运行、代码检查、评估、部署、发布和可观测性相关能力。CLI 可独立在终端执行，也可安装技能后供 Codex、Claude Code、Antigravity CLI 等编程助手调用。评估流程可生成推理 traces、按指标评分、比较结果并分析失败模式，还支持基于评估数据优化提示词。部署与发布功能面向 Google Cloud、Gemini Enterprise、Cloud Run、GKE 及 Agent Runtime 等 Google 生态边界。
通过 agents-cli setup 将 CLI 和技能安装到编程助手；通过 agents-cli scaffold <name> 创建项目，并可用 agents-cli scaffold enhance 为现有项目添加部署、CI/CD 或 RAG。开发阶段可执行 agents-cli install、agents-cli lint 和 agents-cli run "prompt"。评估阶段，agents-cli eval generate 在评估案例上运行智能体并生成 traces，agents-cli eval grade 按指标评分；还可使用 eval compare、eval analyze、eval dataset synthesize 与 eval optimize。部署阶段可执行 agents-cli deploy，并可用 agents-cli publish gemini-enterprise 注册到 Gemini Enterprise；基础设施命令覆盖单项目、CI/CD、数据存储和数据摄取。
- 使用 Codex 的开发者希望从零创建一个 ADK 智能体项目，并通过统一 CLI 完成后续开发与部署。
- 已有本地 ADK 项目的团队需要用 `agents-cli scaffold enhance` 增加部署、CI/CD 或 RAG 支持。
- 负责质量验证的工程师需要对评估数据集批量运行智能体、生成 traces，并用指标对结果评分。
- 准备上线到 Google Cloud 的团队需要部署智能体，或将其注册到 Gemini Enterprise。
- 需要排查评估表现的开发者希望比较两份结果、聚类失败模式，或根据评估数据自动调优提示词。
这个 Agent 有哪些优点和局限？
- 把 ADK 开发、评估、部署和发布工作流集中为同一套 `agents-cli` 命令与编程助手技能。
- 评估能力不止于运行测试：明确支持生成 traces、指标评分、结果比较、失败聚类、场景合成和提示词优化。
- 可同时作为独立终端 CLI 使用，或为 Codex、Claude Code、Antigravity CLI 等编程助手提供技能。
- 提供面向交付的云端路径，包括 Agent Runtime、Cloud Run、GKE、CI/CD、数据存储和数据摄取。
- 核心定位依赖 Gemini Enterprise Agent Platform、ADK 和 Google Cloud，跨云或跨模型迁移路径未在提供材料中说明。
- 安装要求 Python 3.11+、uv 与 Node.js，增加了本地开发环境的前置配置。
- 本地运行 Gemini 需要 AI Studio API key；部署和云端功能需要 Google Cloud。
- 提供材料未说明除 Codex、Claude Code、Antigravity CLI 之外的具体编程助手集成方式或兼容性细节。
如何安装或部署这个 Agent？
前置条件为 Python 3.11+、uv 和 Node.js。安装 CLI 与技能：uvx google-agents-cli setup。如果只需安装技能，可执行：npx skills add google/agents-cli。本地开发可使用 AI Studio API key 运行 Gemini 与 ADK；部署和云端功能需要 Google Cloud，并可通过 agents-cli login 进行 Google Cloud 或 AI Studio 身份验证。
如何使用这个 Agent？
创建项目：agents-cli scaffold <name>。在项目中可运行单次提示：agents-cli run "prompt"；安装项目依赖：agents-cli install；执行代码检查：agents-cli lint。要评估项目，依次运行 agents-cli eval generate 和 agents-cli eval grade。准备部署时运行 agents-cli deploy；需要注册到 Gemini Enterprise 时运行 agents-cli publish gemini-enterprise。
这个 Agent 与同类方案有什么区别？
它不是 Antigravity CLI、Claude Code 或 Codex 的替代品，而是为这类编程助手提供构建、评估和部署 ADK 智能体的 CLI 与技能。与直接使用 ADK 相比，ADK 是智能体框架；Google Agents CLI 增加了端到端的脚手架、评估、部署与发布工作流。