1. Giriş
Ajan becerileri, yapay zeka ajanı özelliklerini uzmanlık bilgisi ve iş akışlarıyla genişletmek için kullanılan basit ve açık bir formattır. MCP, yapay zeka uygulamalarını harici sistemlere bağlamak için kullanılan bir standarttır.
Ajan eklentileri spesifikasyonu, ajan becerilerini ve MCP sunucularını taşınabilir eklentiler halinde paketlemek için açık ve tedarikçiden bağımsız bir spesifikasyondur.
Yapay zeka kodlama aracıları için Google Cloud eklentileri, Google Cloud'da daha etkili yapay zeka aracıları için ilgili Google Cloud becerilerini ve MCP sunucularını yüklenebilir paketler halinde sunar.
Bu codelab'de, bu eklentilerden biri olan Google Cloud Developer eklentisi ve bu eklentiyi Antigravity'de nasıl yükleyip kullanacağınız hakkında bilgi edineceksiniz.
Yapacaklarınız
- Ajan eklentilerini anlama
- Antigravity'de Google Cloud Developer eklentisini yükleyip keşfedin.
- Google Cloud Developer eklentisi tarafından yüklenen becerileri ve MCP sunucularını birkaç istemle test edin.
İhtiyacınız olanlar
- Chrome gibi bir web tarayıcısı.
- Google Cloud projesi
- Yerel makinenizde Antigravity ve Antigravity CLI'nın yüklü olması gerekir.
2. Ajan eklentilerini keşfetme
Ajan eklentileri, ajan becerilerini ve MCP sunucularını aşağıdaki gibi bir dizinde birleştiren taşınabilir bir paket biçimidir:
my-plugin/
├── plugin.json
├── skills/
│ └── my-skill/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
plugin.json, eklentiyi tanımlar.skills/, ajan becerileri içerir.mcp.json, MCP sunucularını açıklar.- Ters alan uzantısı ad alanları, tek tek istemcilerin özel davranışlar eklemesine olanak tanır.
Google Agent Skills deposu, Google Cloud da dahil olmak üzere Google ürünleri ve teknolojileri için temsilci becerileri içerir. Ayrıca, temsilci becerilerini ve MCP sunucularını Google Cloud Developer eklentisi gibi yüklenebilir paketler halinde bir araya getiren eklentiler de içerir.
Google Cloud Developer eklentisi, kodlama temsilcileri için Google Cloud rehberliği sağlar: ilk projeye ilk katılım, kimlik doğrulama ve kimlik bilgisi seçimi ve gcloud CLI komutları için güvenlikle ilgili kritik doğrulama. Temellendirilmiş ve güncel Google Cloud belgeleri için Google Developer Knowledge MCP sunucusunu içerir.
3. Google Cloud Developer Eklentisini yükleme
Antigravity CLI, tüm Antigravity ekosistemi (Antigravity, Antigravity CLI, Antigravity IDE) için ajan eklentilerini yüklemenin en kolay yoludur.
Yolunu belirterek Antigravity CLI'ya Google Cloud Developer eklentisini yükleyelim:
agy plugin install google-cloud-developer
Antigravity Marketplace'ten yüklenen eklentiyi görürsünüz :
Installed plugin "google-cloud-developer" from antigravity-plugins-official
4. Google Cloud Developer Plugin'i keşfedin
Şimdi Google Cloud Developer eklentisini inceleyelim.
Öncelikle, eklentinin Antigravity CLI'de listelendiğinden emin olun:
agy plugin list
Eklentiyi bazı beceriler, bir kural ve bir MCP sunucusuyla birlikte görürsünüz:
...
- google-cloud-developer (enabled, 1.1.10)
Source: antigravity-plugins-official
Components: 5 skills, 1 rule, 1 MCP server
...
Antigravity CLI, eklentileri .gemini/config/plugins/ klasörüne global olarak yükler. Bu, eklentinin Antigravity, Antigravity CLI ve Antigravity IDE'de kullanılabileceği anlamına gelir.
.gemini/config/plugins/google-cloud-developer klasöründe, eklenti manifest dosyası, beceriler ve bir MCP sunucusu içeren Google Cloud Developer eklentisini bulabilirsiniz:
google-cloud-developer/
├── ...
├── skills/
│ ├── finding-google-skills/
│ ├── gcloud/
│ ├── google-cloud-recipe-auth/
│ ├── google-cloud-recipe-onboarding/
│ └── retrieving-developer-knowledge/
├── mcp.json
└── plugin.json
İlk proje oryantasyonu, kimlik doğrulama ve kimlik bilgisi seçimi ile gcloud CLI komutları için güvenlikle ilgili kritik doğrulama konularında beceriler edinebilirsiniz. Ayrıca, dayanaklı ve güncel Google Cloud belgeleri için Google Developer Knowledge MCP sunucusunu da içerir.
Antigravity'ye (bağımsız uygulama) geçip sohbette hangi becerilerin yüklü olduğunu da sorabilirsiniz:
Which Google Cloud skills are available?
Yerleşik Antigravity becerilerinin yanı sıra Google Cloud Developer eklentisindeki beceriler de listelenmelidir:
### 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-*
Ayrıca soldaki Customizations (Özelleştirmeler) sekmesine gidin. Installed (Yüklü) bölümünde Google Cloud Developer eklentisini görürsünüz:
Eklentiyi tıkladığınızda yüklü becerilerin, MCP sunucularının ve kuralların listesini görebilirsiniz:
5. Google Cloud Developer eklentisini kullanma alıştırması
Developer Knowledge API'yi etkinleştirme
Öncelikle Google Cloud projenizde Developer Knowledge API'nin etkinleştirildiğinden emin olun. Bu, Developer Knowledge MCP sunucusu için gereklidir:
- Google Cloud Console'da Developer Knowledge API'yi arayın.
- Developer Knowledge API sayfasında Enable API'ı (API'yi etkinleştir) tıklayın.
Şimdi, Google Cloud Developer eklentisinin farklı senaryolarda nasıl yardımcı olduğunu görmek için bazı istemleri deneyelim.
Eklenti dünya genelinde kullanılabildiğinden bu istemleri Antigravity veya Antigravity CLI'da deneyebilirsiniz.
Oryantasyon
Google Cloud'u kullanmaya yeni başladıysanız ilk katılım süreciyle ilgili temel bir soru sorarak başlayabilirsiniz:
I'm new to Google Cloud. How can I create a new project with billing enabled?
google-cloud-recipe-onboarding becerisinin etkinleştirildiğini görmeniz gerekir:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-onboarding/SKILL.md
Adım adım talimatlar içeren bir yanıt alırsınız:
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).
...
Kimlik doğrulama
Kimlik doğrulama ile ilgili sorular sormayı deneyin:
How can I authenticate my local machine with Google Cloud?
google-cloud-recipe-auth becerisinin etkinleştirildiğini görmeniz gerekir:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-auth/SKILL.md
Kimlik doğrulaması için komutlar almanız gerekir:
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
Resmi belgelerden yanıtlanacak sorular da sorabilirsiniz.
Örneğin:
What's the difference between Cloud Run and GKE according to the official docs?
İlgili becerinin etkinleştirildiğini görürsünüz. Bu beceri, developer-knowledge MCP sunucusunu kullanır:
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?"
}
Diğer Google Skills'i bulma
Son olarak, Google Cloud Developer eklentisi becerileri isteğe bağlı olarak keşfedip yükleyebilir.
Örneğin, şunları sorabilirsiniz:
Explain what steps are needed to start working with Firebase.
finding-google-skills becerisinin etkinleştirildiğini ve ilgili Firebase becerisini bulup yüklediğini görürsünüz:
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. Temizleme
Developer Knowledge API'yi devre dışı bırakın:
- Google Cloud Console'da Developer Knowledge API'yi arayın.
- Developer Knowledge API sayfasında Yönet'i ve ardından API'yi devre dışı bırak'ı tıklayın.
Antigravity CLI ile Google Cloud Developer eklentisinin yüklemesini kaldırın:
agy plugin uninstall google-cloud-developer
Uninstalled plugin "google-cloud-developer"
7. Tebrikler
Tebrikler! Antigravity'de Google Cloud Developer eklentisini başarıyla yükleyip kullandınız. Daha fazla bilgi edinmek için aşağıdaki kaynakları inceleyin: