قبل أن يتمكّن فريقك من استخدام إصدار Standard أو Enterprise من Gemini Code Assist، عليه تنفيذ خطوات الإعداد الموضّحة في هذا المستند:
فعِّل واجهة برمجة التطبيقات "Gemini في Google Cloud" في مشروع على Google Cloud.
منح أدوار "إدارة الهوية وإمكانية الوصول" في مشروع Google Cloud
على مستخدمي مؤسستك تثبيت إضافة Gemini Code Assist لاستخدام Gemini Code Assist Standard أو Enterprise في بيئة تطوير متكاملة. هذه الخطوة غير مطلوبة لمستخدمي Gemini CLI.
شراء اشتراك في 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 Code Assist للاطّلاع على قائمة تفصيلية بالميزات المتاحة لكل إصدار.
بعد ذلك، انقر على متابعة.
في إعداد الاشتراك، أكمِل الحقول لإعداد الاشتراك، بما في ذلك ما يلي:
- اسم الاشتراك
- عدد التراخيص في الاشتراك يُرجى العِلم أنّه في حال شراء إصدار 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 للمستخدمين الفرديين في API Console، يجب أن تتوفّر لديك الأذونات التالية في حساب الفوترة:
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
.
تأكَّد من حصولك على إذن
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 في Google Cloud" في مشروع على Cloud
يوضّح هذا القسم الخطوات المطلوبة لتفعيل واجهة برمجة التطبيقات Gemini for Google Cloud API في مشروع على Cloud.
وحدة التحكّم
لتفعيل واجهة برمجة تطبيقات "Gemini في Google Cloud"، انتقِل إلى صفحة Gemini في Google Cloud.
في أداة اختيار المشاريع، اختَر مشروعًا.
انقر على تفعيل.
يتم تعديل الصفحة وعرض الحالة مفعَّل. يتوفّر Gemini الآن في مشروع Cloud المحدّد لجميع المستخدمين الذين لديهم أدوار IAM المطلوبة.
gcloud
لاستخدام بيئة تطوير على الجهاز، عليك تثبيت وإعداد gcloud CLI.
في قائمة اختيار المشاريع، اختَر مشروعًا.
فعِّل واجهة برمجة التطبيقات "Gemini في Google Cloud" لـ Gemini باستخدام الأمر
gcloud services enable
:gcloud services enable cloudaicompanion.googleapis.com
إذا أردت تفعيل واجهة Gemini for Google Cloud API في مشروع مختلف على 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 for Google Cloud API. -
cloudcode-pa.googleapis.com
: هي واجهة برمجة تطبيقات داخلية توفّر ميزات ذات صلة ببيئة التطوير المتكاملة. -
cloudresourcemanager.googleapis.com
: يُستخدَم في بيئات التطوير المتكاملة (IDE) لاختيار المشاريع. قد لا تكون واجهة برمجة التطبيقات Resource Manager API ضرورية إذا تم ضبط المشاريع بشكل صريح في ملفsettings.json
. - تتيح
people.googleapis.com
الوصول إلى معلومات عن الملفات الشخصية وجهات الاتصال. -
firebaselogging-pa.googleapis.com
: هي واجهة برمجة تطبيقات داخلية تُستخدَم لإرسال بيانات قياس استخدام المنتجات، بما في ذلك الأحداث المتعلقة بقبول الاقتراحات. -
feedback-pa.googleapis.com
: هي واجهة برمجة تطبيقات داخلية تُستخدَم لإرسال الملاحظات داخل بيئة التطوير المتكاملة. 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 for Google Cloud API
- Gemini Code Assist API
إذا كنت تستخدم Gemini Code Assist Standard أو Enterprise من خارج حدود الخدمة، عليك أيضًا تعديل سياسة الدخول للسماح بالوصول إلى تلك الخدمات.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط "عناصر التحكّم في خدمة سحابة VPC" لـ Gemini.
منح أدوار IAM في مشروع Google Cloud
يوضّح هذا القسم الخطوات المطلوبة لمنح أدوار "إدارة الهوية وإمكانية الوصول" (IAM) الخاصة بـ "مستخدم Gemini في Google Cloud" و"مستهلك استخدام الخدمة" للمستخدمين.
وحدة التحكّم
لمنح أدوار إدارة الهوية وإمكانية الوصول (IAM) المطلوبة لاستخدام 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 ضمن مشروع محدّد في API Console. لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على "Gemini في Google Cloud".
تثبيت المكوّن الإضافي Gemini Code Assist
يثبّت مستخدمو مؤسستك المكوّن الإضافي Gemini Code Assist في بيئة التطوير المتكاملة المتوافقة المفضّلة لديهم.
VS Code
لفتح طريقة عرض الإضافات في VS Code، انقر على
الإضافات أو اضغط على
Ctrl
/Cmd
+Shift
+X
.البحث عن
Gemini Code Assist
انقر على تثبيت.
إذا طُلب منك ذلك، أعِد تشغيل VS Code.
بعد تثبيت الإضافة بنجاح، سيظهر Gemini Code Assist في شريط الأنشطة وسيكون جاهزًا للاستخدام. يمكنك ضبط إعدادات تثبيت Gemini Code Assist بشكل أكبر من خلال تحديد إعداداتك المفضّلة باستخدام شريط مهام التطبيق ذي المستوى الأعلى: انتقِل إلى Code > Settings > Settings > Extensions وابحث عن
Gemini Code Assist
.
IntelliJ
- انقر على settings إعدادات بيئة التطوير المتكاملة والمشروع > الإضافات.
- في علامة التبويب Marketplace، ابحث عن
Gemini Code Assist
. - انقر على تثبيت لتثبيت المكوّن الإضافي.
- عند اكتمال التثبيت، انقر على إعادة تشغيل بيئة التطوير المتكاملة (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 في بيئات التطوير المتكاملة، عليهم تسجيل الدخول إلى حساباتهم على Google، وإذا كانت هذه هي المرة الأولى التي يستخدمون فيها إضافة Gemini Code Assist Standard أو Enterprise في بيئة التطوير المتكاملة، عليهم اختيار مشروع على Google Cloud.
VS Code
إذا اخترت مشروعًا على Google Cloud لم يتم تفعيل واجهة برمجة التطبيقات "Gemini في Google Cloud" فيه، ستتلقّى إشعارًا يتيح لك تفعيل واجهة برمجة التطبيقات من بيئة التطوير المتكاملة. انقر على تفعيل واجهة برمجة التطبيقات في نافذة الإشعار لتفعيل واجهة برمجة التطبيقات لمشروعك. لمزيد من المعلومات، يُرجى الاطّلاع على إعداد Gemini Code Assist Standard وEnterprise لمشروع.
إذا كنت تفضّل اتّباع الإرشادات الخاصة بميزة "البرمجة باستخدام Gemini Code Assist" مباشرةً في بيئة التطوير المتكاملة، انقر على تشغيل VS Code واتّبِع الخطوات الواردة في الإرشادات للاتصال بخدمة Google Cloud وتفعيل Gemini Code Assist Standard أو Enterprise.
في ما عدا ذلك، اتّبِع الخطوات التالية:
شغِّل بيئة التطوير المتكاملة (IDE).
في شريط الأنشطة، انقر على 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.
انقر على تسجيل الدخول إلى Google.
في الصفحة التي تفتح في متصفّح الويب، اختَر حسابك على Google.
في الشاشة التي تطلب منك التأكّد من أنّك نزّلت هذا التطبيق من Google، انقر على تسجيل الدخول.
تم الآن منح Gemini Code Assist الإذن بالوصول إلى حسابك.
بعد ذلك، إذا كانت هذه هي المرة الأولى التي تستخدم فيها Gemini Code Assist Standard أو Enterprise في بيئة التطوير المتكاملة، عليك اختيار مشروع Google Cloud باتّباع الخطوات التالية:
ارجع إلى بيئة التطوير المتكاملة (IDE). في نافذة أداة 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 في بيئة التطوير المتكاملة.
مهام الإعداد المتقدّمة
بدلاً من استخدام واجهة برمجة التطبيقات أو gcloud لمنح أدوار IAM المحدّدة مسبقًا، يمكنك إجراء أيّ مما يلي:
استخدِم واجهات REST API الخاصة بإدارة الهوية وإمكانية الوصول أو مكتبات عملاء إدارة الهوية وإمكانية الوصول لمنح الأدوار.
في حال استخدام هذه الواجهات، استخدِم أسماء الأدوار المؤهَّلة بالكامل:
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 في Google Cloud في مشروع Google Cloud نفسه الذي منحت فيه كل إذن.
الخطوات التالية
- مزيد من المعلومات حول أنواع المساعدة المستندة إلى الذكاء الاصطناعي التوليدي المتاحة في "Gemini في Google Cloud"
- كيفية استخدام "Gemini في Google Cloud" لبياناتك
- كيفية الوصول إلى عناصر تحكّم المشرف في Gemini Code Assist Standard وEnterprise وإدارتها
- كيفية ضبط إعدادات تخصيص الرموز البرمجية في Gemini Code Assist Enterprise
- ضبط عناصر التحكّم في خدمة سحابة VPC لإصدارَي Gemini Code Assist Standard وEnterprise