إعداد ميزة Gemini Code Assist (الإصداران Standard وEnterprise)

لكي تتمكّن من استخدام Gemini Code Assist، على فريقك تنفيذ خطوات الإعداد الموضّحة في هذا المستند:

  1. اشترِ اشتراكًا في Gemini Code Assist.

  2. منح تراخيص لمستخدمين فرديين في مؤسستك

  3. فعِّل واجهة برمجة التطبيقات Gemini for Google Cloud في مشروع على Google Cloud.

  4. منح أدوار إدارة الهوية والوصول في مشروع على Google Cloud

  5. يُثبِّت مستخدمو مؤسستك المكوّن الإضافي Gemini Code Assist لاستخدام Gemini Code Assist في بيئة تطوير متكاملة.

شراء اشتراك في Gemini Code Assist

للحصول على قائمة بالميزات المتاحة في كل إصدار، يُرجى الاطّلاع على الميزات المتوافقة.

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

يتوفّر Gemini Code Assist Enterprise مقابل 19 دولار أمريكي في الشهر لكل مستخدم مع التزام لمدة 12 شهرًا حتى 31 آذار (مارس) 2025. يُرجى التواصل مع فريق المبيعات للاستفادة من هذا العرض الترويجي.

إذا كانت لديك عقود حالية مع Google Cloud، يُرجى التواصل مع فريق المبيعات قبل شراء اشتراك.

  1. انتقِل إلى صفحة Gemini في Google Cloud.

    الانتقال إلى "Gemini في Google Cloud"

    ستفتح صفحة Gemini لـ Google Cloud.

  2. انقر على الحصول على ميزة Gemini Code Assist. يُرجى العِلم أنّه إذا لم يتم شراء اشتراك في Gemini Code Assist باستخدام حساب الفوترة، ستظهر رسالة مؤهَّل للاستفادة من فترة تجريبية لمدة 30 يومًا لما يصل إلى 50 ترخيصًا بدون تكلفة. إذا كان مشروعك يتضمّن ميزة Gemini Code Assist، سيظهر النص إدارة ميزة Gemini Code Assist.

    ستفتح صفحة الحصول على اشتراك في Gemini Code Assist.

  3. في اختيار إصدار اشتراك Gemini Code Assist، اختَر إصدار Gemini Code Assist. انقر على المقارنة بين إصدارات Gemini Code Assist للاطّلاع على قائمة تفصيلية بالميزات المتاحة لكل إصدار.

    بعد ذلك، انقر على متابعة.

  4. في قسم ضبط الاشتراك، أكمِل الحقول لضبط الاشتراك، بما في ذلك ما يلي:

    • اسم الاشتراك
    • عدد التراخيص في الاشتراك يُرجى العلم أنّه في حال شراء إصدار Enterprise، يجب شراء 10 تراخيص على الأقل.
    • مدة الاشتراك (شهرية أو سنوية) من خلال الاشتراك السنوي، يتم منحك سعرًا مخفَّضًا يتم تحصيله شهريًا بدلاً من دفعة واحدة.
    • التجديد التلقائي لاشتراكك بعد انتهاء مدة الالتزام (شهريًا أو سنويًا) يحافظ التجديد التلقائي على اشتراكك والتراخيص نشطة. إذا لم يتم تجديد الاشتراك تلقائيًا، سينتهي عند انتهاء الفترة الحالية، وعليك إكمال عملية الشراء مرة أخرى وإعادة منح التراخيص.

  5. لتأكيد الاشتراك، انقر على متابعة.

  6. إذا كنت توافق على البنود، انقر على أوافق على بنود عملية الشراء هذه، ثمّ انقر على تأكيد الاشتراك.

  7. انقر على التالي: إدارة عمليات منح تراخيص Gemini.

تم الآن شراء الاشتراك في Gemini Code Assist. عليك الآن إدارة عمليات منح تراخيص Gemini في مؤسستك.

منح التراخيص

قبل استخدام ميزة "مساعدة ترميز Gemini"، يحتاج كل مستخدم فردي في مؤسستك إلى ترخيص.

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

وحدة التحكّم واجهة برمجة التطبيقات

لتخصيص تراخيص Gemini للمستخدمين الفرديين في Google Cloud Console، يجب أن تكون لديك الأذونات التالية:

  • billing.accounts.get
  • consumerprocurement.orders.get
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.assign

  1. انتقِل إلى صفحة مشرف Gemini.

    الانتقال إلى "Gemini في Google Cloud"

  2. اختَر الاشتراك الذي تريد تغييره، ثم انقر على تعديل الاشتراك.

  3. انقر على منح التراخيص. سيظهر مربّع حوار اختيار المستخدم. للبحث عن مستخدمين معيّنين، أدخِل أسمائهم في مربّع البحث.

  4. اختَر مستخدمًا واحدًا أو أكثر من القائمة، ثم انقر على التالي.

  5. اختَر خدمات Gemini التي تريد تخصيص تراخيص لها.

  6. انقر على منح التراخيص.

لتعيين تراخيص Gemini باستخدام واجهة برمجة التطبيقات، يجب أن يكون لديك إذن consumerprocurement.licensePools.assign.

طريقة HTTP: POST

عنوان URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

غيِّر القيم في السلسلة على الشكل التالي:

  • BILLING_ACCOUNT_ID: رقم تعريف حساب الفوترة
  • ORDER_ID: سياسة إدارة الهوية وإمكانية الوصول

نص الطلب:

    {
        "usernames": [
                  "dana@example.com",
                  "lee@example.com"
        ]
    }

تكون النتيجة مشابهة لما يلي:

{}

يكون الردّ فارغًا إذا تمّ منح الترخيص بنجاح.

عليك الآن تفعيل Gemini for Google Cloud API في مشروع واحد أو أكثر مرتبطَين بحساب الفوترة هذا. لن يظهر ميزة Gemini Code Assist للمستخدمين إلى أن تفعّلها في مشروع واحد على الأقل.

تفعيل واجهة برمجة التطبيقات Gemini for Google Cloud في مشروع على Cloud

يوضّح هذا القسم الخطوات المطلوبة لتفعيل واجهة برمجة التطبيقات Gemini for Google Cloud API في مشروع على Cloud.

وحدة التحكّم gcloud

  1. لتفعيل واجهة برمجة التطبيقات Gemini في Google Cloud، انتقِل إلى صفحة Gemini في Google Cloud.

    الانتقال إلى "Gemini في Google Cloud"

  2. في أداة اختيار المشاريع، اختَر مشروعًا.

  3. انقر على تفعيل.

    يتم تعديل الصفحة وتعرض الحالة مفعَّل. أصبح Gemini متاحًا الآن في مشروع Cloud المحدّد لجميع المستخدمين الذين لديهم أدوار إدارة الهوية وإمكانية الوصول المطلوبة.

لاستخدام بيئة تطوير محلية، عليك تثبيت و إعداد gcloud CLI.

  1. في قائمة أداة اختيار المشاريع، اختَر مشروعًا.

  2. فعِّل واجهة برمجة التطبيقات Gemini for Google Cloud API لخدمة Gemini باستخدام gcloud services enable: 

    gcloud services enable cloudaicompanion.googleapis.com

    إذا كنت تريد تفعيل واجهة برمجة التطبيقات Gemini for Google Cloud في مشروع مختلف على Cloud، أضِف المَعلمة --project:

    gcloud services enable cloudaicompanion.googleapis.com --project PROJECT_ID

    استبدِل PROJECT_ID برقم تعريف مشروعك على Cloud.

    تكون النتيجة مشابهة لما يلي:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

تتوفّر خدمة Gemini في Google Cloud الآن في مشروع Cloud المحدّد لجميع المستخدمين الذين لديهم أدوار إدارة الهوية وإمكانية الوصول المطلوبة.

واجهات برمجة التطبيقات المطلوبة للمستخدمين الذين يستخدمون جدران الحماية

بالإضافة إلى تفعيل Gemini لـ Google Cloud، قد يحتاج المستخدمون الذين يستخدمون جدران الحماية أيضًا إلى تفعيل واجهات برمجة التطبيقات التالية:

  • ‫oauth2.googleapis.com: يُستخدَم لتسجيل الدخول إلى Google Cloud.
  • ‫serviceusage.googleapis.com: يُستخدَم للتحقّق من ضبط إعدادات مشروع Gemini Code Assist الخاص بالمستخدم بشكلٍ سليم.
  • ‫cloudaicompanion.googleapis.com: نقطة نهاية Gemini الأساسية لواجهة برمجة التطبيقات Google Cloud API
  • ‫cloudcode-pa.googleapis.com: واجهة برمجة تطبيقات داخلية توفّر ميزات مرتبطة بالبيئة IDE
  • ‫cloudresourcemanager.googleapis.com: يُستخدَم في حِزم تطوير البرامج (IDE) لأدوات اختيار المشاريع. قد لا تكون واجهة برمجة التطبيقات Resource Manager API ضرورية إذا تم ضبط المشاريع صراحةً في ملف settings.json.
  • ‫people.googleapis.com: تتيح الوصول إلى معلومات عن الملفات الشخصية وجهات الاتصال.
  • ‫firebaselogging-pa.googleapis.com: واجهة برمجة تطبيقات داخلية تُستخدَم لإرسال قياسات اتّباع المستخدِمين للمنتجات، بما في ذلك الأحداث المتعلّقة بما إذا تم قبول الاقتراحات.
  • ‫feedback-pa.googleapis.com: واجهة برمجة تطبيقات داخلية تُستخدَم لإرسال ملاحظات IDE.
  • ‫apihub.googleapis.com: تستخدمه ميزة "متصفّح واجهة برمجة التطبيقات Cloud Code API".

اختياري: ضبط عناصر التحكّم في خدمة VPC

إذا كانت مؤسستك تمتلك حدود خدمة، عليك إضافة موارد العميل التالية إلى حدودك:

  • واجهة برمجة التطبيقات Gemini لـ Google Cloud
  • Gemini Code Assist API

إذا كنت تستخدم ميزة "مساعدة ترميز Gemini" من خارج حدود خدمتك، عليك أيضًا تعديل سياسة الدخول للسماح بالوصول إلى هذه الخدمات.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط عناصر التحكّم في خدمة سحابة VPC لتطبيق Gemini.

منح أدوار إدارة الهوية وإمكانية الوصول في مشروع على Google Cloud

يصف هذا القسم الخطوات المطلوبة لمنح المستخدمين دورَي "مستخدم Gemini لخدمات Google Cloud" و"مستخدِم إدارة الخدمات" في "إدارة الهوية وإمكانية الوصول".

وحدة التحكّم gcloud

  1. لمنح أدوار إدارة الهوية وإمكانية الوصول المطلوبة لاستخدام Gemini، انتقِل إلى صفحة إدارة الهوية وإمكانية الوصول والمشرف.

    الانتقال إلى "إدارة الهوية وإمكانية الوصول والمشرف"

  2. في عمود المشرف، ابحث عن مشرف الذي تريد منحه إذن الوصول إلى Gemini، ثم انقر على تعديل المشرف في هذا الصف.

  3. في لوحة تعديل إذن الوصول، انقر على إضافة دور آخر.

  4. في اختيار دور، اختَر مستخدم Gemini في Google Cloud.

  5. انقر على إضافة دور آخر واختَر مستخدِم استخدام الخدمة.

  6. انقر على حفظ.

لاستخدام بيئة تطوير محلية، عليك تثبيت و إعداد gcloud CLI.

  1. في قائمة أداة اختيار المشاريع، اختَر مشروعًا.

  2. امنح دور "مستخدم Gemini لـ Google Cloud":

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/cloudaicompanion.user

    استبدِل PRINCIPAL بمعرّف العميل الرئيسي. يكون المعرّف على شكل user|group|serviceAccount:email أو domain:domain، على سبيل المثال، user:cloudysanfrancisco@gmail.com أو group:admins@example.com أو serviceAccount:test123@example.domain.com أو domain:example.domain.com.

    الناتج هو قائمة بعمليات ربط السياسات التي تتضمّن ما يلي:

    - members:
  - user:PRINCIPAL
  role: roles/cloudaicompanion.user

  3. امنح دور "مستخدِم استخدام الخدمة":

    gcloud projects add-iam-policy-binding  PROJECT_ID \
    --member=PRINCIPAL --role=roles/serviceusage.serviceUsageConsumer

    الناتج هو قائمة بعمليات ربط السياسات التي تتضمّن ما يلي:

    - members:
  - user:PRINCIPAL
  role: roles/serviceusage.serviceUsageConsumer

لمزيد من المعلومات، يُرجى الاطّلاع على منح دور واحد و gcloud projects add-iam-policy-binding.

يمكن لجميع المستخدمين الذين تم منحهم هذه الأدوار الوصول إلى ميزات Gemini لـ Google Cloud في وحدة تحكّم Google Cloud ضمن المشروع المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على Gemini في Google Cloud.

تثبيت المكوّن الإضافي Gemini Code Assist في بيئة تطوير متكاملة

ثبِّت مستخدمو مؤسستك ميزة "مساعدة ترميز Gemini" في IDE المفضّل لديهم. لمزيد من المعلومات، يُرجى الاطّلاع على ما يلي:

يتم تضمين Gemini Code Assist تلقائيًا في حِزم تطوير البرامج المتكاملة التالية:

مهام الإعداد المتقدّمة

بدلاً من استخدام Google Cloud Console أو gcloud لمنح أدوار إدارة الهوية وإمكانية الوصول المحدّدة مسبقًا، يمكنك إجراء أيٍّ ممّا يلي:

  • استخدِم واجهات برمجة تطبيقات REST لإدارة الهوية وإمكانية الوصول أو مكتبات عملاء إدارة الهوية وإمكانية الوصول لمنح الأدوار.

    إذا كنت تستخدم هذه الواجهات، استخدِم أسماء الأدوار المؤهَّلة بالكامل:

    • roles/cloudaicompanion.user
    • roles/serviceusage.serviceUsageConsumer

    لمزيد من المعلومات عن منح الأدوار، يُرجى الاطّلاع على مقالة إدارة الوصول إلى المشاريع والمجلدات والمؤسسات.

  • إنشاء أدوار مخصّصة ومنحها

    يجب أن تحصل أي أدوار مخصّصة تنشئها على الأذونات التالية لتتمكّن من الوصول إلى ميزة "مساعدة في الترميز" في Gemini:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • serviceusage.services.enable

  • تعيين التراخيص وإدارتها

    يجب أن تحصل أي أدوار مخصّصة تنشئها على الأذونات التالية لتتمكّن من الوصول إلى ميزة "مساعدة ترميز Gemini":

    • consumerprocurement.orders.get
    • consumerprocurement.orders.licensePools..*
    • consumerprocurement.orders.licensePools.update
    • consumerprocurement.orders.licensePools.get
    • consumerprocurement.orders.licensePools.assign
    • consumerprocurement.orders.licensePools.unassign
    • consumerprocurement.orders.licensePools.enumerateLicensedUsers

يُرجى العلم أيضًا أنّه لكي يعمل أي من الأذونات السابقة، يجب تفعيل واجهة برمجة التطبيقات Gemini for Google Cloud API في مشروع Google Cloud نفسه الذي منحْت فيه كل إذن.

الخطوات التالية