开始使用前提条件需 Python 3.11 及以上版本、uv 和 Node.js。步骤如下1. 安装运行 uvx google - agents - cli setup或仅安装技能代码助手会处理其余部分npx skills add google/agents - cli。2. 打开代码助手启动 Antigravity CLI、Claude Code、Codex 或其他喜欢的代码助手。3. 构建首个智能体让代码助手构建东西如“使用 agents - cli 构建一个将冗长文本压缩为简洁技术表述的原始人风格智能体”。查看完整教程获取详细步骤。[浏览完整文档 →]智能体技能技能代码助手学习内容google - agents - cli - workflow开发生命周期、代码保存规则、模型选择google - agents - cli - adk - codeADK Python API智能体、工具、编排、回调、状态google - agents - cli - scaffold项目脚手架创建、增强、升级google - agents - cli - eval评估方法指标、数据集、以大语言模型作为评判、自适应评分标准google - agents - cli - deploy部署智能体运行时、Cloud Run、GKE、CI/CD、密钥管理google - agents - cli - publishGemini Enterprise 注册google - agents - cli - observability可观测性Cloud Trace、日志记录、第三方集成CLI 命令主要命令命令功能agents - cli setup为代码助手安装 CLI 和技能agents - cli scaffold创建新的智能体项目agents - cli eval generate在评估数据集上运行智能体并生成跟踪信息agents - cli eval grade根据跟踪信息对智能体进行评估agents - cli deploy部署到 Google Cloudagents - cli publish gemini - enterprise在 Gemini Enterprise 注册详细命令说明认证- agents - cli login使用 Google Cloud 或 AI Studio 进行身份验证。- agents - cli login --status显示认证状态。脚手架- agents - cli scaffold创建新的智能体项目。- agents - cli scaffold enhance为现有项目添加部署、CI/CD 或 RAG 功能。- agents - cli scaffold upgrade将项目升级到较新的 agents - cli 版本。开发- agents - cli run prompt使用单个提示运行智能体。- agents - cli install安装项目依赖。- agents - cli lint运行代码质量检查Ruff。评估- agents - cli eval generate在评估用例上运行智能体推理。- agents - cli eval grade根据指标对生成的跟踪信息进行评分。- agents - cli eval dataset synthesize为本地智能体合成多轮评估场景。- agents - cli eval compare比较两个评估结果文件。- agents - cli eval analyze从评分结果中聚类失败模式。- agents - cli eval metric list列出可用的指标。- agents - cli eval optimize使用评估数据自动调整智能体提示。部署与发布- agents - cli deploy部署到 Google Cloud。- agents - cli publish gemini - enterprise在 Gemini Enterprise 注册。- agents - cli infra single - project配置单项目基础设施。- agents - cli infra cicd设置 CI/CD 管道和暂存/生产基础设施。数据- agents - cli infra datastore为 RAG 配置数据存储基础设施。- agents - cli data - ingestion运行数据摄入管道。其他- agents - cli info显示项目配置和 CLI 版本。- agents - cli update强制将技能重新安装到所有 IDE。工作原理与架构agents - cli 构建于 Google Cloud 智能体栈之上。常见问题解答- 它是 Antigravity CLI、Claude Code 或 Codex 的替代方案吗不是。agents - cli 是代码助手的工具非代码助手本身提供 CLI 命令和技能让代码助手更擅长在 Google Cloud 上构建、评估和部署 ADK 智能体。- 它与直接使用 adk 有何不同ADK 是智能体框架而 agents - cli 为代码助手提供端到端构建、评估和部署 ADK 智能体的技能和工具。- 需要 Google Cloud 吗本地开发创建、运行、评估不需要可使用 AI Studio API 密钥在本地使用 ADK 运行 Gemini但部署和云功能需要。- 可以在现有智能体项目中使用吗可以。agents - cli scaffold enhance 可为现有项目添加部署和 CI/CD 功能。- 可以不使用代码助手而直接使用 agents - cli 吗可以。CLI 可独立运行可直接从终端运行 agents - cli scaffold、eval、deploy 等命令。技能让代码助手更轻松完成这些工作。- 如何扩展 agents - cli 的技能agents - cli 技能涵盖智能体构建生命周期脚手架、ADK 代码模式、评估、部署、发布、可观测性。相关问题可同时安装其他技能套件如 agent - skills 涵盖通用软件工程工作流构思、规范审查、规划、代码审查google/skills 涵盖 Google Cloud 基础BigQuery、Cloud Run、Firebase、GKE。反馈重视你的意见有助于为社区改进 agents - cli。报告错误和提出功能请求提交一个 issue并对希望优先处理的问题点赞。分享你的成果乐意听取项目进展通过 agents - cligoogle.com 分享智能体或提供反馈。贡献贡献的最佳方式是通过反馈包括通过 issues 分享错误报告、功能请求和想法直接影响路线图。详情参阅贡献指南。服务条款agents - cli 借助 Google Cloud API。部署智能体时将在自己的 Google Cloud 项目中部署资源并对这些资源负责。查看 Google Cloud 服务条款获取详细信息。预览此功能受服务特定条款中“GA 前产品条款”的约束。GA 前功能按“现状”提供可能提供有限支持。更多信息参阅发布阶段说明。