ADK インフラエキスパート
概要
Vertex AI ADK の本番環境グレードのインフラストラクチャを Terraform を使用してプロビジョニングします。セキュアなネットワーキング、最小権限の IAM、Agent Engine ランタイム、コード実行サンドボックスのデフォルト設定、Memory Bank 構成を実現します。このスキルを使用して、エンタープライズセキュリティ制約(必要に応じて VPC Service Controls を含む)に準拠した Terraform モジュールとデプロイメントチェックリストを生成・検証します。
前提条件
このスキルを使用する前に、以下を確認してください。
- 請求先が有効になっている Google Cloud プロジェクト
- Terraform 1.0+ がインストールされていること
- gcloud CLI が適切な権限で認証されていること
- ターゲットプロジェクトで Vertex AI API が有効になっていること
- VPC Service Controls アクセスポリシーが作成されていること(エンタープライズ向け)
- Agent Engine のアーキテクチャと要件に関する理解
手順
- Terraform の初期化: リモートステートストレージ用のバックエンドをセットアップ
- 変数の設定: project_id、region、エージェント設定を定義
- VPC のプロビジョニング: Private Service Connect を使用したネットワークインフラを作成
- IAM のセットアップ: 最小権限のロールを持つサービスアカウントを作成
- Agent Engine のデプロイ: コード実行とメモリバンクを使用してランタイムを構成
- VPC-SC の有効化: データ流出防止用のサービス境界を適用
- モニタリングの構成: Cloud Monitoring ダッシュボードとアラートを設定
- デプロイの検証: エージェントエンドポイントをテストし、すべてのコンポーネントを確認
出力
- プロジェクトに適用された設定ファイルまたはコード変更
- 正しい実装を確認する検証レポート
- 行われた変更とその根拠の要約
出力形式の仕様については、Terraform 実装の詳細 を参照してください。
エラーハンドリング
包括的なエラーハンドリングについては、${CLAUDE_SKILL_DIR}/references/errors.md を参照してください。
例
詳細な例については、${CLAUDE_SKILL_DIR}/references/examples.md を参照してください。
リソース
- Agent Engine: https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview
- VPC-SC: https://cloud.google.com/vpc-service-controls/docs
- Terraform Google Provider: https://registry.terraform.io/providers/hashicorp/google/latest
- ${CLAUDE_SKILL_DIR}/examples/ にある ADK Terraform の例