1. Introduction
Les compétences agentiques sont un format ouvert et léger qui permet d'étendre les capacités des agents IA avec des connaissances et des workflows spécialisés. MCP est une norme qui permet de connecter des applications d'IA à des systèmes externes.
La spécification des plug-ins d'agent est une spécification ouverte et neutre du point de vue du fournisseur qui permet d'empaqueter des compétences agentiques et des serveurs MCP dans des plug-ins portables.
Les plug-ins Google Cloud pour les agents de codage IA regroupent les compétences Google Cloud et les serveurs MCP pertinents dans des packages installables pour des agents IA plus efficaces sur Google Cloud.
Dans cet atelier de programmation, vous allez découvrir l'un de ces plug-ins, le plug-in Google Cloud Developer, et apprendre à l'installer et à l'utiliser dans Antigravity.
Objectifs de l'atelier
- Comprendre les plug-ins d'agent.
- Installer et explorer le plug-in Google Cloud Developer dans Antigravity.
- Tester les compétences et les serveurs MCP installés par le plug-in Google Cloud Developer avec quelques invites.
Ce dont vous avez besoin
- Un navigateur Web tel que Chrome.
- Un projet Google Cloud.
- Antigravity et Antigravity CLI installés sur votre machine locale.
2. Découvrir les plug-ins d'agent
Les plug-ins d'agent sont un format de package portable qui permet de regrouper des compétences agentiques et des serveurs MCP dans un répertoire semblable à celui-ci :
my-plugin/
├── plugin.json
├── skills/
│ └── my-skill/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
plugin.jsonidentifie le plug-in.skills/contient les compétences agentiques.mcp.jsondécrit les serveurs MCP.- Les espaces de noms d'extension de domaine inversé permettent aux clients individuels d'ajouter un comportement personnalisé.
Le dépôt de compétences agentiques de Google contient des compétences agentiques pour les produits et technologies Google, y compris Google Cloud. Il contient également des plug-ins qui regroupent des compétences agentiques et des serveurs MCP dans des packages installables, tels que le plug-in Google Cloud Developer.
Le plug-in Google Cloud Developer fournit des conseils Google Cloud pour les agents de codage : intégration du premier projet, authentification et sélection des identifiants, et validation critique pour les commandes gcloud CLI. Il inclut le serveur MCP Google Developer Knowledge pour une documentation Google Cloud à jour et pertinente.
3. Installer le plug-in Google Cloud Developer
Antigravity CLI est le moyen le plus simple d'installer des plug-ins d'agent pour l'ensemble de l'écosystème Antigravity (Antigravity, Antigravity CLI, Antigravity IDE).
Installons le plug-in Google Cloud Developer dans Antigravity CLI en indiquant son chemin d'accès :
agy plugin install google-cloud-developer
Le plug-in installé devrait s'afficher dans Antigravity Marketplace :
Installed plugin "google-cloud-developer" from antigravity-plugins-official
4. Explorer le plug-in Google Cloud Developer
Explorons maintenant le plug-in Google Cloud Developer.
Tout d'abord, vérifiez que le plug-in est répertorié dans Antigravity CLI :
agy plugin list
Le plug-in devrait s'afficher avec quelques compétences, une règle et un serveur MCP :
...
- google-cloud-developer (enabled, 1.1.10)
Source: antigravity-plugins-official
Components: 5 skills, 1 rule, 1 MCP server
...
Antigravity CLI installe les plug-ins au niveau global dans le dossier .gemini/config/plugins/. Cela signifie que le plug-in est disponible pour Antigravity, Antigravity CLI et Antigravity IDE.
Dans le dossier .gemini/config/plugins/google-cloud-developer, vous trouverez le plug-in Google Cloud Developer avec le fichier manifeste du plug-in, les compétences et un serveur MCP :
google-cloud-developer/
├── ...
├── skills/
│ ├── finding-google-skills/
│ ├── gcloud/
│ ├── google-cloud-recipe-auth/
│ ├── google-cloud-recipe-onboarding/
│ └── retrieving-developer-knowledge/
├── mcp.json
└── plugin.json
Vous trouverez des compétences sur l'intégration du premier projet, l'authentification et la sélection des identifiants, ainsi que la validation critique pour les commandes gcloud CLI. Il inclut également le serveur MCP Google Developer Knowledge pour une documentation Google Cloud à jour et pertinente.
Vous pouvez également passer à Antigravity (application autonome) et demander dans un chat quelles compétences sont installées :
Which Google Cloud skills are available?
Les compétences intégrées d'Antigravity, mais aussi les compétences du plug-in Google Cloud Developer devraient s'afficher :
### 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-*
De plus, accédez à l'onglet Customizations (Personnalisations) à gauche. Sous Installed (Installé), le plug-in Google Cloud Developer devrait s'afficher :
Si vous cliquez sur le plug-in, vous pouvez voir la liste des compétences, des serveurs MCP et des règles installés :
5. Utiliser le plug-in Google Cloud Developer
Activer l'API Developer Knowledge
Tout d'abord, assurez-vous que l'API Developer Knowledge est activée dans votre projet Google Cloud. Elle est nécessaire pour le serveur MCP Developer Knowledge :
- Dans la console Google Cloud, recherchez API Developer Knowledge.
- Sur la page API Developer Knowledge, cliquez sur Activer l'API.
Essayons maintenant quelques invites pour voir comment le plug-in Google Cloud Developer peut vous aider dans différents scénarios.
Vous pouvez essayer ces invites dans Antigravity ou Antigravity CLI, car le plug-in est disponible au niveau global.
Intégration
Si vous débutez sur Google Cloud, vous pouvez commencer par poser une question d'intégration de base :
I'm new to Google Cloud. How can I create a new project with billing enabled?
La compétence google-cloud-recipe-onboarding devrait s'activer :
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-onboarding/SKILL.md
Vous devriez recevoir une réponse avec des instructions détaillées :
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).
...
Authentification
Essayez de poser des questions sur l'authentification :
How can I authenticate my local machine with Google Cloud?
La compétence google-cloud-recipe-auth devrait s'activer :
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-auth/SKILL.md
Vous devriez obtenir des commandes pour vous authentifier :
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
Vous pouvez également poser des questions auxquelles vous souhaitez obtenir des réponses à partir de la documentation officielle.
Exemple :
What's the difference between Cloud Run and GKE according to the official docs?
La compétence pertinente s'active et utilise à son tour le serveur 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?"
}
Trouver d'autres compétences Google
Enfin, le plug-in Google Cloud Developer peut découvrir et charger des compétences à la demande.
Par exemple, vous pouvez poser la question suivante :
Explain what steps are needed to start working with Firebase.
Vous devriez voir que la compétence finding-google-skills est activée, et qu'elle trouve et installe la compétence Firebase appropriée :
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. Nettoyage
Désactivez l'API Developer Knowledge :
- Dans la console Google Cloud, recherchez API Developer Knowledge.
- Sur la page API Developer Knowledge , cliquez sur Gérer , puis sur Désactiver l'API.
Désinstallez le plug-in Google Cloud Developer avec Antigravity CLI :
agy plugin uninstall google-cloud-developer
Uninstalled plugin "google-cloud-developer"
7. Félicitations
Félicitations ! Vous avez installé et utilisé le plug-in Google Cloud Developer dans Antigravity. Pour en savoir plus, consultez les ressources suivantes :