Gemini Code Assist Standard and Enterprise را تنظیم کنید

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

  1. اشتراکی در Gemini Code Assist Standard یا Enterprise بخرید .

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

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

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

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

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

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

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

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

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

    به Admin for Gemini بروید

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

  2. Get Gemini Code Assist را انتخاب کنید.

    توجه داشته باشید که اگر مجوز مورد نیاز consumerprocurement.orders.place را ندارید، این دکمه غیرفعال است. اگر اشتراک Gemini Code Assist از قبل برای حساب صورت‌حساب مرتبط با پروژه وجود داشته باشد، این دکمه به‌عنوان مدیریت 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 Standard یا Enterprise خریداری شده است. اکنون باید تکالیف مجوز Gemini را در سازمان خود مدیریت کنید.

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

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

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

کنسول

برای اختصاص مجوزهای Gemini به کاربران جداگانه در کنسول API، باید مجوزهای زیر را در حساب صورت‌حساب داشته باشید:

  • 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

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

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

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

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

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

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

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

API

برای اختصاص مجوزهای Gemini با API، از روش billingAccounts.orders.licensePool.assign استفاده کنید.

  1. اطمینان حاصل کنید که مجوز consumerprocurement.licensePools.assign Identity and Access Management را در حساب صورت‌حساب که حاوی مجموعه مجوزی است که می‌خواهید مجوز آن را اختصاص دهید، دارید.

  2. یک فایل JSON ایجاد کنید که حاوی اطلاعات زیر باشد:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    جایی که USER_EMAILS فهرستی از حساب‌های کاربری جدا شده با کاما است که مجوز به آنها اختصاص داده شده است. به عنوان مثال، "dana@example.com", "lee@example.com" .

  3. برای فراخوانی متد 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 که در مرحله ۲ ایجاد کردید.
    • PROJECT_ID : شناسه یک پروژه. استفاده از سهمیه و هزینه‌های مربوط به درخواست API برای این پروژه اعمال می‌شود.
    • BILLING_ACCOUNT_ID : شناسه حساب صورت‌حساب مرتبط با مجموعه مجوز.
    • ORDER_ID : شناسه سفارش. اگر شناسه سفارش را نمی‌دانید، می‌توانید با فهرست کردن سفارش‌های مرتبط با حساب صورت‌حساب خود، آن را بازیابی کنید.

در صورت موفقیت آمیز بودن، پاسخ مشابه زیر است:

  {}

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

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

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

کنسول

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

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

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

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

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

gcloud

برای استفاده از یک محیط توسعه محلی، 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 بین IDE و Google پیکربندی کنید

علاوه بر فعال کردن 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 استفاده می شود.
  • lh3.googleusercontent.com و lh5.googleusercontent.com : برای به دست آوردن عکس های کاربر استفاده می شود.

آدرس های IP را برای دامنه های پیش فرض Google Cloud تعیین کنید

برای فعال کردن اتصال از IDE به APIهای Google Cloud، فایروال شما باید به ترافیک TCP خروجی به محدوده آدرس IP مستند شده عمومی Google اجازه دهد. این محدوده ها به صورت پویا توسط گوگل مدیریت می شوند.

برای حفظ فهرستی از محدوده IP برای دسترسی به دامنه های Google Cloud، چندین گزینه دارید:

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

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

  • Gemini for Google Cloud API
  • Gemini Code Assist API

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

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

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

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

کنسول

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

    به IAM & Admin بروید

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

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

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

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

  6. روی ذخیره کلیک کنید.

gcloud

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

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

  2. اعطای نقش کاربر 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

  3. مرحله قبل را برای نقش roles/serviceusage.serviceUsageConsumer تکرار کنید.

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

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

افزونه Gemini Code Assist را نصب کنید

کاربران سازمان شما افزونه Gemini Code Assist را در IDE مورد علاقه خود نصب می کنند

کد VS

  1. برای باز کردن نمای Extensions در VS Code، کلیک کنید نماد برنامه افزودنی برنامه های افزودنی یا Ctrl / Cmd + Shift + X را فشار دهید.

  2. Gemini Code Assist را جستجو کنید.

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

  4. اگر از شما خواسته شد، VS Code را مجددا راه اندازی کنید.

    پس از نصب موفقیت آمیز برنامه افزودنی، Gemini Code Assist در نوار فعالیت ظاهر می شود و آماده استفاده است. می‌توانید نصب Gemini Code Assist را با تعیین تنظیمات برگزیده خود با استفاده از نوار وظیفه برنامه سطح بالا پیکربندی کنید: به Code > Settings > Settings > Extensions بروید و Gemini Code Assist را جستجو کنید.

IntelliJ

  1. settings IDE و Project Settings > Plugins کلیک کنید.
  2. در برگه Marketplace ، Gemini Code Assist را جستجو کنید.
  3. برای نصب افزونه روی Install کلیک کنید.
  4. پس از اتمام نصب، روی Restart IDE کلیک کنید.

  5. هنگامی که IDE راه اندازی مجدد می شود، Gemini Code Assist در نوار فعالیت شما ظاهر می شود.

    نماد Gemini Code Assist در نوار فعالیت ظاهر می شود.

اکنون کاربران آماده استفاده از Gemini Code Assist Standard یا Enterprise در IDE خود هستند. درباره ویژگی های پشتیبانی شده بیشتر بدانید:

با راهنماهای زیر شروع کنید:

فهرست دایرکتوری هایی که Gemini Code Assist اطلاعات را در آن ذخیره می کند

جدول زیر فهرستی از دایرکتوری‌هایی را ارائه می‌کند که Gemini Code Assist اطلاعات برنامه‌های افزودنی مانند توکن‌های تأیید را ذخیره می‌کند:

ویندوز

  • %LOCALAPPDATA%/cloud-code
  • %LOCALAPPDATA%/google-vscode-extension

macOS

  • ~/Library/Application Support/cloud-code
  • ~/Library/Application Support/google-vscode-extension

لینوکس

  • ~/.cache/cloud-code
  • ~/.cache/google-vscode-extension

وارد Google شوید و یک پروژه Google Cloud را انتخاب کنید

هنگامی که کاربران Gemini Code Assist را در IDE های خود نصب کردند، باید به حساب های Google خود وارد شوند و اگر اولین بار است که از Gemini Code Assist Standard یا Enterprise در IDE خود استفاده می کنند، یک پروژه Google Cloud را انتخاب می کنند.

کد VS

اگر پروژه Google Cloud را بدون فعال بودن Gemini for Google Cloud API انتخاب کنید، اعلانی دریافت می کنید که به شما این امکان را می دهد که API را از IDE فعال کنید. Enable the API را در پنجره اعلان انتخاب کنید تا API برای پروژه شما فعال شود. برای اطلاعات بیشتر، به تنظیم Gemini Code Assist Standard and Enterprise برای یک پروژه مراجعه کنید.

اگر ترجیح می‌دهید به طور مستقیم از کد با Gemini Code Assist در IDE خود پیروی کنید، روی Launch VS Code کلیک کنید و مراحل زیر را برای اتصال به Google Cloud و فعال کردن Gemini Code Assist Standard یا Enterprise دنبال کنید.

VS Code را اجرا کنید

در غیر این صورت مراحل زیر را دنبال کنید:

  1. IDE خود را راه اندازی کنید.

  2. در نوار فعالیت، روی Gemini Code Assist کلیک کنید.

  3. در صفحه چت Gemini Code Assist ، روی ورود به Google Cloud کلیک کنید.

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

  5. دستورات را دنبال کنید تا وارد حساب Google خود شوید.

  6. وقتی از شما پرسیده شد که Gemini Code Assist را از Google دانلود کرده‌اید، روی ورود به سیستم کلیک کنید.

    اکنون به Google Cloud متصل هستید.

    در مرحله بعد، برای انتخاب یک پروژه Google Cloud که Gemini for Google Cloud API فعال است، این مراحل را دنبال کنید:

  7. در نوار وضعیت Gemini Code Assist ، روی Gemini Code Assist کلیک کنید.

    نوار وضعیت Gemini در دسترس است.

  8. در منوی Gemini Code Assist ، پروژه Select Gemini Code را انتخاب کنید.

  9. یک پروژه Google Cloud را انتخاب کنید که Gemini for Google Cloud API را فعال کرده باشد.

    Gemini Code Assist Standard یا Enterprise آماده استفاده است.

    نماد Gemini در نوار وضعیت روی حالت عادی تنظیم شده است.

IntelliJ

برای ورود به حساب Google خود، این مراحل را دنبال کنید:

  1. در نوار فعالیت، روی spark Gemini Code Assist کلیک کنید.

  2. روی ورود به گوگل کلیک کنید.

  3. در صفحه ای که در مرورگر وب باز می شود، حساب Google خود را انتخاب کنید.

  4. در صفحه‌ای که از شما می‌خواهد مطمئن شوید که این برنامه را از Google دانلود کرده‌اید، روی ورود به سیستم کلیک کنید.

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

    در مرحله بعد، اگر اولین بار است که از Gemini Code Assist Standard یا Enterprise در IDE خود استفاده می‌کنید، باید با دنبال کردن این مراحل یک پروژه Google Cloud را انتخاب کنید:

  5. به IDE خود برگردید. در پنجره ابزار Gemini Code Assist، اگر موافقت می کنید که به Google اجازه دهید API های مورد نیاز برای استفاده از Gemini Code Assist را برای پروژه انتخابی شما فعال کند، برای ادامه روی انتخاب پروژه GCP کلیک کنید.

  6. در گفتگوی Select Google Cloud Project ، پروژه Google Cloud خود را جستجو و انتخاب کنید و سپس روی OK کلیک کنید.

  7. روی FINISH کلیک کنید.

پروژه Google Cloud شما با فعال بودن Gemini Code Assist API انتخاب شده است. شما آماده استفاده از Gemini Code Assist Standard یا Enterprise در IDE خود هستید!

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

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

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

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

    • 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 که در آن هر مجوز را اختصاص داده‌اید، فعال شود.

بعدش چی