google-agents-cli-onboarding について
Google agents-cli のセットアップと手順案内を行うスキルです。Gemini Enterprise Agent Platform で AI エージェントを開発するコーディングエージェント向けに、初期設定と各段階のワークフロー選択を支援します。
主な機能
- 01agents-cli とスキルの導入
- 02開発段階に応じた手順案内
- 03エージェントプロジェクトの作成
- 04エージェントの評価とデプロイ
- 05エージェントの公開と監視
活用シーン
- 01コーディングエージェントへの agents-cli 設定
- 02エージェント作業に適した手順の選択
- 03AI エージェントの構築と評価
- 04エージェントのデプロイと公開
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ google/ skills --skill google-agents-cli-onboardingインストール後、Claude Code で/google-agents-cli-onboardingを入力して読み込まれたか確認します。
同梱ファイルreferences/attribution.md
詳細
Google Agents CLI のオンボーディング
ヒント
初回セットアップ:CLI をインストールし、コーディングエージェントで 7 つの専門スキルをすべて有効にするには、次のセットアップコマンドを実行してください。
uvx google-agents-cli setupまたは、エキスパートスキルのみをインストールし、実行をエージェントに任せるには、次を実行してください。
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)"
を付け、User-Agent ヘッダーに agent-skills/1.0 (skill:google-agents-cli-onboarding) を追加してください。
概要
このスキルは、Gemini Enterprise Agent Platform 上で AI エージェントを構築、評価、デプロイするための Google のツールキットである agents-cli のエントリーポイントです。
このスキルを使って初期セットアップを行い、タスクに適した専門ワークフローを特定してください。
エージェント開発ライフサイクル
セットアップを実行すると、以下の専門スキルが利用可能になり、リクエストに応じて自動的に有効になります。現在のフェーズで読み込むスキルを特定するには、この表を使用してください。
| フェーズ | 専門スキル | 目的/読み込むタイミング |
|---|---|---|
| 0 — 理解 | google-agents-cli-workflow | 意図を明確にします。 コーディングの前に .agents-cli-spec.md でエージェントの仕様を定義します。 |
| 1 — 調査 | google-agents-cli-workflow | サンプルを活用します。 スキャフォールディングの前に、既存のエージェントサンプル(例:ambient-expense)を調査します。 |
| 2 — スキャフォールディング | google-agents-cli-scaffold | 作成/拡張します。 プロジェクト構成、CI/CD、インフラストラクチャのテンプレートを初期化します。 |
| 3 — 構築 | google-agents-cli-adk-code | 実装します。 ADK API を使用して、エージェントのロジック、ツール、コールバックを記述し、状態を管理します。 |
| 4 — 評価 | google-agents-cli-eval | 品質を検証します。 システマティックな評価(LLM による評価)を実行します。 |
| 5 — デプロイ | google-agents-cli-deploy | 本番環境に移行します。 Agent Runtime(Vertex AI)、Cloud Run、または GKE にデプロイします。 |
| 6 — 公開 | google-agents-cli-publish | 登録します。 エージェントを Gemini Enterprise のツールとして利用できるようにします。 |
| 7 — オブザーバビリティ | google-agents-cli-observability | モニタリングします。 Cloud Trace、プロンプトと応答のログ記録、BigQuery 分析を設定します。 |
主な CLI コマンド
開発ライフサイクル全体で使用する主なコマンドを以下に示します。
| コマンド | 説明 |
|---|---|
agents-cli setup | CLI をインストールし、コーディングエージェントでスキルを設定します。 |
agents-cli scaffold <name> | テンプレートから新しいエージェントプロジェクトを作成します。 |
agents-cli eval run | エージェントを実行し、トレースを 1 つのステップで生成および採点します。 |
agents-cli deploy | エージェントを Google Cloud(Agent Runtime、Cloud Run、GKE)にデプロイします。 |
agents-cli publish gemini-enterprise | デプロイ済みのエージェントを Gemini Enterprise に登録します。 |
使用可能なコマンドとグローバルオプションの全一覧を確認するには、agents-cli --help を実行してください。
次のステップ
開発ワークフローを開始するには、次の手順に従ってください。
- セットアップを実行する: 上の
[!TIP]ボックスにあるuvxまたはnpxコマンドを実行して、CLI をインストールし、環境で専門スキルを有効にします。 - インストールを確認する:
agents-cli infoを実行して、インストールを確認し、アクティブなプロジェクト設定を表示します。 - フェーズ 0 を開始する: コードを書く前に、ユーザーに主要な要件(エージェントの目的、外部ツール、デプロイ先)を確認し、
.agents-cli-spec.mdに記録します。
問題の報告
バグや改善案は、Google Agents CLI の問題報告から報告してください。