۱. مقدمه
مهارتهای عامل ، قالبی سبک و باز برای گسترش قابلیتهای عامل هوش مصنوعی با دانش و گردشهای کاری تخصصی است. MCP استانداردی برای اتصال برنامههای هوش مصنوعی به سیستمهای خارجی است.
مشخصات افزونههای عامل ، یک مشخصات باز و بیطرف از نظر فروشنده برای بستهبندی مهارتهای عامل و سرورهای MCP در افزونههای قابل حمل است.
افزونههای گوگل کلود برای عاملهای کدنویسی هوش مصنوعی، مهارتهای مرتبط با گوگل کلود و سرورهای MCP را در بستههای قابل نصب برای عاملهای هوش مصنوعی مؤثرتر در گوگل کلود قرار میدهند.
در این آزمایشگاه کد، شما با یکی از این افزونهها، افزونه Google Cloud Developer ، و نحوه نصب و استفاده از این افزونه در Antigravity آشنا خواهید شد.
کاری که انجام خواهید داد
- افزونههای عامل را بشناسید.
- افزونه Google Cloud Developer را در Antigravity نصب و بررسی کنید.
- مهارتهای تست و سرورهای MCP نصب شده توسط افزونه Google Cloud Developer با چند سوال.
آنچه نیاز دارید
- یک مرورگر وب مانند کروم.
- یک پروژه ابری گوگل.
- آنتیگراویتی و رابط خط فرمان آنتیگراویتی روی دستگاه محلی شما نصب شده باشند.
۲. افزونههای عامل را بررسی کنید
افزونههای عامل (Agent plugins ) یک قالب بسته قابل حمل برای دستهبندی مهارتهای عامل و سرورهای MCP در دایرکتوریای است که به شکل زیر است:
my-plugin/
├── plugin.json
├── skills/
│ └── my-skill/
│ ├── SKILL.md
│ ├── scripts/
│ └── references/
├── mcp.json
└── com.example.client/
-
plugin.jsonافزونه را شناسایی میکند. -
skills/شامل مهارتهای عامل است. -
mcp.jsonسرورهای MCP را توصیف میکند. - فضاهای نام افزونه دامنه معکوس به کلاینتهای منفرد اجازه میدهند رفتار سفارشی اضافه کنند.
مخزن مهارتهای عامل گوگل (Google Agent Skills) شامل مهارتهای عامل برای محصولات و فناوریهای گوگل، از جمله گوگل کلود (Google Cloud) است. همچنین شامل افزونههایی است که مهارتهای عامل و سرورهای MCP را در بستههای قابل نصب مانند افزونه توسعهدهنده گوگل کلود (Google Cloud Developer) قرار میدهد.
افزونه Google Cloud Developer راهنماییهای Google Cloud را برای عوامل کدنویسی ارائه میدهد: راهاندازی اولیه پروژه، احراز هویت و انتخاب اعتبارنامه، و اعتبارسنجی ایمنی-حیاتی برای دستورات gcloud CLI. شامل سرور MCP دانش توسعهدهنده Google برای مستندات بهروز و مبتنی بر Google Cloud است.
۳. افزونه توسعهدهنده گوگل کلود را نصب کنید
رابط خط فرمان آنتیگراویتی (Antigravity CLI) سادهترین راه برای نصب افزونههای عامل برای کل اکوسیستم آنتیگراویتی (Antigravity، Antigravity CLI، Antigravity IDE) است.
بیایید افزونه Google Cloud Developer را در Antigravity CLI با اشاره به مسیر آن نصب کنیم:
agy plugin install https://github.com/google/skills/plugins/cloud/google-cloud-developer
شما باید افزونه را به همراه برخی مهارتها و یک سرور 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)
۴. افزونه توسعهدهنده گوگل کلود را بررسی کنید
حالا بیایید افزونه Google Cloud Developer را بررسی کنیم.
ابتدا، بررسی کنید که افزونه در Antigravity CLI فهرست شده باشد:
agy plugin list
{
"imports": [
{
"name": "google-cloud-developer",
"source": "antigravity",
"importedAt": "2026-09-04T10:41:05Z",
"components": [
"skills",
"mcpServers"
]
}
]
}
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 خواهید یافت. همچنین شامل سرور MCP دانش توسعهدهندگان گوگل برای مستندات بهروز و مبتنی بر گوگل کلود میشود.
همچنین میتوانید به Antigravity بروید و در چت بپرسید که کدام مهارتها نصب شدهاند:
Which skills are available?
این باید مهارتهای داخلی Antigravity و همچنین مهارتهای افزونه 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.
علاوه بر این، به تنظیمات > سفارشیسازیها بروید، باید ببینید که این مهارتها نیز در آنجا موجود هستند:
توجه: در بخش سفارشیسازیها، بخشی به نام سرورهای MCP نصبشده وجود دارد و در حال حاضر، سرورهای MCP به عنوان بخشی از افزونه نمایش داده نمیشوند:
با این حال، میتوانید در چت از Antigravity در مورد سرورهای MCP سوال کنید:
Which MCP servers are available?
باید MCP مربوط به Developer Knowledge را که به عنوان بخشی از افزونه نصب شده است، تشخیص دهد:
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
۵. افزونه توسعهدهنده گوگل کلود را تمرین کنید
فعال کردن API دانش توسعهدهنده
ابتدا مطمئن شوید که رابط برنامهنویسی کاربردی ( API) دانش توسعهدهندگان (Developer Knowledge API) در پروژه گوگل کلود شما فعال است. این برای سرور MCP دانش توسعهدهندگان (Developer Knowledge MCP) مورد نیاز است:
- در کنسول ابری گوگل، عبارت Developer Knowledge API را جستجو کنید.
- در صفحهی «API دانش توسعهدهندگان» ، روی «فعال کردن API» کلیک کنید.
حالا بیایید چند دستور را امتحان کنیم تا ببینیم افزونه Google Cloud Developer چگونه در سناریوهای مختلف کمک میکند.
شما میتوانید این دستورات را در Antigravity یا Antigravity CLI امتحان کنید، زیرا این افزونه به صورت جهانی در دسترس است.
استخدام
اگر در گوگل کلود تازهکار هستید، میتوانید با پرسیدن یک سوال مقدماتی شروع کنید:
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
...
دانش توسعهدهنده
همچنین میتوانید سوالات خود را از طریق مستندات رسمی بپرسید تا به آنها پاسخ داده شود.
برای مثال:
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 Cloud Developer میتواند مهارتها را بر اساس تقاضا کشف و بارگذاری کند.
برای مثال، میتوانید بپرسید:
I want to start using 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 را جستجو کنید.
- در صفحهی «دانش توسعهدهندگان API» ، روی «مدیریت» و سپس «غیرفعال کردن API» کلیک کنید.
افزونه Google Cloud Developer را با استفاده از Antigravity CLI حذف نصب کنید:
agy plugin uninstall google-cloud-developer
Uninstalled plugin "google-cloud-developer"
۷. تبریک
تبریک! شما با موفقیت افزونه Google Cloud Developer را در Antigravity نصب و استفاده کردید. برای کسب اطلاعات بیشتر، منابع زیر را بررسی کنید: