agents-cli 調査レポート

開発元: Google
カテゴリ: 🔌 CLI拡張/プロキシ
公式サイト GitHub DeepWiki Markdown

AIコーディングエージェントにGoogle CloudでのADKエージェント構築・デプロイ機能を追加するCLIツール

総合評価
80点
基準点70点からの評価
オープンソース
OSS
無料プラン
あり
最低価格
無料
対象ユーザー
開発者
更新頻度
中
🆕 最新情報: v1.7.0でLive（音声）エージェントとA2Aモードに完全対応（2026年9月）

📋 評価の詳細

👍 加点項目

  • +5 お気に入りのコーディングエージェント（Gemini CLI, Claude Codeなど）にGoogle Cloud向けのスキルを追加できる
  • +5 開発から評価、デプロイメントまでCLIで一貫して行える

👎 減点項目

  • 0 特筆すべき減点なし
総評: 既存のAIコーディングアシスタントを活用してGoogle Cloud向けのエンタープライズ対応エージェントを構築する強力な補助ツール

親レポート

Gemini Enterprise Agent Platform 💚 無料プランあり92点企業が自社のデータに基づき、エンタープライズ対応のAIエージェントを構築、スケーリング、ガバナンス、最適化するための包括的プラットフォーム。

agents-cli 調査レポート

1. 基本情報

  • ツール名: agents-cli
  • ツールの読み方: エージェンツ・シーエルアイ
  • 開発元: Google
  • 公式サイト: https://google.github.io/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音声エージェント等とのリアルタイム通信に利用。
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

  • インストール/導入:

    # 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. サポート体制

  • ドキュメント: 公式ドキュメント
  • コミュニティ: GitHub Issuesを活用したバグ報告や機能要望のコミュニティ
  • 公式サポート: GitHub Issues経由での対応や、フィードバック用メールアドレス（agents-cli@google.com）が用意されています。

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)

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）を活用して素早く本番稼働させたいケースに最適です。