google/agents-cli

The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.

什么是 agents‑cli？

agents‑cli 是一个命令行工具（以及一组可添加到 AI 驱动的编码助手的“技能”），可帮助您构建、测试和部署在 Google 的 Gemini 平台上运行的 AI 代理。它封装了底层 Agent Development Kit (ADK) 和 Google Cloud 服务，因此您无需手动拼接多个单独的 CLI。

适用对象

开发者：希望创建“代理”应用程序（基于 LLM 的机器人，可以调用工具、维护状态等）并在 Google Cloud 上运行。
编码助手：如 Antigravity CLI、Claude Code 或 OpenAI Codex——该工具可以作为技能安装，让这些助手为您发出正确的命令。
需要可重复、CI/CD 就绪的代理项目工作流（脚手架、评估、部署、可观测性）的团队。

核心功能（根据 README 描述）

领域	您获得的功能
脚手架	`agents-cli create <name>` 创建具有 ADK 兼容布局的新项目。`scaffold enhance` 为现有仓库添加部署或 CI/CD，`upgrade` 将项目升级到最新的 CLI 版本。
开发辅助	`run "prompt"` 允许您在本地调用代理，`install` 解析依赖，`lint` 运行 Ruff 进行代码质量检查。
评估套件	`agents-cli eval …` 下的命令允许您生成推理轨迹，使用内置指标进行评分，合成多轮场景，比较运行，聚类失败模式，甚至自动调整提示（`optimize`）。
部署与发布	`deploy` 将代理推送到 Google Cloud（Cloud Run、GKE 或 Gemini 托管运行时）。`publish gemini` 在 Gemini 平台注册代理。基础设施辅助（`infra single-project`、`infra cicd`）设置所需的 Google Cloud 资源。
可观测性	通过 `observability` 技能内置了与 Cloud Trace、Cloud Logging 和第三方监控的集成。
身份验证	`agents-cli login` 使用 Google Cloud 或 AI Studio 进行身份验证；`login --status` 显示当前令牌。
遥测控制	默认情况下，最小使用日志发送到您自己的 Google Cloud 项目；您可以使用 `AGENTS_CLI_TELEMETRY=0` 或 `DO_NOT_TRACK=1` 禁用它。

底层工作原理

ADK Python API – CLI 生成使用 Agent Development Kit 的代码，该工具包定义代理、工具、回调和状态处理。
Gemini 平台 – 当您 deploy 或 publish 时，CLI 在 Gemini 上配置 Agent Runtime，或标准 Cloud Run / GKE 服务，处理 IAM、密钥和 CI/CD 管道。
评估框架 – 内置数据集格式和“LLM 作为裁判”评分系统允许您衡量质量（例如，正确性、相关性），并将结果反馈到提示优化中。
技能层 – 相同的命令作为技能暴露，可以安装到外部编码代理中（通过 npx skills add google/agents-cli）。这些代理可以代表您发出 CLI 命令。

快速入门（简要回顾）

先决条件 – Python 3.11+、uv（快速 Python 包管理器）和 Node.js。
安装 – uvx google-agents-cli setup（或使用 npx skills add google/agents-cli 将技能添加到编码代理）。
创建项目 – agents-cli create my‑agent。
迭代 – 运行提示、lint 并在本地评估。
部署 – agents-cli deploy 推送到 Google Cloud，然后 agents-cli publish gemini 注册。

为什么重要

端到端工作流 – 消除了手动组合 ADK、Cloud Run、GKE 和日志设置的需要。
以代理为中心的评估 – 提供现成的多轮测试和提示调整框架，这通常缺少通用 LLM 工具包。
与编码助手集成 – 技能模型允许 AI 驱动的 IDE 助手成为代理项目的“操作员”，简化开发体验。

了解更多

完整文档站点：https://google.github.io/agents-cli/
快速入门教程：https://google.github.io/agents-cli/guide/quickstart-tutorial/
发布说明、问题跟踪器和 PyPI 包在 README 中链接。

以上所有信息均直接取自仓库的 README；未假设任何额外功能。