agents-cli v1.0.0徹底解説 — Google公式CLIでClaude CodeやCursor対応のAIエージェントを即作成・評価・Cloud Runデプロイ

Googleが提供するagents-cli v1.0.0は、AIエージェントの開発ライフサイクル全体を1つのCLIでカバーするツールです。ローカルでの作成から評価、本番環境へのデプロイまでをシームレスに繋ぎ、Claude CodeやCursorなどのコーディングエージェントが直接操作できるmachine-readableインターフェースを提供します。

📑目次

1. agents-cliとは？Googleが提供するAgent Development Lifecycle統一ツール
2. インストールと初期セットアップ
3. エージェント作成からローカル評価までのワークフロー
4. 本番デプロイとCloud Run / Agent Runtimeへの公開
5. 実際のユースケースと注意点
6. agents-cliと既存ツールの比較
7. よくある質問（FAQ）
8. まとめ

---

agents-cliとは？Googleが提供するAgent Development Lifecycle統一ツール

AIエージェント開発では、ローカルでのプロトタイプ作成と本番デプロイの間で大きなギャップが生じやすいです。agents-cliはGoogle CloudのAgent Platformと連携し、この断片化を解消します。公式のGoogle Developers Blogによると、coding agent向けに設計された専用CLIとして位置づけられています。詳細は公式ドキュメントで確認できます。

---

インストールと初期セットアップ

インストールはuvxコマンド1つで完了します。以下の手順で始められます。

uvx google-agents-cli setup

Agent ModeはClaude CodeやCursorなどのAIエージェントが直接利用するモードで、Human Modeは開発者がターミナルから直接操作するモードです。skillsの注入もこのCLIから簡単に行えます。公式GitHubリポジトリ（https://github.com/google/agents-cli）から最新情報を入手してください。

---

エージェント作成からローカル評価までのワークフロー

エージェントの作成はcreateコマンドでシンプルです。

agents-cli create finance-agent -y --deployment-target agent_runtime

作成後、eval runやeval compareコマンドでローカル評価を実行できます。比較機能により、複数のエージェントを並行して評価し、指標に基づいた改善が可能です。具体的な評価ハーネスは公式ブログで紹介されています。

---

本番デプロイとCloud Run / Agent Runtimeへの公開

本番環境への移行もワンコマンドで可能です。

agents-cli infra single-project
agents-cli deploy
agents-cli publish gemini-enterprise

Cloud RunやAgent Runtimeへのデプロイを自動化し、CI/CDパイプラインとの統合も容易です。Google Cloudの既存プロジェクトとの互換性も高いのが特徴です。

---

実際のユースケースと注意点

旅行経費精算エージェントの例では、Human Intentと組み合わせることで実務的なワークフローを構築できます。ただし、制限事項として特定のユースケースに最適化されている点を理解する必要があります。公式ソースを参照し、最新の対応状況を確認してください。

---

agents-cliと既存ツールの比較

項目	agents-cli	従来のGCP CLI / SDK	利点
エージェント向け設計	専用	汎用	coding agentが直接操作可能
評価機能	組み込み	別途構築必要	即時比較可能
デプロイ	ワンコマンド	複数ステップ	時間短縮
サポート対象	Claude Code / Cursor	手動	AI開発者向け最適化

出典: Google Developers Blog（2026年4月時点）

---

よくある質問（FAQ）

Q: agents

cliは無料で使えますか？ A: 基本機能はオープンソースで無料利用可能です。Google Cloudの従量課金は別途発生します。

Q: Claude CodeやCursor以外でも使えますか？

Gemini CLIなど他のコーディングエージェントにも対応しています。詳細は公式ドキュメントを確認してください。

Q: ローカル評価の精度はどの程度ですか？

組み込みの評価ハーネスにより、信頼性の高い比較が可能です。実際の運用結果に基づいて改善を繰り返せます。

Q: Cloud Run以外のデプロイ先は対応していますか？

Agent RuntimeやGemini Enterpriseへのpublishにも対応しています。

Q: 既存のGCPプロジェクトとの互換性はありますか？

single-projectモードで既存プロジェクトに統合可能です。

Q: エラーが出た場合のトラブルシューティングは？

公式GitHubのIssuesやドキュメントを参照し、Human Modeでのデバッグをおすすめします。

---

関連記事:

• Google Agent Development Kit (ADK) オープンソース公開 — 生産グレード multi-agent 構築フレームワーク
• Google Gemini Managed Agents API GA — マネージドsandboxで単一APIコールによるagent実行を実現
• GoogleがDiffusionGemmaを発表：テキスト拡散で最大4倍高速なローカル生成へ

まとめ

agents-cliはAIエージェント開発の効率を大幅に向上させるツールです。インストールからデプロイまでの一貫したワークフローを体験してみてください。公式リポジトリとブログを活用して、最新情報を常に確認しましょう。

関連する新しい記事:

• GeminiとObsidianの連携でDeep Researchを効率化する方法 – This published update adds current operational context for agents-cli v1.0.0徹底解説 — Google公式CLIでClaude CodeやCursor対応のAIエージェントを即作成・評価・Cloud Runデプロイ.