قبل أن تتمكّن من استخدام Gemini Code Assist Standard أو Enterprise، على فريقك تنفيذ خطوات الإعداد описанة في هذا المستند:
فعِّل واجهة برمجة التطبيقات Gemini for Google Cloud في مشروع على Google Cloud.
يُثبِّت مستخدمو مؤسستك مكوّن Gemini Code Assist الإضافي لاستخدام Gemini Code Assist Standard أو Enterprise في بيئة تطوير متكاملة.
شراء اشتراك في Gemini Code Assist
للحصول على قائمة بالميزات المتاحة في كل إصدار، يُرجى الاطّلاع على الميزات المتوافقة.
بالنسبة إلى عملاء Gemini Code Assist الجدد الذين لديهم حسابات فوترة ولم يسبق لهم الاشتراك في Gemini Code Assist، سنطبّق تلقائيًا رصيدًا يعادل ما يصل إلى 50 ترخيصًا مجانيًا للشهر الأول، بغض النظر عن إصدار Gemini Code Assist. يُرجى العلم أنّه لا يمكنك زيادة عدد الأرصدة المجانية بعد تخصيص أرصدة الترخيص المجاني الأولية. بالإضافة إلى ذلك، لا يمكنك تغيير إصدار Gemini Code Assist خلال الشهر الأول.
إذا كانت لديك عقود حالية مع Google Cloud، تواصَل مع فريق المبيعات قبل شراء اشتراك.
انتقِل إلى صفحة مشرف Gemini.
الانتقال إلى صفحة "المشرف" في Gemini
ستفتح صفحة مشرف Gemini.
انقر على الحصول على Gemini Code Assist.
يُرجى العلم أنّه إذا لم يكن لديك الإذن
consumerprocurement.orders.place
المطلوب، سيتم إيقاف هذا الزر. إذا كان هناك اشتراك في Gemini Code Assist مرتبط بحساب الفوترة المرتبط بالمشروع، سيظهر هذا الزر على النحو التالي: إدارة Gemini Code Assist ويتيح لك تعديل اشتراكك.ستفتح صفحة الحصول على اشتراك Gemini Code Assist.
في اختيار إصدار اشتراك Gemini Code Assist، اختَر إصدار Gemini Code Assist. انقر على مقارنة إصدارات ميزة "مساعدة كتابة الرموز البرمجية" في Gemini للاطّلاع على قائمة تفصيلية بالميزات المتاحة لكل إصدار.
بعد ذلك، انقر على متابعة.
في قسم ضبط الاشتراك، أكمِل الحقول لضبط الاشتراك، بما في ذلك ما يلي:
- اسم الاشتراك
- عدد التراخيص في الاشتراك يُرجى العلم أنّه في حال شراء إصدار Enterprise، يجب شراء 10 تراخيص على الأقل.
- مدة الاشتراك (شهرية أو سنوية) من خلال الاشتراك السنوي، يتم منحك سعرًا مخفَّضًا يتم تحصيله شهريًا بدلاً من دفعة واحدة.
لتأكيد الاشتراك، انقر على متابعة.
إذا كنت توافق على البنود، انقر على أوافق على بنود عملية الشراء هذه، ثمّ انقر على تأكيد الاشتراك.
انقر على التالي: إدارة عمليات منح تراخيص Gemini.
تم شراء الاشتراك الآن في Gemini Code Assist Standard أو Enterprise. عليك الآن إدارة عمليات منح تراخيص Gemini في مؤسستك.
منح التراخيص
قبل استخدام Gemini Code Assist، يجب منح ترخيص لكل مستخدم فردي يجب منحه إذن الوصول في المؤسسة.
بالنسبة إلى عملاء Gemini Code Assist الجدد الذين لديهم حسابات فوترة ولم يسبق لهم الاشتراك في Gemini Code Assist، سنطبّق تلقائيًا رصيدًا يعادل ما يصل إلى 50 ترخيصًا مجانيًا للشهر الأول، بغض النظر عن إصدار Gemini Code Assist. يُرجى العلم أنّه لا يمكنك زيادة عدد الأرصدة المجانية بعد تخصيص الأرصدة الأولية لإصدار الترخيص المجاني. بالإضافة إلى ذلك، لا يمكنك تغيير إصدار Gemini Code Assist خلال الشهر الأول.
وحدة التحكّم
لتخصيص تراخيص Gemini للمستخدمين الفرديين في وحدة تحكُّم واجهة برمجة التطبيقات، يجب أن تكون لديك الأذونات التالية في حساب الفوترة:
billing.accounts.get
billing.accounts.list
consumerprocurement.orders.get
consumerprocurement.orders.list
consumerprocurement.orders.modify
consumerprocurement.orders.place
consumerprocurement.licensePools.enumerateLicensedUsers
consumerprocurement.licensePools.get
consumerprocurement.licensePools.update
consumerprocurement.licensePools.assign
consumerprocurement.licensePools.unassign
انتقِل إلى صفحة مشرف Gemini.
اختَر الاشتراك الذي تريد تغييره، ثم انقر على تعديل الاشتراك.
انقر على منح التراخيص. سيظهر مربّع حوار لاختيار المستخدم. للبحث عن مستخدمين معيّنين، أدخِل أسمائهم في مربّع البحث.
اختَر مستخدمًا واحدًا أو أكثر من القائمة، ثم انقر على التالي.
اختَر خدمات Gemini التي تريد تخصيص تراخيص لها.
انقر على منح التراخيص.
واجهة برمجة التطبيقات
لتعيين تراخيص Gemini باستخدام واجهة برمجة التطبيقات، استخدِم billingAccounts.orders.licensePool.assign
method.
تأكَّد من حصولك على
consumerprocurement.licensePools.assign
إذن "إدارة الهوية والوصول" في حساب الفوترة الذي يحتوي على مجموعة التراخيص التي تريد تعيين ترخيصها.أنشئ ملف JSON يحتوي على المعلومات التالية:
{ "usernames": [ USER_EMAILS ] }
حيث يكون
USER_EMAILS
قائمة مفصولة بفواصل ل حسابات المستخدمين الذين يتم منحهم الترخيص. على سبيل المثال:"dana@example.com", "lee@example.com"
.استخدِم
cURL
لاستدعاء الطريقة:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ -H "Content-Type: application/json" \ "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"
غيِّر القيم في السلسلة على الشكل التالي:
JSON_FILE_NAME
: مسار ملف JSON الذي أنشأته في الخطوة 2.- PROJECT_ID: رقم تعريف المشروع يتم تطبيق استخدام الحصة والرسوم المرتبطة بطلب واجهة برمجة التطبيقات على هذا المشروع.
BILLING_ACCOUNT_ID
: رقم تعريف حساب الدفع المرتبط بمجموعة التراخيص.-
ORDER_ID
: معرّف الطلب إذا لم تكن تعرف معرّف الطلب، يمكنك استرجاعه من خلال إدراج الطلبات المرتبطة بحساب الفوترة.
في حال نجاح العملية، تكون الاستجابة مشابهة لما يلي:
{}
عليك الآن تفعيل Gemini for Google Cloud API في مشروع واحد أو أكثر مرتبطَين بحساب الفوترة هذا. لن يظهر ميزة Gemini Code Assist للمستخدمين إلى أن تفعّلها في مشروع واحد على الأقل.
تفعيل واجهة برمجة التطبيقات Gemini for Google Cloud في مشروع على Cloud
يوضّح هذا القسم الخطوات المطلوبة لتفعيل واجهة برمجة التطبيقات Gemini for Google Cloud API في مشروع على Cloud.
وحدة التحكّم
لتفعيل واجهة برمجة التطبيقات Gemini for Google Cloud، انتقِل إلى صفحة Gemini لخدمة Google Cloud.
في أداة اختيار المشاريع، اختَر مشروعًا.
انقر على تفعيل.
يتم تعديل الصفحة وتعرض الحالة مفعَّل. أصبح Gemini متاحًا الآن في مشروع Cloud المحدّد لجميع المستخدمين الذين لديهم دور إدارة الهوية وإمكانية الوصول المطلوب.
gcloud
لاستخدام بيئة تطوير على الجهاز، عليك تثبيت و إعداد gcloud CLI.
في قائمة أداة اختيار المشاريع، اختَر مشروعًا.
فعِّل واجهة برمجة التطبيقات Gemini لـ Google Cloud لخدمة 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 المحدّد لجميع المستخدمين الذين لديهم أدوار إدارة الهوية وإمكانية الوصول المطلوبة.
ضبط جدار الحماية لحركة مرور واجهة برمجة التطبيقات بين IDE وGoogle
بالإضافة إلى تفعيل 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". -
lh3.googleusercontent.com
وlh5.googleusercontent.com
: تُستخدَم للحصول على صور المستخدمين.
تحديد عناوين IP لنطاقات Google Cloud التلقائية
لتفعيل الاتصال من بيئة تطوير البرامج المتكاملة (IDE) إلى Google Cloud APIs، يجب أن يسمح جدار الحماية بمرور حركة مرور بروتوكول النقل (TCP) الصادرة إلى نطاقات عناوين IP الموثَّقة علنًا من Google. تدير Google هذه النطاقات ديناميكيًا.
للحفاظ على قائمة بنطاقات IP للوصول إلى نطاقات Google Cloud، لديك عدة خيارات:
- استخدِم القوائم المنشورة أو شغِّل نصًا برمجيًا تلقائيًا لالحصول على نطاقات عناوين IP التابعة إلى Google.
- استخدِم عنوان IP الافتراضي private.googleapis.com.
- استخدِم Private Service Connect.
اختياري: ضبط عناصر التحكّم في خدمة سحابة VPC
إذا كانت مؤسستك تمتلك حدود خدمة، عليك إضافة موارد العميل التالية إلى حدودك:
- واجهة برمجة التطبيقات Gemini لـ Google Cloud
- Gemini Code Assist API
إذا كنت تستخدم Gemini Code Assist Standard أو Enterprise من خارج نطاق خدمتك، عليك أيضًا تعديل سياسة الولوج للسماح بالوصول إلى هذه الخدمات.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط عناصر التحكّم في خدمة سحابة VPC لتطبيق Gemini.
منح أدوار إدارة الهوية وإمكانية الوصول في مشروع على Google Cloud
يصف هذا القسم الخطوات المطلوبة لمنح المستخدمين أدوار إدارة الهوية وإمكانية الوصول (IAM) الخاصة بمستخدم Gemini for Google Cloud ومستهلك استخدام الخدمة.
وحدة التحكّم
لمنح أدوار إدارة الهوية وإمكانية الوصول المطلوبة لاستخدام Gemini، انتقِل إلى صفحة إدارة الهوية وإمكانية الوصول والمشرف.
في عمود المشرف، ابحث عن مشرف الذي تريد منح إذن الوصول إلى Gemini له، ثم انقر على تعديل المشرف في هذا الصف.
في لوحة تعديل إذن الوصول، انقر على
إضافة دور آخر.في اختيار دور، اختَر مستخدم Gemini في Google Cloud.
انقر على إضافة دور آخر واختَر مستخدِم استخدام الخدمة.
انقر على حفظ.
gcloud
لاستخدام بيئة تطوير على الجهاز، عليك تثبيت و إعداد gcloud CLI.
في قائمة أداة اختيار المشاريع، اختَر مشروعًا.
امنح دور "مستخدم Gemini لـ Google Cloud":
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/cloudaicompanion.user
غيِّر القيم في السلسلة على الشكل التالي:
PROJECT_ID
: رقم تعريف مشروعك على Cloud، على سبيل المثال،1234567890
.PRINCIPAL
: المعرّف للمشرف، على سبيل المثالuser:cloudysanfrancisco@gmail.com
.
الناتج هو قائمة بعمليات ربط السياسات التي تتضمّن ما يلي:
- members: - user:PRINCIPAL role: roles/cloudaicompanion.user
كرِّر الخطوة السابقة للدور
roles/serviceusage.serviceUsageConsumer
.
لمزيد من المعلومات، يُرجى الاطّلاع على
منح دور واحد
و
gcloud projects add-iam-policy-binding
.
يمكن لجميع المستخدمين الذين تم منحهم هذه الأدوار الوصول إلى ميزات Gemini لـ Google Cloud في وحدة تحكّم واجهة برمجة التطبيقات ضمن المشروع المحدّد. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على Gemini في Google Cloud.
تثبيت المكوّن الإضافي Gemini Code Assist
يُثبِّت مستخدمو مؤسستك المكوّن الإضافي Gemini Code Assist في محرّر بيئة التطوير المتكامل (IDE) المفضّل لديهم والمتوافق
VS Code
لفتح طريقة عرض الإضافات في VS Code، انقر على
الإضافات أو اضغط على
Ctrl
/Cmd
+Shift
+X
.البحث عن
Gemini Code Assist
انقر على تثبيت.
يُرجى إعادة تشغيل VS Code إذا طُلب منك ذلك.
بعد تثبيت الإضافة بنجاح، يظهر Gemini Code Assist في شريط الأنشطة ويُصبح جاهزًا للاستخدام. يمكنك ضبط إعدادات إضافية لتطبيق Gemini Code Assist من خلال تحديد إعداداتك المفضّلة باستخدام شريط مهام التطبيق من المستوى الأعلى: انتقِل إلى الرمز > الإعدادات > الإعدادات > الإضافات وابحث عن
Gemini Code Assist
.
IntelliJ
- انقر على settings IDE وإعدادات المشروع > الإضافات.
- في علامة التبويب Marketplace، ابحث عن
Gemini Code Assist
. - انقر على تثبيت لتثبيت المكوّن الإضافي.
- عند اكتمال التثبيت، انقر على إعادة تشغيل IDE.
عند إعادة تشغيل IDE، يظهر Gemini Code Assist في شريط الأنشطة.
أصبح المستخدمون الآن جاهزين لاستخدام Gemini Code Assist Standard أو Enterprise في بيئة تطوير البرامج المتكاملة. مزيد من المعلومات حول الميزات المتاحة:
يمكنك البدء باستخدام الأدلة التالية:
قائمة الأدلة التي تخزِّن Gemini Code Assist المعلومات فيها
يقدّم الجدول التالي قائمة بالأدلة التي يخزّن فيها Gemini Code Assist معلومات الإضافات، مثل علامات المصادقة:
Windows
%LOCALAPPDATA%/cloud-code
%LOCALAPPDATA%/google-vscode-extension
نظام التشغيل Mac
~/Library/Application Support/cloud-code
~/Library/Application Support/google-vscode-extension
Linux
~/.cache/cloud-code
~/.cache/google-vscode-extension
تسجيل الدخول إلى Google واختيار مشروع Google Cloud
بعد أن ينتهي المستخدمون من تثبيت Gemini Code Assist في حِزم تطوير البرامج المتكاملة (IDE)، عليهم تسجيل الدخول إلى حساباتهم على Google. وإذا كانت هذه هي المرة الأولى التي يستخدمون فيها Gemini Code Assist Standard أو Enterprise في حِزم تطوير البرامج المتكاملة، عليهم اختيار مشروع على Google Cloud.
VS Code
إذا اختَرت مشروعًا على Google Cloud بدون تفعيل واجهة برمجة التطبيقات Gemini for Google Cloud، ستتلقّى إشعارًا يمنح لك خيار تفعيل واجهة برمجة التطبيقات من IDE. انقر على تفعيل واجهة برمجة التطبيقات في نافذة الإشعار لتفعيل واجهة برمجة التطبيقات لمشروعك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد Gemini Code Assist Standard وEnterprise لمشروع.
إذا كنت تفضّل اتّباع الدليل التفصيلي كتابة الرموز البرمجية باستخدام Gemini Code Assist مباشرةً في بيئة تطوير البرامج المتكاملة، انقر على بدء VS Code واتّبِع الخطوات الواردة في الدليل التفصيلي لربط IDE بخدمة Google Cloud وتفعيل Gemini Code Assist Standard أو Enterprise.
في حال عدم توفّر هذه الميزة، اتّبِع الخطوات التالية:
افتح بيئة تطوير البرامج المتكاملة.
في شريط الأنشطة، انقر على Gemini Code Assist.
في لوحة المحادثة Gemini Code Assist، انقر على تسجيل الدخول إلى Google Cloud.
عندما يُطلب منك السماح لميزة Gemini Code Assist بفتح الموقع الإلكتروني الخارجي، انقر على فتح.
اتّبِع التعليمات لتسجيل الدخول إلى حسابك على Google.
عندما يُطلب منك معرفة ما إذا كنت قد نزّلت Gemini Code Assist من Google، انقر على تسجيل الدخول.
لقد تم ربط حسابك الآن بخدمة Google Cloud.
بعد ذلك، لاختيار مشروع على Google Cloud تم تفعيل واجهة برمجة التطبيقات Gemini for Google Cloud فيه، اتّبِع الخطوات التالية:
في شريط حالة Gemini Code Assist، انقر على Gemini Code Assist.
في قائمة Gemini Code Assist، اختَر اختيار مشروع Gemini Code .
اختَر مشروعًا على Google Cloud تم تفعيل واجهة برمجة التطبيقات Gemini for Google Cloud فيه.
أن يكون Gemini Code Assist Standard أو Enterprise جاهزًا للاستخدام
IntelliJ
لتسجيل الدخول إلى حسابك على Google، اتّبِع الخطوات التالية:
في شريط النشاط، انقر على spark Gemini Code Assist.
انقر على Log in to Google (تسجيل الدخول إلى Google).
في الصفحة التي تفتح في متصفّح الويب، اختَر حسابك على Google.
في الشاشة التي تطلب منك التأكّد من أنّك نزّلت هذا التطبيق من Google، انقر على تسجيل الدخول.
تم الآن منح Gemini Code Assist الإذن بالوصول إلى حسابك.
بعد ذلك، إذا كانت هذه هي المرة الأولى التي تستخدم فيها ميزة Gemini Code Assist Standard أو Enterprise في بيئة تطوير البرامج المتكاملة، عليك اختيار مشروع Google Cloud باتّباع الخطوات التالية:
ارجع إلى بيئة تطوير البرامج المتكاملة. في نافذة أداة Gemini Code Assist، إذا وافقت على السماح لشركة Google بتفعيل واجهات برمجة التطبيقات المطلوبة لاستخدام Gemini Code Assist نيابةً عنك في مشروعك المحدّد، انقر على اختيار مشروع على Google Cloud Platform للمتابعة.
في مربّع الحوار اختيار مشروع Google Cloud، ابحث عن مشروعك على Google Cloud واختَره، ثم انقر على حسنًا.
انقر على إنهاء.
تم اختيار مشروعك على Google Cloud مع تفعيل واجهة برمجة التطبيقات Gemini Code Assist API. أصبحت جاهزًا لاستخدام Gemini Code Assist Standard أو Enterprise في بيئة تطوير البرامج (IDE).
مهام الإعداد المتقدّمة
بدلاً من استخدام "وحدة تحكّم واجهة برمجة التطبيقات" أو gcloud لمنح أدوار إدارة الهوية وإمكانية الوصول المحدّدة مسبقًا، يمكنك إجراء أيٍّ مما يلي:
استخدِم واجهات برمجة تطبيقات REST لإدارة الهوية وإمكانية الوصول أو مكتبات عملاء إدارة الهوية وإمكانية الوصول لمنح الأدوار.
في حال استخدام هذه الواجهات، استخدِم أسماء الأدوار المؤهَّلة بالكامل:
roles/cloudaicompanion.user
roles/serviceusage.serviceUsageConsumer
لمزيد من المعلومات عن منح الأدوار، يُرجى الاطّلاع على مقالة إدارة الوصول إلى المشاريع والمجلدات والمؤسسات.
إنشاء أدوار مخصّصة ومنحها
إنّ أي أدوار مخصّصة تنشئها تحتاج إلى الأذونات التالية للوصول إلى Gemini Code Assist Standard وEnterprise:
cloudaicompanion.companions.generateChat
cloudaicompanion.companions.generateCode
cloudaicompanion.instances.completeCode
cloudaicompanion.instances.completeTask
cloudaicompanion.instances.generateCode
cloudaicompanion.instances.generateText
cloudaicompanion.instances.exportMetrics
cloudaicompanion.instances.queryEffectiveSetting
cloudaicompanion.instances.queryEffectiveSettingBindings
serviceusage.services.enable
تعيين التراخيص وإدارتها
إنّ أي أدوار مخصّصة تنشئها تحتاج إلى الأذونات التالية لتتمكّن من منح مستخدمين تراخيص Gemini Code Assist وإدارتها:
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 نفسه الذي منحْت فيه كل إذن.
الخطوات التالية
- مزيد من المعلومات حول أنواع المساعدة المستندة إلى الذكاء الاصطناعي التوليدي المتاحة في Gemini في Google Cloud
- تعرَّف على كيفية استخدام Gemini في Google Cloud لبياناتك.
- تعرَّف على كيفية الوصول إلى عناصر التحكّم الخاصة بمديري حسابات Gemini Code Assist Standard وEnterprise وإدارتها.
- تعرَّف على كيفية ضبط إعدادات تخصيص الرموز في Gemini Code Assist Enterprise.
- ضبط عناصر التحكّم في خدمة سحابة VPC لإصدارَي Gemini Code Assist Standard وEnterprise