1. Introdução
As habilidades de agentes são um formato leve e aberto para estender os recursos de agentes de IA com conhecimento e fluxos de trabalho especializados. MCP é um padrão para conectar aplicativos de IA a sistemas externos.
A especificação de plug-ins de agente é uma especificação aberta e independente de fornecedor para empacotar habilidades de agentes e servidores MCP em plug-ins portáteis.
Os plug-ins do Google Cloud para agentes de programação de IA empacotam habilidades relevantes do Google Cloud e servidores MCP em pacotes instaláveis para agentes de IA mais eficazes no Google Cloud.
Neste codelab, você vai aprender mais sobre um desses plug-ins, o plug-in para desenvolvedores do Google Cloud, e como instalar e usar esse plug-in no Antigravity.
Atividades deste laboratório
- Entender os plug-ins de agente.
- Instalar e conhecer o plug-in para desenvolvedores do Google Cloud no Antigravity.
- Testar habilidades e servidores MCP instalados pelo plug-in para desenvolvedores do Google Cloud com alguns comandos.
O que é necessário
- Um navegador da Web, como o Chrome.
- Um projeto do Google Cloud.
- O Antigravity e a CLI do Antigravity instalados na sua máquina local.
2. Conheça os plug-ins de agente
Os plug-ins de agente são um formato de pacote portátil para agrupar habilidades de agentes e servidores MCP em um diretório como este:
my-plugin/
├── plugin.json
├── skills/
│ └── my-skill/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
plugin.jsonidentifica o plug-in.skills/contém habilidades de agentes.mcp.jsondescreve os servidores MCP.- Os namespaces de extensão de domínio reverso permitem que clientes individuais adicionem um comportamento personalizado.
O repositório de habilidades de agentes do Google contém habilidades de agentes para produtos e tecnologias do Google, incluindo o Google Cloud. Ele também contém plug-ins que agrupam habilidades de agentes e servidores MCP em pacotes instaláveis, como o plug-in para desenvolvedores do Google Cloud.
O **plug-in para desenvolvedores do Google Cloud** oferece orientações do Google Cloud para agentes de programação: integração do primeiro projeto, autenticação e seleção de credenciais e validação de segurança crítica para comandos da CLI gcloud. Inclui o servidor MCP de conhecimento do Google Developers para documentação atualizada e baseada do Google Cloud.
3. Instalar o plug-in para desenvolvedores do Google Cloud
A CLI do Antigravity é a maneira mais fácil de instalar plug-ins de agente para todo o ecossistema do Antigravity (Antigravity, CLI do Antigravity, IDE do Antigravity).
Vamos instalar o plug-in para desenvolvedores do Google Cloud na CLI do Antigravity apontando para o caminho dele:
agy plugin install google-cloud-developer
O plug-in instalado vai aparecer no Antigravity Marketplace :
Installed plugin "google-cloud-developer" from antigravity-plugins-official
4. Conheça o plug-in para desenvolvedores do Google Cloud
Agora, vamos conhecer o plug-in para desenvolvedores do Google Cloud.
Primeiro, verifique se o plug-in está listado na CLI do Antigravity:
agy plugin list
O plug-in vai aparecer com algumas habilidades, uma regra e um servidor MCP:
...
- google-cloud-developer (enabled, 1.1.10)
Source: antigravity-plugins-official
Components: 5 skills, 1 rule, 1 MCP server
...
A CLI do Antigravity instala plug-ins globalmente na pasta .gemini/config/plugins/. Isso significa que o plug-in está disponível para o Antigravity, a CLI do Antigravity e o IDE do Antigravity.
Na pasta .gemini/config/plugins/google-cloud-developer, você vai encontrar o plug-in para desenvolvedores do Google Cloud com o arquivo de manifesto do plug-in, habilidades e um servidor MCP:
google-cloud-developer/
├── ...
├── skills/
│ ├── finding-google-skills/
│ ├── gcloud/
│ ├── google-cloud-recipe-auth/
│ ├── google-cloud-recipe-onboarding/
│ └── retrieving-developer-knowledge/
├── mcp.json
└── plugin.json
Você vai encontrar habilidades na integração do primeiro projeto, autenticação e seleção de credenciais e validação de segurança crítica para comandos da CLI gcloud. Ele também inclui o servidor MCP do Google Developers Knowledge para documentação atualizada e baseada do Google Cloud.
Você também pode mudar para o Antigravity (app independente) e perguntar em um chat quais habilidades estão instaladas:
Which Google Cloud skills are available?
Ele vai listar as habilidades integradas do Antigravity, mas também as habilidades do plug-in para desenvolvedores do Google Cloud:
### Bundled Google Cloud Skills
• **`finding-google-skills`**: Guides Google Cloud architectural choices, service trade-offs, and dynamically retrieves specialized skills on demand from the
official Google skill catalog.
• **`gcloud`**: Provides validation, safety guardrails, syntax checks, and data reduction for executing or planning gcloud CLI commands.
• **`google-cloud-recipe-auth`**: Guidance on IAM, authentication, authorization, service accounts, and Application Default Credentials (ADC).
• **`google-cloud-recipe-onboarding`**: Guides initial Google Cloud project creation, billing configuration, and deploying a first resource.
• **`retrieving-developer-knowledge`**: Searches and synthesizes official Google Cloud, Firebase, and developer platform documentation.
──────
### On-Demand Catalog Skills
Through finding-google-skills, additional specialized skills from the Google Cloud skills catalog https://github.com/google/skills/tree/main/skills/cloud can
be fetched on demand during our session without requiring permanent installation:
• Product Basics: <product>-basics (e.g., Cloud Run, Cloud SQL, BigQuery, Spanner, Firestore, Storage)
• GKE: gke-* (networking, storage, autoscaling, troubleshooting, AI inference)
• AI & Agent Platforms: agent-platform-*, gemini-*, genkit-*
• Architecture & Frameworks: google-cloud-solution-*, google-cloud-waf-* (Well-Architected Framework)
• Observability: cloud-logging-*, cloud-monitoring-*
Além disso, acesse a guia Personalizações à esquerda. Em Instalado, você vai encontrar o plug-in para desenvolvedores do Google Cloud:
Se você clicar no plug-in, vai encontrar a lista de habilidades, servidores MCP e regras instaladas:
5. Exercitar o plug-in para desenvolvedores do Google Cloud
Ativar a API Developer Knowledge
Primeiro, verifique se a API Developer Knowledge está ativada no seu projeto na nuvem do Google Cloud. Isso é necessário para o servidor MCP de conhecimento do desenvolvedor :
- No console do Google Cloud, pesquise API Developer Knowledge.
- Na página API Developer Knowledge, clique em Ativar API.
Agora, vamos tentar alguns comandos para ver como o plug-in para desenvolvedores do Google Cloud ajuda em diferentes cenários.
Você pode tentar esses comandos no Antigravity ou na CLI do Antigravity, já que o plug-in está disponível globalmente.
Integração
Se você é novo no Google Cloud, comece fazendo uma pergunta básica de integração:
I'm new to Google Cloud. How can I create a new project with billing enabled?
A habilidade google-cloud-recipe-onboarding vai ser ativada:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-onboarding/SKILL.md
Você vai receber uma resposta com instruções detalhadas:
To get started with Google Cloud, you will need an active Google Cloud account and an authorized terminal session:
Google Cloud Account & Console: If you haven't already, sign up and access the Google Cloud Console where you can manage accounts, projects, and set up a Cloud Billing account (new accounts are eligible for the $300 Free Trial).
...
Autenticação
Tente fazer perguntas sobre autenticação:
How can I authenticate my local machine with Google Cloud?
A habilidade google-cloud-recipe-auth vai ser ativada:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-auth/SKILL.md
Você vai receber comandos para autenticar:
To authenticate your local machine with Google Cloud, there are two primary methods depending on whether you want to use the CLI or run code/client libraries locally:
1. Authenticate the CLI (gcloud)
Use this to run gcloud, bq, and gsutil management commands in your terminal:
bash
gcloud auth login
This opens a web browser asking you to log in with your Google Account and grant permissions.
If you are on a remote server without a web browser, use:
bash
...
Conhecimento do desenvolvedor
Você também pode fazer perguntas para serem respondidas na documentação oficial.
Exemplo:
What's the difference between Cloud Run and GKE according to the official docs?
A habilidade relevante ativada vai usar o servidor MCP developer-knowledge:
Exploring 2 files ˅
* Analyzed retrieving-developer-knowledge/SKILL.md
* Analyzed answer_query.json
MCP Tool: developer-knowledge / answer_query ˅
Tool arguments
```json
{
"query": "What is the difference between Cloud Run and Google Kubernetes Engine (GKE) according to official Google Cloud documentation?"
}
Encontrar outras Google Skills
Por último, mas não menos importante, o plug-in para desenvolvedores do Google Cloud pode descobrir e carregar habilidades sob demanda.
Por exemplo, você pode perguntar:
Explain what steps are needed to start working with Firebase.
A habilidade finding-google-skills vai ser ativada, e ela vai encontrar e instalar a habilidade relevante do Firebase:
Explored 1 file ˅
* Analyzed finding-google-skills/SKILL.md
Ran `curl -sS https://raw.githubusercontent.com/google/skills/main/index.json | jq -r '.skills[ >`
Exploring 3 files, 2 searches ˅
* Reading skills catalog
* Searched firebase
* Fetching Firebase skill
6. Limpeza
Desative a API Developer Knowledge:
- No console do Google Cloud, pesquise API Developer Knowledge.
- Na página API Developer Knowledge, clique em Gerenciar e depois em Desativar API.
Desinstale o plug-in para desenvolvedores do Google Cloud com a CLI do Antigravity:
agy plugin uninstall google-cloud-developer
Uninstalled plugin "google-cloud-developer"
7. Parabéns
Parabéns! Você instalou e usou o plug-in para desenvolvedores do Google Cloud no Antigravity. Para saber mais, confira os seguintes recursos: