بدء استخدام إضافات Gemini CLI

1. مقدمة

‫Gemini CLI هو وكيل مفتوح المصدر مستند إلى الذكاء الاصطناعي مخصّص لتلقّي طلباتك، وهو يتيح لك الاستفادة من قدرات نماذج Gemini مباشرةً من سطر الأوامر. على الرغم من أنّ Gemini CLI قوي بحد ذاته، إلا أنّ إمكاناته الحقيقية تظهر عند استخدام إضافات Gemini CLI.

الإضافات هي الطريقة الرسمية والموحّدة لتعزيز إمكانات Gemini CLI. قبل توفّر الإضافات، كان تخصيص واجهة سطر الأوامر يتطلّب غالبًا تعديل ملفات الإعداد يدويًا، مثل settings.json، وهي عملية يمكن أن تكون "غير منظَّمة وعرضة للأخطاء".

يمكنك اعتبار الإضافة بمثابة "حاوية شحن" لتخصيصات Gemini CLI. وهي حزمة مستقلة وقابلة للتعديل ويمكن توزيعها بسهولة، وتجمع كل المكوّنات اللازمة لتعليم Gemini مجموعة جديدة من المهارات. يمكن أن يشمل "حاوية الشحن" ما يلي :

• إعدادات خادم MCP: تربط هذه الإعدادات Gemini بالأدوات وواجهات برمجة التطبيقات الخارجية، مثل واجهات برمجة تطبيقات Google Cloud أو الخدمات التابعة لجهات خارجية.
• ملفات السياق (GEMINI.md): هي "كتيبات إرشادات" تزود النموذج بتعليمات وإرشادات محددة حول كيفية استخدام الأدوات الجديدة بفعالية.
• أوامر الشرطة المائلة المخصّصة (ملفات ‎.toml): تعمل هذه الأوامر على دمج الطلبات المعقّدة والمتعدّدة الخطوات في أوامر بسيطة وسهلة الاستخدام، مثل ‎ /deploy.
• قيود الأدوات (excludeTools): يمكن أن تؤدي هذه القيود إلى إيقاف الأدوات المضمّنة لإنشاء بيئة أكثر أمانًا أو تركيزًا.

تتمثّل القيمة الأساسية للإضافات في تحويل Gemini CLI من مساعد شخصي إلى منصة قابلة للتوسّع وجاهزة للاستخدام في المؤسسات. يمكن للفريق تجميع حزمة السحابة الإلكترونية بأكملها في إضافة واحدة، ما يتيح للمطوّرين الجدد بدء العمل بإنتاجية عالية باستخدام أمر واحد.

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

المهام التي ستنفذها

• ثبِّت واجهة سطر الأوامر (CLI) الخاصة بـ Gemini واضبطها، بالإضافة إلى المتطلبات الأساسية في Google Cloud.
• تصفَّح معرض إضافات Gemini CLI الرسمي للعثور على الإضافات.
• استخدِم واجهة سطر الأوامر gemini extensions لتثبيت الإضافات وعرضها وإدارتها.
• استكشاف بعض إضافات Gemini CLI

ما ستتعلمه

• ما هي إضافات Gemini CLI ولماذا تُعتبر المعيار لتخصيص واجهة سطر الأوامر؟
• كيفية العثور على الإضافات وتثبيتها من "معرض الإضافات" أو عنوان URL على GitHub
• وظيفة أوامر إدارة المفاتيح: gemini extensions install وgemini extensions list وgemini extensions update
• تثبيت واستخدام بعض إضافات Gemini CLI

المتطلبات

• متصفّح الويب Chrome
• حساب Gmail
• مشروع على السحابة الإلكترونية تم تفعيل الفوترة فيه

تم تصميم هذا الدرس التطبيقي للمستخدمين والمطوّرين من جميع المستويات (بما في ذلك المبتدئين). يُفترض أن تكون على دراية بـ Gemini CLI، ولكن سيتم توفير خطوات لتثبيت Gemini CLI من البداية. إذا أردت التعرّف على Gemini CLI، جرِّب هذا الدرس العملي: استخدام Gemini CLI.

2. قبل البدء

إنشاء مشروع

1. في Google Cloud Console، ضمن صفحة اختيار المشروع، اختَر أو أنشِئ مشروعًا على Google Cloud.
2. تأكَّد من تفعيل الفوترة لمشروعك على Cloud. تعرَّف على كيفية التحقّق مما إذا كانت الفوترة مفعَّلة في مشروع.

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

3. ستستخدم Cloud Shell، وهي بيئة سطر أوامر تعمل في Google Cloud ومحمّلة مسبقًا بأداة bq. انقر على "تفعيل Cloud Shell" في أعلى "وحدة تحكّم Google Cloud".

4. بعد الاتصال بـ Cloud Shell، تحقَّق من أنّك قد تمّت مصادقتك وأنّه تم ضبط المشروع على معرّف مشروعك باستخدام الأمر التالي:

gcloud auth list

5. نفِّذ الأمر التالي في Cloud Shell للتأكّد من أنّ أمر gcloud يعرف مشروعك.

gcloud config list project

6. إذا لم يتم ضبط مشروعك، استخدِم الأمر التالي لضبطه:

gcloud config set project <YOUR_PROJECT_ID>

7. فعِّل واجهات برمجة التطبيقات المطلوبة من خلال الأمر الموضّح أدناه. قد تستغرق هذه العملية بضع دقائق، لذا يُرجى الانتظار.

gcloud services enable cloudresourcemanager.googleapis.com \
                       servicenetworking.googleapis.com \
                       run.googleapis.com \
                       cloudbuild.googleapis.com \

عند تنفيذ الأمر بنجاح، من المفترض أن تظهر لك رسالة مشابهة للرسالة الموضّحة أدناه:

Operation "operations/..." finished successfully.

في حال عدم توفّر أي واجهة برمجة تطبيقات، يمكنك تفعيلها في أي وقت أثناء عملية التنفيذ.

راجِع المستندات لمعرفة أوامر gcloud وطريقة استخدامها.قبل إعداد Gemini CLI وتشغيله، لننشئ مجلدًا ستستخدمه كمجلد رئيسي لجميع المشاريع التي قد تنشئها داخله. هذه هي نقطة البداية التي ستعمل عليها واجهة سطر الأوامر في Gemini، مع أنّها ستشير أيضًا إلى بعض المجلدات الأخرى على نظامك والتي ستتعرّف عليها لاحقًا حسب الحاجة.

أنشئ مجلدًا نموذجيًا (gemini-cli-projects) وانتقِل إليه باستخدام الأوامر الموضّحة أدناه. إذا كنت تفضّل استخدام اسم مجلد آخر، يمكنك ذلك.

mkdir gemini-cli-projects

لننتقل إلى هذا المجلد:

cd gemini-cli-projects

ملاحظة: إذا كنت تستخدم Google Cloud Shell، يكون Gemini CLI مثبّتًا تلقائيًا.

يمكنك تشغيل Gemini CLI مباشرةً من خلال الأمر gemini في نافذة طرفية جديدة في Cloud Shell، أو قد تم تشغيله مسبقًا في نافذة طرفية منفصلة في Cloud Shell.

تفاعلنا الأول مع Gemini CLI

علينا التأكّد من أنّ كل شيء على ما يرام في بيئة Gemini CLI، حتى نتمكّن من تقديم الطلب الأول كما هو موضّح أدناه:

Give me a famous quote on Artificial Intelligence and who said that?

ستلاحظ أنّ طلب البحث الخاص بنا أدى إلى استدعاء أداة GoogleSearch (أداة مدمجة في Gemini CLI). بعبارة أخرى، لقد استخدمت إحدى أدوات Gemini CLI المضمّنة الفعّالة، وهي GoogleSearch التي تستند في ردودها إلى المعلومات التي تحصل عليها من الويب. من المفترض أن تتلقّى ردًا على طلبك.

لنبدأ الآن بالحديث عن "الإضافات".

3- ما هي الإضافة؟

الإضافة هي حزمة مستقلة وقابلة للتحديث ويمكن توزيعها بسهولة. يمكنك اعتبارها "حاوية الشحن" لتخصيصات Gemini CLI، إذ تجمع كل ما يلزم لمسار عمل معيّن في حزمة واحدة منظَّمة.

يمكن أن تتضمّن الإضافة أي مجموعة من العناصر التالية:

• أوامر مخصّصة تبدأ بشرطة مائلة (ملفات ‎ .toml).
• إعدادات خادم MCP (التي كانت متوفّرة سابقًا في settings.json)
• ملفات السياق (GEMINI.md) لتقديم تعليمات وإرشادات محدّدة للنموذج
• قيود الأدوات (excludeTools) لإنشاء بيئة أكثر أمانًا وتركيزًا

لماذا يجب استخدام الإضافات؟ المزايا الأساسية

يوفّر استخدام الإضافات في عمليات التخصيص العديد من المزايا الفعّالة:

• التثبيت باستخدام أمر واحد: هذه ميزة أساسية. بدلاً من عملية إعداد يدوية متعدّدة الخطوات، يمكن للمستخدم تثبيت مجموعة أدوات كاملة ومعقّدة باستخدام أمر واحد: gemini extensions install <URL> أو gemini extensions install --path=some/local/path. يمكن أن يكون <URL> في الأمر أعلاه هو عنوان URL الخاص بـ Github الذي استضفت فيه الإضافة.
• سهولة التوزيع: أصبحت مشاركة عملك سهلة مثل مشاركة عنوان URL واحد لمستودع Git. لن تحتاج بعد الآن إلى تبادل الملفات الفردية ومقتطفات الإعدادات.
• إدارة الإصدارات والتبعيات: بما أنّ الإضافات تتم استضافتها عادةً في مستودعات Git، يمكنك الحصول على ميزة التحكّم في الإصدارات مجانًا. هناك gemini extensions update command لتحديث إضافة إلى أحدث إصدار.
• إمكانية الاكتشاف والمنظومة المتكاملة: تشكّل الإضافات الأساس لمنظومة متكاملة غنية ومفتوحة، تمامًا مثل الأسواق الخاصة بـ VS Code أو Chrome. يمكن أن تشكّل آلية "الإضافات" أساسًا لسوق مستقبلي حيث تتوفّر هذه "الإضافات" للمراجعة والتنزيل وغير ذلك، بأسلوب المنتدى الحقيقي.

إنّ طرح إطار عمل الإضافات هو إشارة واضحة إلى أنّ Gemini CLI يتطوّر من أداة مستقلة وفعّالة إلى منصة قابلة للتوسيع.

4. فهم أساسيات الإضافات

يتناول هذا القسم الأجزاء التي تظهر للمستخدمين في منظومة الإضافات المتكاملة: العثور على الإضافات وإدارتها.

استكشاف "معرض الإضافات"

معرض الإضافات هو السوق المركزي لاكتشاف جميع الإضافات الرسمية التي أنشأتها Google وتلك التي أنشأتها جهات خارجية:

1. افتح عنوان URL التالي في المتصفّح: https://geminicli.com/extensions/browse/.
2. هذا المعرض هو محرك البحث عن التطبيقات في النظام المتكامل. يمكنك الاطّلاع على "الإضافات" من شركات مثل GitHub وRedis وDynaTrace، ما يوضّح مدى توفّر الأدوات.
3. انتقِل للأسفل وابحث عن بطاقة إضافة Cloud Run.
4. لاحظ أنّ البطاقة تقدّم وصفًا والمؤلف (Google) وزرّ أمر Copy install بنقرة واحدة. هذه هي أبسط طريقة للحصول على أمر تثبيت إضافة.

إضافات Gemini CLI - أوامر الإدارة

الأمر gemini extensions هو نقطة الدخول لإدارة الإضافات المحلية.

شغِّله في الوحدة الطرفية للاطّلاع على قائمة الأوامر المتاحة.

الأوامر بسيطة (تثبيت/إلغاء التثبيت، وإدراج، وتعديل، وتفعيل/إيقاف، وما إلى ذلك)، وسنستخدم بعض هذه الأوامر في هذا الدرس التطبيقي حول الترميز.

الاطّلاع على حالتك الحالية

قبل تثبيت أي شيء، لنراجع "الوضع التلقائي".

1. نفِّذ الأمر gemini extensions list:
2. من المفترض أن تظهر لك النتيجة التالية التي تؤكّد أنّه لم يتم تثبيت أي إضافات بعد.

No extensions installed.

5- إضافة Cloud Run (نشر تطبيق)

إضافة Cloud Run المتوفّرة في معرض إضافات Gemini CLI هي خادم MCP يتيح لنا نشر تطبيقاتنا على Cloud Run.

في ما يلي بطاقة "إضافة Cloud Run" من معرض "الإضافات":

لنبدأ أولاً بتثبيت إضافة Cloud Run من خلال النقر على نسخ أمر التثبيت كما هو موضّح أعلاه. بعد ذلك، الصِق هذا الأمر في وحدة Cloud Shell الطرفية (يجب أن يكون مشابهاً لما يلي):

gemini extensions install https://github.com/GoogleCloudPlatform/cloud-run-mcp

عند تنفيذ الأمر أعلاه، سيظهر لك طلب تأكيد. يُرجى الموافقة على ذلك. بعد ذلك، من المفترض أن يتم تثبيت إضافة Cloud Run بنجاح.

Installing extension "cloud-run".
**Extensions may introduce unexpected behavior. Ensure you have investigated the extension source and trust the author.**
This extension will run the following MCP servers:
  * cloud-run (local): npx -y @google-cloud/cloud-run-mcp
This extension will append info to your gemini.md context using gemini-extension/GEMINI.md
Do you want to continue? [Y/n]: Y
Extension "cloud-run" installed successfully and enabled.

إذا نفّذت الآن أمر قائمة إضافات Gemini، من المفترض أن ترى إضافة Cloud Run مثبَّتة كما هو موضّح أدناه:

✓ cloud-run (1.0.0)
 Path: <HOME_FOLDER>/.gemini/extensions/cloud-run
 Source: https://github.com/GoogleCloudPlatform/cloud-run-mcp (Type: github-release)
 Release tag: v1.5.0
 Enabled (User): true
 Enabled (Workspace): true
 Context files:
  <HOME_FOLDER>/.gemini/extensions/cloud-run/gemini-extension/GEMINI.md
 MCP servers:
  cloud-run

إذا شغّلت Gemini CLI الآن ونفّذت الأمر /mcp، سيظهر لك ما يلي:

لنرجع الآن إلى Cloud Shell ونحاول نشر تطبيق. لإجراء ذلك، سنحتاج أولاً إلى تطبيق بسيط لنشره على Cloud Run. يُرجى اتّباع الخطوات التالية:

تأكَّد من أنّك في المجلد الذي أنشأناه سابقًا، أي gemini-cli-projects. أنشئ مجلدًا آخر داخل هذا المجلد باسم gemini-cloud-run وانتقِل إليه.

mkdir gemini-cloud-run

cd gemini-cloud-run

الآن، أنشئ ملفَين في هذا المجلد (الملف app.py والملف requirements.txt)، ويتم عرض محتوياتهما أدناه:

app.py

from flask import Flask
app = Flask(__name__)
@app.route('/')
def hello_world():
  return 'Hello from Gemini and Cloud Run!'
if __name__ == "__main__":
  app.run(debug=True, host='0.0.0.0', port=8080)

requirements.txt

Flask
gunicorn

الآن، شغِّل Gemini CLI من المجلد gemini-cloud-run، وبعد أن يصبح الجهاز جاهزًا، أدخِل الطلب التالي:

/deploy --project="PROJECT_ID" --location="PROJECT_LOCATION" --name="SERVICE_NAME"

عليك تحديد PROJECT_ID (معرّف مشروع Google Cloud) وPROJECT_LOCATION وSERVICE_NAME. إذا لم تقدّم هذه المعلومات، يستدعي أمر Cloud Run الأدوات المناسبة لمساعدتك في اختيارها.

وكجزء من العملية، سيتم اختيار الأداة المناسبة من "إضافة خادم MCP" في Cloud Run التي ثبّتناها. على سبيل المثال، من المفترض أن تظهر لك رسالة على النحو التالي:

يُرجى السماح باستخدام الأداة.

هذا كل شيء! يتضمّن Gemini CLI الآن جميع المعلومات التي يحتاج إليها بالإضافة إلى إذنك بتنفيذ الأدوات. سيتم الآن تنفيذ مسار النشر بالكامل: إنشاء صورة Docker، ونقلها إلى Artifact Registry، وإعداد خدمة Cloud Run جديدة ونشرها.

بعد بضع لحظات (في الواقع، من دقيقتَين إلى 3 دقائق)، ستظهر لك رسالة نجاح تتضمّن عنوان URL للخدمة. في ما يلي نموذج لعملية التنفيذ:

The Cloud Run service SERVICE_NAME has been deployed from the current folder in project PROJECT_ID.
  You can view the service in the Cloud Console: https://console.cloud.google.com/run/detail/PROJECT_LOCATION/SERVICE_NAME?project=PROJECT_ID
  The service is accessible at: https://SERVICE_NAME-SOME-ID.a.run.app

انقر على هذا الرابط. من المفترض أن يظهر تطبيق Flask يعرض الصفحة الرئيسية:

يوضّح لك هذا المثال قوة إحدى إضافات Gemini CLI (Cloud Run في هذه الحالة)، حيث إنّها غطّت تمامًا تعقيد أوامر gcloud CLI واهتمّت بكل التفاصيل نيابةً عنك.

يمكنك استكشاف أدوات أخرى في خادم MCP على Cloud Run.

6. إضافة BigQuery (تحليل مجموعات البيانات الكبيرة)

للمتابعة، ستحتاج إلى:

• مشروع Google Cloud تم تفعيل BigQuery API فيه
• أذونات "إدارة الهوية وإمكانية الوصول":
• مستخدم BigQuery (roles/bigquery.user)

1. نفِّذ هذا الأمر لضبط متغيّر البيئة BIGQUERY_PROJECT. هذا هو المشروع الذي سيتم فيه تنفيذ مهام BigQuery، وليس بالضرورة المشروع الذي يتم فيه تخزين بياناتك (على الرغم من أنّهما قد يكونان متطابقَين).

export BIGQUERY_PROJECT=<YOUR_GCP_PROJECT_ID>

2. ثبِّت إضافة BigQuery Data Analytics من خلال الأمر أدناه. يُرجى منح التطبيق الإذن بالتثبيت. بعد اكتمال عملية التثبيت بنجاح، سيتم تثبيت وظيفتَين إضافيتَين في إعدادك : cloud-run وbigquery-data-analytics.

gemini extensions install https://github.com/gemini-cli-extensions/bigquery-data-analytics

3. لنطلق Gemini CLI مرة أخرى باستخدام الأمر التالي:

gemini

من المفترض أن يتم تشغيل Gemini CLI في نافذة الأوامر:

يجب إدخال الأوامر التالية في وحدة طرفية لواجهة سطر الأوامر في Gemini.

4. تأكَّد من تثبيت إضافة BigQuery وأنّها جاهزة للاستخدام من خلال إدخال أمر الشرطة المائلة أدناه:

/extensions list

من المفترض أن تظهر لك الإضافة bigquery-data-analytics أيضًا.

5. نفِّذ الأمر التالي للاطّلاع على الأدوات المتاحة.

/mcp list

6. لنطرح سؤالاً أساسيًا حول الإحصاءات بشأن مجموعة بيانات BigQuery العامة: التجارة الإلكترونية في Look. تحتوي مجموعة البيانات هذه على بيانات حول العملاء والمنتجات والطلبات لموقع إلكتروني وهمي للتجارة الإلكترونية خاص بالملابس. أدخِل الطلب التالي في Gemini CLI:

Look at BigQuery's the look ecommerce public dataset. Identify the top 5 products that had the most orders.

• سيسألك Gemini CLI عمّا إذا كنت تريد السماح بتنفيذ أدوات BigQuery. للمتابعة، انقر على الخيار الثالث: Yes, always allow all tools from server "bigquery_data_analytics".
• في الخلفية، سينشئ Gemini طلب بحث SQL المناسب، ويستدعي أداة execute_sql، ويعرض ردًا باللغة الطبيعية إلى جانب بياناتك:

7. الآن، سنطلب من Gemini توقّع معدّل إرجاع المنتجات استنادًا إلى البيانات السابقة. بالنسبة إلى هذا الأمر، يجب ألا تحاول Gemini CLI إنشاء بعض عبارات SQL المطوّلة لإنشاء هذه التوقعات، بل يجب أن تستدعي الأداة forecast من خادم MCP، الذي سيستخدم AI.Forecast من BigQuery في الخلفية:

Forecast what the return rate will be next month.

• من المفترض أن يظهر لك ردّ على النحو التالي:

7. استكشاف المزيد

بهذا نكون قد أكملنا جلسة التدريب العملي التي تناولنا فيها ماهية إضافات Gemini CLI والأوامر الأساسية لاستخدامها، واستكشفنا إضافتين : إضافة cloud-run وإضافة bigquery-data-analytics.

يمكنك زيارة "معرض إضافات Gemini" على الرابط https://geminicli.com/extensions/ لاستكشاف الإضافات المتوفّرة حاليًا (أكثر من 100 إضافة في وقت كتابة هذا الرد) والتي يمكنك استخدامها اليوم. تحتوي كل بطاقة من بطاقات الإضافات على معلومات ونوع الإضافة (مثل MCP أو Context وما إلى ذلك) بالإضافة إلى رابط مستودع GitHub وأمر لتثبيت الإضافة في بيئتك.

8. تهانينا

تهانينا، لقد تعرّفت بنجاح على إضافات Gemini CLI وكيفية تثبيت إضافات Gemini CLI المختلفة واستخدامها.

المستندات المرجعية

• إضافات Gemini CLI
• معرض إضافات Gemini CLI