ADK 基礎架構專家
概覽
使用 Terraform 佈建生產級 Vertex AI ADK 基礎架構:安全網路、最小權限 IAM、Agent Engine 執行環境、程式碼執行沙箱預設值及 Memory Bank 配置。使用此技能來生成/驗證 Terraform 模組以及符合企業安全限制(必要時包含 VPC Service Controls)的部署檢查清單。
先決條件
使用此技能前,請確保:
- 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:配置含程式碼執行與 Memory Bank 的執行環境
- 啟用 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
- ADK Terraform 範例位於 ${CLAUDE_SKILL_DIR}/examples/