agents-cli icon

agents-cli

agents-cli 是一款 CLI 和技能包,帮助编码助手在 Google Cloud 上构建、评估、部署并发布 AI agents。支持独立终端使用,也可与 Antigravity CLI、Claude Code 和 Codex 等编码代理集成。

agents-cli

概述

agents-cli 是一款用于在 Google Cloud 上构建 AI agents 的 CLI 和技能包,尤其面向 Gemini Enterprise Agent Platform。它旨在让现有的编码助手在整个 agent 生命周期中变得更强:搭建项目脚手架、编写基于 ADK 的代码、运行评估、部署基础设施以及发布 agents。

该仓库将此工具定位为一种无需分别学习每个 Google Cloud 服务即可端到端处理 agents 的方式。它支持 Antigravity CLI、Claude Code 和 Codex 等编码助手,也可以直接从终端使用。README 说明了安装所需的 Python 3.11+、uv 和 Node.js,并区分了本地开发工作流与云部署功能。

主要功能

端到端 agent 工作流支持

帮助编码助手在 Google Cloud 上创建、评估、部署、发布并监控 AI agents,而无需用户手动学习每个 CLI 和服务。

广泛的 CLI 命令集

提供用于通过终端处理 agent 项目的 setup、login、scaffold、run、install、lint、eval、deploy、publish、infra、data-ingestion、info 和 update 命令。

基于技能的编码助手指导

提供工作流指导、ADK Python API 使用、项目脚手架、评估方法、部署、发布和可观测性等技能。

评估与优化工具

支持生成 eval 数据集的 traces、对结果进行评分、合成多轮场景、比较结果文件、分析失败模式以及优化提示词等评估流程。

部署与注册工作流

包含与 Agent Runtime、Cloud Run、GKE、CI/CD、secrets 和 Gemini Enterprise 注册相关的部署命令和脚手架。

灵活的使用模式

可与 Antigravity CLI、Claude Code、Codex 或其他编码代理一起使用,也可直接在终端中独立运行。

典型用例

  • 创建新的 agent 项目

    先通过脚手架创建一个新的 agent 项目,然后让你的编码助手应用所需的 ADK 代码模式和工作流指导,以构建第一个版本。

  • 评估并调优 agent

    在发布前想检查 agent 的行为时,运行 eval 数据集、生成 traces、对输出评分、比较结果文件并分析失败模式。

  • 将 agent 部署到 Google Cloud

    当项目需要面向云端的发布路径时,设置部署到 Google Cloud,包括 Agent Runtime、Cloud Run、GKE、CI/CD 和 secrets。

  • 扩展现有 agent 项目

    使用 scaffold enhance 为现有项目添加部署、CI/CD 或 RAG,而不是从头重建。

  • 发布并监控 agent

    当 agent 准备好供更广泛使用时,将其注册到 Gemini Enterprise,并通过日志、Cloud Trace 或其他集成配置可观测性。

Pros and Cons

Pros

  • 在一个工具中覆盖 agent 生命周期的多个阶段:脚手架搭建、编码、评估、部署、发布和可观测性。
  • 可与多个编码助手配合使用,也可直接从命令行独立运行。
  • 包含面向评估的命令,用于生成 traces、对结果评分、比较运行结果和分析失败模式。
  • 通过 scaffold create、enhance 和 upgrade 命令同时支持新项目和现有项目。
  • 记录了诸如 CI/CD 设置、datastore 配置和数据导入等基础设施与数据工作流。

Cons

  • 云部署和发布功能依赖 Google Cloud;README 说明本地开发可以不使用它,但部署和云端功能需要它。
  • 该项目是为编码代理提供的工具,而不是完整的 agent 本身,因此用户仍然需要另一个助手或基于终端的工作流来操作它。

FAQ

agents-cli 本身是编码助手吗?

不是。README 说明 agents-cli 是面向编码代理的工具,而不是编码代理本身。它提供 CLI 命令和技能,帮助另一个编码助手构建、评估并部署 agent。

使用它需要 Google Cloud 吗?

对于创建、运行和评估 agent 等本地开发任务,README 说明你不需要 Google Cloud,并且可以使用 AI Studio API key 通过 ADK 在本地运行 Gemini。云部署功能则需要 Google Cloud。

它支持哪些编码助手?

README 列出了对 Antigravity CLI、Claude Code、Codex 以及其他任意编码代理的支持。它还说明该 CLI 也可以直接在终端中独立使用。

agents-cli 支持哪些类型的工作流?

源码中描述了用于设置、脚手架搭建、评估、部署、发布、基础设施配置、数据导入和可观测性的命令。具体工作流取决于你是从新项目开始,还是为现有项目添加部署和 CI/CD。

agents-cli 的价格是多少?

定价页面显示 GitHub 提供免费方案和付费层级,但该仓库本身在 GitHub 上是开源的。此处提供的源码没有显示 agents-cli 本身的单独价格。

Quick Facts

类别
开发者工具
产品类型
CLI 和技能包
主要平台
Google Cloud / Gemini Enterprise Agent Platform
支持的助手
Antigravity CLI、Claude Code、Codex 和其他编码代理
来源域名
github.com
前提条件
Python 3.11+、uv 和 Node.js