📌 项目地址：google/agents-cli | ⭐ 4,037 颗星 | 🔧 Python | 📜 未标注
这个项目解决了什么问题
开发一个能在 Google Cloud 上运行的企业级 AI Agent，通常需要同时掌握多项技能：GCP 服务（Cloud Run、GKE、Vertex AI、Agent Runtime）、ADK Python API、评估方法论、CI/CD 配置、可观测性集成……每个环节都有各自的 CLI 和文档，学习曲线陡峭。
agents-cli 的思路是把这些知识打包成一整套“技能包”和 CLI 命令，注入到你常用的 AI 编码助手（Claude Code、Codex 等）中。让助手直接学会如何创建、评估、部署 Google Cloud Agent，而开发者只需用自然语言描述需求，助手就能调用 agents-cli 完成具体操作。
快速上手：两个命令搞定安装
前提条件：
– Python 3.11+
– uv（Python 包管理器）
– Node.js
安装分两种方式：
-
完整安装（CLI + 技能注入）：
bash
uvx google-agents-cli setup
这个命令会自动安装 CLI 并将相关技能注册到你的开发环境中。 -
仅注入技能（推荐 coding agent 处理后续）：
bash
npx skills add google/agents-cli
之后打开你的 AI 编码助手（如 Antigravity CLI、Claude Code、Codex 等），直接说：“Use agents-cli to build a caveman-style agent that compresses verbose text into terse, technical grunts”
助手就会利用注入的技能完成脚手架创建、代码编写、评估和部署。
完整的入门教程请参考 官方 Quickstart。
技能包：从开发到运维全覆盖
agents-cli 不是简单的 CLI 封装，它为编码助手提供了 7 个明确的技能领域，每个对应一套知识库和工具链：
| 技能名称 | 教给助手的核心能力 |
|---|---|
google-agents-cli-workflow |
开发全生命周期流程、代码保护规则、模型选择策略 |
google-agents-cli-adk-code |
ADK Python API（Agent Development Kit），包括 tools、orchestration、callbacks、state 管理 |
google-agents-cli-scaffold |
项目骨架的创建、增强、升级操作 |
google-agents-cli-eval |
评估方法：指标、数据集、LLM-as-judge、自适应评分标准 |
google-agents-cli-deploy |
部署到 Agent Runtime、Cloud Run、GKE，以及 CI/CD 和 Secrets 管理 |
google-agents-cli-publish |
注册到 Gemini Enterprise Platform |
google-agents-cli-observability |
可观测性：Cloud Trace、日志、第三方集成 |
这意味着你不需要记住 gcloud 或 kubectl 的繁复参数——助手通过技能包知道该调用哪些命令、传什么参数。
CLI 命令速览
agents-cli 本身也提供了少量但核心的 CLI 命令：
| 命令 | 作用 |
|---|---|
agents-cli setup |
安装 CLI 并将技能注册到当前编码助手 |
agents-cli scaffold <agent-type> |
创建一个新的 agent 项目（具体类型请参考官方文档） |
其他更细粒度的操作（如
eval、deploy、publish）通过技能注入的编码助手完成，不直接暴露为 CLI 子命令。具体用法可查阅 官方文档。
和同类工具的区别
市面上已经有不少 Agent 开发框架（LangGraph、CrewAI、AutoGen），但 agents-cli 的定位截然不同：
- 并不是一个新的 Agent 框架，而是“给编码助理补课”的工具。它不定义 agent 运行时逻辑，而是确保助手知道如何用 Google Cloud 的原生服务和 API 来构建 agent。
- 深度绑定 Google Cloud 生态。其他框架通常跨云，而
agents-cli直接与 Gemini Enterprise Agent Platform、Cloud Run、GKE 等对接，适合已经或计划使用 Google Cloud 的团队。 - 降低门槛。传统框架需要开发者手动编写 Pydantic 模型、调试回调、配置部署环境；
agents-cli让助手承担这部分工作，开发者只需审核生成结果。
注意事项与局限
- 环境依赖性：本地必须安装
uv和Node.js，且推荐使用uv作为 Python 包管理器（而非 pip/poetry）。 - 云平台绑定：所有部署和发布功能都针对 Google Cloud，不适用于 AWS、Azure 或其他自建环境。
- 编码助手前置：核心价值依赖于你使用的 AI 编码助手（如 Claude Code、Codex）能否正确调用注入的技能。效果可能因助手版本而异。
- 学习成本前置：虽然助手帮你执行，但你仍需理解 Google Cloud Agent 的基本概念（Agent Runtime、ADK、评估指标等），否则难以判断助手给出的建议是否合理。
- 许可证：项目采用 Apache 2.0 许可证，适合企业使用。具体请查看仓库 LICENSE 文件。
总结
agents-cli 是 Google Cloud Agent 开发领域的一个巧妙设计——它不重新发明轮子，而是让已有的 AI 编码助手变得更专业。如果你是 Google Cloud 用户，并且已经习惯用 Claude Code 或 Codex 辅助编码，这个工具能明显减少你在 Agent 开发中的记忆负担和手动操作。