### [agents-cli：Google 官方 AI Agent 构建 CLI，让编程助手变身 Google Cloud 专家（4,723 Stars）](https://www.willai.cc/article/3284)

**Published:** 2026-07-04T23:57:37

**Author:** hiyoho

**Excerpt:** agents-cli 是 Google 官方出品的 CLI 工具与技能包，将任意编程助手转化为 Google Cloud 上构建、评估、部署企业级 AI Agent 的专家。支持 Claude Code、Codex 等主流编程助手。

G

# agents-cli：Google 官方 AI Agent 构建 CLI

让任何编程助手都成为 Google Cloud AI Agent 专家

## 📌 项目简介

agents-cli 是 Google 官方出品的 CLI 工具与技能包，将任意编程助手（Claude Code、Codex、Antigravity CLI 等）转化为 Google Cloud 上构建、评估、部署企业级 AI Agent 的专家。2026年4月刚发布，已在 AI 开发者社区引起广泛关注。

4,723

GitHub Stars

506

Forks

Python

主要语言

Apache 2.0

开源许可

## ⚙️ 安装要求与过程

### 环境要求

-   Python 3.11+ （推荐 3.11 或 3.12）
-   [uv](https://docs.astral.sh/uv/getting-started/installation/) （Python 包管理器，类似 pip 但更快）
-   [Node.js](https://nodejs.org/en/download) （用于 npx skills add 方式安装）
-   Google Cloud 账号（如需部署到 Google Cloud）

### 快速安装（推荐方式）

```
# 一键安装 CLI + 技能包到编程助手
uvx google-agents-cli setup

# 或者只安装技能包（让编程助手自己处理）
npx skills add google/agents-cli
```

### 验证安装

```
# 查看已安装的技能
agents-cli --help

# 创建新 Agent 项目
agents-cli scaffold my-agent
```

## 🚀 核心功能

### ① 全栈 Agent 开发工作流

从项目脚手架创建、代码编写、评估测试到云端部署，agents-cli 提供完整的 Agent 开发生命周期支持。无需手动学习每款 CLI 和云服务，编程助手通过技能包自动掌握最佳实践。

### ② 七大专业技能包

内置 7 个精心设计的技能包，覆盖 Agent 开发全流程：

-   **google-agents-cli-workflow**：开发周期、代码保留规则、模型选择
-   **google-agents-cli-adk-code**：ADK Python API（Agent、Tools、编排、回调、状态）
-   **google-agents-cli-scaffold**：项目脚手架（create、enhance、upgrade）
-   **google-agents-cli-eval**：评估方法论（指标、数据集、LLM-as-judge、自适应评分）
-   **google-agents-cli-deploy**：部署（Agent Runtime、Cloud Run、GKE、CI/CD、密钥管理）
-   **google-agents-cli-publish**：Gemini Enterprise 注册
-   **google-agents-cli-observability**：可观测性（Cloud Trace、日志、第三方集成）

### ③ 多编程助手无缝集成

原生支持 Antigravity CLI、Claude Code、Codex 以及其他遵循 MCP 协议的编程助手。安装后，编程助手自动获得 Google Cloud AI Agent 开发能力，无需额外配置。

### ④ 企业级部署与治理

支持部署到 Google Cloud 多种运行环境：Agent Runtime（专用 Agent 托管平台）、Cloud Run（无服务器容器）、GKE（Kubernetes）。内置 CI/CD 集成、密钥管理和版本控制，满足企业级安全要求。

### ⑤ 内置评估与可观测性

提供完整的 Agent 评估框架（数据集管理、自动评分、LLM-as-judge）和开箱即用的可观测性工具（Cloud Trace 分布式追踪、结构化日志、第三方 APM 集成），让 Agent 质量可度量、问题可定位。

## 💡 典型使用场景

### 场景一：快速构建客服 Agent 并部署到云端

开发者在 Claude Code 中安装 agents-cli 技能包后，直接描述需求：”构建一个客服 Agent，接入公司知识库，支持订单查询和退换货处理，然后部署到 Cloud Run”。Claude Code 自动调用 agents-cli 技能，完成项目创建、代码生成、测试评估和云端部署全流程，全程无需手动操作 gcloud CLI。

### 场景二：企业 Agent 性能评估与持续优化

使用 agents-cli eval 生成评估数据集，对 Agent 进行自动化测试。通过 LLM-as-judge 自适应评分机制，全面评估 Agent 的回答质量、工具调用准确性、多轮对话连贯性。测试结果自动生成报告，指导后续优化方向。

### 场景三：将开源 Agent 发布到 Gemini Enterprise 平台

完成 Agent 开发后，使用 agents-cli publish gemini-enterprise 命令，一键将 Agent 注册到 Gemini Enterprise Agent Platform，让企业内其他团队可以发现、调用和组合你的 Agent，实现 Agent 能力的内部共享与治理。

## 🌟 推荐理由

agents-cli 的最大价值在于**“技能转移”**——它将 Google Cloud AI Agent 开发的最佳实践封装成技能包，让任何编程助手都能立即获得专家级 Agent 构建能力。对于已经在使用 Claude Code 或 Codex 的开发者，安装 agents-cli 相当于免费聘请了一位精通 Google Cloud 的 Agent 架构师。

项目虽然刚发布不久（2026年4月），但作为 Google 官方出品，其架构设计和工程质量有充分保障。七大技能包覆盖了从开发到部署的完整生命周期，特别是评估（eval）和部署（deploy）技能，解决了 AI Agent 工程化落地的最大痛点。

如果你正在使用 Google Cloud 或考虑将 Agent 部署到云端，agents-cli 是目前最完整、最官方的一站式解决方案。即使暂时不用 Google Cloud，其技能包中蕴含的 Agent 工程最佳实践也值得深入学习。

## 📥 下载地址

[

🐙

GitHub 仓库

google/agents-cli

](https://github.com/google/agents-cli)  
[

📚

官方文档

google.github.io/agents-cli

](https://google.github.io/agents-cli/)  
[

📦

PyPI 安装包

google-agents-cli

](https://pypi.org/project/google-agents-cli/)  
[

🐛

问题反馈

GitHub Issues

](https://github.com/google/agents-cli/issues)

**快速安装：**`uvx google-agents-cli setup`  
 |   
**仅安装技能：**`npx skills add google/agents-cli`

数据来源：[GitHub API](https://github.com/google/agents-cli) | 更新时间：2026-07-05 | 由 AI 自动整理

**Tags:** Agent框架, AI, AI Agent, AI开源项目, Apache-2.0, CLI工具, Google, Google Cloud, LLM, MCP

**Categories:** 开源项目

---