用途:google-agents-cli 是 Google Cloud Gemini Enterprise Agent Platform 上构建、评估和部署生产级 AI 智能体的官方 CLI 与技能套件,基于 ADK(Agent Development Kit),覆盖从脚手架到部署再到可观测性的完整开发生命周期。
主要能力:用 ADK 最佳实践结构搭建智能体项目;通过指标、evalset、LLM-as-judge 和轨迹评分进行评测;部署到 Agent Runtime、Cloud Run 或 GKE 并支持 CI/CD;发布到 Gemini Enterprise 供组织内使用;用 Cloud Trace、日志及第三方可观测性集成进行监控;为已有项目补充部署配置、RAG 和 CI/CD 流水线。
安装与认证:需 Python 3.11+、uv、Node.js,以及 Google Cloud 账号(部署)或 AI Studio API key(本地开发)。安装 CLI 与技能:uvx google-agents-cli setup;仅安装技能:npx skills add google/agents-cli。认证:agents-cli login;本地开发设置 export GOOGLE_API_KEY=your-api-key;查看状态:agents-cli login --status。
常用命令:agents-cli scaffold my-agent 创建项目;agents-cli scaffold enhance 增强已有项目;agents-cli install 安装依赖;agents-cli run "What's the weather in Tokyo?" 本地运行;agents-cli lint 代码检查;agents-cli eval run 运行评测;agents-cli eval compare results-v1.json results-v2.json 对比结果;agents-cli deploy 部署;agents-cli infra single-project 或 infra cicd 配置基础设施;agents-cli publish gemini-enterprise 发布;agents-cli infra datastore 与 agents-cli data-ingestion 支持 RAG;agents-cli info 查看项目信息;agents-cli update 更新技能。
配置:pyproject.toml 中 [tool.agents-cli] 可设置 agent_module、deployment_target、region、project_id;评测配置位于 eval/evalset.yaml,支持自定义指标与 LLM-as-judge。
适用场景:在 Google Cloud 上开发、评测、部署和发布 ADK 智能体,包括多轮对话、结构化输出、多智能体编排、RAG 集成与 CI/CD 流水线。
限制:依赖 Google Cloud 或 AI Studio 环境;部署需相应 IAM 权限;模型速率限制可能触发 429,需配置重试;具体收费与价格资料暂未提供。