在 Google Cloud 上从零搭一个生产级 AI 智能体，要同时懂 ADK、Cloud Run、GKE、CI/CD、密钥管理、评测，门槛不低。agents-cli 的做法是：把这些能力封装成一组 CLI 命令和技能，直接装进你正在用的编程助手（Claude Code、Codex、Antigravity 等），让它替你把智能体从脚手架一直推到云端部署。

项目基本信息

信息项详情
项目名称agents-cli
GitHub地址https://github.com/google/agents-cli
项目描述把任意编程助手变成Google云上智能体的构建、评测与部署专家
作者google
开源协议Apache License 2.0
开源状态公开
LanguagesPython
支持平台Windows / macOS / Linux
最后更新2026-10-20

一、项目介绍

agents-cli 是 Google 推出的命令行与技能集合，目标是把你的编程助手变成“在 Google Cloud 上构建、评测、治理、优化企业级智能体”的专家。它本身不是编程助手，而是给助手用的工具：提供脚手架、ADK 代码范式、评测方法、部署与可观测性技能，覆盖智能体从开发到上线的完整生命周期。

二、核心优势

  • 生命周期全覆盖：脚手架、ADK 代码范式、评测、部署、发布、可观测性一条龙。
  • 多智能体技能：内置 workflow、adk-code、scaffold、eval、deploy、publish、observability 等技能。
  • 评测内建：指标、数据集、LLM-as-judge、自适应评分卡，量化智能体质量。
  • 多云部署：Agent Runtime、Cloud Run、GKE 均可部署，并带 CI/CD 与密钥管理。
  • 本地零云依赖：create、run、eval 可纯本地跑，用 AI Studio Key 即可。

三、适用场景

  • 企业团队在 Google Cloud 上标准化交付智能体。
  • 想用 Claude Code / Codex 但不想手搓 ADK 与部署配置。
  • 需要可量化评测与回归的 Agent 项目。
  • 把已有项目补上部署与 CI/CD。

四、安装教程

依赖：Python 3.11+、uv、Node.js。

 uvx google-agents-cli setup

只装技能（让编程助手接管其余）：

 npx skills add google/agents-cli

常见报错：若 uvx 找不到，先装 uv（curl -LsSf https://astral.sh/uv/install.sh | sh）；部署类命令需要 agents-cli login 登录 Google Cloud 或 AI Studio。

五、使用示例

创建并部署一个智能体：

 agents-cli create my-agent -y
 agents-cli deploy

跑评测：

 agents-cli eval run

发布到 Gemini：

 agents-cli publish gemini

输出：create 生成 ADK 模板项目，deploy 推到 Google Cloud，eval 返回带评分的链路报告。

六、常见问题

  • 必须 Google Cloud 吗？本地开发不需要；部署与云特性才需要。
  • 和 ADK 啥关系？ADK 是框架，agents-cli 是给助手用的构建 / 评测 / 部署工具。
  • 能脱离编程助手用吗？能，CLI 可独立在终端跑全部命令。

七、总结

agents-cli 把 Google Cloud 智能体的“认知成本”压到最低：你描述需求，助手借这套技能把脚手架、评测、部署一次做完。Apache-2.0 协议，适合已经在用 Google 栈、又想用任意编程助手提效的团队。