agents-cli

谷歌正式发布了 agents-cli，这是一套专为在 Gemini Enterprise Agent Platform 上构建、评估和部署 AI 智能体而设计的命令行工具（CLI）与技能套件。它的核心愿景是：将你喜爱的编码助手（如 Claude Code、Antigravity CLI、Codex 等）转变为精通 Google Cloud 架构的 AI 智能体开发专家。

通过提供标准化的工作流、脚手架和自动化命令，agents-cli 让开发者无需手动学习复杂的云服务配置，即可快速实现企业级智能体的全生命周期管理。

核心亮点

• 无缝集成主流编码助手：兼容 Antigravity CLI、Claude Code、Codex 等任何支持 Skill 系统的编码智能体。
• 端到端生命周期管理：覆盖从项目脚手架、代码开发、自动化评估、云部署到 Gemini Enterprise 注册的全过程。
• 基于 ADK (Agent Development Kit)：底层依托谷歌的智能体开发框架，提供标准的工具调用、状态管理和编排能力。
• 双重使用模式：
  • AI 驱动模式：安装 Skill 后，直接让编码助手执行复杂任务（如“帮我部署这个智能体”）。
  • 独立 CLI 模式：开发者可直接在终端运行命令，不依赖 AI 助手。

快速开始

1. 环境准备

确保已安装 Python 3.11+、uv 和 Node.js。

2. 安装

你可以选择安装完整的 CLI + Skill，或仅安装 Skill：

# 方式一：完整安装（推荐）
uvx google-agents-cli setup

# 方式二：仅安装 Skill（由你的编码助手处理其余逻辑）
npx skills add google/agents-cli

3. 构建第一个智能体

打开你喜欢的编码助手（例如 Claude Code），输入自然语言指令：

“使用 agents-cli 构建一个‘穴居人’风格的智能体，它能将冗长的文本压缩为简洁、技术性的咕哝声。”

编码助手会自动调用 agents-cli 的技能来完成项目创建、代码生成和测试。

核心功能模块

agents-cli 通过一系列模块化技能和命令，覆盖了智能体开发的每一个环节：

1. 项目脚手架 (Scaffold)

• agents-cli scaffold <name>：从零创建新的智能体项目。
• agents-cli scaffold enhance：为现有项目添加部署、CI/CD 或 RAG（检索增强生成）支持。
• agents-cli scaffold upgrade：升级项目以适配最新版本的 CLI。

2. 开发与运行 (Develop & Run)

• agents-cli run "prompt"：使用单个提示快速测试智能体响应。
• agents-cli install / lint：管理依赖并检查代码质量。

3. 自动化评估 (Eval) —— 关键差异化优势

• agents-cli eval generate：在评估数据集上运行智能体，生成推理跟踪。
• agents-cli eval grade：使用 LLM 作为评判者，对跟踪结果进行指标评分。
• agents-cli eval dataset synthesize：自动合成多轮对话场景用于测试。
• agents-cli eval analyze：聚类分析失败模式，帮助优化提示词。
• agents-cli eval optimize：基于评估数据自动调整智能体提示。

4. 部署与发布 (Deploy & Publish)

• agents-cli deploy：一键部署到 Google Cloud（支持 Agent Runtime、Cloud Run、GKE）。
• agents-cli publish gemini-enterprise：将智能体注册到 Gemini Enterprise 平台，供企业内部使用。
• agents-cli infra cicd：自动设置 CI/CD 管道及暂存/生产环境基础设施。

5. 可观测性与数据 (Observability & Data)

• agents-cli infra datastore：配置用于 RAG 的数据存储基础设施。
• agents-cli data-ingestion：运行数据摄取管道。
• 集成 Cloud Trace 和日志记录，支持第三方监控工具。

常见问题 (FAQ)

Q: 这是 Antigravity CLI 或 Claude Code 的替代品吗？

A: 不是。agents-cli 是一个工具集，它赋能这些编码助手，让它们更擅长在 Google Cloud 上构建智能体。它本身不是一个通用的编码助手。

Q: 我需要 Google Cloud 账号吗？

A: 本地开发不需要。你可以使用 AI Studio API Key 在本地运行和测试。但在进行部署或使用高级云功能时，需要 Google Cloud 账号。

Q: 我可以将此用于现有的智能体项目吗？

A: 可以。使用 agents-cli scaffold enhance 命令，可以为现有项目添加部署配置和 CI/CD 支持。

Q: 我必须使用编码助手才能运行它吗？

A: 不必。所有功能都可以通过终端直接运行 CLI 命令来实现。Skill 只是让 AI 助手能更自然地调用这些命令。