این سند نحوه پیکربندی کانالهای انتشار Gemini Code Assist را برای یک پروژه با استفاده از Google API Console یا یک API توضیح میدهد.
ما ویژگیهای Gemini Code Assist را در کانالهای انتشار مختلف منتشر میکنیم. بسته به تعادل انتخابی خود بین در دسترس بودن ویژگی و پایداری، میتوانید هر پروژه Google Cloud را روی یک کانال انتشار تنظیم کنید. کاربران سازمان شما که از Gemini Code Assist در IDE محلی خود استفاده میکنند، میتوانند از ویژگیها و مدلهای مبتنی بر کانال انتشار پیکربندیشده برای پروژه استفاده کنند.
کانال های انتشار زیر در دسترس هستند:
- به طور کلی در دسترس است. کانال انتشار پیش فرض به شما امکان می دهد از مدل ها و ویژگی های عمومی موجود استفاده کنید. توجه داشته باشید که دسترسی به برخی ویژگیهای پیشنمایش بدون شرکت در کانال پیشنمایش، با استفاده از مکانیسمهای جایگزین ثبتنام پیشنمایش امکانپذیر است. این ویژگیها در کانال GA قابل دسترسی خواهند بود، اما همچنان تحت شرایط ارائه قبل از GA هستند.
پیش نمایش. به شما امکان میدهد به ویژگیهای پیشنمایش خاصی برای Gemini Code Assist دسترسی داشته باشید و به صورت اختیاری، بازخورد و دادههای استفاده را برای کمک به Google در بهبود نسخههای بعدی ارائه دهید. توجه داشته باشید که در حال حاضر هیچ ویژگی متمایزی در کانال انتشار پیش نمایش وجود ندارد.
وقتی کانال انتشار پیشنمایش را در پروژهای فعال میکنید، از طرف مشتری موافقت میکنید که تمام استفاده از Gemini Code Assist در آن پروژه مشمول شرایط ارائه Pre-GA در شرایط خدمات خاص Google Cloud Platform باشد. از این کانال برای پروژه ها و منابعی که برای استفاده با پیشنهادات قبل از GA مناسب نیستند استفاده نکنید.
بخشهای زیر مراحل لازم برای تنظیم یا تغییر کانال انتشار Gemini Code Assist را ارائه میکنند.
قبل از شروع
- بررسی کنید که پروژه Google Cloud شما به یک حساب صورتحساب متصل است. برای اطلاعات بیشتر، به تأیید وضعیت صورتحساب پروژههای خود مراجعه کنید.
نقش های مورد نیاز
برای مجوزهای لازم برای ایجاد تنظیمات و اتصالهایی که کانال انتشار را کنترل میکنند، از سرپرست خود بخواهید که نقش Gemini برای مدیر تنظیمات Google Cloud ( roles/cloudaicompanion.settingsAdmin
) را در پروژه به شما اعطا کند.
برای مشاهده مجوزهای دقیق مورد نیاز، بخش مجوزهای مورد نیاز را گسترش دهید:
مجوزهای مورد نیاز
-
cloudaicompanion.releaseChannelSettings.create
-
cloudaicompanion.releaseChannelSettings.delete
-
cloudaicompanion.releaseChannelSettings.get
-
cloudaicompanion.releaseChannelSettings.list
-
cloudaicompanion.releaseChannelSettings.update
-
cloudaicompanion.dataSharingWithGoogleSettings.create
- کانال های انتشار را با استفاده از یک API پیکربندی کنید:
-
cloudaicompanion.settingBindings.releaseChannelSettingsCreate
-
cloudaicompanion.settingBindings.releaseChannelSettingsDelete
-
cloudaicompanion.settingBindings.releaseChannelSettingsGet
-
cloudaicompanion.settingBindings.releaseChannelSettingsList
-
cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
-
cloudaicompanion.settingBindings.releaseChannelSettingsUse
- پیکربندی اشتراکگذاری سریع و پاسخ با استفاده از یک API:
-
cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
-
cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
- تنظیمات مدیر Gemini برای Google Cloud را مشاهده کنید:
-
cloudaicompanion.instances.queryEffectiveSetting
-
cloudaicompanion.instances.queryEffectiveSettingBindings
کانال های انتشار Gemini Code Assist را پیکربندی کنید
یکی از گزینه های زیر را انتخاب کنید:
کنسول
در کنسول API، به صفحه Admin for Gemini بروید.
برای Google Cloud به Gemini بروید
صفحه Gemini for Google Cloud بارگیری می شود.
در منوی پیمایش روی تنظیمات کلیک کنید.
صفحه تنظیمات بارگیری می شود.
در بخش Release channels for Gemini Code Assist در IDEs محلی ، کانال انتشار را انتخاب کنید که به بهترین وجه با نیازهای شما مطابقت دارد:
پیش نمایش
- پیش نمایش را انتخاب کنید.
- جزئیات کانال انتشار پیشنمایش و شرایط برنامه آزمایشکننده معتمد را مرور کنید و سپس روی ذخیره تغییرات کلیک کنید.
به طور کلی در دسترس است
- GA را انتخاب کنید.
- روی ذخیره تغییرات کلیک کنید.
API
تنظیم کانال انتشار و یک مقدار خاص تنظیم را ایجاد کنید:
یک نشانه احراز هویت دریافت کنید. برای به دست آوردن آن باید با استفاده از احراز هویت gcloud احراز هویت شوید:
TOKEN=$(gcloud auth print-access-token)
تنظیم را ایجاد کنید. این دستورالعمل ها از
cURL
برای فراخوانی متدهای API استفاده می کنند: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
برای Generally Available. -
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
: شناسه عملیات ایجاد صحافی تنظیم اعلان و پاسخ ارائه شده در پاسخ در مرحله قبل.
-