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 e i server MCP di Google Cloud 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 tua 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 del dominio inverso 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 Google Cloud Developer plugin.
Il plug-in Google Cloud Developer fornisce indicazioni di 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 Google Cloud Developer Plugin
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 google-cloud-developer
Dovresti vedere il plug-in installato da Antigravity Marketplace :
Installed plugin "google-cloud-developer" from antigravity-plugins-official
4. Esplorare Google Cloud Developer Plugin
Ora esploriamo il plug-in Google Cloud Developer.
Innanzitutto, verifica che il plug-in sia elencato in Antigravity CLI:
agy plugin list
Dovresti vedere il plug-in con alcune skill, una regola e un server MCP:
...
- google-cloud-developer (enabled, 1.1.10)
Source: antigravity-plugins-official
Components: 5 skills, 1 rule, 1 MCP server
...
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 (app autonoma) e chiedere in una chat quali skill sono installate:
Which Google Cloud skills are available?
Dovrebbe elencare le skill Antigravity integrate, ma anche le skill del plug-in Google Cloud Developer:
### 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-*
Inoltre, nella scheda Personalizzazioni a sinistra, sotto Installato, dovresti vedere il plug-in Google Cloud Developer:
Se fai clic sul plug-in, puoi visualizzare l'elenco delle skill, dei server MCP e delle regole installate:
5. Esercitarsi con Google Cloud Developer Plugin
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 Google Skills
Infine, il plug-in Google Cloud Developer può scoprire e caricare le skill on demand.
Ad esempio, puoi chiedere:
Explain what steps are needed to start working with 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: