ADK デプロイメントスペシャリスト

ADK デプロイメントスペシャリスト は何をしますか？

概要

GoogleのAgent Development Kit（ADK）を使用して本番向けマルチエージェントシステムを構築およびデプロイする専門家です。エージェントオーケストレーション（Sequential、Parallel、Loop）、A2Aプロトコル通信、GCP操作用のCode Execution Sandbox、ステートフルな会話のためのメモリバンク、およびVertex AI Agent Engineへのデプロイメントを処理します。

前提条件

• Vertex AIが有効化されたGoogle Cloudプロジェクト（Agent Engineランタイムをデプロイする権限が必要）
• ADKがインストールされていること（プロジェクトのサポート対象バージョンに固定）
• 明確なエージェント契約：必要なツール、オーケストレーションパターン、デプロイ先（ローカルまたはAgent Engine）
• シークレット/認証情報の計画（可能な限りOIDC/WIFを使用し、長期有効なキーは決してコミットしない）

手順

1. 望ましいアーキテクチャ（単一エージェントまたはマルチエージェント）とオーケストレーションパターン（Sequential/Parallel/Loop）を確認する。
2. AgentCard + A2Aインターフェース（入力/出力、タスク送信、ステータスポーリングの期待値）を定義する。
3. 最小限のツールサーフェス（必要に応じてCode Execution Sandboxやメモリバンク）を使用してエージェントを実装する。
4. 代表的なプロンプトと障害ケースを使用してローカルでテストし、デプロイ確認用のスモークテストを追加する。
5. Vertex AI Agent Engineにデプロイし、生成されたエンドポイント（/.well-known/agent-card、タスク送信/ステータスAPI）を検証する。
6. 可観測性を追加する：ログ、ダッシュボード、および一時的な障害に対するリトライ/バックオフ動作。

出力

• デプロイ準備が整ったエージェントソースファイル（またはパッチ）
• デプロイコマンド/設定（例：adk deploy 呼び出しと必要なフラグ）
• Agent Engineエンドポイント（AgentCard + タスクAPI）とセキュリティ体制の検証チェックリスト

エラーハンドリング

包括的なエラーハンドリングについては、${CLAUDE_SKILL_DIR}/references/errors.md を参照してください。

例

詳細な例については、${CLAUDE_SKILL_DIR}/references/examples.md を参照してください。

リソース

• ADKドキュメント：https://cloud.google.com/vertex-ai/docs/agent-engine
• Workload Identity（CI/CD）：https://cloud.google.com/iam/docs/workload-identity-federation
• A2A / AgentCardパターン：000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md