google-agents-cli-onboarding
Onboarding entrypoint for agents-cli in Agent Platform. It should be used when the user wants to "create a new agent", "develop an agent", "build an agent using ADK", "run the agent locally", "debug agent code", "test an agent", "evaluate an agent", "deploy an agent", "publish an agent", "monitor an agent", or needs the ADK (Agent Development Kit) development lifecycle.
摘要
- 用途
- 它引導使用者完成 Google agents-cli 的初始設定，並為 Gemini Enterprise Agent Platform 上的代理程式開發指向合適的生命週期流程。
- 使用時機
- 在設定或驗證 CLI、選擇目前開發階段的工作流程，或開始定義代理程式需求時使用。
- 輸出結果
- 它提供設定與驗證步驟、各階段的工作流程指引，以及在編寫程式碼前將需求記錄於 .agents-cli-spec.md 的說明。
上游變更（4 筆，最新收錄 2026-09-21）
becc4b8 Enforce semantic versioning (MAJOR.MINOR.PATCH) for skills. 在技能的 front matter 中將中繼資料版本設為 1.0.0。 b303146 Update README.md to group skills by category. 在技能中繼資料新增 DevOps 類別，並加入 `Google Agents CLI Onboarding` 標題。 4f2b58c Fix google-agents-cli-onboarding tables 將生命週期章節改名為 The Agent Development Lifecycle，將範例描述中的 ADK 範例改為代理程式範例，並重新排版生命週期與 CLI 指令表格。 94826ed Add google-agents-cli-onboarding skill 新增此入門技能，提供 agents-cli 設定說明、概覽、生命週期與指令表格、後續步驟、問題回報資訊及支援連結。 npx skills add "lettucebo/Skills#v2.2.0@google-agents-cli-onboarding" --full-depth ⚠ v2.2.0 發布後即可使用
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:
uvx google-agents-cli setupAlternatively, to install only the expert skills and let the agent handle execution:
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:
- Execute Setup: Run the
uvxornpxcommand in the[!TIP]box above to install the CLI and enable the specialized skills in your environment. - Verify Installation: Run
agents-cli infoto confirm the installation and view the active project configuration. - Initiate Phase 0: Ask the user for their core requirements (agent
purpose, external tools, deployment target) and document them in
.agents-cli-spec.mdbefore writing any code.
Reporting Issues
Report bugs or improvements at Google Agents CLI Issues.