تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

تثبيت المكوّن الإضافي Google Cloud Developer واستخدامه في Antigravity

1. مقدمة

مهارات الوكيل هي تنسيق مفتوح وخفيف الوزن لتوسيع إمكانات وكلاء الذكاء الاصطناعي من خلال المعرفة المتخصّصة وسير العمل. MCP هو معيار لربط تطبيقات الذكاء الاصطناعي بالأنظمة الخارجية.

مواصفات المكوّنات الإضافية للوكيل هي مواصفات مفتوحة ومحايدة للمورّدين لتعبئة مهارات الوكيل وخوادم MCP في مكوّنات إضافية قابلة للنقل.

تجمع مكوّنات Google Cloud الإضافية لوكلاء ترميز الذكاء الاصطناعي مهارات Google Cloud وخوادم MCP ذات الصلة في حِزم قابلة للتثبيت من أجل توفير وكلاء ذكاء اصطناعي أكثر فعالية على Google Cloud.

في هذا الدرس التطبيقي حول الترميز، ستتعرّف على أحد هذه المكوّنات الإضافية، وهو المكوّن الإضافي Google Cloud Developer، وكيفية تثبيته واستخدامه في Antigravity.

الإجراءات التي ستنفذّها

التعرّف على مكوّنات الوكيل الإضافية
ثبِّت إضافة Google Cloud Developer واستكشِفها في Antigravity.
اختبِر المهارات وخوادم MCP التي تم تثبيتها بواسطة إضافة Google Cloud Developer باستخدام بعض الطلبات.

المتطلبات

متصفّح ويب، مثل Chrome
مشروع Google Cloud
يجب أن يكون Antigravity وAntigravity CLI مثبّتَين على جهازك.

2. استكشاف مكوّنات الوكيل الإضافية

مكوّنات الوكيل الإضافية هي تنسيق حزمة قابل للنقل لتجميع مهارات الوكيل وخوادم 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 Developer.

توفّر إضافة Google Cloud Developer إرشادات Google Cloud لوكلاء الترميز: إعداد المشروع الأول، والمصادقة واختيار بيانات الاعتماد، والتحقّق من صحة الأوامر المهمة في gcloud CLI. يتضمّن خادم MCP الخاص بـ Google Developer Knowledge للحصول على مستندات Google Cloud حديثة وموثوقة.

3- تثبيت المكوّن الإضافي Google Cloud Developer Plugin

‫Antigravity CLI هي أسهل طريقة لتثبيت مكوّنات إضافية للوكيل في نظام Antigravity المتكامل (‫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)

4. استكشاف المكوّن الإضافي للمطوّرين في Google Cloud

لنستكشف الآن إضافة 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" مع ملف بيان المكوّن الإضافي والمهارات وخادم 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 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) المثبَّتة، ولا يعرض حاليًا خوادم بروتوكول سياق النموذج كجزء من المكوّن الإضافي:

ومع ذلك، يمكنك طرح أسئلة على Antigravity في محادثة حول خوادم MCP:

Which MCP servers are available?

يجب أن يتعرّف على شهادة MCP الخاصة بمعرفة المطوّرين المثبَّتة كجزء من المكوّن الإضافي:

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

5- التمرين على المكوّن الإضافي "أدوات المطوّرين في 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?

سيظهر لك التطبيق المناسب مفعَّلاً، والذي يستخدم بدوره خادم developer-knowledge MCP:

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 الإضافي اكتشاف المهارات وتحميلها عند الطلب.

على سبيل المثال، يمكنك طرح الأسئلة التالية:

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

6. تنظيف

إيقاف واجهة برمجة التطبيقات Developer Knowledge API:

في Google Cloud Console، ابحث عن Developer Knowledge API.
في صفحة Developer Knowledge API، انقر على إدارة ثم على إيقاف واجهة برمجة التطبيقات.

ألغِ تثبيت المكوّن الإضافي Google Cloud Developer باستخدام Antigravity CLI:

agy plugin uninstall google-cloud-developer

Uninstalled plugin "google-cloud-developer"

7. تهانينا

تهانينا! لقد تمكّنت من تثبيت واستخدام إضافة Google Cloud Developer في Antigravity بنجاح. لمزيد من المعلومات، يُرجى الاطّلاع على المراجع التالية: