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、agent 配置
- 配置 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/