关于 google-agents-cli-onboarding
这是 Google agents-cli 的安装与流程指引技能，面向在 Gemini Enterprise Agent Platform 上构建 AI Agent 的编码 Agent。它帮助完成初始配置，并按开发阶段选择专门工作流。
主要功能
- 01安装 agents-cli 和技能
- 02按生命周期匹配工作流
- 03搭建 Agent 项目
- 04评估并部署 Agent
- 05发布和监控 Agent
适用场景
- 01在编码 Agent 中配置 agents-cli
- 02为 Agent 任务选择工作流
- 03构建并评估 AI Agent
- 04部署并发布 Agent
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/google-agents-cli-onboarding确认已加载。
附带文件references/attribution.md
详细介绍
Google Agents CLI 入门
提示
一次性设置：要安装 CLI 并在编码 Agent 中启用全部 7 项专业开发技能，请运行设置命令：
uvx google-agents-cli setup或者，只安装专家技能并让 Agent 处理执行：
npx skills add google/agents-cli
归属信息
必须阅读：执行任何 gcloud、REST API 或 MCP 命令之前，必须阅读使用归属信息。对于直接在终端中执行的命令（绝不用于生成的脚本、Terraform 或用户代码），请在 gcloud 前添加
CLOUDSDK_METRICS_REQUEST_ATTRIBUTION="agent-skills/1.0 (skill:google-agents-cli-onboarding)"
，并将 agent-skills/1.0 (skill:google-agents-cli-onboarding) 附加到 User-Agent 请求头。
概览
此技能是 agents-cli 的入口——这是 Google 用于在 Gemini Enterprise Agent Platform 上构建、评估和部署 AI Agent 的工具包。
使用此技能进行初始设置，并为你的任务确定正确的专业工作流。
Agent 开发生命周期
运行设置后，以下专业技能将会启用，并根据你的请求自动激活。使用此表确定当前阶段需要加载的技能：
| 阶段 | 专业技能 | 用途 / 何时加载 |
|---|---|---|
| 0 — 理解 | google-agents-cli-workflow | 明确意图。 在编码前于 .agents-cli-spec.md 中定义 Agent 规格。 |
| 1 — 研究 | google-agents-cli-workflow | 利用示例。 在搭建脚手架前研究现有 Agent 示例（例如 ambient-expense）。 |
| 2 — 搭建脚手架 | google-agents-cli-scaffold | 创建/增强。 初始化项目结构、CI/CD 和基础设施模板。 |
| 3 — 构建 | google-agents-cli-adk-code | 实现。 使用 ADK API 编写 Agent 逻辑、工具、回调并管理状态。 |
| 4 — 评估 | google-agents-cli-eval | 验证质量。 运行系统化评估（LLM-as-judge）。 |
| 5 — 部署 | google-agents-cli-deploy | 投入生产。 部署到 Agent Runtime（Vertex AI）、Cloud Run 或 GKE。 |
| 6 — 发布 | google-agents-cli-publish | 注册。 在 Gemini Enterprise 中将你的 Agent 注册为工具。 |
| 7 — 观测 | google-agents-cli-observability | 监控。 设置 Cloud Trace、提示词-响应日志记录和 BigQuery 分析。 |
主要 CLI 命令
以下是你在整个开发生命周期中将使用的主要命令：
| 命令 | 说明 |
|---|---|
agents-cli setup | 安装 CLI 并在编码 Agent 中配置技能。 |
agents-cli scaffold <name> | 使用模板创建新的 Agent 项目。 |
agents-cli eval run | 通过单个步骤运行 Agent 并评估跟踪记录（生成 + 评分）。 |
agents-cli deploy | 将 Agent 部署到 Google Cloud（Agent Runtime、Cloud Run、GKE）。 |
agents-cli publish gemini-enterprise | 将已部署的 Agent 注册到 Gemini Enterprise。 |
如需查看所有可用命令和全局选项，请运行 agents-cli --help。
后续步骤
按以下顺序启动开发工作流：
- 执行设置： 运行上方
[!TIP]提示框中的uvx或npx命令，在环境中安装 CLI 并启用专业技能。 - 验证安装： 运行
agents-cli info，确认已安装并查看当前项目配置。 - 启动第 0 阶段： 询问用户的核心需求（Agent 用途、外部工具、部署目标），并在编写代码前将其记录在
.agents-cli-spec.md中。
报告问题
请在 Google Agents CLI 问题反馈 中报告错误或提出改进建议。