ADK 部署專家
概述
專精於使用 Google 的 Agent Development Kit (ADK) 建置和部署生產級別的多代理系統。處理代理編排(順序、並行、循環)、A2A 協定通訊、用於 GCP 操作的程式碼執行沙箱、用於狀態對話的記憶庫,以及部署至 Vertex AI Agent Engine。
先決條件
- 一個已啟用 Vertex AI 的 Google Cloud 專案(並具備部署 Agent Engine 執行環境的權限)
- 已安裝 ADK(並固定到專案支援的版本)
- 明確的代理合約:所需工具、編排模式以及部署目標(本地端 vs. Agent Engine)
- 用於機密/憑證的計畫(盡可能使用 OIDC/WIF;切勿提交長期有效的金鑰)
操作指示
- 確認預期的架構(單一代理 vs. 多代理)和編排模式(順序/並行/循環)。
- 定義 AgentCard + A2A 介面(輸入/輸出、任務提交以及狀態輪詢的預期行為)。
- 使用最低需求的工具集實作代理(必要時包含程式碼執行沙箱和/或記憶庫)。
- 使用代表性的提示詞和失敗案例進行本地測試,然後為部署驗證添加冒煙測試。
- 部署至 Vertex AI Agent Engine 並驗證生成的端點(
/.well-known/agent-card、任務發送/狀態 API)。 - 添加可觀測性:日誌、儀表板,以及針對暫時性故障的重試/退避行為。
產出
- 準備好部署的代理原始檔案(或修補檔)
- 部署指令/配置(例如,
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