Google Agents CLI
让编程助手具备构建、评估并部署 Google Cloud ADK 智能体所需的 CLI 与技能。
按维度查看评分与理由
证据显示：CLI 命令如 deploy、publish 会调用 Google Cloud API，但 README 未明确说明权限最小化或用户确认机制。存在 scaffold 和 eval 等命令，但未提及敏感数据处理或数据流透明性。依赖管理使用 uv，但未提供依赖安全审计。外部效果（部署资源）在 README 中提及，但未说明回滚机制。来源归属明确（Google 官方组织），但未提供更细的归属信息。扣分原因：缺乏权限最小化、用户确认、数据流透明、敏感数据处理、依赖安全、外部效果和回滚的具体证据。
证据显示：README 和代码示例（如 eval_config.yaml、response_quality.py）在描述上基本一致，但未提供完整的错误处理或失败消息。依赖可用性方面，README 列出了 Python、uv、Node.js 等前置条件，但未提供依赖的可用性保证。扣分原因：失败消息和依赖可用性证据不足。
证据显示：README 明确面向编码助手用户，提供了多种使用场景（本地开发、部署、评估）。能力边界在 FAQ 中有所说明（如需要 Google Cloud 才能部署）。触发精度方面，命令列表清晰，但未提供详细的触发条件。环境适配方面，列出了前置条件，但未提供不同环境的详细配置。扣分原因：触发精度和环境适配的证据不够充分。
证据显示：README 提供了清晰的信息架构，包括安装说明、命令列表、FAQ 和文档链接。命名稳定性方面，命令名称一致。示例和 FAQ 提供了基本的使用示例。已知局限性在 FAQ 中部分提及（如需要 Google Cloud 才能部署），但未全面列出。许可证为 Apache-2.0，版本变更日志有 RELEASE_NOTES.md。维护责任明确（Google 官方）。扣分原因：已知局限性不够全面。
证据显示：输出可用性方面，CLI 命令和技能设计用于提高编码助手的效率，但未提供实际输出示例。边际价值方面，README 说明了与 ADK 的区别，但未提供与其他工具的比较。成本效益方面，未提供性能或成本数据。扣分原因：缺乏实际输出示例和成本效益数据。
证据显示：README 中的声明（如支持多种编码助手）有文档链接支持，但未提供独立的验证。跨来源佐证方面，仅依赖 README 和少量代码文件，缺乏外部验证。事实与推断分离方面，README 区分了事实（如命令列表）和推断（如“使你的编码助手成为专家”），但推断部分未明确标注。扣分原因：跨来源佐证不足。
- 静态审查无法验证实际执行行为，所有信任相关评分基于文档和代码推断。
- README 未明确说明权限最小化、用户确认、数据流透明等安全机制，部署命令可能产生云资源费用。
- 依赖安全未提供审计证据，建议使用前检查依赖漏洞。
这个 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 增加了端到端的脚手架、评估、部署与发布工作流。
常见问题
没有 Google Cloud 可以使用吗？
create、run 和 eval；材料说明可使用 AI Studio API key 在本地通过 ADK 运行 Gemini。部署及云端功能则需要 Google Cloud。它必须配合编程助手使用吗？
如何验证智能体质量？
agents-cli eval generate 在评估案例上生成 traces，再用 agents-cli eval grade 按指标评分；还可比较结果、分析失败模式或优化提示词。能用于现有智能体项目吗？
agents-cli scaffold enhance 用于为现有项目添加部署、CI/CD 或 RAG。