11月13日、Google CloudエンジニアのDenise Kwanが「Build Custom AI Agents with Agents CLI and Claude Code」と題した記事を公開した。Google CloudのAgents CLIとAnthropicのClaude Codeを組み合わせ、カスタムAIエージェントをGCP上に構築・デプロイする手順を詳しく紹介している。
汎用のAIエージェントは「だいたい動く」が、自分のワークフローには合わない——そういう不満を持つエンジニアは多い。本記事が示すのは、その課題に対する一つの実践的な回答だ。自然言語でエージェントの仕様を書くだけで、コード生成・テスト・クラウドデプロイまでが一気通貫で完了する。
プロンプト1本でエージェントがデプロイされる流れ
記事の核心から先に紹介する。セットアップ済みの環境でClaude Codeを起動し、以下のような自然言語プロンプトを入力するだけでよい。
Build a customer support agent for our online outdoor gear store.
It should answer questions using our help center docs, look up order status
using a mock orders API, and process returns, but ask a human to approve
any refund over $100. Never share another customer's order info. Include
a few evals and deploy it to Google Cloud.
このプロンプトを受けたClaude Codeは、以下の一連の作業を自動で実行する。
- プロジェクト構成の生成:ADKのプロジェクト構造を自動でスキャフォールド
- エージェントのコード生成:注文照会ツール・モックAPIの実装、ビジネスルール(100ドル超の払い戻しは人間の承認が必要、他顧客の情報は非公開)の組み込みをPythonコードで実装
- テストの実行:サンプルテストケースを生成し、ツール呼び出しとルール遵守を検証
- GCPへのデプロイ:テスト通過後、インフラをプロビジョニングしてクラウドにデプロイ
評価(eval)の仕組みやクラウドインフラの設定を自分でゼロから組む必要がない点が最大のポイントだ。途中でClaude Codeがコマンド実行の確認を求めることがあるが、推奨オプションを選んで進めるだけでよい。
デプロイ後の動作確認も自然言語で指示できる。
Send a test message to the deployed agent to check an order status
and request a return for an item over $100.
検証が終わったら、課金が発生しないようリソース削除も忘れずに。
Clean up and delete the deployed agent from Google Cloud.
Agents CLIとADKの位置づけ
この仕組みを支えるのが**Agents CLIだ。AIエージェントのビルド・テスト・デプロイ・監視・管理を一貫して行えるCLIツールで、Google Agent Development Kit(ADK)上に構築されている。ADKはGoogleが提供するエージェント開発フレームワークであり、Agents CLIはそのADKをより手軽に扱うためのインターフェース層に相当する。デプロイ先となるVertex AI Agent Engine**はGCP上のマネージドなエージェント実行基盤で、スケーリングや監視といったインフラ管理をGoogleが担う。
なお、記事公開時点におけるAgents CLIのプレビュー/GA(一般提供)ステータスについては元記事に明示的な記載がないため、導入前に公式ドキュメントで最新状況を確認することを推奨する。
またClaude Codeとの連携は、/skills コマンドによってAgents CLIのスキルセットをClaude Codeに読み込ませることで実現している。この仕組みにより、Claude Codeは単なるコード生成ツールではなく、Agents CLIのオペレーターとして機能する。
セットアップ:インストールもClaude Codeに任せられる
Agents CLIのインストールには2通りの方法がある。
Claude Codeに任せる場合:
# ターミナルでClaude Codeを起動
claude
# Claude Codeのプロンプトに入力
Install Google Agents CLI, and install Google Cloud CLI if it isn't already installed.
手動でインストールする場合:
uvx google-agents-cli setup
その後、Google Cloud CLIの認証(ADC: Application Default Credentials)を通す必要がある。
gcloud auth login --update-adc
gcloud config set project YOUR_PROJECT_ID
ハルシネーション削減とトークン節約という設計思想
記事中で言及されている重要な観点として、カスタムエージェントはハルシネーションの低減とトークン使用量の削減に寄与するという点がある。汎用エージェントは広い知識を扱うためにコンテキストが膨らみがちだが、特定のワークフローや知識ベースに絞ったエージェントはその無駄を省けるという考え方だ。元記事では具体的な削減率などの数値は示されていないものの、設計方針としての根拠はこの「スコープの絞り込み」にある。
Agents CLIとClaude Codeの組み合わせは、こうした「用途特化型エージェント」をエンジニアが手軽に量産できる体制を整えることを狙っている。ビジネスロジックを自然言語で記述すれば、ルール遵守の実装やテストケースの生成まで自動化される点は、エージェント開発の参入障壁を大きく下げる可能性がある。
詳細はBuild Custom AI Agents with Agents CLI and Claude Codeを参照していただきたい。




