۱. مقدمه
مهارت‌های عامل قالبی سبک و باز برای گسترش قابلیت‌های عامل هوش مصنوعی با دانش و گردش کار تخصصی است. MCP استانداردی برای اتصال برنامه‌های هوش مصنوعی به سیستم‌های خارجی است.
مشخصات افزایه‌های عامل یک مشخصات باز و مستقل از فروشنده برای بسته‌بندی مهارت‌های عامل و سرورهای MCP در افزایه‌های قابل‌حمل است.
افزونه‌های Google Cloud برای عامل‌های کدنویسی هوش مصنوعی مهارت‌های مرتبط Google Cloud و سرورهای MCP را در بسته‌های قابل‌نصب برای عامل‌های هوش مصنوعی مؤثرتر در Google Cloud بسته‌بندی می‌کنند.
در این codelab، با یکی از این افزایه‌ها، یعنی افزایه Google Cloud Developer، و نحوه نصب و استفاده از این افزایه در Antigravity آشنا خواهید شد.
آنچه انجام خواهید داد
- افزایه‌های عامل را درک کنید.
- افزایه «توسعه‌دهنده Google Cloud» را در Antigravity نصب و کاوش کنید.
- مهارت‌ها و سرورهای MCP نصب‌شده توسط افزایه Google Cloud Developer را با چند پیام‌واره آزمایش کنید.
آنچه نیاز خواهید داشت
- مرورگر وبی مثل Chrome.
- پروژه Google Cloud.
- Antigravity و Antigravity CLI در ماشین محلی شما نصب شده باشد.
۲. کاوش افزایه‌های عامل
افزایه‌های عامل یک قالب بسته قابل‌حمل برای دسته‌بندی مهارت‌های عامل و سرورهای MCP در یک دایرکتوری است که به این شکل است:
my-plugin/
├── plugin.json
├── skills/
│ └── my-skill/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
-
plugin.jsonافزایه را شناسایی می‌کند. -
skills/حاوی مهارت‌های عامل است. -
mcp.jsonسرورهای MCP را توصیف می‌کند. - فضاهای نام افزونه دامنه معکوس به مشتریان منفرد اجازه می‌دهد رفتار سفارشی اضافه کنند.
مخزن مهارت‌های عامل Google حاوی مهارت‌های عامل برای محصولات و فناوری‌های Google، ازجمله Google Cloud، است. همچنین حاوی افزایه‌هایی است که مهارت‌های عامل و سرورهای MCP را در دسته‌های نصب‌شدنی مانند افزایه توسعه‌دهنده Google Cloud دسته‌بندی می‌کند.
افزونه Google Cloud Developer راهنمایی Google Cloud را برای عامل‌های کدنویسی ارائه می‌دهد: آماده‌سازی اولین پروژه، اصالت‌سنجی و انتخاب اطلاعات کاربری، و اعتبارسنجی ایمنی-بحرانی برای فرمان‌های gcloud CLI. شامل سرور Google Developer Knowledge MCP برای اسناد مستدل و به‌روز Google Cloud است.
۳. نصب افزایه Google Cloud Developer
Antigravity CLI ساده‌ترین راه برای نصب افزایه‌های عامل برای کل بوم‌سازگان Antigravity (Antigravity، Antigravity CLI، Antigravity IDE) است.
بیایید افزایه توسعه‌دهنده Google Cloud را در Antigravity CLI با اشاره به مسیر آن نصب کنیم:
agy plugin install google-cloud-developer
باید افزایه نصب‌شده از بازار Antigravity را ببینید :
Installed plugin "google-cloud-developer" from antigravity-plugins-official
۴. کاوش افزایه «توسعه‌دهنده Google Cloud»
اکنون بیایید افزونه Google Cloud Developer را کاوش کنیم.
ابتدا بررسی کنید که افزونه در Antigravity CLI فهرست شده باشد:
agy plugin list
باید افزایه را با چند مهارت، یک قانون، و یک سرور MCP ببینید:
...
- google-cloud-developer (enabled, 1.1.10)
Source: antigravity-plugins-official
Components: 5 skills, 1 rule, 1 MCP server
...
Antigravity CLI افزایه‌ها را به‌طور سراسری در پوشه .gemini/config/plugins/ نصب می‌کند. این یعنی افزایه برای Antigravity، Antigravity CLI، و Antigravity IDE دردسترس است.
در پوشه .gemini/config/plugins/google-cloud-developer، افزونه Google Cloud Developer را با فایل مانیفست افزونه، مهارت‌ها، و سرور MCP پیدا خواهید کرد:
google-cloud-developer/
├── ...
├── skills/
│ ├── finding-google-skills/
│ ├── gcloud/
│ ├── google-cloud-recipe-auth/
│ ├── google-cloud-recipe-onboarding/
│ └── retrieving-developer-knowledge/
├── mcp.json
└── plugin.json
مهارت‌هایی را در زمینه آماده‌سازی اولین پروژه، انتخاب اطلاعات کاربری و اصالت‌سنجی، و اعتبارسنجی ایمنی-بحرانی برای فرمان‌های gcloud CLI پیدا خواهید کرد. همچنین شامل سرور Google Developer Knowledge MCP برای مستندات به‌روز و زمینه‌ای Google Cloud می‌شود.
همچنین می‌توانید به Antigravity (برنامه مستقل) بروید و در گپ بپرسید کدام مهارت‌ها نصب شده‌اند:
Which Google Cloud skills are available?
این فهرست باید شامل مهارت‌های داخلی Antigravity و همچنین مهارت‌های مربوط به افزونه 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-*
علاوه‌براین، به برگه سفارشی‌سازی‌ها در سمت راست بروید، در بخش نصب‌شده، باید افزونه Google Cloud Developer را ببینید:
اگر روی افزایه کلیک کنید، می‌توانید فهرست مهارت‌ها، سرورهای MCP، و قوانین نصب‌شده را ببینید:
۵. تمرین افزایه «توسعه‌دهنده Google Cloud»
فعال کردن Developer Knowledge API
ابتدا مطمئن شوید Developer Knowledge API در پروژه Google Cloud شما فعال باشد. این مورد برای سرور MCP «دانش توسعه‌دهنده» لازم است:
- در Google Cloud Console، Developer Knowledge API را جستجو کنید
- در صفحه Developer Knowledge API، روی فعال کردن میانای برنامه‌سازی کاربردی کلیک کنید.
اکنون بیایید چند پیام‌واره را امتحان کنیم تا ببینیم افزونه Google Cloud Developer چگونه در سناریوهای مختلف کمک می‌کند.
می‌توانید این پیام‌واره‌ها را در Antigravity یا Antigravity CLI امتحان کنید، زیرا افزایه در سطح جهانی دردسترس است.
آماده‌سازی
اگر با Google Cloud آشنایی ندارید، می‌توانید با پرسیدن یک سؤال اولیه درباره پذیرش سازمانی شروع کنید:
I'm new to Google Cloud. How can I create a new project with billing enabled?
باید ببینید مهارت google-cloud-recipe-onboarding فعال شده است:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-onboarding/SKILL.md
باید پاسخی با دستورالعمل‌های گام‌به‌گام دریافت کنید:
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).
...
اصالت‌سنجی
سؤالاتی درباره اصالت‌سنجی بپرسید:
How can I authenticate my local machine with Google Cloud?
باید ببینید مهارت google-cloud-recipe-auth فعال شده است:
Worked for 1m ˅
Explored 1 file ˅
> Analyzed google-cloud-recipe-auth/SKILL.md
باید فرمان‌هایی برای اصالت‌سنجی دریافت کنید:
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
همچنین می‌توانید سؤالاتی بپرسید که از اسناد رسمی پاسخ داده شوند.
برای مثال:
What's the difference between Cloud Run and GKE according to the official docs?
مهارت مربوطه را فعال‌شده خواهید دید که به‌نوبه خود از سرور 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?"
}
پیدا کردن مهارت‌های دیگر Google
و درنهایت، افزونه Google Cloud Developer می‌تواند مهارت‌ها را به‌صورت درخواستی کاوش و بارگیری کند.
برای مثال، می‌توانید بپرسید:
Explain what steps are needed to start working with Firebase.
باید ببینید که مهارت finding-google-skills فعال شده است و مهارت 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
۶. پاک‌سازی
غیرفعال کردن Developer Knowledge API:
- در Google Cloud Console، Developer Knowledge API را جستجو کنید
- در صفحه Developer Knowledge API، روی مدیریت و سپس غیرفعال کردن API کلیک کنید.
حذف نصب کردن افزونه Google Cloud Developer با Antigravity CLI:
agy plugin uninstall google-cloud-developer
Uninstalled plugin "google-cloud-developer"
۷. تبریک می‌گوییم
تبریک! افزایه «توسعه‌دهنده Google Cloud» را باموفقیت در Antigravity نصب و استفاده کرده‌اید. برای کسب اطلاعات بیشتر، منابع زیر را بررسی کنید: