agents-cli 使用教程
从入门到精通的完整指南
agents-cli 简介
agents-cli是Google推出的AI Agent开发CLI工具和技能包，用于在Google Cloud上构建、评估和部署AI Agent。基于Google的Agent Development Kit（ADK）构建，提供完整的Agent开发生命周期管理，包括项目脚手架、评估测试、部署上线和可观测性监控。支持两种使用方式：作为技能包安装到Gemini CLI、Claude Code、Codex等AI编码助手中，让编码Agent在每个开发步骤做出正确决策；或直接在终端中以CLI命令独立运行。内置7个技能模块覆盖ADK开发全流程。
详细功能介绍
【工具简介】agents-cli是Google官方推出的AI Agent开发CLI工具，基于ADK框架提供从构建到部署的完整生命周期管理。
【核心功能】
① Agent脚手架生成：快速创建ADK项目结构，提供多种Agent模板，支持从零开始构建自定义Agent
② 评估测试框架：内置Agent评估指南和数据集管理，支持系统化测试Agent的性能和准确性
③ 一键部署：支持部署到Google Cloud，提供CI/CD集成和生产环境运维方案
④ 可观测性监控：集成Cloud Trace和BigQuery插件，实时监控Agent运行状态和性能指标
⑤ 7个内置技能模块：覆盖ADK开发全流程，可作为技能包注入Gemini CLI、Claude Code等AI编码助手
【适用场景】
【快速入门】
【优缺点分析】
优点：
缺点：
【适合人群】
1agents-cli 入门教程：Google官方AI Agent开发利器
入门10分钟
agents-cli是Google推出的AI Agent开发CLI工具，基于Agent Development Kit构建，用于在Google Cloud上构建、评估和部署AI Agent。
一、快速开始
首先确保已安装Google Cloud CLI并完成gcloud auth登录认证。通过pip install google-adk安装Agent Development Kit。然后安装agents-cli工具，可通过npm install -g @google/agents-cli安装，或作为技能包集成到Gemini CLI和Claude Code中。安装完成后运行agents-cli --help查看可用命令。确保你的Google Cloud项目已启用Vertex AI API。
二、核心功能演示
1. 项目脚手架：运行agents-cli init my-agent命令，工具会交互式引导你选择Agent类型、配置模型参数和工具集，自动生成项目结构和配置文件。生成的项目包含Agent定义、工具实现、测试模板和部署配置，开箱即用。
2. 评估测试：运行agents-cli eval命令对Agent进行自动化评估。你可以定义测试用例和预期输出，工具会自动运行Agent并对比结果，生成评估报告。支持单元测试和端到端测试，确保Agent行为符合预期。
3. 部署上线：运行agents-cli deploy命令一键将Agent部署到Google Cloud。工具会自动处理容器化、服务配置和网络设置。部署完成后提供访问端点和监控面板链接，支持蓝绿部署和回滚。
三、实际使用案例
场景一：企业智能客服。使用agents-cli快速搭建一个基于企业知识库的客服Agent，连接内部文档和FAQ系统，自动回答用户常见问题。通过评估功能持续优化回答准确率，部署到Cloud Run实现弹性扩缩容。
场景二：数据分析助手。构建一个能查询BigQuery数据库的Agent，用户用自然语言提问，Agent自动生成SQL查询并返回分析结果。用评估功能验证SQL生成的准确性，确保数据安全。
四、常见问题
Q：必须使用Google Cloud吗？A：是的，agents-cli深度集成Google Cloud服务，特别是Vertex AI和Cloud Run，需要有效的GCP项目和计费账号。
Q：和直接用ADK SDK开发有什么区别？A：agents-cli封装了ADK的最佳实践，提供脚手架、评估和部署一站式体验，降低上手门槛，适合快速启动项目。
Q：支持哪些AI模型？A：主要支持Gemini系列模型，也可通过Vertex AI Model Garden接入第三方模型。
五、小贴士
1. 评估测试用例要覆盖正常流程和边界情况，好的测试用例是Agent质量的保障。
2. 作为技能包安装到Claude Code后，可以在对话中直接调用agents-cli命令，开发体验更流畅。
3. 部署前先在本地用agents-cli serve启动开发服务器测试，确认无误再部署到云端节省成本。