1. Introducción
Las habilidades de agentes son un formato abierto y ligero para extender las capacidades de los agentes de IA con conocimientos y flujos de trabajo especializados. MCP es un estándar para conectar aplicaciones de IA a sistemas externos.
La especificación de complementos de agentes es una especificación abierta e independiente del proveedor para empaquetar habilidades de agentes y servidores de MCP en complementos portátiles.
Los complementos de Google Cloud para agentes de codificación de IA empaquetan habilidades y servidores de MCP relevantes de Google Cloud en paquetes instalables para agentes de IA más eficaces en Google Cloud.
En este codelab, aprenderás sobre uno de esos complementos, el complemento de Google Cloud Developer, y cómo instalarlo y usarlo en Antigravity.
Actividades
- Comprender los complementos de agentes
- Instalar y explorar el complemento de Google Cloud Developer en Antigravity
- Probar las habilidades y los servidores de MCP instalados por el complemento de Google Cloud Developer con algunas instrucciones
Requisitos
- Un navegador web, como Chrome
- Un proyecto de Google Cloud,
- Antigravity y CLI de Antigravity instalados en tu máquina local
2. Explora los complementos de agentes
Los complementos de agentes son un formato de paquete portátil para agrupar habilidades de agentes y servidores de MCP en un directorio que se ve de la siguiente manera:
my-plugin/
├── plugin.json
├── skills/
│ └── my-skill/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
plugin.jsonidentifica el complemento.skills/contiene habilidades de agentes.mcp.jsondescribe los servidores de MCP.- Los espacios de nombres de extensión de dominio inverso permiten que los clientes individuales agreguen un comportamiento personalizado.
El repositorio de habilidades de agentes de Google contiene habilidades de agentes para productos y tecnologías de Google, incluido Google Cloud. También contiene complementos que agrupan habilidades de agentes y servidores de MCP en paquetes instalables, como el complemento de Google Cloud Developer.
El complemento de Google Cloud Developer proporciona orientación de Google Cloud para agentes de codificación: integración del primer proyecto, autenticación y selección de credenciales, y validación de seguridad crítica para comandos de gcloud CLI. Incluye el servidor de MCP de Google Developer Knowledge para documentación de Google Cloud actualizada y fundamentada.
3. Instala el complemento de Google Cloud Developer
La CLI de Antigravity es la forma más sencilla de instalar complementos de agentes para todo el ecosistema de Antigravity (CLI de Antigravity, IDE de Antigravity).
Instalemos el complemento de Google Cloud Developer en la CLI de Antigravity apuntando a su ruta de acceso:
agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer
Deberías ver el complemento instalado con algunas habilidades y un servidor de 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. Explora el complemento de Google Cloud Developer
Ahora, exploremos el complemento de Google Cloud Developer.
Primero, verifica que el complemento aparezca en la CLI de Antigravity:
agy plugin list
{
"imports": [
{
"name": "google-cloud-developer",
"source": "antigravity",
"importedAt": "2026-09-04T10:41:05Z",
"components": [
"skills",
"mcpServers"
]
}
]
}
La CLI de Antigravity instala complementos de forma global en la carpeta .gemini/config/plugins/. Esto significa que el complemento está disponible para Antigravity, CLI de Antigravity y IDE de Antigravity.
En la carpeta .gemini/config/plugins/google-cloud-developer, encontrarás el complemento de Google Cloud Developer con el archivo de manifiesto del complemento, las habilidades y un servidor de MCP:
google-cloud-developer/
├── ...
├── skills/
│ ├── finding-google-skills/
│ ├── gcloud/
│ ├── google-cloud-recipe-auth/
│ ├── google-cloud-recipe-onboarding/
│ └── retrieving-developer-knowledge/
├── mcp.json
└── plugin.json
Encontrarás habilidades en la integración del primer proyecto, la autenticación y la selección de credenciales, y la validación de seguridad crítica para los comandos de gcloud CLI. También incluye el servidor de MCP de Google Developer Knowledge para documentación de Google Cloud actualizada y fundamentada.
También puedes cambiar a Antigravity y preguntar en un chat qué habilidades están instaladas:
Which skills are available?
Debería mostrar las habilidades integradas de Antigravity, pero también las habilidades del complemento de 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.
Además, ve a Configuración > Personalizaciones y deberías ver que estas habilidades también están disponibles allí:
Nota: En Personalizaciones, hay una sección Servidores de MCP instalados y, actualmente, no muestra los servidores de MCP como parte del complemento:
Sin embargo, puedes preguntarle a Antigravity en un chat sobre los servidores de MCP:
Which MCP servers are available?
Debería reconocer el MCP de Developer Knowledge instalado como parte del complemento:
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. Ejercita el complemento de Google Cloud Developer
Habilita la API de Developer Knowledge
Primero, asegúrate de que la API de Developer Knowledge esté habilitada en tu proyecto de Google Cloud. Esto es necesario para el servidor de MCP de Developer Knowledge:
- En la consola de Google Cloud, busca API de Developer Knowledge.
- En la página API de Developer Knowledge, haz clic en Habilitar API.
Ahora, probemos algunas instrucciones para ver cómo ayuda el complemento de Google Cloud Developer en diferentes situaciones.
Puedes probar estas instrucciones en Antigravity o CLI de Antigravity, ya que el complemento está disponible de forma global.
Integración
Si es la primera vez que usas Google Cloud, puedes comenzar con una pregunta básica de integración:
I'm new to Google Cloud. How can I create a new project with billing enabled?
Deberías ver la habilidad google-cloud-recipe-onboarding activada:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-onboarding/SKILL.md
Deberías recibir una respuesta con instrucciones paso a paso:
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).
...
Autenticación
Intenta hacer preguntas sobre la autenticación:
How can I authenticate my local machine with Google Cloud?
Deberías ver la habilidad google-cloud-recipe-auth activada:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-auth/SKILL.md
Deberías obtener 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
...
Developer Knowledge
También puedes hacer preguntas para que se respondan desde la documentación oficial.
Por ejemplo:
What's the difference between Cloud Run and GKE according to the official docs?
Verás que se activa la habilidad pertinente, que, a su vez, usa el servidor de 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?"
}
Busca otras habilidades de Google
Por último, pero no menos importante, el complemento de Google Cloud Developer puede descubrir y cargar habilidades a pedido.
Por ejemplo, puedes preguntar lo siguiente:
I want to start using Firebase
Deberías ver que la habilidad finding-google-skills está activada y que encuentra e instala la habilidad pertinente de 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. Limpieza
Inhabilita la API de Developer Knowledge:
- En la consola de Google Cloud, busca API de Developer Knowledge.
- En la página API de Developer Knowledge , haz clic en Administrar y, luego, en Inhabilitar API.
Desinstala el complemento de Google Cloud Developer con la CLI de Antigravity:
agy plugin uninstall google-cloud-developer
Uninstalled plugin "google-cloud-developer"
7. Felicitaciones
¡Felicitaciones! Instalaste y usaste correctamente el complemento de Google Cloud Developer en Antigravity. Para obtener más información, consulta los siguientes recursos: