Especialista em Infraestrutura ADK
Visão Geral
Provisione infraestrutura ADK do Vertex AI de nível de produção com Terraform: rede segura, IAM com privilégios mínimos, runtime do Agent Engine, padrões de sandbox de execução de código e configuração do Memory Bank. Use essa skill para gerar/validar módulos Terraform e um checklist de implantação que atenda às restrições de segurança empresarial (incluindo VPC Service Controls quando necessário).
Pré-requisitos
Antes de usar esta skill, certifique-se de:
- Projeto Google Cloud com faturamento ativado
- Terraform 1.0+ instalado
- CLI gcloud autenticada com permissões apropriadas
- API Vertex AI ativada no projeto de destino
- Política de acesso do VPC Service Controls criada (para ambiente empresarial)
- Compreensão da arquitetura e requisitos do Agent Engine
Instruções
- Inicializar o Terraform: Configure o backend para armazenamento remoto de estado
- Configurar Variáveis: Defina project_id, region, configuração do agente
- Provisionar VPC: Crie a infraestrutura de rede com Private Service Connect
- Configurar IAM: Crie contas de serviço com papéis de privilégios mínimos
- Implantar Agent Engine: Configure o runtime com execução de código e memory bank
- Habilitar VPC-SC: Aplique o perímetro de serviço para proteção contra exfiltração de dados
- Configurar Monitoramento: Configure painéis e alertas do Cloud Monitoring
- Validar a Implantação: Teste o endpoint do agente e verifique todos os componentes
Saída
- Arquivos de configuração ou alterações de código aplicados ao projeto
- Relatório de validação confirmando a implementação correta
- Resumo das alterações realizadas e sua justificativa
Consulte Detalhes de implementação do Terraform para especificações de formato da saída.
Tratamento de Erros
Consulte ${CLAUDE_SKILL_DIR}/references/errors.md para tratamento abrangente de erros.
Exemplos
Consulte ${CLAUDE_SKILL_DIR}/references/examples.md para exemplos detalhados.
Recursos
- Agent Engine: https://cloud.google.com/vertex-ai/generative-ai/docs/agent-engine/overview
- VPC-SC: https://cloud.google.com/vpc-service-controls/docs
- Provedor Google do Terraform: https://registry.terraform.io/providers/hashicorp/google/latest
- Exemplos Terraform ADK em ${CLAUDE_SKILL_DIR}/examples/