---
id: gh-google-agents-cli-onboarding
name: "google-agents-cli-onboarding"
url: https://skills.yangsir.net/skill/gh-google-agents-cli-onboarding
author: google
domain: ai-dev-tools-workflow
tags: ["google", "agents-cli", "cli-tool", "ai-agent-development", "deployment"]
install_count: 6400
rating: 4.50 (120 reviews)
github: https://github.com/google/skills/tree/main/skills/cloud/google-agents-cli-onboarding
---

# google-agents-cli-onboarding

> 此技能用于初始化Google Agents CLI工具链，引导开发者完成AI代理的搭建、评估、部署与发布全流程。通过自动化命令和结构化工作流，显著降低开发门槛，提升多阶段协作效率。

**Stats**: 6,400 installs · 4.5/5 (120 reviews)

## Before / After 对比

### 开发环境配置时间

**Before**:

传统手动配置开发环境、安装依赖、理解工具链需要数天，开发者需自行查阅大量文档并手动下载组件。

**After**:

此技能一键安装CLI并激活所有专用技能，几分钟内即可开始开发Agent，无需复杂配置。

| Metric | Before | After | Change |
|---|---|---|---|
| 环境配置时长 | 480分钟 | 10分钟 | -98% |

## Readme

# Google Agents CLI Onboarding

> [!TIP] **One-Time Setup**: To install the CLI and enable all 7 specialized
> development skills in your coding agent, run the setup command:
>
> ```bash
> uvx google-agents-cli setup
> ```
>
> Alternatively, to install only the expert skills and let the agent handle
> execution:
>
> ```bash
> npx skills add google/agents-cli
> ```

## Overview

This skill serves as the entrypoint for **agents-cli** — Google's toolkit for
building, evaluating, and deploying AI agents on the Gemini Enterprise Agent
Platform.

Use this skill to perform the initial setup and identify the correct specialized
workflows for your task.

## The Agent Development Lifecycle

After running the setup, the following specialized skills become available and
will activate automatically based on your requests. Use this table to identify
which skill to load for your current phase:

| Phase | Specialized Skill | Purpose / When to Load |
| :--- | :--- | :--- |
| **0 — Understand** | `google-agents-cli-workflow` | **Clarify intent.** Define the agent spec in `.agents-cli-spec.md` before coding. |
| **1 — Study** | `google-agents-cli-workflow` | **Leverage samples.** Study existing agent samples (e.g., `ambient-expense`) before scaffolding. |
| **2 — Scaffold** | `google-agents-cli-scaffold` | **Create/Enhance.** Initialize the project structure, CI/CD, and infrastructure templates. |
| **3 — Build** | `google-agents-cli-adk-code` | **Implement.** Write agent logic, tools, callbacks, and manage state using ADK APIs. |
| **4 — Evaluate** | `google-agents-cli-eval` | **Validate Quality.** Run systematic evaluations (LLM-as-judge). |
| **5 — Deploy** | `google-agents-cli-deploy` | **Go Production.** Deploy to Agent Runtime (Vertex AI), Cloud Run, or GKE. |
| **6 — Publish** | `google-agents-cli-publish` | **Register.** Make your agent available as a tool in Gemini Enterprise. |
| **7 — Observe** | `google-agents-cli-observability` | **Monitor.** Set up Cloud Trace, prompt-response logging, and BigQuery analytics. |

## Key CLI Commands

Below are the primary commands you will use throughout the development
lifecycle:

| Command | Description |
| :--- | :--- |
| `agents-cli setup` | Install the CLI and configure skills in your coding agent. |
| `agents-cli scaffold <name>` | Create a new agent project from a template. |
| `agents-cli eval run` | Run the agent and grade the traces in a single step (generate + grade). |
| `agents-cli deploy` | Deploy your agent to Google Cloud (Agent Runtime, Cloud Run, GKE). |
| `agents-cli publish gemini-enterprise` | Register your deployed agent with Gemini Enterprise. |

*For the full list of available commands and global options, run `agents-cli
--help`.*

## Next Steps

Follow this sequence to initiate the development workflow:

1.  **Execute Setup:** Run the `uvx` or `npx` command in the `[!TIP]` box above
    to install the CLI and enable the specialized skills in your environment.
2.  **Verify Installation:** Run `agents-cli info` to confirm the installation
    and view the active project configuration.
3.  **Initiate Phase 0:** Ask the user for their core requirements (agent
    purpose, external tools, deployment target) and document them in
    `.agents-cli-spec.md` before writing any code.

## Reporting Issues

Report bugs or improvements at [Google Agents CLI Issues](https://github.com/google/agents-cli/issues).

## Supporting Links

*   [Google Agents CLI Documentation](https://github.com/google/agents-cli/tree/main/docs/src)


---
*Source: https://skills.yangsir.net/skill/gh-google-agents-cli-onboarding*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-google-agents-cli-onboarding/markdown*