google/agents-cli
The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.
agents‑cli とは？
agents‑cli は、Google の Gemini プラットフォーム上で実行される AI エージェントを構築、テスト、デプロイするのに役立つコマンドラインツール（および AI 搭載コーディングアシスタントに追加できる「スキル」のセット）です。低レベルの Agent Development Kit (ADK) と Google Cloud サービスをラップしているため、複数の個別 CLI を手動で組み合わせる必要はありません。
対象ユーザー
- 開発者：「エージェント」アプリケーション（ツールを呼び出したり、状態を維持したりできる LLM ベースのボット）を作成し、Google Cloud で実行したい方。
- コーディングアシスタント：Antigravity CLI、Claude Code、OpenAI Codex など。このツールは スキル としてインストールでき、それらのアシスタントが適切なコマンドを代わりに発行できるようになります。
- エージェントプロジェクト（スキャフォールディング、評価、デプロイ、可観測性）に再現可能で CI/CD 対応のワークフローを必要とするチーム。
コア機能（README の説明による）
| 領域 | 提供される機能 |
|---|---|
| スキャフォールディング | agents-cli create <name> は、ADK 互換のレイアウトで新しいプロジェクトを作成します。scaffold enhance は既存のリポジトリにデプロイまたは CI/CD を追加し、upgrade はプロジェクトを最新の CLI バージョンにアップグレードします。 |
| 開発ヘルパー | run "prompt" でエージェントをローカルで呼び出し、install で依存関係を解決し、lint で Ruff を実行してコード品質をチェックします。 |
| 評価スイート | agents-cli eval … の下のコマンドで、推論トレースの生成、組み込みメトリクスによる評価、マルチターンシナリオの合成、実行の比較、失敗モードのクラスタリング、プロンプトの自動調整（optimize）が可能です。 |
| デプロイと公開 | deploy はエージェントを Google Cloud（Cloud Run、GKE、または Gemini マネージドランタイム）にプッシュします。publish gemini は Gemini プラットフォームにエージェントを登録します。インフラストラクチャヘルパー（infra single-project、infra cicd）は必要な Google Cloud リソースを設定します。 |
| 可観測性 | Cloud Trace、Cloud Logging、およびサードパーティのモニタリングとの統合は、observability スキルを介して組み込まれています。 |
| 認証 | agents-cli login は Google Cloud または AI Studio で認証します。login --status は現在のトークンを表示します。 |
| テレメトリ制御 | デフォルトでは、最小限の使用ログが自分の Google Cloud プロジェクトに送信されます。AGENTS_CLI_TELEMETRY=0 または DO_NOT_TRACK=1 で無効にできます。 |
内部の仕組み
- ADK Python API – CLI は Agent Development Kit を使用するコードを生成します。これにより、エージェント、ツール、コールバック、状態処理が定義されます。
- Gemini プラットフォーム –
deployまたはpublishすると、CLI は Gemini 上に Agent Runtime をプロビジョニングするか、標準の Cloud Run / GKE サービスをプロビジョニングし、IAM、シークレット、CI/CD パイプラインを処理します。 - 評価フレームワーク – 組み込みのデータセット形式と「LLM アズジャッジ」評価システムにより、品質（例：正確性、関連性）を測定し、結果をプロンプト最適化にフィードバックできます。
- スキルレイヤー – 同じコマンドが スキル として公開され、外部コーディングエージェントにインストールできます（
npx skills add google/agents-cliを使用）。それらのエージェントは、代わりに CLI コマンドを発行できます。
はじめに（クイック概要）
- 前提条件 – Python 3.11+、
uv（高速 Python パッケージマネージャー）、Node.js。 - インストール –
uvx google-agents-cli setup（またはnpx skills add google/agents-cliでコーディングエージェントにスキルを追加）。 - プロジェクトを作成 –
agents-cli create my‑agent。 - 反復 – プロンプトを実行し、lint し、ローカルで評価します。
- デプロイ –
agents-cli deployで Google Cloud にプッシュし、agents-cli publish geminiで登録します。
重要性
- エンドツーエンドのワークフロー – ADK、Cloud Run、GKE、ログ設定を手動で組み合わせる必要がなくなります。
- エージェント中心の評価 – マルチターンテストとプロンプトチューニングのための既製フレームワークを提供します。これは一般的な LLM ツールキットには欠けていることがよくあります。
- コーディングアシスタントとの統合 – スキルモデルにより、AI 駆動の IDE ヘルパーがエージェントプロジェクトの「オペレーター」になり、開発者エクスペリエンスを合理化できます。
詳細情報
- 完全なドキュメントサイト：https://google.github.io/agents-cli/
- クイックスタートチュートリアル：https://google.github.io/agents-cli/guide/quickstart-tutorial/
- リリースノート、問題トラッカー、PyPI パッケージは README にリンクされています。
上記のすべての情報はリポジトリの README から直接取得したものであり、追加機能は想定されていません。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト