يوضّح هذا المستند كيفية ضبط قنوات الإصدار في Gemini Code Assist لمشروع باستخدام وحدة تحكّم Google Cloud أو واجهة برمجة تطبيقات.
نطرح ميزات Gemini Code Assist في قنوات إصدار مختلفة. يمكنك ضبط كل مشروع على Google Cloud على قناة إصدار واحدة استنادًا إلى التوازن الذي تختاره بين توفّر الميزات والاستقرار. يمكن للمستخدمين في مؤسستك الذين يستعينون بـ "مساعد Gemini للرموز البرمجية" في بيئة التطوير المتكاملة (IDE) المحلية استخدام الميزات والنماذج استنادًا إلى قناة الإصدار التي تم ضبطها للمشروع.
تتوفّر قنوات الإصدار التالية:
- متوفّر للجمهور العام: قناة الإصدار التلقائية يتيح لك استخدام النماذج والميزات المتاحة بشكل عام. يُرجى العِلم أنّه يمكن الوصول إلى بعض الميزات التجريبية بدون الاشتراك في "قناة الإصدار التجريبي"، وذلك باستخدام آليات بديلة للاشتراك في الإصدار التجريبي. يمكن الوصول إلى هذه الميزات من خلال قناة الإصدار العام، ولكنها تظل خاضعة لأحكام "عروض مرحلة ما قبل التوفّر للجمهور العام".
المعاينة: تتيح لك هذه الميزة الوصول إلى بعض ميزات المعاينة في "مساعد Gemini للبرمجة"، ويمكنك أيضًا تقديم ملاحظات وبيانات استخدام لمساعدة Google في تحسين الإصدارات المستقبلية. يُرجى العِلم أنّه لا تتوفّر حاليًا أي ميزات مميّزة في قناة الإصدار التجريبي.
عند تفعيل قناة الإصدار التجريبي في أحد المشاريع، يعني ذلك موافقتك نيابةً عن العميل على أنّ جميع استخدامات Gemini Code Assist في هذا المشروع تخضع لأحكام العرض لمرحلة ما قبل التوفّر للجمهور العام الواردة في الأحكام الخاصة بخدمة Google Cloud Platform. لا تستخدِم هذه القناة للمشاريع والموارد غير المناسبة للاستخدام مع عروض مرحلة ما قبل التوفّر للجمهور العام.
توضّح الأقسام التالية الخطوات المطلوبة لضبط قناة الإصدار الخاصة بـ "مساعد Gemini في كتابة الرموز" أو تغييرها.
قبل البدء
- تأكَّد من أنّ مشروعك على Google Cloud مرتبط بحساب فوترة. لمزيد من المعلومات، يُرجى الاطّلاع على التحقّق من حالة الفوترة لمشاريعك.
الأدوار المطلوبة
للحصول على الأذونات المطلوبة لإنشاء الإعدادات وعمليات الربط التي تتحكّم في قناة الإصدار، اطلب من المشرف منحك دور "مشرف إعدادات Gemini في Google Cloud" (roles/cloudaicompanion.settingsAdmin) في المشروع.
للاطّلاع على الأذونات المطلوبة بالتحديد، وسِّع قسم الأذونات المطلوبة:
الأذونات المطلوبة
cloudaicompanion.releaseChannelSettings.createcloudaicompanion.releaseChannelSettings.deletecloudaicompanion.releaseChannelSettings.getcloudaicompanion.releaseChannelSettings.listcloudaicompanion.releaseChannelSettings.updatecloudaicompanion.dataSharingWithGoogleSettings.create- ضبط قنوات الإصدار باستخدام واجهة برمجة تطبيقات:
cloudaicompanion.settingBindings.releaseChannelSettingsCreatecloudaicompanion.settingBindings.releaseChannelSettingsDeletecloudaicompanion.settingBindings.releaseChannelSettingsGetcloudaicompanion.settingBindings.releaseChannelSettingsListcloudaicompanion.settingBindings.releaseChannelSettingsUpdatecloudaicompanion.settingBindings.releaseChannelSettingsUse- ضبط إعدادات مشاركة الطلبات والردود باستخدام واجهة برمجة تطبيقات:
cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreatecloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse- عرض إعدادات المشرف في "Gemini في Google Cloud":
cloudaicompanion.instances.queryEffectiveSettingcloudaicompanion.instances.queryEffectiveSettingBindings
ضبط قنوات إصدار Gemini Code Assist
اختر أحد الخيارات التالية:
وحدة التحكّم
في Google Cloud Console، انتقِل إلى صفحة مشرف Gemini.
الانتقال إلى "Gemini في Google Cloud"
يتم تحميل صفحة Gemini في Google Cloud.
انقر على الإعدادات في قائمة التنقل.
يتم تحميل صفحة الإعدادات.
في قسم قنوات الإصدار لـ "Gemini Code Assist في بيئات التطوير المتكاملة المحلية"، اختَر قناة الإصدار الأنسب لاحتياجاتك:
معاينة
- اختَر معاينة.
- راجِع تفاصيل قناة الإصدار التجريبي من "المعاينة" وبنود برنامج "المختبِرون الموثوق بهم"، ثم انقر على حفظ التغييرات.
متوفر للجمهور العام
- انقر على GA.
- انقر على حفظ التغييرات.
واجهة برمجة التطبيقات
أنشئ إعداد قناة الإصدار وقيمة خاصة بالإعداد:
احصل على رمز مميز للمصادقة. يجب أن تتم مصادقتك باستخدام مصادقة gcloud للحصول عليها:
TOKEN=$(gcloud auth print-access-token)أنشئ الإعداد. تستخدِم هذه التعليمات
cURLلطلب بيانات من طرق واجهة برمجة التطبيقات:curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{ "release_channel": "RELEASE_CHANNEL", } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"غيِّر القيم في السلسلة على الشكل التالي:
RELEASE_CHANNEL: قناة الإصدار، إماEXPERIMENTALللإصدار التجريبي أوSTABLEللإصدار المتاح للجميع-
CONTAINER_PROJECT_NAME: رقم تعريف المشروع الذي يتم فيه تخزين المورد المرتبط. هذا هو المشروع الرئيسي الذي يضم عملية الربط. RC_SETTING_ID: اسم إعداد فريد، مثلrc1لـRelease Channel
تعرض النتيجة قيمة
releaseChannelعلى النحو التالي:RELEASE_CHANNEL:{ "name": "projects/CONTAINER_PROJECT_NAME /locations/global/releaseChannelSettings/RC_SETTING_ID", "createTime": "2025-01-23T15:22:49.717166932Z", "updateTime": "2025-01-23T15:22:49.717166932Z", "releaseChannel": RELEASE_CHANNEL }أنشئ ربط إعدادات قناة الإصدار:
curl \ -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ -d '{ "target": "projects/TARGET_PROJECT_NAME", "product": "GEMINI_CODE_ASSIST" }' \ -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings?setting_binding_id=RC_BINDING_ID"غيِّر القيم في السلسلة على الشكل التالي:
-
TARGET_PROJECT_NAME: المشروع المستهدف الذي يجب ربط عملية الربط به. ويكون هذا المعرّف غالبًا هو نفسه معرّف مشروع الحاوية. ومع ذلك، يمكنك ربط إعداد بمشاريع متعددة حتى لا تحتاج إلى تكرار مورد الإعداد. -
CONTAINER_PROJECT_NAME: رقم تعريف المشروع الذي يتم فيه تخزين المورد المرتبط. هذا هو المشروع الرئيسي الذي يضم عملية الربط. - استخدِم
RC_SETTING_ID: وهوRC_SETTING_IDنفسه الذي استخدمته عند إنشاء الإعداد، ولكن مع إضافةb1. على سبيل المثال، استخدِمrc1b1لـRelease Channel. RC_BINDING_ID: اسم فريد لربط الإعدادات، مثلrc_binding.
يتضمّن الناتج البيانات الوصفية للعملية بالتنسيق التالي:
{ "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata", "createTime": "2025-01-23T15:27:50.076075570Z", "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }-
اختياري: تحقَّق من حالة ربط إعداد قناة الإصدار بالإنشاء:
curl -H "Authorization: Bearer $TOKEN" \ https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_IDغيِّر القيم في السلسلة على الشكل التالي:
-
CONTAINER_PROJECT_NAME: رقم تعريف المشروع الذي يتم فيه تخزين المورد المرتبط. هذا هو المشروع الرئيسي الذي يضم عملية الربط. - استبدِل
RC_BINDING_OPERATION_IDبرقم تعريف عملية إنشاء ربط إعداد قناة الإصدار الذي تم تقديمه في الرد في الخطوة السابقة.
-
اختياري: أنشئ إعداد مشاركة الطلبات والاستجابات وقيمة خاصة بالإعداد:
الحصول على الرمز المميّز:
TOKEN=$(gcloud auth print-access-token)إنشاء الإعداد:
curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{ "enable_preview_data_sharing": true, } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=DSWG_SETTING_ID"غيِّر القيم في السلسلة على الشكل التالي:
-
CONTAINER_PROJECT_NAME: رقم تعريف المشروع الرئيسي DSWG_SETTING_ID: اسم إعداد فريد، مثلdswg1لـData Sharing with Google
تعرض النتيجة قيمة
enablePreviewDataSharingعلى النحو التالي:true:{ "name": "projects/CONTAINER_PROJECT_NAME /locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID", "createTime": "2025-01-23T15:22:49.717166932Z", "updateTime": "2025-01-23T15:22:49.717166932Z", "enablePreviewDataSharing": true }-
أنشئ ربط إعداد الطلب والاستجابة:
curl \ -H "Authorization: Bearer $TOKEN" \ -H 'Content-Type: application/json' \ -d '{ "target": "projects/TARGET_PROJECT_NAME", "product": "GEMINI_CODE_ASSIST" }' \ -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings?setting_binding_id=DSWG_BINDING_ID"غيِّر القيم في السلسلة على الشكل التالي:
TARGET_PROJECT_NAME: المشروع المستهدف الذي يجب تطبيق الإعداد عليه.-
CONTAINER_PROJECT_NAME: رقم تعريف المشروع الرئيسي. - استخدِم
DSWG_SETTING_ID: وهوDSWG_SETTING_IDنفسه الذي استخدمته عند إنشاء الإعداد، ولكن مع إضافةb1. على سبيل المثال، استخدِمdswg1b1لـData Sharing with Google. DSWG_BINDING_ID: اسم فريد لربط الإعدادات، مثلdswg_binding.
يتضمّن الناتج البيانات الوصفية للعملية بالتنسيق التالي:
{ "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata", "createTime": "2025-01-23T15:27:50.076075570Z", "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID", "verb": "create", "requestedCancellation": false, "apiVersion": "v1" }, "done": false }اختياري: يمكنك التحقّق من حالة ربط إعدادات الطلب والاستجابة:
curl -H "Authorization: Bearer $TOKEN" \ https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_IDغيِّر القيم في السلسلة على الشكل التالي:
-
CONTAINER_PROJECT_NAME: رقم تعريف المشروع الذي يتم فيه تخزين المورد المرتبط. هذا هو المشروع الرئيسي الذي يضم عملية الربط. -
DSWG_BINDING_OPERATION_ID: رقم تعريف عملية إنشاء ربط الإعدادات الخاصة بالطلب والاستجابة المقدَّم في الاستجابة في الخطوة السابقة.
-