agents-cli

agents-cli – 谷歌云智能体开源的官方命令行工具

Agents CLI：赋能AI智能体开发的利器，简化全生命周期管理

Agents CLI，作为谷歌云智能体平台官方推出的命令行工具，以其精妙的设计理念，致力于大幅简化AI智能体的全生命周期开发流程。该工具巧妙地将工程化知识凝聚成七个的技能模块，全面覆盖了从项目启动、ADK开发、本地调试，到Cloud Run/GKE部署乃至Gemini Enterprise的发布等关键环节。开发者可以借助AI编程助手，实现全流程的自动化，亦可选择人工模式，直接掌控CLI命令的执行。尤为值得一提的是，在本地开发阶段，仅需AI Studio API Key，便可无需配置Google Cloud项目，实现快速的原型验证。

Agents CLI的核心功能亮点

项目脚手架：通过 scaffold 命令，轻松创建标准化Agent项目，为现有项目注入部署、CI/CD、RAG能力，或将其升级至最新规范。
本地开发与调试：内置 run 命令支持快速冒烟测试，playground 提供交互式Web可视化界面，便于调试。同时，install 和 lint 命令确保依赖管理和代码质量。
评估与验证： eval run 命令驱动评估流水线，按预设指标和数据集测试Agent性能。 eval compare 则用于对比不同版本的结果，支持LLM-as-Judge和轨迹评分。
自动化部署： deploy 命令实现一键部署至Agent Runtime、Cloud Run或GKE，满足不同部署需求。
企业级发布： publish gemini-enterprise 命令将部署后的Agent注册至Gemini Enterprise平台，便于组织内部搜索和调用。
基础设施即代码： infra 系列命令生成Terraform配置，搭建CI/CD流水线，配置RAG数据基础设施及数据接入管道。
编程助手技能包：将工程化知识打包为Workflow、ADK Code、Scaffold、Eval、Deploy、Publish、Observability七个模块，直接赋能Gemini CLI、Claude Code等编程助手。

Agents CLI的技术驱动力

技能包注入机制：将Google Cloud的工程化知识封装为结构化技能模块，通过 npx skills add 注入编程助手，使其无需自行推断即可生成精准代码和配置。
ADK + A2A编排架构：基于Google ADK和A2A协议，利用ADK的Python API定义Agent行为，并通过A2A实现Agent间的互操作。
分层云原生架构：编排层处理Agent逻辑，模型层接入Gemini大模型，数据层整合Vector Store和BigQuery，可观测性层实现全链路追踪。
上下文压缩与确定互：预编码的结构化命令和技能包，避免重复推断，降低Token消耗，提升输出确定性。
本地评估与轨迹验证：内置评估流水线支持本地数据集测试，通过LLM-as-Judge和轨迹评分确保行为一致性。

Agents CLI的使用指南

环境准备：确保安装Python 3.11+、uv和Node.js。
安装CLI与技能包：执行 uvx google-agents-cli setup 完成安装。
仅安装技能包（可选）：运行 npx skills add google/agents-cli 单独注入技能知识。
身份认证：执行 agents-cli login --interactive 或设置 GEMINI_API_KEY。
创建项目：使用 agents-cli scaffold my-first-agent 生成项目。
安装依赖：在项目根目录运行 agents-cli install。
本地调试：执行 agents-cli playground 启动Web可视化界面进行交互调试。

Agents CLI的核心优势

降低工程化门槛：将复杂的云服务知识转化为易于编程助手理解的技能包。
多Agent兼容：支持Gemini CLI、Claude Code、Codex等主流编程助手。
本地零成本起步：无需GCP项目即可快速原型验证。
全生命周期覆盖：提供端到端的开发、部署和发布闭环。
人工模式兜底：允许开发者在必要时直接接管流程。
企业级可靠性：具备评估、IaC、CI/CD和多环境部署能力。

Agents CLI的项目资源

项目官网：https://google.github.io/agents-cli/
GitHub仓库：https://github.com/google/agents-cli

Agents CLI与竞品对比

维度	Google Agents CLI	MMX-CLI	Cursor CLI
定位	谷歌云官方开源CLI，赋能编程助手成为企业级AI Agent专家。	MiniMax多模态命令行工具，封装全模态模型调用能力。	AI原生IDE内置CLI Agent，面向日常编码与代码重构。
覆盖阶段	项目脚手架、ADK开发、本地评估、Cloud Run/GKE部署、Gemini Enterprise发布及生产观测。	信息搜集、内容生成、语音合成、图像/音乐选择到视频制作。	代码编辑、多文件重构、测试生成、终端命令执行及CI/CD对接。
部署目标	Agent Runtime、Cloud Run、GKE。	本地或CI环境执行shell命令，调用MiniMax API。	本地开发为主，对接外部CI/CD流水线。
评估能力	内置eval流水线，支持LLM-as-Judge和轨迹评分。	未提供内置Agent评估框架。	未提供内置Agent评估框架。
技能包机制	七个结构化技能模块注入编程助手。	未采用技能包机制。	未采用技能包机制。
人工模式	支持直接执行原生CLI命令。	支持直接执行标准shell命令。	支持直接执行Cursor CLI命令或手动接管Agent会话。