1. Introdução
As habilidades de agentes são um formato aberto e leve 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 é 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 codificaçã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 sobre um desses plug-ins, o plug-in do Google Cloud Developer, 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 do Google Cloud Developer no Antigravity.
- Testar habilidades e servidores MCP instalados pelo plug-in do Google Cloud Developer 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. Conhecer 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 do Google Cloud Developer.
O plug-in do Google Cloud Developer oferece orientações do Google Cloud para agentes de codificaçã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 desenvolvedor do Google para documentação atualizada e fundamentada do Google Cloud.
3. Instalar o plug-in do Google Cloud Developer
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 do Google Cloud Developer na CLI do Antigravity apontando para o caminho dele:
agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer
O plug-in será instalado com algumas habilidades e um servidor MCP:
Cloning plugin from https://github.com/google/skills.git...
[ok] google-cloud-developer
✔ skills : 5 processed
- agents : skipped (not found)
- commands : skipped (not found)
✔ mcpServers : 1 processed
- hooks : skipped (not found)
4. Conhecer o plug-in do Google Cloud Developer
Agora vamos conhecer o plug-in do Google Cloud Developer.
Primeiro, verifique se o plug-in está listado na CLI do Antigravity:
agy plugin list
{
"imports": [
{
"name": "google-cloud-developer",
"source": "antigravity",
"importedAt": "2026-09-04T10:41:05Z",
"components": [
"skills",
"mcpServers"
]
}
]
}
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 do Google Cloud Developer 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 de conhecimento do desenvolvedor do Google para documentação atualizada e fundamentada do Google Cloud.
Você também pode mudar para o Antigravity e perguntar em um chat quais habilidades estão instaladas:
Which skills are available?
Ele vai listar as habilidades integradas do Antigravity, mas também as habilidades do plug-in do Google Cloud Developer:
...
2. Google Cloud Developer Plugin Skills
Installed via the google-cloud-developer plugin in
~/.gemini/config/plugins/google-cloud-developer/skills/:
finding-google-skills: Dynamically locates and loads specialized Google product skills on-demand from the remote catalog index (e.g., GKE, BigQuery, Vertex AI, Firebase).
gcloud: Validation guardrails, syntax rules, and data reduction for executing gcloud CLI commands safely.
google-cloud-recipe-auth: Guidance on authentication and authorization patterns (ADC, service accounts, IAM, and workload identity).
google-cloud-recipe-onboarding: Step-by-step walkthrough for onboarding new Google Cloud projects, billing accounts, and first deployments.
retrieving-developer-knowledge: Integration with the developer-knowledge MCP server to retrieve official Google developer documentation and API references.
Além disso, acesse Configurações > Personalizações para conferir se essas habilidades também estão disponíveis:
Observação:em "Personalizações", há uma seção Servidores MCP instalados e, no momento, ela não mostra os servidores MCP como parte do plug-in:
No entanto, você pode perguntar ao Antigravity em um chat sobre servidores MCP:
Which MCP servers are available?
Ele vai reconhecer o MCP de conhecimento do desenvolvedor instalado como parte do plug-in:
Based on your Antigravity configuration and cached tool definitions, here are the MCP servers and their statuses:
1. Actively Configured Plugin Server
Configured in
~/.gemini/config/plugins/google-cloud-developer/mcp.json
:
developer-knowledge
Type / URL: Streamable HTTP (https://developerknowledge.googleapis.com/mcp)
Provided Tools:
search_documents: Search official Google developer documentation
get_documents: Retrieve document content
answer_query: Synthesize developer query answers
5. Exercitar o plug-in do Google Cloud Developer
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 conferir como o plug-in do Google Cloud Developer 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ê ainda não conhece o 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 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 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 será ativada, o que, por sua vez, usa 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 habilidades do Google
Por último, mas não menos importante, o plug-in do Google Cloud Developer pode descobrir e carregar habilidades sob demanda.
Por exemplo, você pode perguntar:
I want to start using Firebase
A habilidade finding-google-skills 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. Revisão dos dados
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 do Google Cloud Developer 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 do Google Cloud Developer no Antigravity. Para saber mais, confira os seguintes recursos: