用途:在需要以 Terraform 配置 Vertex AI ADK 基础设施时使用,触发语如“deploy ADK terraform”“agent engine infrastructure”。目标是生成并校验 Terraform 模块与部署清单,满足企业安全约束(必要时含 VPC Service Controls)。
主要能力:配置安全网络、最小权限 IAM、Agent Engine 运行时、Code Execution 沙箱默认值与 Memory Bank;输出配置或代码变更、验证报告及变更摘要与理由。
使用方式(步骤):1) 初始化 Terraform,设置远程状态存储后端;2) 配置变量,定义 project_id、region、agent 配置;3) 配置 VPC,使用 Private Service Connect 创建网络;4) 设置 IAM,创建带最小权限角色的服务账号;5) 部署 Agent Engine,配置运行时、代码执行与 Memory Bank;6) 启用 VPC-SC,应用服务边界防数据外泄;7) 配置 Cloud Monitoring 仪表盘与告警;8) 验证部署,测试 agent 端点并核对组件。
前置条件:已启用计费的 Google Cloud 项目;Terraform 1.0+;已认证且权限足够的 gcloud CLI;目标项目已启用 Vertex AI API;企业场景需已创建 VPC Service Controls 访问策略;了解 Agent Engine 架构与要求。
限制与说明:错误处理见 ${CLAUDE_SKILL_DIR}/references/errors.md,示例见 ${CLAUDE_SKILL_DIR}/references/examples.md,ADK Terraform 示例位于 ${CLAUDE_SKILL_DIR}/examples/。参考资源: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。具体收费、价格与效果暂未提供。