agents-cli
给任意编码助手（如 Claude Code、Codex）注入 CLI 命令和技能，使其能一站式创建、评估、部署 Google Cloud 上的 AI Agent。亮点是 Google 官方出品，深度集成 Gemini Enterprise Agent Platform，覆盖从脚手架到监控的完整生命周期，支持本地先用 AI Studio 调试。预览版，功能支持有限。
README
agents-cli
用于在 Gemini Enterprise Agent Platform 上构建智能体（agent）的 CLI 和技能（skills）。
开始使用 | 技能 | 命令 | PyPI | 问题反馈 | 文档 | 发布说明 | 加星收藏
将你喜爱的编码助手转变为在 Google Cloud 上构建和部署智能体（agent）的专家。
Agent Platform 中的 Agents CLI（agents-cli）为你的编码智能体提供了构建、扩展、治理和优化企业级智能体所需的技能和命令——这样你就不必亲自学习每一个 CLI 和服务。
无缝集成： Antigravity CLI • Claude Code • Codex • 以及任何其他编码智能体。
开始使用
前置条件： 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-code |
ADK Python API — 智能体、工具、编排、回调、状态 |
google-agents-cli-scaffold |
项目脚手架 — create、enhance、upgrade |
google-agents-cli-eval |
评估方法论 — 指标、数据集、LLM-as-judge、自适应评分标准 |
google-agents-cli-deploy |
部署 — Agent Runtime、Cloud Run、GKE、CI/CD、密钥 |
google-agents-cli-publish |
Gemini Enterprise 注册 |
google-agents-cli-observability |
可观测性 — Cloud Trace、日志、第三方集成 |
CLI 命令
| 命令 | 功能 |
|---|---|
agents-cli setup |
安装 CLI 并将技能添加到编码智能体 |
agents-cli scaffold <name> |
创建新的智能体项目 |
agents-cli eval generate |
在评估数据集上运行智能体，生成 trace |
agents-cli eval grade |
对 trace 运行智能体评估 |
agents-cli deploy |
部署到 Google Cloud |
agents-cli publish gemini-enterprise |
注册到 Gemini Enterprise |
| 命令 | 描述 |
|---|---|
agents-cli login |
认证到 Google Cloud 或 AI Studio |
agents-cli login --status |
显示认证状态 |
| 脚手架 | |
agents-cli scaffold <name> |
创建新的智能体项目 |
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 |
根据指标对生成的 trace 评分 |
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 吗？
本地开发（create、run、eval）不需要——你可以使用 AI Studio API key 在本地结合 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-cli@google.com 联系我们，分享你的智能体或提供反馈
贡献
贡献的最佳方式是提供反馈：通过 issues 提交错误报告、功能请求和想法，直接影响我们的路线图。
详情请参阅贡献指南。
服务条款
agents-cli 利用了 Google Cloud API。当你部署智能体时，你将在自己的 Google Cloud 项目中部署资源，并对这些资源负责。请查看 Google Cloud 服务条款 了解详情。
预览
此功能受通用服务条款中“预通用可用性产品条款”的约束，详见服务特定条款。预通用可用性功能按“现状”提供，可能支持有限。更多信息请参阅发布阶段描述。