FollowAgents AI AGENTS 目录
首页 / 全部 Agents / Google Agents CLI
开发与工程 ✓ Google · 官方 google-cloudadkgemini-enterpriseagent-scaffoldingagent-evaluationcloud-deploymentobservability

Google Agents CLI

让编程助手具备构建、评估并部署 Google Cloud ADK 智能体所需的 CLI 与技能。

在 GitHub 查看 ↗ 快速上手 ↓
源仓库
google/agents-cli
Star 数
★ 6.3k
最近更新
1 天前
License
Apache-2.0
主语言
Python
FA 评分
56/100 · 缺口较多

30 秒速览

运行形态
命令行工具Agent 插件 / 技能
可在哪里用
平台专用Codex · Claude Code
费用
软件免费，模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Python 3.11+uvNode.jsShell / 命令行网络访问本地文件系统
典型场景
使用 Codex 的开发者希望从零创建一个 ADK 智能体项目，并通过统一 CLI 完成后续开发与部署。
不适合
  • 需要跨云或跨模型迁移的团队，其核心依赖 Gemini Enterprise Agent Platform、ADK 与 Google Cloud
  • 不使用 Google Cloud 的团队，部署与云功能必须依赖 Google Cloud 账号
源码审查
56/100 · 缺口较多

这个 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、数据存储和数据摄取。

  1. 使用 Codex 的开发者希望从零创建一个 ADK 智能体项目，并通过统一 CLI 完成后续开发与部署。
  2. 已有本地 ADK 项目的团队需要用 agents-cli scaffold enhance 增加部署、CI/CD 或 RAG 支持。
  3. 负责质量验证的工程师需要对评估数据集批量运行智能体、生成 traces，并用指标对结果评分。
  4. 准备上线到 Google Cloud 的团队需要部署智能体，或将其注册到 Gemini Enterprise。
  5. 需要排查评估表现的开发者希望比较两份结果、聚类失败模式，或根据评估数据自动调优提示词。

如何安装或部署这个 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 有哪些优点和局限？

优点
  • 把 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 与同类方案有什么区别？

它不是 Antigravity CLI、Claude Code 或 Codex 的替代品，而是为这类编程助手提供构建、评估和部署 ADK 智能体的 CLI 与技能。与直接使用 ADK 相比，ADK 是智能体框架；Google Agents CLI 增加了端到端的脚手架、评估、部署与发布工作流。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Google Agents CLI 当前 56 · 缺口较多 命令行工具免费 + 模型费 ★ 6.3k 1 天前 Python Codex · Claude Code
Runtm 63 · 存在缺口 命令行工具免费版 + 付费版 ★ 303 1 天前 Python Codex · Claude Code
Google Cloud 生成式 AI 示例库 46 · 缺口较多 代码库 / SDK免费 + 模型费 ★ 18k 1 天前 Jupyter Notebook —
AnyAgent 41 · 缺口较多 代码库 / SDK免费 + 模型费 ★ 1.3k 1 个月前 Python —

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1
缺口较多
56/ 100 五分制 2.8 / 5
本评测基于 2026年8月9日 的源码；此后该项目发布了 12 个正式版本，尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 11/29
可靠稳定 8/14
适用触发 12/18
规范维护 12/18
有效结果 9/13
证据核验 4/8
查看各维度的扣分理由
信任安全11 / 29 · 1.9/5

证据显示：CLI 命令如 deploy、publish 会调用 Google Cloud API，但 README 未明确说明权限最小化或用户确认机制。存在 scaffold 和 eval 等命令，但未提及敏感数据处理或数据流透明性。依赖管理使用 uv，但未提供依赖安全审计。外部效果（部署资源）在 README 中提及，但未说明回滚机制。来源归属明确（Google 官方组织），但未提供更细的归属信息。扣分原因：缺乏权限最小化、用户确认、数据流透明、敏感数据处理、依赖安全、外部效果和回滚的具体证据。

可靠稳定8 / 14 · 2.9/5

证据显示：README 和代码示例（如 eval_config.yaml、response_quality.py）在描述上基本一致，但未提供完整的错误处理或失败消息。依赖可用性方面，README 列出了 Python、uv、Node.js 等前置条件，但未提供依赖的可用性保证。扣分原因：失败消息和依赖可用性证据不足。

适用触发12 / 18 · 3.3/5

证据显示：README 明确面向编码助手用户，提供了多种使用场景（本地开发、部署、评估）。能力边界在 FAQ 中有所说明（如需要 Google Cloud 才能部署）。触发精度方面，命令列表清晰，但未提供详细的触发条件。环境适配方面，列出了前置条件，但未提供不同环境的详细配置。扣分原因：触发精度和环境适配的证据不够充分。

规范维护12 / 18 · 3.3/5

证据显示：README 提供了清晰的信息架构，包括安装说明、命令列表、FAQ 和文档链接。命名稳定性方面，命令名称一致。示例和 FAQ 提供了基本的使用示例。已知局限性在 FAQ 中部分提及（如需要 Google Cloud 才能部署），但未全面列出。许可证为 Apache-2.0，版本变更日志有 RELEASE_NOTES.md。维护责任明确（Google 官方）。扣分原因：已知局限性不够全面。

有效结果9 / 13 · 3.5/5

证据显示：输出可用性方面，CLI 命令和技能设计用于提高编码助手的效率，但未提供实际输出示例。边际价值方面，README 说明了与 ADK 的区别，但未提供与其他工具的比较。成本效益方面，未提供性能或成本数据。扣分原因：缺乏实际输出示例和成本效益数据。

证据核验4 / 8 · 2.5/5

证据显示：README 中的声明（如支持多种编码助手）有文档链接支持，但未提供独立的验证。跨来源佐证方面，仅依赖 README 和少量代码文件，缺乏外部验证。事实与推断分离方面，README 区分了事实（如命令列表）和推断（如“使你的编码助手成为专家”），但推断部分未明确标注。扣分原因：跨来源佐证不足。

风险与缓解建议
  • 静态审查无法验证实际执行行为，所有信任相关评分基于文档和代码推断。
  • README 未明确说明权限最小化、用户确认、数据流透明等安全机制，部署命令可能产生云资源费用。
  • 依赖安全未提供审计证据，建议使用前检查依赖漏洞。
证据充分度：低 评估于 2026年8月9日 审查版本 5a306f8956cb 评估后仓库已有新提交，评分可能未覆盖最新改动
评估证据 github.comREADME.mdLICENSEworkflows/docs.ymleval/eval_config.yamleval/response_quality.pyintegration/test_agent.py
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

  1. v1.13.0 Release v1.13.0
    发布说明摘录
    Release v1.13.0 - Cloud Run deployments support Agent Identity. - agents-cli deploy --agent-identity deploys a Cloud Run service with Agent Identity. - New projects default using Agent Identity for Cloud Run deployments. To migrate an old project so that it uses Agent Identity, run agents-cli scaffold enhance with --cloud-run-identity-type agent_identity. - To create a new project that uses a service account instead, run agents-cli scaffold create with --cloud-run-identity-type service_account. …
    在 GitHub 查看 ↗
  2. v1.12.0 Release v1.12.0
    发布说明摘录
    Release v1.12.0 - ADK Go is now Generally Available. The adk_go template is out of Preview: it is stable, production-ready and supported on the same terms as adk_python. This release also brings: - agents-cli create --agent <template> supports ADK Go v2 templates whose manifest.yaml declares language: go. Templates built for other ADK Go versions are rejected. A declared language that contradicts the base template (or --base-template) fails with an error explaining how to fix it. …
    在 GitHub 查看 ↗
  3. v1.11.0 Release v1.11.0
    发布说明摘录
    Release v1.11.0 - Breaking: The adk@<name> shortcut has been removed. Pass the recipe's GitHub URL to agents-cli create instead, and browse recipes at https://github.com/google/adk-recipes. - The scaffold's "Browse ADK recipes" option lists recipes from both core/python/ and contrib/python/ in google/adk-recipes. - Projects created with adk@ still upgrade. Their base_template is rewritten to the recipe URL on the first applied change. …
    在 GitHub 查看 ↗

常见问题

没有 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。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审，横向比较这个 Agent 所属的短名单。

开源编程 Agent 横向对比

按 FARS 评审排序的开源编程 agent——分数、信任、许可证、语言与维护状态并排比较，并说明各自擅长与不擅长什么。

Claude Code Agent 横向对比

完整兼容 Claude Code 的 agent，按 FARS 评审排序——兼容性取自各 agent 自己的 AGENTS.md 与文档，不做推测。

相关 Agents

开发与工程

Runtm

为编码智能体提供开源沙箱：在隔离环境中运行 Claude Code、Cursor 等智能体构建并部署软件，附带实时 URL、日志与预览。
开发与工程

Google Cloud 生成式 AI 示例库

用示例和笔记本探索 Gemini 与 Google Cloud 生成式 AI 工作流。
开发与工程

AnyAgent

用统一 Python 接口运行并评估多种智能体框架。
开发与工程

Tracely

面向 AI Agent 的 trace 原生 CI/CD：把生产失败冻结成可回放的回归测试，并拦下会导致退化的 PR。