agents-cli 是 Google 为 Gemini 平台上的智能体开发提供的 CLI 和技能包，定位是“为编码代理提供工具”，而非编码代理本身。它不替代 Antigravity CLI、Claude Code 或 Codex，而是让你的编码代理更擅长在 Google Cloud 上构建、评估和部署 ADK 智能体。
主要能力 它提供覆盖智能体构建生命周期的 CLI 命令与技能，包括脚手架（scaffold）、ADK 代码模式、评估（eval）、部署（deploy）、发布（publish）和可观测性（observability）。它构建在 Google Cloud 的智能体技术栈之上，帮助用户无需自行学习每个 CLI 和服务。
使用方式 前置条件：Python 3.11+、uv 和 Node.js。安装后，在 Antigravity CLI、Claude Code、Codex 或任意编码代理中，直接要求代理使用 agents-cli 构建任务，例如“Use agents-cli to build a caveman-style agent that compresses verbose text into terse, technical grunts”。CLI 也可独立于编码代理直接在终端中使用，可运行 agents-cli scaffold、eval、deploy 等全部命令。对于已有智能体项目，agents-cli scaffold enhance 可为其添加部署和 CI/CD。
本地开发与部署 本地开发（create、run、eval）不需要 Google Cloud，可使用 AI Studio API 密钥在本地通过 ADK 运行 Gemini。部署和云端功能则需要 Google Cloud。部署智能体时，资源会部署在用户自己的 Google Cloud 项目中，用户需自行负责这些资源，并应查阅 Google Cloud 服务条款。
扩展 agents-cli 技能覆盖智能体构建生命周期。对于相邻领域，可并列安装其他技能套件，例如 agent-skills 覆盖通用软件工程工作流（构思、规格门禁、规划、代码审查），google/skills 覆盖 Google Cloud 基础（BigQuery、Cloud Run、Firebase、GKE）。
遥测与隐私 默认情况下，agents-cli 每次命令调用会向用户自己的 Google Cloud 项目发送一条使用信号，写入结构化日志条目（logName=projects/<project>/logs/agents-cli），记录命令名（如 deploy、scaffold.create）、退出码、错误类别、时长、CLI/Python 版本和操作系统，绝不记录文件内容、参数或其他输入。扩展添加的命令不记录其名称。请求的 User-Agent 和 X-Goog-Api-Client 头会携带使用元数据供 Google 使用分析，包括 CLI 和 Python 版本、操作系统及版本、CPU 架构、命令名和随机调用 ID；日志条目内容保留在用户项目中。可通过环境变量选择退出遥测，使用 agents-cli info 查看当前遥测状态。
贡献与支持 可通过 issues 提交错误报告、功能请求和想法，影响路线图。也可通过 agents-cli@google.com 分享项目或反馈。
