agents-cli

用于在 Gemini Enterprise Agent Platform 上构建 Agent 的 CLI 工具与技能库。

让您心仪的编码助手摇身一变，成为在 Google Cloud 上构建和部署 AI Agent 的专家。

Agent Platform 中的 Agents CLI (agents-cli) 为您的编码 Agent 提供了构建、扩展、管理和优化企业级 Agent 所需的技能与命令，让您无需亲自学习每一个 CLI 和服务。

完美兼容以下工具： Gemini CLI • Claude Code • Codex • Antigravity • 以及任何其他编码 Agent。

快速开始

前提条件： Python 3.11+、uv 以及 Node.js。

uvx google-agents-cli setup

或者仅安装技能，剩下的交给您的编码 Agent 处理：

npx skills add google/agents-cli

启动 Gemini CLI、Claude Code、Codex 或任何您偏好的编码 Agent。

要求您的编码 Agent 构建项目，例如："使用 agents-cli 构建一个穴居人风格的 Agent，将冗长的文本压缩为简短、专业的短语"。

查看完整教程以获取分步指南。

技能	您的编码 Agent 将学会
`google-agents-cli-workflow`	开发生命周期、代码保留规则、模型选择
`google-agents-cli-adk-code`	ADK Python API — Agent、工具、编排、回调、状态
`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、日志记录、第三方集成

命令	描述
`agents-cli setup`	为编码 Agent 安装 CLI 及技能
`agents-cli scaffold`	创建一个新的 Agent 项目
`agents-cli eval generate`	在评估数据集上运行 Agent，生成轨迹（trace）
`agents-cli eval grade`	对生成的轨迹进行评估打分
`agents-cli deploy`	部署到 Google Cloud
`agents-cli publish gemini-enterprise`	在 Gemini Enterprise 中注册

命令	描述
`agents-cli login`	登录 Google Cloud 或 AI Studio
`agents-cli login --status`	显示身份验证状态
Scaffold (脚手架)
`agents-cli scaffold`	创建一个新的 Agent 项目
`agents-cli scaffold enhance`	为现有项目添加部署、CI/CD 或 RAG 功能
`agents-cli scaffold upgrade`	将项目升级到更高版本的 agents-cli
Develop (开发)
`agents-cli run "prompt"`	使用单条提示词运行 Agent
`agents-cli install`	安装项目依赖
`agents-cli lint`	运行代码质量检查 (Ruff)
Evaluate (评估)
`agents-cli eval generate`	对评估案例执行 Agent 推理
`agents-cli eval grade`	根据指标对生成的轨迹进行评分
`agents-cli eval dataset synthesize`	为本地 Agent 合成多轮评估场景
`agents-cli eval compare`	比较两个评估结果文件
`agents-cli eval analyze`	从评分结果中聚类分析故障模式
`agents-cli eval metric list`	列出可用指标
`agents-cli eval optimize`	使用评估数据自动调优 Agent 提示词
Deploy & Publish (部署与发布)
`agents-cli deploy`	部署到 Google Cloud
`agents-cli publish gemini-enterprise`	在 Gemini Enterprise 中注册
`agents-cli infra single-project`	配置单项目基础设施
`agents-cli infra cicd`	设置 CI/CD 流水线 + 预发布/生产环境基础设施
Data (数据)
`agents-cli infra datastore`	为 RAG 配置数据存储基础设施
`agents-cli data-ingestion`	运行数据摄取流水线