1. Introduzione
Le skill dell'agente sono un formato open source leggero per estendere le funzionalità degli agenti AI con conoscenze e workflow specializzati. MCP è uno standard per connettere le applicazioni AI a sistemi esterni.
La specifica dei plug-in dell'agente è una specifica open source e indipendente dal fornitore per il packaging di skill dell'agente e server MCP in plug-in portatili.
I plug-in Google Cloud per gli agenti di codifica AI raggruppano le skill Google Cloud e i server MCP pertinenti in bundle installabili per agenti AI più efficaci su Google Cloud.
In questo codelab, scoprirai uno di questi plug-in, Google Cloud Developer plugin, e come installarlo e utilizzarlo in Antigravity.
In questo lab proverai a:
- Comprendere i plug-in dell'agente.
- Installare ed esplorare il plug-in Google Cloud Developer in Antigravity.
- Testare le skill e i server MCP installati dal plug-in Google Cloud Developer con alcuni prompt.
Che cosa ti serve
- Un browser web come Chrome.
- Un progetto Google Cloud.
- Antigravity e Antigravity CLI installati sulla macchina locale.
2. Esplorare i plug-in dell'agente
I plug-in dell'agente sono un formato di pacchetto portatile per raggruppare skill dell'agente e server MCP in una directory simile alla seguente:
my-plugin/
├── plugin.json
├── skills/
│ └── my-skill/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
plugin.jsonidentifica il plug-in.skills/contiene le skill dell'agente.mcp.jsondescrive i server MCP.- Gli spazi dei nomi delle estensioni dei domini inversi consentono ai singoli client di aggiungere un comportamento personalizzato.
Il repository Google Agent Skills contiene le skill dell'agente per i prodotti e le tecnologie Google, tra cui Google Cloud. Contiene anche plug-in che raggruppano le skill dell'agente e i server MCP in bundle installabili, come il plug-in Google Cloud Developer.
Il plug-in Google Cloud Developer fornisce indicazioni su Google Cloud per gli agenti di codifica: onboarding del primo progetto, autenticazione e selezione delle credenziali e convalida di sicurezza critica per i comandi gcloud CLI. Include il server MCP Google Developer Knowledge per la documentazione di Google Cloud basata su dati reali e aggiornata.
3. Installare il plug-in Google Cloud Developer
Antigravity CLI è il modo più semplice per installare i plug-in dell'agente per l'intero ecosistema Antigravity (Antigravity, Antigravity CLI, Antigravity IDE).
Installiamo il plug-in Google Cloud Developer in Antigravity CLI indicandone il percorso:
agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer
Dovresti vedere il plug-in installato con alcune skill e un server 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. Esplorare il plug-in Google Cloud Developer
Ora esploriamo il plug-in Google Cloud Developer.
Innanzitutto, verifica che il plug-in sia elencato in Antigravity CLI:
agy plugin list
{
"imports": [
{
"name": "google-cloud-developer",
"source": "antigravity",
"importedAt": "2026-09-04T10:41:05Z",
"components": [
"skills",
"mcpServers"
]
}
]
}
Antigravity CLI installa i plug-in a livello globale nella cartella .gemini/config/plugins/. Ciò significa che il plug-in è disponibile per Antigravity, Antigravity CLI e Antigravity IDE.
Nella cartella .gemini/config/plugins/google-cloud-developer troverai il plug-in Google Cloud Developer con il file manifest del plug-in, le skill e un server MCP:
google-cloud-developer/
├── ...
├── skills/
│ ├── finding-google-skills/
│ ├── gcloud/
│ ├── google-cloud-recipe-auth/
│ ├── google-cloud-recipe-onboarding/
│ └── retrieving-developer-knowledge/
├── mcp.json
└── plugin.json
Troverai le skill per l'onboarding del primo progetto, l'autenticazione e la selezione delle credenziali e la convalida di sicurezza critica per i comandi gcloud CLI. Include anche il server MCP Google Developer Knowledge per la documentazione di Google Cloud basata su dati reali e aggiornata.
Puoi anche passare ad Antigravity e chiedere in una chat quali skill sono installate:
Which skills are available?
Dovrebbe elencare le skill Antigravity integrate, ma anche le skill del plug-in 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.
Inoltre, vai a Impostazioni > Personalizzazioni, dovresti vedere che queste skill sono disponibili anche qui:
Nota: in Personalizzazioni è presente una sezione Server MCP installati e al momento non mostra i server MCP come parte del plug-in:
Tuttavia, puoi chiedere ad Antigravity in una chat informazioni sui server MCP:
Which MCP servers are available?
Dovrebbe riconoscere il server MCP Developer Knowledge installato come parte del 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. Esercitarsi con il plug-in Google Cloud Developer
Abilitare l'API Developer Knowledge
Innanzitutto, assicurati che l'API Developer Knowledge sia abilitata nel tuo progetto Google Cloud. È necessaria per il server MCP Developer Knowledge :
- Nella console Google Cloud, cerca API Developer Knowledge.
- Nella pagina API Developer Knowledge, fai clic su Abilita API.
Ora proviamo alcuni prompt per vedere in che modo il plug-in Google Cloud Developer aiuta in diversi scenari.
Puoi provare questi prompt in Antigravity o Antigravity CLI, poiché il plug-in è disponibile a livello globale.
Onboarding
Se non hai familiarità con Google Cloud, puoi iniziare ponendo una domanda di onboarding di base:
I'm new to Google Cloud. How can I create a new project with billing enabled?
Dovresti vedere la skill google-cloud-recipe-onboarding attivata:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-onboarding/SKILL.md
Dovresti ricevere una risposta con istruzioni passo passo:
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).
...
Autenticazione
Prova a porre domande sull'autenticazione:
How can I authenticate my local machine with Google Cloud?
Dovresti vedere la skill google-cloud-recipe-auth attivata:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-auth/SKILL.md
Dovresti ricevere i comandi per l'autenticazione:
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
Puoi anche porre domande a cui rispondere dalla documentazione ufficiale.
Ad esempio:
What's the difference between Cloud Run and GKE according to the official docs?
Vedrai la skill pertinente attivata, che a sua volta utilizza il server 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?"
}
Trovare altre skill Google
Infine, il plug-in Google Cloud Developer può scoprire e caricare le skill on demand.
Ad esempio, puoi chiedere:
I want to start using Firebase
Dovresti vedere che la skill finding-google-skills è attivata e trova e installa la skill Firebase pertinente:
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. Esegui la pulizia
Disabilita l'API Developer Knowledge:
- Nella console Google Cloud, cerca API Developer Knowledge.
- Nella pagina API Developer Knowledge, fai clic su Gestisci e poi su Disabilita API.
Disinstalla il plug-in Google Cloud Developer con Antigravity CLI:
agy plugin uninstall google-cloud-developer
Uninstalled plugin "google-cloud-developer"
7. Complimenti
Complimenti! Hai installato e utilizzato correttamente il plug-in Google Cloud Developer in Antigravity. Per saperne di più, consulta le seguenti risorse: