- Centralizar as funcionalidades do Google Cloud em pacotes instaláveis que suportem padrões abertos.
- Integre a documentação oficial em tempo real usando servidores MCP para evitar alucinações da IA.
- Implemente camadas de segurança e validação IAM antes de fazer alterações na infraestrutura.
- Ele oferece suporte à integração nativa com ferramentas como Claude Code, Codex e Antigravity CLI.
Se você trabalha na área de desenvolvimento e usa agentes de IA para escrever código, sabe que fazer a máquina entender exatamente como a infraestrutura de nuvem funciona pode ser um verdadeiro desafio. Até então, precisávamos fornecer documentação manual ou configurar servidores MCP remotos, mas a situação se complicava quando várias ferramentas precisavam trabalhar juntas para resolver um problema complexo. Para solucionar esse problema, o Google Cloud lançou o plugin AI Agents , uma solução que reúne habilidades e ferramentas em um único pacote instalável.
A grande vantagem desse sistema é que ele evita que os desenvolvedores precisem gerenciar dependências complexas ou configurações diferentes para cada assistente. Por ser baseado em um padrão aberto e neutro , ele permite que o agente acesse conhecimento aprofundado de produtos específicos sem sobrecarregar a janela de contexto, tornando a interação com o ecossistema do Google muito mais fluida e, sobretudo, mais eficaz em ambientes de trabalho reais .
O que exatamente é o plugin google-cloud-developer?
Este plugin é essencialmente um kit de sobrevivência para qualquer agente de IA que precise operar no Google Cloud. Seu principal objetivo é ajudar o assistente a navegar pelos fundamentos da plataforma , abordando tópicos críticos como gerenciamento de projetos, autorização, autenticação e, muito importante, a implementação de barreiras de segurança ao executar comandos da CLI do gcloud.
Um dos seus maiores trunfos é a integração com a configuração do servidor Developer Knowledge MCP. Graças a isso, o agente não inventa informações; em vez disso, ele possui uma conexão em tempo real com a documentação oficial do Google, garantindo que as respostas estejam atualizadas e não baseadas em dados desatualizados.
Tipos de plugins e como eles funcionam
O Google estruturou seu repositório de habilidades para permitir um crescimento ordenado, dividindo os recursos adicionais em dois blocos principais:
- Plugins fundamentais: Esses são os conceitos básicos para todos. Eles se concentram na configuração do projeto, no projeto arquitetônico e na capacidade de encontrar documentação relevante.
- Plugins focados em domínios: Esses são mais especializados e oferecem melhores práticas técnicas para áreas específicas dentro da nuvem do Google.
Para evitar que o agente se perca, existe um mapa de rotas chamado google-cloud-discovery.mdEsse mecanismo funciona como um guia, redirecionando o agente para funcionalidades mais avançadas (como as do GKE ou do WAF do Google Cloud) somente quando a tarefa realmente exige, otimizando assim o uso de recursos. recursos de computação de IA.
Testando o plugin: O caso de integração
Imagine que você é novo na plataforma e precisa configurar um projeto do zero com faturamento ativo e autenticação local para que seus scripts funcionem com uma identidade de serviço. Com o plugin instalado, o agente não é iniciado de forma aleatória, mas segue um processo lógico:
- Análise envolvente: O assistente verifica silenciosamente se você tem a CLI instalada e se alguma organização ou projeto já foi criado.
- Revisão de segurança: Analisar as melhores práticas em IAM para prevenir, por meio de supervisão, filtros de chave privada em um commit do Git.
- Folha de rota: Propõe um plano de ação detalhado e solicita sua permissão antes de acessar quaisquer recursos reais na nuvem.
Guia de instalação passo a passo
Dependendo da ferramenta que você usa, o processo varia um pouco, mas sempre requer a ativação do API de conhecimento do desenvolvedor usando o comando gcloud services enable developerknowledge.googleapis.com.
Para usuários da CLI do Antigravity
Esta é a opção mais direta. Basta executar o comando de instalação apontando para o caminho do repositório do GitHub: agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer.
Para a CLI do Claude Code
O processo aqui é um pouco mais detalhado. Primeiro, você adiciona o Google Marketplace e, em seguida, instala o plugin específico. Isso é essencial. gerar chave de API para a API Developer Knowledge e exporte-a para o seu terminal usando a variável de ambiente DEVELOPERKNOWLEDGE_API_KEY, de preferência adicionando-o ao seu arquivo .bashrc o .zshrc Assim você não precisa fazer isso todas as vezes.
Para Codex CLI
Assim como no caso do Claude, utiliza-se o marketplace. A diferença é que você precisa atualizar o arquivo de configuração. ~/.codex/config.toml Para adicionar o URL do servidor MCP e o cabeçalho de autenticação com sua chave de API. Não se preocupe se você vir um status de 'não conectado'É um comportamento normal que não afeta o funcionamento.
Ferramentas complementares e ambiente local
Para que tudo isso funcione da melhor forma, é fundamental ter um ambiente local bem configurado. Isso envolve a instalação do CLI gcloud, executar gcloud init para o projeto padrão e configure o Credenciais padrão do aplicativo (ADC) com gcloud auth application-default loginIsso permite que bibliotecas cliente para Java, Python ou Go se autentiquem sem complicações.
Esse ecossistema transforma a maneira como desenvolvemos na nuvem, passando de um gerenciamento manual e propenso a erros para um fluxo em que a IA tem acesso direto à documentação e às ferramentas de controle, permitindo que o programador se concentre na lógica de negócios enquanto o agente cuida da complexidade técnica da infraestrutura.