将您最喜爱的编程助手变成在 Google Cloud 上构建和部署 agent 的专家。 **Agent Platform 中的 Agents CLI** (`agents-cli`) 为您的编程 agent 提供了构建、扩展、治理和优化企业级 agent 所需的技能和命令——因此您无需亲自学习每一个 CLI 和服务。 **无缝兼容：** [Gemini CLI](https://github.com/google-gemini/gemini-cli)  •  [Claude Code](https://docs.anthropic.com/en/docs/claude-code)  •  [Codex](https://github.com/openai/codex)  •  [Antigravity](https://antigravity.google/)  •  *以及任何其他编程 agent。* ## 开始使用 **前提条件：** Python 3.11+、[uv](https://docs.astral.sh/uv/getting-started/installation/) 和 [Node.js](https://nodejs.org/en/download)。 ### 1. 安装 ``` uvx google-agents-cli setup ```

或者仅安装技能——您的编程 agent 会处理剩下的部分

``` npx skills add google/agents-cli ```

### 2. 打开您的编程 agent 启动 [Gemini CLI](https://github.com/google-gemini/gemini-cli)、[Claude Code](https://docs.anthropic.com/en/docs/claude-code)、[Codex](https://github.com/openai/codex) 或任何您偏好的编程 agent。 ### 3. 构建您的第一个 agent 让您的编程 agent 构建一些东西——例如，*“使用 agents-cli 构建一个穴居人风格的 agent，将冗长的文本压缩成简短、技术性的咕哝声”* 有关逐步演练，请查看[完整教程](https://google.github.io/agents-cli/guide/quickstart-tutorial/)。 **[浏览完整文档 →](https://google.github.io/agents-cli/)** ## Agent 技能 | 技能 | 您的编程 agent 将学到什么 | |-------|-------------------------------| | `google-agents-cli-workflow` | 开发生命周期、代码保留规则、模型选择 | | `google-agents-cli-adk-code` | ADK Python API——agent、工具、编排、回调、状态 | | `google-agents-cli-scaffold` | 项目脚手架——`create`、`enhance`、`upgrade` | | `google-agents-cli-eval` | 评估方法论——指标、数据集、LLM-as-judge、自适应评分标准 | | `google-agents-cli-deploy` | 部署——[Agent Runtime](https://docs.cloud.google.com/gemini-enterprise-agent-platform/scale)、[Cloud Run](https://cloud.google.com/run)、[GKE](https://cloud.google.com/kubernetes-engine)、CI/CD、secrets | | `google-agents-cli-publish` | Gemini Enterprise 注册 | | `google-agents-cli-observability` | 可观测性——Cloud Trace、日志记录、第三方集成 | ## CLI 命令 | 命令 | 功能说明 | |---------|-------------| | `agents-cli setup` | 将 CLI 和技能安装到编程 agent 中 | | `agents-cli scaffold ` | 创建新的 agent 项目 | | `agents-cli eval generate` | 在评估数据集上运行 agent，生成 traces | | `agents-cli eval grade` | 对 traces 运行 agent 评估 | | `agents-cli deploy` | 部署到 Google Cloud | | `agents-cli publish gemini-enterprise` | 在 Gemini Enterprise 注册 |

查看所有命令

| 命令 | 描述 | |---------|-------------| | `agents-cli login` | 向 Google Cloud 或 AI Studio 进行身份验证 | | `agents-cli login --status` | 显示身份验证状态 | | **脚手架** | | | `agents-cli scaffold ` | 创建新的 agent 项目 | | `agents-cli scaffold enhance` | 为现有项目添加部署、CI/CD 或 RAG 功能 | | `agents-cli scaffold upgrade` | 将项目升级到较新的 agents-cli 版本 | | **开发** | | | `agents-cli run "prompt"` | 使用单个 prompt 运行 agent | | `agents-cli install` | 安装项目依赖 | | `agents-cli lint` | 运行代码质量检查 (Ruff) | | **评估** | | | `agents-cli eval generate` | 对评估用例运行 agent 推理 | | `agents-cli eval grade` | 根据指标对生成的 traces 进行评分 | | `agents-cli eval dataset synthesize` | 为您的本地 agent 合成多轮评估场景 | | `agents-cli eval compare` | 比较两个评估结果文件 | | `agents-cli eval analyze` | 从评分结果中聚类失败模式 | | `agents-cli eval metric list` | 列出可用的指标 | | `agents-cli eval optimize` | 使用评估数据自动优化 agent prompt | | **部署与发布** | | | `agents-cli deploy` | 部署到 Google Cloud | | `agents-cli publish gemini-enterprise` | 在 Gemini Enterprise 注册 | | `agents-cli infra single-project` | 配置单项目基础设施 | | `agents-cli infra cicd` | 设置 CI/CD pipeline 和 staging/prod 基础设施 | | **数据** | | | `agents-cli infra datastore` | 为 RAG 配置数据存储基础设施 | | `agents-cli data-ingestion` | 运行数据摄取 pipeline | | **其他** | | | `agents-cli info` | 显示项目配置和 CLI 版本 | | `agents-cli update` | 强制将技能重新安装到所有 IDE |

## 工作原理

## 架构 `agents-cli` 所构建的 Google Cloud agent 技术栈：  ## 常见问题解答 **这是 Gemini CLI、Claude Code 或 Codex 的替代品吗？**
不是。**`agents-cli` 是一个*为*编程 agent 服务的工具，它本身并不是一个编程 agent。** 它提供的 CLI 命令和技能，让您的编程 agent 能更擅长在 Google Cloud 上构建、评估和部署 ADK agent。 **这与直接使用 `adk` 有什么不同？**
[ADK](https://adk.dev) 是一个 agent 框架。`agents-cli` 为您的编程 agent 提供了端到端构建、评估和部署 ADK agent 的技能和工具。 **我需要 Google Cloud 吗？**
对于本地开发（`create`、`run`、`eval`），不需要——您可以使用 [AI Studio API key](https://aistudio.google.com/apikey) 在本地通过 [ADK](https://adk.dev) 运行 Gemini。但对于部署和云功能，则是需要的。 **我可以将它用于现有的 agent 项目吗？**
可以。`agents-cli scaffold enhance` 可以为现有项目添加部署和 CI/CD 功能。 **我可以不使用编程 agent 而直接使用 `agents-cli` 吗？**
可以。该 CLI 可以独立工作——您可以直接从终端运行 `agents-cli scaffold`、`eval`、`deploy` 以及其他所有命令。这些技能只是让编程 agent 更容易替您完成这些工作。 **如何使用其他技能扩展 `agents-cli`？**
`agents-cli` 技能涵盖了 agent 构建的生命周期（scaffold、ADK 代码模式、evals、部署、发布、可观测性）。对于相关领域的需求，您可以安装其他的技能套件。例如，[agent-skills](https://github.com/addyosmani/agent-skills) 涵盖了通用的软件工程工作流（构思、规范检查点、规划、代码审查），而 [google/skills](https://github.com/google/skills) 涵盖了 Google Cloud 基础服务（BigQuery、Cloud Run、Firebase、GKE）。 ## 反馈 我们非常重视您的反馈——它有助于我们为社区改进 `agents-cli`。 - **Bug 和功能请求：**[提交 issue](https://github.com/google/agents-cli/issues/new)——为您希望优先处理的项目点赞 👍 - **分享您的作品：**我们很乐意了解您的项目！请通过 agents-cli@google.com 联系我们，分享您的 agent 或提供反馈 ## 服务条款 `agents-cli` 利用了 Google Cloud API。当您部署 agent 时，您将在自己的 Google Cloud 项目中部署资源，并需对这些资源负责。请查阅 [Google Cloud 服务条款](https://cloud.google.com/terms/service-terms) 了解详细信息。 ## 预览版 此功能受通用服务条款部分中的“Pre-GA Offerings Terms”约束。 有关更多详细信息，请参阅[特定服务条款](https://cloud.google.com/terms/service-terms#1)。 Pre-GA 功能按“原样”提供，可能仅获得有限的支持。有关更多 信息，请参阅 [发布阶段描述](https://cloud.google.com/products?hl=en#product-launch-stages)。

标签：AI智能体, AI编程助手, Google Cloud, MITM代理, SOC Prime, 云原生部署, 开发工具, 逆向工具