--- title: agents-cli 調査レポート tool_name: agents-cli tool_reading: エージェンツ・シーエルアイ category: CLI拡張/プロキシ developer: Google official_site: https://google.github.io/agents-cli/ date: '2026-04-25' last_updated: '2026-09-24' tags: - AI - エージェント - オープンソース - 開発者ツール - CLI description: AIコーディングエージェントにGoogle CloudでのADKエージェント構築・デプロイ機能を追加するCLIツール quick_summary: has_free_plan: true is_oss: true starting_price: 無料 target_users: - 開発者 latest_highlight: v1.7.0でLive（音声）エージェントとA2Aモードに完全対応（2026年9月） update_frequency: 中 evaluation: score: 80 base_score: 70 plus_points: - point: 5 reason: お気に入りのコーディングエージェント（Gemini CLI, Claude Codeなど）にGoogle Cloud向けのスキルを追加できる - point: 5 reason: 開発から評価、デプロイメントまでCLIで一貫して行える minus_points: - point: 0 reason: 特筆すべき減点なし summary: 既存のAIコーディングアシスタントを活用してGoogle Cloud向けのエンタープライズ対応エージェントを構築する強力な補助ツール links: github: https://github.com/google/agents-cli deepwiki: https://deepwiki.com/google/agents-cli relationships: parent: Gemini Enterprise Agent Platform --- # **agents-cli 調査レポート** ## **1. 基本情報** * **ツール名**: agents-cli * **ツールの読み方**: エージェンツ・シーエルアイ * **開発元**: Google * **公式サイト**: [https://google.github.io/agents-cli/](https://google.github.io/agents-cli/) * **関連リンク**: * GitHub: [https://github.com/google/agents-cli](https://github.com/google/agents-cli) * **カテゴリ**: AIエージェント基盤 * **概要**: agents-cliは、Gemini CLIやClaude Code、Codexなどの既存のコーディングアシスタントに、Google Cloud上でエンタープライズレベルのAIエージェントを構築・スケーリング・デプロイするためのスキルを提供するCLIツールです。 ## **2. 目的と主な利用シーン** * **解決する課題**: 開発者がGoogle CloudやAgent Development Kit (ADK)の各サービス・CLIを個別に学習することなく、普段使っているコーディングエージェントのスキルを拡張して効率的にクラウドネイティブなAIエージェントを構築できるようにします。 * **想定利用者**: AIエージェントの開発者、ソフトウェアエンジニア * **利用シーン**: * AIコーディングアシスタントを用いたADK（Agent Development Kit）ベースのエージェントの新規プロジェクトの構築（スキャフォールディング） * エージェントのローカル環境での評価・比較 * Agent RuntimeやCloud Run、GKEなどのGoogle Cloud環境へのデプロイメントパイプラインの構築 ## **3. 主要機能** * **Agent Skillsの提供**: コーディングエージェントにモデル選択、ADK Python APIの使い方、評価方法、Google Cloudへのデプロイ方法などの知識を注入します。 * **プロジェクトのスキャフォールディング**: `agents-cli scaffold` コマンドを使用して、新しいエージェントプロジェクトの雛形を作成したり、既存プロジェクトにデプロイメント機能やCI/CD機能を追加できます。 * **エージェントの評価（Eval）**: `agents-cli eval run` や `agents-cli eval compare` を用いて、エージェントの評価セットを実行したり、結果を比較検証できます。 * **Google Cloudへのデプロイ**: `agents-cli deploy` を使ってCloud RunやGKE、Agent Runtimeへのデプロイを自動化します。 * **インフラストラクチャ・プロビジョニング**: CI/CDインフラやデータストアインフラ（RAG用）のセットアップを自動化するコマンドを提供します。 ## **4. 動作原理・システム構成** * **アーキテクチャ**: ローカル開発ツール（CLI）からクラウド完結型SaaS（Google Cloudリソース）へのデプロイを橋渡しする構成 * **主要コンポーネントとデータフロー**: * 開発者はコーディングエージェント（Gemini CLI等）にプロンプトを入力し、agents-cliのスキル（JSON Schema定義など）を利用してローカルでエージェントプロジェクトを生成（Scaffold）。 * 評価時（Eval）にはローカルでSSEやWebSocket（Live API）経由でエージェントと通信し、結果を検証。 * デプロイ時（Deploy）には、生成されたコンテナをCloud RunやGKEにプロビジョニングし、Agent Runtime等と連携させる。 * **特筆すべき要素技術**: * **ADK (Agent Development Kit)**: バックエンドの主要SDKで、Python/Goに対応しストリーミングやA2A通信を処理。 * **WebSocket / SSE**: Live音声エージェント等とのリアルタイム通信に利用。 ```mermaid flowchart LR A[AIコーディングアシスタント] -->|スキル利用| B(agents-cli) B -->|Scaffold| C[ローカルエージェントプロジェクト] B -->|Eval/Run| C B -->|Deploy| D[Google Cloud] D --> E[Cloud Run / GKE] D --> F[Agent Runtime / Platform] ``` ## **5. 開始手順・セットアップ** * **前提条件**: * Python 3.11以上 * uv * Node.js * **インストール/導入**: ```bash # CLIとスキルのインストール uvx google-agents-cli setup # もしくはスキルのみをインストール（コーディングエージェント側で設定） npx skills add google/agents-cli ``` * **初期設定**: ローカルでの開発（作成、実行、評価）にはAI Studio APIキーが利用可能。クラウドデプロイにはGoogle Cloudのプロジェクトと認証が必要です。 * **クイックスタート**: Gemini CLIやClaude Codeなどのコーディングエージェントを起動し、「agents-cliを使って、冗長なテキストを短く技術的な内容に圧縮するエージェントを構築して」のように指示します。 ## **6. 特徴・強み (Pros)** * AIコーディングエージェントそのものを置き換えるのではなく、既存のアシスタント（Gemini CLI, Claude Codeなど）を強化してGoogle Cloudエコシステムに特化させられる点。 * Google Cloudが提供するAgent RuntimeやADK（Agent Development Kit）の利用を極めて簡略化し、インフラ学習コストを下げられます。 * コマンド自体もスタンドアロンで使用可能であり、コーディングエージェントがなくても利用できる柔軟性。 ## **7. 弱み・注意点 (Cons)** * Python、uv、Node.jsなど複数のツール依存があり、環境構築に多少の手間がかかる可能性があります。 * 基本的にGoogle Cloud（Gemini Enterprise Agent Platform等）へデプロイするためのツールであるため、AWSやAzureへのデプロイ用途には向きません。 * ドキュメントは英語が主体であり、日本語対応は十分ではありません。 ## **8. 料金プラン** | プラン名 | 料金 | 主な特徴 | |---------|------|---------| | **無料** | 無料 | CLIおよびスキルの利用自体はオープンソースであり無料（※裏で動くGoogle CloudリソースやGemini APIの利用には別途課金が発生します） | * **課金体系**: クラウドインフラ利用およびLLM APIコールの従量課金 ## **9. 導入実績・事例** * **導入事例**: 公開事例なし。ただし、Google CloudやGeminiを活用したエンタープライズエージェント構築分野での利用が想定されています。 ## **10. サポート体制** * **ドキュメント**: [公式ドキュメント](https://google.github.io/agents-cli/) * **コミュニティ**: GitHub Issuesを活用したバグ報告や機能要望のコミュニティ * **公式サポート**: GitHub Issues経由での対応や、フィードバック用メールアドレス（）が用意されています。 ## **11. エコシステムと連携** ### **11.1 API・外部サービス連携** * **API**: 内部的にはGoogle Cloud APIs（Cloud Run, GKE, Cloud Trace等）およびGemini APIを利用します。 * **外部サービス連携**: Gemini CLI, Claude Code, Codex などの主要AIコーディングアシスタントとシームレスに連携。 ### **11.2 技術スタックとの相性** | 技術スタック | 相性 | メリット・推奨理由 | 懸念点・注意点 | |:---|:---:|:---|:---| | **Python** | ◎ | ベースとなるADKの主要言語。公式に完全にサポートされている | 特になし | | **Google Cloud (Cloud Run / GKE)** | ◎ | 公式デプロイメントターゲット | 他のクラウド（AWS/Azure）へのデプロイは非推奨 | ## **12. セキュリティとコンプライアンス** * **データ管理**: インフラはユーザー自身のGoogle Cloudプロジェクト内にデプロイされ、リソースの管理責任はユーザーに帰属します。 * **準拠規格**: （CLIツール自体の直接的な規格というより、デプロイ先のGoogle Cloudのコンプライアンス基準に依存します） ## **13. 操作性 (UI/UX) と学習コスト** * **UI/UX**: 一般的なコマンドラインインターフェースとして動作し、コーディングエージェントからの直接利用を想定しているため、人間が複雑な引数を覚える負担は大きく軽減されます。 * **学習コスト**: ADKやGoogle Cloudの仕様を学ぶ必要がなく、プロンプトで指示するだけで開発が進められるため、クラウド構築の学習コストは低く抑えられます。 ## **14. ベストプラクティス** * **効果的な活用法 (Modern Practices)**: * 既存のプロジェクトに対して `agents-cli scaffold enhance` コマンドを実行し、CI/CDやデプロイ機能、RAG構成を後から安全に追加する。 * クラウドデプロイ前に、`agents-cli eval run` を活用してローカルでのエージェント評価を徹底する。 * **陥りやすい罠 (Antipatterns)**: * エージェントデプロイ時に必要なGoogle Cloudの権限やプロジェクト設定が不足していると、CLIやコーディングアシスタント側でエラーとなり解決が難航することがあります。 ## **15. ユーザーの声（レビュー分析）** * **調査対象**: GitHub * **総合評価**: GitHubスター数 900以上 (2026年時点) * **ポジティブな評価**: * コーディングエージェントに直接スキルを追加できる仕組みが斬新で便利。 * Google Cloudへのエージェントデプロイが劇的に簡単になる。 * **ネガティブな評価 / 改善要望**: * 初期リリース段階（プレビュー）のため、機能やサポート面での発展途上な部分がある。 ## **16. 直近半年のアップデート情報** * **2026-09-22**: Release v1.7.0 * Live（音声）エージェントが `run` および `eval` で動作可能に（`--mode adk_live`）。 * ローカルサーバーに対するA2Aモード（`--mode a2a`）のサポートを追加。 * `agents-cli deploy` におけるCloud Run Ingress設定（`--ingress`）などのオプション強化、シンボリックリンクの修正等。 * **2026-09-16**: Release v1.6.1 * ADK Go が誰でも利用可能に（Preview）。Pythonと同等のツールチェーンを提供。 * `google-adk` のバージョンを2.9.0未満に固定。 * scaffold コマンドのデフォルトモデルを `gemini-3.8-flash` に変更。 * **2026-09-01**: Release v1.5.0 * カスタムコマンドとアドオンテンプレートによる拡張システム（LangChainテンプレート対応）を追加。 * インフラ設定の確認用 `agents-cli infra show` や、更新専用の `--update-only` 等を `deploy` に追加。 (出典: [製品アップデート情報 - GitHub Releases](https://github.com/google/agents-cli/releases)) ## **17. 類似ツールとの比較** ### **17.1 機能比較表 (星取表)** | 機能カテゴリ | 機能項目 | agents-cli | cli-anything | GitHub Copilot CLI | |:---:|:---|:---:|:---:|:---:| | **基本機能** | クラウドデプロイ自動化 | ◎
Google Cloudのエージェント専用 | ×
非対応 | ×
非対応 | | **カテゴリ特定** | AIアシスタントへのスキル提供 | ◎
専用スキル追加に対応 | ×
非対応 | ×
非対応 | | **カテゴリ特定** | エージェント評価(Eval)の統合 | ◯
コマンドで実行可 | ×
非対応 | ×
非対応 | | **汎用性** | 任意のCLIタスク実行 | △
エージェント開発に特化 | ◎
自然言語で汎用コマンド実行 | ◯
主にコマンド生成と説明 | | **非機能要件** | 日本語対応 | △
ドキュメントは英語主体 | ◎
日本語プロンプト対応 | ◯
一部日本語対応 | ### **17.2 詳細比較** | ツール名 | 特徴 | 強み | 弱み | 選択肢となるケース | |---------|------|------|------|------------------| | **agents-cli** | AIアシスタントにGCPの知識を付与するCLI | 既存のコーディングAIを拡張しGCP特化にできる | 対象がGoogle CloudベースのADKエージェントに限定される | GCPで本格的なエージェントを構築・デプロイしたい場合 | | **cli-anything** | 自然言語でCLI操作を行う汎用ツール | 任意のコマンドを自然言語から生成・実行できる | デプロイやインフラ管理に特化した機能はない | 日常的なコマンドライン作業をAI化したい場合 | | **GitHub Copilot CLI** | Copilotのターミナル向け機能 | Gitコマンドやシェルコマンドの提案・説明に優れる | エージェントプロジェクトのScaffoldやデプロイは対象外 | ターミナルでの開発作業をCopilotで支援したい場合 | ## **18. 総評** * **総合的な評価**: agents-cliは、LLMを用いたエージェント開発において、インフラやデプロイ周りの煩雑な作業を普段使いのAIコーディングアシスタントに丸投げできるようにする非常に優れたユーティリティです。 * **推奨されるチームやプロジェクト**: Google Cloudを基盤とし、GeminiモデルやADK（Agent Development Kit）を用いたエンタープライズグレードのAIエージェントを開発しているチーム。 * **選択時のポイント**: ゼロからエージェント基盤を構築するよりも、GCPのエコシステム（Agent Runtime, Cloud Run, Cloud Trace）を活用して素早く本番稼働させたいケースに最適です。