راه اندازی Gemini Code Assist (استاندارد و سازمانی)

قبل از اینکه بتوانید از Gemini Code Assist استفاده کنید، تیم شما باید مراحل راه اندازی که در این سند توضیح داده شده است را انجام دهد:

  1. اشتراک Gemini Code Assist را خریداری کنید .

  2. مجوزها را به کاربران فردی در سازمان خود اختصاص دهید .

  3. Gemini for Google Cloud API را در پروژه Google Cloud فعال کنید .

  4. نقش‌های مدیریت هویت و دسترسی را در پروژه Google Cloud اعطا کنید .

  5. کاربران سازمان شما افزونه Gemini Code Assist را برای استفاده از Gemini Code Assist در یک IDE نصب می کنند .

اشتراک Gemini Code Assist را خریداری کنید

برای فهرستی از ویژگی‌های موجود در هر نسخه، ویژگی‌های پشتیبانی شده را ببینید.

برای مشتریان جدید Gemini Code Assist با حساب‌های صورت‌حساب که هرگز اشتراک Gemini Code Assist نداشته‌اند، بدون در نظر گرفتن نسخه Gemini Code Assist ، به‌طور خودکار اعتباری معادل حداکثر ۵۰ مجوز رایگان برای ماه اول اعمال می‌کنیم. توجه داشته باشید که پس از تخصیص اعتبار مجوز رایگان اولیه نمی توانید تعداد اعتبارات رایگان را افزایش دهید. علاوه بر این، نمی‌توانید نسخه Gemini Code Assist را در ماه اول تغییر دهید.

Gemini Code Assist Enterprise با 19 دلار در ماه به ازای هر کاربر با تعهد 12 ماهه تا 31 مارس 2025 در دسترس است. برای استفاده از این پیشنهاد تبلیغاتی با تیم فروش ما ارتباط برقرار کنید .

اگر قراردادهای موجود با Google Cloud دارید، قبل از خرید اشتراک با تیم فروش ما تماس بگیرید .

  1. به صفحه Gemini for Google Cloud بروید.

    برای Google Cloud به Gemini بروید

    صفحه Gemini for Google Cloud باز می شود.

  2. Get Gemini Code Assist را انتخاب کنید. توجه داشته باشید که اگر حساب صورت‌حساب شما اشتراک Gemini Code Assist خریداری نکرده باشد، پیامی نمایش داده می‌شود که می‌گوید واجد شرایط برای استفاده آزمایشی 30 روزه برای 50 مجوز بدون هزینه است . اگر پروژه شما قبلا دارای Gemini Code Assist است، این متن Manage Gemini Code Assist را نشان می دهد.

    صفحه اشتراک Get Gemini Code Assist باز می شود.

  3. در Select Gemini Code Assist نسخه اشتراک ، نسخه Gemini Code Assist را انتخاب کنید. مقایسه نسخه‌های کمک کد Gemini را انتخاب کنید تا فهرست دقیقی از ویژگی‌های موجود برای هر نسخه را ببینید.

    سپس، Continue را انتخاب کنید.

  4. در پیکربندی اشتراک ، فیلدها را برای پیکربندی اشتراک تکمیل کنید، از جمله موارد زیر:

    • نام اشتراک.
    • تعداد مجوزها در اشتراک. توجه داشته باشید که اگر نسخه Enterprise را خریداری می کنید، باید حداقل 10 مجوز خریداری کنید.
    • دوره اشتراک (ماهانه یا سالانه). با اشتراک سالانه، نرخ تخفیفی به شما داده می شود که به جای پرداخت یک بار، به صورت ماهانه شارژ می شود.
    • تمدید خودکار اشتراک شما پس از پایان مدت تعهد (ماهانه یا سالانه). تمدید خودکار اشتراک و مجوزهای شما را فعال نگه می دارد. اگر اشتراک به طور خودکار تمدید نشود، با پایان دوره فعلی پایان می‌یابد و باید دوباره مراحل خرید را طی کنید و مجوزها را مجدداً اختصاص دهید.

  5. برای تأیید اشتراک، ادامه را انتخاب کنید.

  6. اگر با شرایط موافق هستید، من با شرایط این خرید موافقت می‌کنم و سپس تأیید اشتراک را انتخاب کنید.

  7. Next را انتخاب کنید: مدیریت تکالیف مجوز Gemini .

اشتراک اکنون برای Gemini Code Assist خریداری شده است. اکنون باید تکالیف مجوز Gemini را در سازمان خود مدیریت کنید.

مجوزها را اختصاص دهید

قبل از استفاده از Gemini Code Assist، هر کاربر فردی در سازمان شما نیاز به مجوز دارد.

برای مشتریان جدید Gemini Code Assist با حساب‌های صورت‌حساب که هرگز اشتراک Gemini Code Assist نداشته‌اند، بدون در نظر گرفتن نسخه Gemini Code Assist ، به‌طور خودکار اعتباری معادل حداکثر ۵۰ مجوز رایگان برای ماه اول اعمال می‌کنیم. توجه داشته باشید که پس از تخصیص اعتبار مجوز رایگان اولیه نمی توانید تعداد اعتبارات رایگان را افزایش دهید. علاوه بر این، نمی‌توانید نسخه Gemini Code Assist را در ماه اول تغییر دهید.

کنسول API

برای تخصیص مجوزهای Gemini به کاربران فردی در کنسول Google Cloud، باید مجوزهای زیر را داشته باشید:

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

  1. به صفحه Admin for Gemini بروید.

    برای Google Cloud به Gemini بروید

  2. اشتراکی را که می خواهید تغییر دهید انتخاب کنید و سپس روی تغییر اشتراک کلیک کنید.

  3. روی اختصاص مجوزها کلیک کنید. یک گفتگوی انتخاب کاربر ظاهر می شود. برای جستجوی کاربران خاص، نام آنها را در کادر جستجو وارد کنید.

  4. یک یا چند کاربر را از لیست انتخاب کنید و سپس روی Next کلیک کنید.

  5. سرویس‌های Gemini را که می‌خواهید به آنها مجوز اختصاص دهید، انتخاب کنید.

  6. روی اختصاص مجوزها کلیک کنید.

برای تخصیص مجوزهای Gemini با API، باید مجوز 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 : خط مشی IAM

بدن درخواستی:

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

خروجی مشابه موارد زیر است:

{}

اگر مجوز با موفقیت تخصیص داده شود، پاسخ خالی است.

اکنون باید Gemini for Google Cloud API را در یک یا چند پروژه که با این حساب صورت‌حساب مرتبط هستند، فعال کنید. تا زمانی که حداقل در یک پروژه آن را فعال نکنید، کاربران نرم افزار Gemini Code Assist را نمی بینند.

Gemini for Google Cloud API را در پروژه Cloud فعال کنید

این بخش مراحل مورد نیاز برای فعال کردن Gemini for Google Cloud API در یک پروژه Cloud را شرح می‌دهد.

کنسول gcloud

  1. برای فعال کردن Gemini for Google Cloud API، به صفحه Gemini for Google Cloud بروید.

    برای Google Cloud به Gemini بروید

  2. در انتخابگر پروژه، یک پروژه را انتخاب کنید.

  3. روی Enable کلیک کنید.

    صفحه به روز می شود و وضعیت فعال را نشان می دهد. Gemini اکنون در پروژه Cloud انتخاب شده برای همه کاربرانی که نقش های IAM مورد نیاز را دارند در دسترس است.

برای استفاده از یک محیط توسعه محلی، gcloud CLI را نصب و مقداردهی اولیه کنید .

  1. در منوی انتخاب پروژه، یک پروژه را انتخاب کنید.

  2. Gemini for Google Cloud API for Gemini را با استفاده از دستور gcloud services enable فعال کنید:

    gcloud services enable cloudaicompanion.googleapis.com

    اگر می‌خواهید Gemini برای Google Cloud API را در یک پروژه Cloud دیگر فعال کنید، پارامتر --project را اضافه کنید:

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

    شناسه پروژه Cloud خود را جایگزین PROJECT_ID کنید.

    خروجی مشابه موارد زیر است:

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

Gemini برای Google Cloud اکنون در پروژه Cloud مشخص شده برای همه کاربرانی که نقش های IAM مورد نیاز را دارند در دسترس است.

API های مورد نیاز برای کاربران پشت فایروال

علاوه بر فعال کردن Gemini برای Google Cloud، کاربران پشت فایروال ممکن است نیاز به فعال کردن API های زیر نیز داشته باشند:

  • oauth2.googleapis.com : برای ورود به Google Cloud استفاده می شود.
  • serviceusage.googleapis.com : برای بررسی اینکه پروژه Gemini Code Assist کاربر به درستی پیکربندی شده است استفاده می شود.
  • cloudaicompanion.googleapis.com : Gemini اولیه برای Google Cloud API پایانی.
  • cloudcode-pa.googleapis.com : یک API داخلی که ویژگی های مرتبط با IDE را ارائه می دهد.
  • cloudresourcemanager.googleapis.com : در IDE ها برای انتخاب کنندگان پروژه استفاده می شود. اگر پروژه ها به صراحت در فایل settings.json شما پیکربندی شده باشند، ممکن است Resource Manager API ضروری نباشد.
  • people.googleapis.com : دسترسی به اطلاعات نمایه ها و مخاطبین را فراهم می کند.
  • firebaselogging-pa.googleapis.com : یک API داخلی که برای ارسال تله متری محصول از جمله رویدادهایی در مورد پذیرش پیشنهادات استفاده می شود.
  • feedback-pa.googleapis.com : یک API داخلی که برای ارسال بازخورد درون IDE استفاده می‌شود.
  • apihub.googleapis.com : توسط ویژگی Cloud Code API Browser استفاده می شود.

اختیاری: کنترل های سرویس VPC را پیکربندی کنید

اگر سازمان شما دارای یک محیط سرویس است، باید منابع زیر را به محیط خود اضافه کنید:

  • Gemini for Google Cloud API
  • Gemini Code Assist API

اگر از Gemini Code Assist خارج از محدوده خدمات خود استفاده می کنید، باید خط مشی ورود را نیز تغییر دهید تا امکان دسترسی به آن خدمات را فراهم کنید.

برای اطلاعات بیشتر، به پیکربندی کنترل‌های سرویس VPC برای Gemini مراجعه کنید.

نقش‌های IAM را در پروژه Google Cloud اعطا کنید

این بخش مراحل مورد نیاز برای اعطای نقش‌های Gemini برای Google Cloud User and Service Usage Consumer IAM به کاربران را شرح می‌دهد.

کنسول gcloud

  1. برای اعطای نقش های IAM که برای استفاده از Gemini مورد نیاز هستند، به صفحه IAM & Admin بروید.

    به IAM & Admin بروید

  2. در ستون Principal ، اصلی را پیدا کنید که می‌خواهید به Gemini دسترسی داشته باشید و سپس روی Principal در آن ردیف کلیک کنید.

  3. در پنجره دسترسی ویرایش ، روی نقش دیگری کلیک کنید.

  4. در انتخاب نقش ، Gemini برای Google Cloud User را انتخاب کنید.

  5. روی افزودن نقش دیگری کلیک کنید و Service Usage Consumer را انتخاب کنید.

  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

برای اطلاعات بیشتر، به Grant a single role and gcloud projects add-iam-policy-binding مراجعه کنید.

همه کاربرانی که این نقش‌ها را دریافت کرده‌اند می‌توانند در پروژه مشخص شده به Gemini برای ویژگی‌های Google Cloud در کنسول Google Cloud دسترسی داشته باشند. برای اطلاعات بیشتر، به نمای کلی Gemini for Google Cloud مراجعه کنید.

پلاگین Gemini Code Assist را در یک IDE نصب کنید

کاربران سازمان شما Gemini Code Assist را در IDE ترجیحی خود نصب می کنند. برای اطلاعات بیشتر به ادامه مطلب مراجعه کنید:

به طور پیش فرض، Gemini Code Assist در IDE های زیر گنجانده شده است:

وظایف راه اندازی پیشرفته

به جای استفاده از کنسول Google Cloud یا gcloud برای اعطای نقش های IAM از پیش تعریف شده، می توانید یکی از کارهای زیر را انجام دهید:

  • از IAM REST API یا کتابخانه های سرویس گیرنده IAM برای اعطای نقش استفاده کنید.

    اگر از این رابط‌ها استفاده می‌کنید، از نام‌های نقش کاملا واجد شرایط استفاده کنید:

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

    برای اطلاعات بیشتر درباره اعطای نقش، به مدیریت دسترسی به پروژه‌ها، پوشه‌ها و سازمان‌ها مراجعه کنید.

  • ایجاد و اعطای نقش های سفارشی

    هر نقش سفارشی که ایجاد می‌کنید به مجوزهای زیر برای دسترسی به Gemini Code Assist نیاز دارد:

    • cloudaicompanion.companions.generateChat
    • cloudaicompanion.companions.generateCode
    • cloudaicompanion.instances.completeCode
    • cloudaicompanion.instances.completeTask
    • cloudaicompanion.instances.generateCode
    • cloudaicompanion.instances.generateText
    • 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 که در آن هر مجوز را اختصاص داده‌اید، فعال شود.

بعدش چی