agents-cli：谷歌开源 AI 智能体 CLI 工具，全生命周期极简开发部署

一、agents-cli 是什么

agents-cli 是由 Google 官方开源推出的基于命令行的 AI 智能体全生命周期开发工具链，依托谷歌 ADK（Agent Development Kit） 底层架构打造，专为 Gemini Enterprise Agent Platform 生态设计。

该项目定位为轻量化终端工具，不依赖复杂可视化界面，开发者可通过终端命令完成AI 智能体脚手架创建、代码开发、调试运行、自动化评估、云原生部署、企业平台发布、可观测性运维等全套流程。它既可以独立作为命令行工具使用，也能无缝兼容 Gemini CLI、Claude Code 等主流 AI 编程助手，为大模型智能体开发提供标准化、工程化的终端解决方案。

agents-cli 目前处于 Pre-GA 预览版本，面向企业开发者、AI 工程研发人员、云架构师群体，简化谷歌生态下大模型智能体从0到1的落地成本，统一智能体开发的工程规范与部署标准。

二、功能特色

1. 全生命周期一站式管控
   覆盖 AI 智能体初始化脚手架、编码开发、本地调试、自动化评测、云端部署、企业注册、日志观测七大核心环节，无需切换多平台工具，终端即可完成全流程操作。

2. 原生适配谷歌生态体系
   深度绑定 Gemini 大模型、Google ADK 开发套件、Google Cloud 云服务，原生支持 Agent Runtime、Cloud Run、GKE 等谷歌云部署架构，适配 Gemini Enterprise 企业级智能体托管平台。

3. 轻量化命令行极简操作
   摒弃复杂图形化界面，采用简洁命令行指令设计，提供标准化 CLI 命令集，新手开发者可快速上手，熟练开发者可实现脚本化、批量自动化开发。

4. 模块化技能体系设计
   内置独立可拆分的技能包，包含工作流编排、ADK 代码封装、项目脚手架、智能体评估、云端部署、企业发布、可观测追踪七大模块，按需启用、灵活组合。

5. 存量项目无缝兼容升级
   支持对已有 AI 智能体项目进行增强改造，通过内置命令快速接入 CI/CD 流水线、RAG 检索增强、云部署配置等能力，无需重构原有业务代码。

6. 双环境开发模式
   支持本地轻量化开发与企业云端生产部署双模式：本地仅需 AI Studio 密钥即可调试，生产环境对接 Google Cloud 项目完成商业化落地。

7. 标准化代码规范与校验
   内置代码 lint 检查、项目工程规范约束，统一团队智能体开发编码标准，降低多人协作中的架构混乱与代码冗余问题。

三、技术细节

1. 底层技术架构

• 核心依赖：基于 Google ADK（Agent Development Kit） 二次封装，承接 ADK 的智能体状态管理、多轮对话编排、工具调用调度核心能力。

• 运行环境：强制要求 **Python 3.11+**，同时兼容 uv 包管理器、Node.js 环境，适配主流 Linux、macOS、Windows 终端环境。

• 项目架构采用分层设计：

• 命令行交互层：解析终端指令、参数校验、任务分发；

• 技能模块层：拆分七大独立技能包，解耦各业务能力；

• 底层适配层：对接 Google Cloud、Gemini API、日志追踪、评估引擎；

• 工程脚手架层：生成标准化项目目录、配置文件、基础代码模板。

2. 核心技术模块解析

• Scaffold 脚手架模块：内置标准化项目模板，自动生成智能体基础目录、配置文件、入口代码、依赖清单，规避重复初始化工作。

• Eval 自动化评估模块：集成 LLM 自主评判机制，支持自定义评估指标、批量用例测试、多版本智能体效果对比，量化智能体对话准确率与任务完成度。

• Deploy 云部署模块：原生适配 Google Cloud 多类算力载体，支持容器化打包、镜像构建、资源自动配置，一键发布至 Cloud Run、GKE、Agent Runtime。

• Observability 可观测模块：集成链路追踪、运行日志采集、异常监控、会话流程回溯，便于线上智能体故障排查与性能优化。

3. 安装与运行技术要求

• 包分发方式：以 Python wheel 包形式分发，支持 uvx、npm 多渠道安装；

• 权限与鉴权：通过账号登录机制对接 Google Cloud 身份认证、Gemini AI Studio API 鉴权，分离开发环境与生产环境权限体系；

• 扩展能力：支持接入第三方 AI 编程助手，以技能插件形式嵌入 Claude Code、Gemini CLI 等工具，扩展智能体开发辅助能力。

四、应用场景

1. 企业级 Gemini 智能体定制开发
   企业基于 Gemini 大模型搭建行业专属智能体，如客服智能体、办公流程机器人、行业知识库问答智能体，用 agents-cli 完成快速开发与标准化部署。

2. AI 研发团队工程化协作
   技术团队统一使用命令行工具规范智能体开发流程，通过脚手架统一项目结构，借助 CI/CD 适配能力实现智能体版本迭代、自动化测试与灰度发布。

3. 个人开发者快速原型验证
   独立开发者基于谷歌大模型快速搭建智能体原型，本地无需复杂云资源配置，依托 AI Studio 密钥即可完成调试，降低入门门槛。

4. 云原生 AI 智能体运维管控
   运维人员通过可观测模块监控线上智能体运行状态、会话链路、接口调用日志，快速定位异常问题，实现企业级 AI 应用稳定运维。

5. 存量 AI 项目改造升级
   对传统自研大模型智能体项目进行云原生改造，通过 agents-cli 增强命令快速接入谷歌云部署、RAG 检索、自动化评估能力，无需重构代码。

五、使用方法

1. 前置环境准备

安装基础依赖环境：

• 安装 Python 3.11 及以上版本

• 安装 uv 包管理器 或 Node.js 环境

• 准备 Gemini AI Studio API Key 或 Google Cloud 项目权限

2. 项目安装

方式一：uvx 全局安装

uvx google-agents-cli setup

方式二：作为技能插件安装

npx skills add google/agents-cli

3. 基础常用命令

• 创建智能体项目脚手架

agents-cli scaffold my-agent-project

• 本地运行智能体项目

agents-cli run

• 代码规范检查

agents-cli lint

• 执行智能体自动化评估

agents-cli eval run

• 多版本评估结果对比

agents-cli eval compare

• 云端部署智能体

agents-cli deploy

• 发布至 Gemini 企业平台

agents-cli publish gemini-enterprise

• 存量项目能力增强升级

agents-cli scaffold enhance

4. 开发流程步骤

1. 执行 scaffold 命令创建项目脚手架；

2. 编写智能体业务逻辑与工具调用代码；

3. 本地 run 命令调试运行，lint 校验代码规范；

4. 配置评估用例，执行 eval 完成效果测试；

5. 配置 Google Cloud 资源，执行 deploy 云端部署；

6. 发布至 Gemini Enterprise 企业平台，接入可观测运维监控。

六、竞品对比

选取同领域AI 智能体命令行开发工具 3 款进行横向对比，从生态适配、部署能力、评估能力、使用门槛、开源属性多维度分析：

七、常见问题解答

Q1：agents-cli 必须依赖 Google Cloud 才能使用吗？

A：不需要。本地开发调试阶段仅需配置 Gemini AI Studio 的 API Key 即可正常运行，无需申请 Google Cloud 项目与资源；只有进行云端生产部署、发布到 Gemini 企业平台时，才需要配置 Google Cloud 权限与项目信息。

Q2：最低需要什么版本的 Python 才能运行该工具？

A：项目硬性要求 Python 3.11 及以上版本，低版本 Python 会出现依赖安装失败、命令运行异常等问题，建议直接安装 3.11 或 3.12 稳定版。

Q3：能否用来开发非 Gemini 大模型的智能体？

A：agents-cli 底层深度基于 Google ADK 和 Gemini 生态优化，核心适配谷歌系列大模型；虽然可通过自定义改造接入其他模型，但无法享受原生脚手架、部署、评估等完整能力，更推荐优先用于 Gemini 生态智能体开发。

Q4：已有旧的 AI 智能体项目，如何接入 agents-cli？

A：可直接使用 agents-cli scaffold enhance 命令，对已有项目进行结构适配和能力增强，自动补全配置文件、部署脚本、CI/CD 配置，无需手动重构原有业务代码。

Q5：可以和 Claude Code、Gemini CLI 搭配使用吗？

A：完全支持。可通过 npx 命令将 agents-cli 作为技能包添加到 AI 编程助手中，借助编程助手的代码生成能力，配合 agents-cli 的工程化能力，大幅提升智能体开发效率。

Q6：该项目是否适合个人开发者入门学习？

A：非常适合。命令行操作简洁、脚手架标准化，屏蔽了底层复杂架构，个人开发者可以快速搭建智能体原型，学习谷歌生态 AI 智能体的工程化开发规范。

八、相关链接

• 项目 GitHub 开源地址：https://github.com/google/agents-cli

• 项目官网：https://google.github.io/agents-cli/

• Google ADK 官方文档地址：https://developers.google.com/adk

• Gemini Enterprise Agent Platform 官方介绍地址：https://cloud.google.com/gemini/enterprise-agents

九、总结

agents-cli 是 Google 为 Gemini 生态量身打造的开源命令行 AI 智能体开发工具链，依托 ADK 底层能力整合了项目初始化、编码调试、自动化评估、云原生部署、企业发布与运维观测全流程能力，以轻量化终端操作降低了企业级大模型智能体的开发与落地门槛，原生适配谷歌云全栈生态，具备标准化工程模板、模块化技能拆分、存量项目无缝升级等核心优势，既适合企业研发团队规范协作开发，也满足个人开发者快速原型验证的需求，是谷歌生态下 AI 智能体工程化开发不可或缺的轻量化工具。